Connecting through Seller EDI - Invoice (810) Specification
Updated
by Keith Weaver
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~