Connecting through Seller EDI - Invoice (810) Specification
In this guide, we walkthrough our basic EDI specification for Invoice (810) files. You can read through the full guide here.
Segment Summary
ID | Name | Loop ID | Required by Convictional |
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: UP, EN, OT |
IT1-07 | Product ID | True | 1 | 48 | Ex. 123142 |
IT1-03
Code | Name |
EA | Each |
IT1-06
Code | Name | Notes |
UP | UPC Code | |
EN | European Article Number | |
OT | Internal Number | This is the Convictional Variant ID. |
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**UP*028295461111***PO*4541811000~
IT1*00020*1*EA*22.75**UP*028295452222***PO*4541811000~
TDS*4634~
TXI*GS*3.04~
TXI*SP*3~
CTT*2~
SE*17*0001~
GE*5*38030~
IEA*1*000038030~
