Invoice (810) Specification

Nick Wehner Updated by Nick Wehner

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 seller. This can be disabled for any Partnership if the seller 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~

How did we do?

Inventory Update (846) Specification

Purchase Order (850) Specification

Contact