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.

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:

  1. Transactions coming from you to Rithum need to be placed in the /in directory.
  2. 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.
  3. Transactions being generated by Rithum will be deposited in the /out directory.
  4. 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

Rithum
  • 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.

Was this article helpful?
0 out of 0 found this helpful

Comments

0 comments

Please sign in to leave a comment.