Seller EDI Quick Reference: Fall 2024 and later
If you integrated with EDI earlier, refer to these docs.
Modern Dropship supports the transfer of EDI messages via SFTP.
SFTP details
Host
sftp.convictional.com:2122
Credentials
Your username and password are accessed via the Modern Dropship app at app.moderndropship.com/settings/dropshipping/integrations
Directories
/outbound- This is where you will place files being sent to Modern Dropship- product csv, 846, 855, 856
/inbound- This is where Modern Dropship will place files for you to consume- 997, 850
File naming and extensions
By default, Modern Dropship expects EDI files to have one of the following extensions: .x12, .edi, .dat, .txt. If you need to send files with a different extension, that can be configured at app.moderndropship.com/settings/dropshipping/integrations. All EDI files that Modern Dropship sends will have a .x12 extension and have the following naming convention:
Pattern:
interchange-control-number_transaction-set-code_transaction-set-name_company-id.x12
Example:
0123456789_850_PurchaseOrder_fdgs904ibon3q97a8ds.x12
Modern Dropship does not require a specific naming convention for files we receive, but they should otherwise be unique within the integration to avoid conflicts.
Data flow
- All EDI files must contain a single transaction set. Single-file batching is not supported, and Modern Dropship will only ever send one transaction set within a file and expects to only ever see one transaction set in a file we receive.
- Modern Dropship checks for new files to process in the
/outbounddirectory every 15 minutes. - Modern Dropship writes files to the
/inbounddirectory any time there is a new 850 or 997 to send. - Any errors encountered will result in TradeOps Issues being created.
- If you are looking for details on transaction sets related to order flow (850, 855, 856), you can typically find these on the related order page app.moderndropship.com/orders/:order-id. In some cases an issue with file processing (like malformed edi file) can result in the EDI record not being associated with an order. If that happens you can reach out to support@moderndropship.com.
ISA identifiers
You can configure your own ISA qualifier and identifier in app.moderndropship.com/settings/dropshipping/integrations.
Testing
Qualifier: 01ID: 117522184
Production
ISA qualifiers and IDs in production are based on your trading partners configuration. You can set this data in your Dropping Integrations Settings.
Product Identifiers
In order for Modern Dropship to successfully process transaction sets that make references to products, it is important that the products being referenced in these messages are properly set up in Modern Dropship with the expected identifiers.
All products will need unique Variant Codes populated. In this setup, segments with product identifiers will, for example, contain ...VC*12347679... within the segment. Refer to our mapping specifications for more detail and examples. See our Product Upload Template for an example.
Inventory
EDI integrations are expected to manage inventory via 846s. When products are initially created via CSV, they can seed an initial inventory count but ongoing csv processing will ignore inventory and defer to counts provided in the 846.
Testing
Once you've set up products and pricing within Modern Dropship and are ready to test EDI flows (inventory and orders), you can generate a test order through the app by following these steps. Once the test order is created within Modern Dropship, you should see the 850 in your /inbound directory within 30 minutes.
Depending upon the complexity of partial orders and fulfillments you plan to support, consider additional testing against the following scenarios:
- one order, completely accepted by the 855 and completely fulfilled by an 856
- one order, completely rejected by the 855
- one order, partially rejected and partially accepted by the 855, and partially fulfilled by 856
