Invoice (810) Specification
This documentation is for users who have integrated with EDI in September 2024 or later.
If you integrated with EDI earlier, refer to these docs.
In this guide, we walkthrough our basic EDI specification for Invoice (810) files. You can read through the full guide here.
By default, invoices are generated automatically after an Advanced Ship Notice (856) has been accepted, and should not be submitted by the supplier. This can be disabled for any Partnership if the supplier wishes to invoice manually: please contact Modern Dropship support to make this change.
Segment Summary
ID | Name | Loop ID | Required by Modern Dropship |
ST | Transaction Set Header | Mandatory | |
BIG | Beginning Segment for Invoice | Mandatory | |
CUR | Currency | Mandatory | |
REF | Reference Identification | Mandatory | |
IT1 | Baseline Item Date (Invoice) | IT1 | Mandatory |
TDS | Total Monetary Value Summary | Mandatory | |
TXI | Tax Information | Optional | |
CTT | Transaction Totals | Mandatory | |
SE | Transaction Set Trailer | Mandatory |
Segment Specifications
ST
ID | Name | Required | Min | Max | Notes |
ST-01 | Transaction Set Identifier Code | True | 3 | 3 | Accepted Values: 810 |
ST-02 | Transaction Set Control Number | True | 4 | 9 | Ex. 0001 |
BIG
ID | Name | Required | Min | Max | Notes |
BIG-01 | Date | True | 8 | 8 | Ex. 20211231 |
BIG-02 | Invoice Number | True | 1 | 22 | Ex. 9203 |
BIG-04 | Purchase Order Number | True | 1 | 22 | Ex. 1235 |
BIG-01
Expected format YYYYMMDD.
Our servers run on the UTC timezone.
CUR
ID | Name | Required | Min | Max | Notes |
CUR-01 | Entity Identifier Code | True | 2 | 3 | Accepted Values: SE |
CUR-02 | Currency Code | True | 3 | 3 | Ex. CAD, USD |
CUR-01
Code | Name |
SE | Selling Party |
IT1
ID | Name | Required | Min | Max | Notes |
IT1-01 | Assigned Identification | True | 1 | 20 | Ex. 0001 |
IT1-02 | Quantity Invoiced | True | 1 | 10 | Ex. 1 |
IT1-03 | Unit for Measurement Code | True | 2 | 2 | Accepted Values: EA |
IT1-04 | Unit Price | True | 1 | 17 | Ex. 17.55 |
IT1-06 | Product ID Qualifier | True | 2 | 2 | Accepted Values: VC |
IT1-07 | Product ID | True | 1 | 48 | Ex. 123142 |
IT1-03
Code | Name |
EA | Each |
IT1-06
Code | Name | Notes |
VC | Variant Code |
TDS
ID | Name | Required | Min | Max | Notes |
TDS-01 | Amount | True | 1 | 15 | This value should be in cents. Ex. 4653 |
TXI
ID | Name | Required | Min | Max | Notes |
TXI-01 | Tax Type Code | True | 2 | 2 | Accepted Values: GS, SP |
TXI-02 | Monetary Amount | False | 1 | 18 | Ex. 3.04, 3 |
TXI-01
Code | Name | Notes |
GS | Goods and Services Tax | |
SP | State/Provincial Tax |
CTT
ID | Name | Required | Min | Max | Notes |
CTT-01 | Number of Line Items | True | 1 | 6 | Ex. 2 |
SE
ID | Name | Required | Min | Max | Notes |
SE-01 | Number of Include Segments | True | 1 | 10 | Ex. 17 |
SE-02 | Transaction Set Control Number | True | 4 | 9 | Ex. 0001 |
Samples
ISA*00* *00* *01*117522184 *ZZ*SAMPLEISAID *210423*2004*U*00401*000038030*0*P*}~
GS*IN*117522184*SAMPLEISAID*20210423*2004*38030*X*004010~
ST*810*0001~
BIG*20210423*9200543422**4541811000~
CUR*SE*CAD~
IT1*00010*1*EA*17.55**VC*028295461111***PO*4541811000~
IT1*00020*1*EA*22.75**VC*028295452222***PO*4541811000~
TDS*4634~
TXI*GS*3.04~
TXI*SP*3~
CTT*2~
SE*17*0001~
GE*5*38030~
IEA*1*000038030~