Connection Issues Overview
Connection problems are the most common category of EDI errors. They prevent documents from being sent to or received from your trading partners. The good news is that most connection issues have straightforward solutions.
SFTP Connection Issues
SFTP Connection Refused
This error means RetailReady tried to connect to the SFTP server but the connection was actively refused. Common causes:
- The SFTP server is down or not running
- A firewall is blocking the connection on the server side
- The server address or port number is incorrect
How to fix: Go to Trading Partners > Connection Settings and verify the SFTP host address and port are correct. If they look right, contact your trading partner to confirm their server is running and that your IP address is allowed through their firewall.
SFTP Connection Lost
The connection was established but then dropped during file transfer. This is usually a temporary network issue.
How to fix: No action needed. RetailReady will automatically retry on the next processing cycle. If this happens frequently, it may indicate an unstable network connection between RetailReady and the SFTP server.
SFTP Connection Timeout
RetailReady waited 30 seconds for the server to respond but got no answer. The server may be overloaded, or there may be a network routing issue.
How to fix: Verify the SFTP host address and port in Trading Partners > Connection Settings. If the address is correct, wait a few minutes and try again. The server may be experiencing high load.
SFTP Authentication Failed
The connection reached the server, but the username and password (or SSH key) were rejected.
How to fix: Go to Trading Partners > Connection Settings and re-enter your SFTP credentials. Common issues include: copied passwords with trailing spaces, expired passwords, or the retailer changed credentials without notifying you.
SFTP Permission Denied
Authentication succeeded, but the SFTP user does not have permission to access the requested file or directory.
How to fix: Contact your SFTP administrator (usually the retailer's EDI team) and request read/write access to the EDI directories.
SFTP Path Not Found
The directory specified in your connection settings does not exist on the SFTP server.
How to fix: Go to Trading Partners > Connection Settings and verify the directory path. The directory may need to be created on the server, or the path may have a typo.
SFTP Directory Listing Failed
RetailReady connected to the server but could not list the files in the EDI directory.
How to fix: Verify the directory path exists and that the SFTP user has list/read permissions on that directory.
SFTP Host Not Configured
The outbound SFTP host address has not been entered in your trading partner settings.
How to fix: Go to Trading Partners > Connection Settings and add the SFTP host address provided by your retailer.
SFTP Username Not Configured
The outbound SFTP username has not been entered in your trading partner settings.
How to fix: Go to Trading Partners > Connection Settings and add the SFTP username provided by your retailer.
Inbound Host Not Configured
The inbound SFTP host address is missing from your configuration.
How to fix: Go to Trading Partners > Connection Settings and add the inbound host address.
Inbound Username Not Configured
The inbound SFTP username is missing from your configuration.
How to fix: Go to Trading Partners > Connection Settings and add the inbound username.
AS2 Connection Issues
AS2 Network Error
RetailReady could not reach the AS2 endpoint at all. The server may be down or the URL may be incorrect.
How to fix: Verify the AS2 URL in Trading Partners > Connection Settings. Contact your trading partner if the URL appears correct but the error persists.
AS2 HTTP Error
The AS2 server responded with an HTTP error (like 400, 403, 500, etc.). The server is reachable but rejected the request.
How to fix: Check the AS2 URL and credentials. If the error includes a specific HTTP status code, that can help diagnose the issue. Contact your trading partner's EDI team for help.
AS2 Timeout
The AS2 request timed out. The trading partner's server may be slow or unresponsive.
How to fix: The system will retry automatically. If the timeout happens repeatedly, contact your trading partner about their server performance.
AS2 URL Not Configured
The AS2 URL has not been entered for this trading partner.
How to fix: Go to Trading Partners > Connection Settings and add the AS2 URL provided by your retailer.
AS2 Partner ID Not Configured
The AS2 Partner ID has not been entered for this trading partner.
How to fix: Go to Trading Partners > Connection Settings and add the AS2 Partner ID provided by your retailer.
Transmission Errors
SFTP Transmission Failed
RetailReady could not upload a document to the trading partner's SFTP server. This is different from a connection error — the connection may have worked previously but failed during this specific transmission.
How to fix: Check the outbound SFTP settings in Trading Partners > Connection Settings. Verify the host, port, credentials, and directory path are all correct.
AS2 Transmission Failed
An AS2 document transmission failed. The system will retry automatically.
How to fix: If retries fail, check your AS2 settings including the URL, AS2 IDs, and certificates.
AS2 MDN Issues
AS2 uses MDN (Message Disposition Notification) receipts to confirm document delivery. MDN issues include:
- MDN Negative — The trading partner's system reported an error processing your document. Contact them to understand why.
- MDN Timeout — The trading partner did not confirm receipt within 30 minutes. The document may have been received — contact them to verify.
- MDN MIC Mismatch — The message integrity check failed, meaning the content may have been altered in transit. Resend the document.
- MDN Parse Failure — The MDN response could not be parsed. Contact support.
Connection Configuration Invalid
The trading partner's connection settings are incomplete. One or more required fields are missing.
How to fix: Go to Trading Partners > Connection Settings and fill in all required fields. Look for any fields highlighted in red or marked as required.