You can exchange data such as orders, inventory, order status, shipment and invoice information. The platform only needs two automated jobs to enable EDI exchange. The first job is an EDI Import job that handles the import of your inventory (846), order status (870), order acknowledgement (855), shipment (856) and invoice (810) data. The second job handles the export of your orders (850). The instructions below provide you with the details you need to ensure proper setup and configuration of your EDI exchange.
Table of contents
Rithum EDI specifications
For more information, see Rithum EDI specifications.
Standard version
Rithum 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.
Interchange ID
Rithum uses "DSCO" as the interchange ID with a qualifier of "ZZ".
Data exchange protocols
SFTP/FTP
Rithum supports EDI using FTP or SFTP. Rithum recommends using SFTP as it is more secure.
Every Rithum 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 Rithum FTP/SFTP servers, please be aware of the following:
- Transactions coming from you to Rithum need to be placed in the /in directory.
- When Rithum 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 Rithum 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.
AS2
For those requiring a higher level of security, Rithum provides access to an AS2 server. The setup and configuration of the AS2 connection is currently manual so please contact our support team to make a request to utilize AS2.
Supported transactions
Rithum 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 Rithum.
ISA control numbers
For incoming EDI transactions, Rithum 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. Rithum does not reject ISA Control Numbers that are not unique.
For outgoing EDI transactions, Rithum provides an ISA Control Number that is a sequentially incremented number, starting at 000000001.
Delimiters
- 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, Rithum 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
Rithum 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 Rithum to return a 997 for every incoming EDI transaction. If that option is not selected, Rithum will not return the 997. All 997 documents we generate are deposited on our FTP/SFTP within the "/out" directory. Rithum does not currently support the generation of 997 documents that need to be delivered to external destinations.
When processing the incoming EDI transactions, Rithum records the "Sender" and "Receiver" IDs and qualifiers that were provided and switches them in order to generate the 997s. Because Rithum 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
Rithum supports the following shipping service level codes:
| Carrier | Method | Service Code |
|---|---|---|
| FedEx | SameDay | FESD |
| FedEx | SameDay City | FSDC |
| FedEx | First Overnight | FEFO |
| FedEx | Priority Overnight | FEPO |
| FedEx | Standard Overnight | FESO |
| FedEx | 2 Day A.M. | F2DA |
| FedEx | 2 Day | FE2D |
| FedEx | Express Saver | FEES |
| FedEx | Ground | FECG |
| FedEx | Home Delivery | FEHD |
| FedEx | SmartPost | FESP |
| 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 |
| UPS | Ground | UPCG |
| UPS | Standard | UPSS |
| USPS | Priority Mail Express | USPE |
| USPS | Priority Mail | USPM |
| USPS | First-Class Mail | USFC |
| USPS | Ground | USCG |
| Generic | Three Day | G3D |
| Generic | Ground | GCG |
| Generic | Express Saver | GCX |
| Generic | International | GIX |
| Generic | Next Day | GND |
| Generic | Priority | GNM |
| Generic | 1st Overnight | GON |
| Generic | Same Day | GSA |
| Generic | Saturday | GSD |
| Generic | Second Day | GSE |
Although Rithum uses the codes above as our defaults, be advised that it is possible for your retailer to use their own. To ensure that orders flow properly, please discuss these details with your trading partner prior to processing live orders.
Comments
Please sign in to leave a comment.