As a retailer, you can use EDI to pull supplier updates (inventory, shipment, cancellation, invoice) from Dsco and send orders to Dsco. Typically, you should only need two automated jobs to enable EDI exchange. The first job is an EDI Import job that handles the import of your orders (850). The second job will handle all of the supplier data you need to receive: inventory (846), order status (870), order acknowledgement (855), shipment (856), and invoice (810) data. The instructions below provide you with the details you need to ensure proper setup and configuration of your EDI exchange.
For additional support with your EDI exchange, please email us at email@example.com.
Table of Contents
Dsco EDI Specification
Dsco currently supports two different versions of EDI. Most trading partners should use the 4010 version, linked below. However, some trading partners may require more information, especially on the 850 Purchase Order file. If you require information such as bill-to, tax, gift indicators, and marketing messages to be included with orders, please reference the 5010 850 version.
Dsco 4010 Version (All Documents)
Dsco 5010 Version (850 Only)
Dsco supports EDI using the 004010VICS and 005010 versions.
Please note that only the 850 document is supported in the 005010 version. All other documents, including the 4010 version of the 850, are referenced in the 004010VICS version.
Dsco uses "DSCO" as the interchange ID with a qualifier of "ZZ".
Note: Both the interchange ID and qualifier can be customized to whatever values the retailer would like to see. This can be done by editing the job settings of an EDI Export job on the AUTOMATION (https://app.dsco.io/automation) page.
Data Exchange Protocols
Dsco supports EDI using FTP or SFTP. Dsco recommends using SFTP as it is more secure.
Every Dsco account includes an FTP/SFTP account that is specific to that account and is not shared with any other. EDI exchange can use the ftp.dsco.io server or you can use your own FTP/SFTP server.
For those utilizing the standard Dsco FTP/SFTP servers, please be aware of the following:
- Transactions coming from the retailer to Dsco need to be placed in the /in directory.
- When Dsco processes incoming files, we move the files to the /in/processing directory temporarily, while we process those files, and then we move them to the /in/archive directory once the import has completed.
- Transactions being generated by Dsco will be deposited in the /out directory.
- Our servers monitor the /out directory. Upon successful download of any file in that directory, we moves the file(s) to the /out/archive folder where you can access them again if necessary.
Please do not delete the files from the /out directory once you have downloaded them. It is helpful to both parties to have those files available in archive if need be.
For those requiring a higher level of security, Dsco provides access to an AS2 server. The setup and configuration of the AS2 connection is currently manual so please contact our support team at firstname.lastname@example.org to make a request to utilize AS2.
Dsco supports the following transaction types:
- 846 Inventory Advice
- 850 Purchase Order
- 855 Purchase Order Acknowledgement
- 856 Advanced Ship Notice (ASN)
- 870 Order Status (Cancel)
- 810 Invoice
If you wish to download rich product information, such as product descriptions and images, you can utilize our flat-file exchange using CSV, TAB or Excel formatted files. However, please check with your trading partner as it is possible that they may not be adding that information to Dsco.
ISA Control Numbers
For incoming EDI transactions, Dsco does not require that each transaction have a unique ISA Control Number, but it is best practice, especially in the event that two parties need to research a specific transaction. Dsco does not reject ISA Control Numbers that are not unique.
For outgoing EDI transactions, Dsco provides an ISA Control Number that is a sequentially incremented number, starting at 000000001.
Dsco utilizes the following defaults for new EDI 850 export jobs:
- Segment Terminator: ~ (Decimal Value 126 or HEX 7E)
- Element Separator: * (Decimal Value 42 or HEX 2A)
- Sub-element Separator: > (Decimal Value 62 or HEX 3E)
For incoming EDI transactions, Dsco automatically detects the above characters as the EDI specification dictates. The Segment Terminator should be the 106th character, the Element Separator should be the 104th character and the Sub-element Separator should be the 105th character.
997 (FA) Acknowledgements
Dsco does not require that you return a 997 for each transaction that we send you, but it is considered best practice to do so and we encourage you to follow best practice.
When setting up an incoming EDI import job, you have the option of setting the "Generate 997 Flag" option. Selecting this option instructs Dsco to return a 997 for every incoming EDI transaction. If that option is not selected, Dsco will not return the 997. All 997 documents we generate are deposited on our FTP/SFTP within the "/out" directory. Dsco does not currently support the generation of 997 documents that need to be delivered to external destinations.
When processing the incoming EDI transactions, Dsco records the "Sender" and "Receiver" IDs and qualifiers that were provided and switches them in order to generate the 997s. Because Dsco also automatically detects the segment terminator, element separator, sub-element separator and standard version, we use those same characters within the 997s.
Shipping Service Level Codes
Dsco supports the following shipping service level codes:
|UPS||Next Day Air Early||UNAE|
|UPS||Next Day Air||UNDA|
|UPS||Next Day Air Saver||UNAS|
|UPS||2nd Day Air A.M.||U2AA|
|UPS||2nd Day Air||U2DA|
|UPS||3 Day Select||U3DS|
|USPS||Priority Mail Express||USPE|
Although Dsco uses the above codes as our defaults, be advised that it is possible for your supplier to expect different codes. To ensure that orders flow properly, please discuss these details with your trading partner prior to processing live orders.