Invoice: Standard EDI payload – TradeCentric

The X12 810 invoice request payload sends an invoice request from your system, such as your eCommerce platform or ERP system, to the TradeCentric platform so that we can deliver the invoice to the buyer's eProcurement system. For standard integrations that send EDI payloads, we accept invoices in our standard EDI format.

This article describes the standard EDI format to use for this payload.

Important: This invoice request payload is for invoices associated with purchase orders (POs) only. The payload must include the buyer PO identifier from the PO request payload that we sent.

Jump to:

Request payload (to TradeCentric)

Request segment details

Envelope
Heading
Detail
Summary

Request payload (to TradeCentric)

The code block below shows an example invoice request payload in our standard EDI format:

X12

810

Invoice request

ISA*00*          *00*          *ZZ*SUPPLIER_INC *ZZ*TEST_CORP*221118*1057*U*00401*000000002*0*P*>~
GS*IN*SUPPLIER_INC*TEST_CORP*20221118*1057*2*X*004010~
ST*810*0001~
BIG*20221118*INV-PO-123*20221118*PO-123~
REF*ZZ*93369535150910.10.57.136~
N1*BY*TEST_CORP~
N1*ST*Test Corp. - Nashville Branch~
N3*123 Test St.; Suite A~
N4*Nashville*TN*37011*US~
N1*BT*Test Corp. - Nashville Branch~
N3*123 Test St.; Suite A~
N4*Nashville*TN*37011*US~
PER*CN*Contact Name*TE*8885559876*EM*contact@buyer.com~
PER*BD*Contact Name*TE*8885551234*EM*contact@buyer.com~
ITD*01*3*2**30**30~
DTM*011*20221225~
IT1*101*3*EA*41.15**BP*45L017*VP*CART12-ITEM123~
PID*F****Low Arc Kitchen Faucet: Dominion Faucets,
Silver, Chrome Finish, 1.75 gpm Fl~
TDS*13209~
TXI*ST*8.64~
SAC*C*D240***1009~
CTT*1~
SE*21*0001~
GE*1*2~
IEA*1*000000002~

Request segment details

A standard invoice request EDI payload has envelope, heading, detail, and summary sections. The subsections explain the segments and fields in each payload section.

String and number types: ID = standard EDI code, AN = alphanumeric text, N0 = whole number, N2 = decimal number without decimal point, R = decimal number with decimal point

Envelope

Contains the entire payload and provides the general identifying information described in the subsections below

ISA - Interchange control header

Required Max use: 1

Provides identifying information about the payload

Example

ISA*00*          *00*          *ZZ*SUPPLIER_INC *ZZ*TEST_CORP*221118*1057*U*00401*000000002*0*P*>~

ISA field breakdown

ISA-01

Authorization information qualifier

RequiredType: String (ID)Length: 2

Specifies whether authorization information is included

Example: 00 = no authorization information is included
ISA-02

Authorization information

RequiredType: String (AN)Length: 10

Provides the authorization value when authorization information is included

Example: = 10 spaces to indicate that the authorization information is blank
ISA-03

Security information qualifier

RequiredType: String (ID)Length: 2

Specifies whether security information is included

Example: 00 = no security information is included
ISA-04

Security information

RequiredType: String (AN)Length: 10

Provides the security value when security information is included

Example: = 10 spaces to indicate that the security information is blank
ISA-05

Sender qualifier

RequiredType: String (ID)Length: 2

Specifies the type of sender identifier provided

Example: ZZ = mutually defined by buyer and supplier
ISA-06

Sender identifier

RequiredType: String (AN)Length: 15

Provides the sender identifier

Example: SUPPLIER_INC
ISA-07

Receiver qualifier

RequiredType: String (ID)Length: 2

Specifies the type of receiver identifier provided

Example: ZZ = mutually defined by buyer and supplier
ISA-08

Receiver identifier

RequiredType: String (AN)Length: 15

Provides the receiver identifier

Example: TEST_CORP
ISA-09

Interchange date

RequiredFormat: YYMMDD

Provides the date when the payload was created

Example: 221118 = November 18, 2022
ISA-10

Interchange time

RequiredFormat: HHMM

Provides the time when the payload was created

Example: 1057 = 10:57
ISA-11

Interchange control standards identifier

RequiredType: String (ID)Length: 1

Specifies the standards organization that defines the format used for the payload

Example: U = U.S. EDI Community of ASC X12, TDCC, and UCS
ISA-12

Interchange control version code

RequiredType: String (ID)Length: 5

Specifies the X12 version used for the payload

Example: 00401
ISA-13

Interchange control number

RequiredType: Numeric (N0)Length: 9

Provides a unique control number for the payload

Example: 000000002
ISA-14

Acknowledgment requested

RequiredType: String (ID)Length: 1

Specifies whether your organization requests an acknowledgment that the buyer received this document

Values: 0 = no acknowledgment requested, 1 = acknowledgment requested
ISA-15

Interchange usage indicator code

RequiredType: String (ID)Length: 1

Indicates how the receiver should process the payload

Example: P = production data

Other codes: T = test data, I = informational data
ISA-16

Component element separator

RequiredType: DelimiterLength: 1

Specifies the unique character used to separate multiple values within one field

Example: >

GS - Functional group header

Required Max use: 1

Assigns a functional group to the invoice in the payload

Note: We recommend one functional group per payload so that errors in one group don’t affect other groups in the same payload.

Example

GS*IN*SUPPLIER_INC*TEST_CORP*20221118*1057*2*X*004010~

GS field breakdown

GS-01

Functional identifier code

RequiredType: String (ID)Length: 2

Specifies the transaction type for the group

Must be IN
GS-02

Application sender's code

RequiredType: String (AN)Length: 2-15

Provides the sender code for the group

Example: SUPPLIER_INC
GS-03

Application receiver's code

RequiredType: String (AN)Length: 2-15

Provides the receiver code for the group

Example: TEST_CORP
GS-04

Group date

RequiredFormat: YYYYMMDD

Provides the date when the group was created

Example: 20221118 = November 18, 2022
GS-05

Group time

RequiredFormat: HHMM

Provides the time when the group was created

Example: 1057 = 10:57
GS-06

Group control number

RequiredType: Numeric (N0)Length: 1-9

Provides the unique control number that your organization generated for the group

Example: 2
GS-07

Responsible agency code

RequiredType: String (ID)Length: 1

Specifies the standards organization that defines the format used for the group

Must be X
GS-08

Version or release code

RequiredType: String (AN)Length: 1-12

Provides the X12 version used for the group

Example: 004010

Heading

Starts the invoice and provides the identifying information, reference information, and contact details described in the subsections below

ST - Transaction set header

Required Max use: 1

Start of the invoice document

Note: We recommend one transaction set, meaning one document, per payload so that errors in one document don’t affect other documents in the same payload.

Example

ST*810*0001~

ST field breakdown

ST-01

Transaction set identifier code

RequiredType: String (ID)Length: 3

Specifies the transaction type

Must be 810
ST-02

Transaction set control number

RequiredType: String (AN)Length: 4-9

Provides the control number that your organization generated for the transaction set

Example: 0001

BIG - Beginning segment for invoice

Required Max use: 1

Provides identifying information about the invoice

Example

BIG*20221118*INV-PO-123*20221118*PO-123~

BIG field breakdown

BIG-01

Invoice date

RequiredFormat: YYYYMMDD

Provides the date when the invoice was created

Example: 20221118 = November 18, 2022
BIG-02

Invoice identifier

RequiredType: String (AN)Length: 1-22

Provides the invoice identifier that your organization generated

Example: INV-PO-123
BIG-03

PO date

OptionalFormat: YYYYMMDD

Provides the date from the PO request payload that we sent

Example: 20221118 = November 18, 2022
BIG-04

Buyer PO identifier

RequiredType: String (AN)Length: 1-22

Provides the buyer's PO identifier from the PO request payload that we sent

Example: PO-123

REF - Reference information

Optional Max use: 12

Provides additional reference information, which may vary depending on the integration's requirements

Example

REF*ZZ*93369535150910.10.57.136~

REF field breakdown

REF-01

Reference identification qualifier

Required if REF is usedType: String (ID)Length: 2-3

Specifies the type of reference identifier provided

Example: ZZ = mutually defined by buyer and supplier

Other common codes: DP = department number, IA = buyer's internal vendor number
REF-02

Reference identification

Required if REF is usedType: String (AN)Length: 1-30

Provides the reference identifier

Example: 93369535150910.10.57.136 = PO payload identifier

N1 loop - Parties, addresses, and contacts

Typically required Max use: 200

Provides the organizations, addresses, and contact details for the invoice

Note: Repeat this loop for each organization or address involved in the transaction. For example, if the billing address is different from the buyer's address, include a segment for the buyer and a separate segment for billing.

Example

N1*BY*TEST_CORP~
N1*ST*Test Corp. - Nashville Branch~
N3*123 Test St.; Suite A~
N4*Nashville*TN*37011*US~
N1*BT*Test Corp. - Nashville Branch~
N3*123 Test St.; Suite A~
N4*Nashville*TN*37011*US~
PER*CN*Contact Name*TE*8885559876*EM*contact@buyer.com~
PER*BD*Contact Name*TE*8885551234*EM*contact@buyer.com~

N1 loop breakdown

N1
Name

Typically required

Identifies the organization or location and provides its name
- N1-01 Entity identifier code
  
  Required if N1 is usedType: String (ID)Length: 2-3
  
  Specifies the type of organization or location provided
  
  Example: BY = buyer
  
  Other common codes: SU = supplier, ST = ship to, BT = bill to
- N1-02 Name
  
  Required if N1 is usedType: String (AN)Length: 1-60
  
  Provides the name of the organization or location
  
  Example: TEST_CORP
Example: N1*BY*TEST_CORP~
N3
Address information

Optional

Provides street address details for the organization or location
- N3-01 Address information
  
  Required if N3 is usedType: String (AN)Length: 1-55
  
  Provides the first line of the street address
  
  Example: 123 Test St.; Suite A
- N3-02 Address information
  
  OptionalType: String (AN)Length: 1-55
  
  Provides the second line of the street address
  
  Example: blank in this payload
Example: N3*123 Test St.; Suite A~
N4
Geographic location

Optional

Provides city, region, postal code, and country details
- N4-01 City name
  
  Required if N4 is usedType: String (AN)Length: 2-30
  
  Provides the city for the organization or location
  
  Example: Nashville
- N4-02 State or province code
  
  OptionalType: String (ID)Length: 2
  
  Provides the state, province, or region code
  
  Example: TN
- N4-03 Postal code
  
  OptionalType: String (ID)Length: 3-15
  
  Provides the postal code
  
  Example: 37011
- N4-04 Country code
  
  OptionalType: String (ID)Length: 2-3
  
  Provides the country code
  
  Example: US
Example: N4*Nashville*TN*37011*US~
PER
Administrative communications contact

Typically required

Provides the contact details for the organization or location
- PER-01 Contact function code
  
  Required if PER is usedType: String (ID)Length: 2
  
  Specifies the role of the contact
  
  Example: CN = general contact
  
  Other common codes: BD = buyer contact, DC = delivery contact
- PER-02 Name
  
  OptionalType: String (AN)Length: 1-60
  
  Provides the contact name
  
  Example: Contact Name
- PER-03 / PER-04 Communication number
  
  Optional
  
  Provides a communication method for the contact
  - PER-03 Communication number qualifier
    
    Required if PER-04 is usedType: String (ID)Length: 2
    
    Specifies the type of communication method provided
    
    Example: TE = telephone number
    
    Other common codes: EM = email, FX = fax
  - PER-04 Communication number
    
    Required if PER-03 is usedType: String (AN)Length: 1-256
    
    Provides the value for the communication method
    
    Example: 8885559876
- PER-05 / PER-06 Additional communication number
  
  Optional
  
  Provides an additional communication method for the contact
  - PER-05 Communication number qualifier
    
    Required if PER-06 is usedType: String (ID)Length: 2
    
    Specifies the type of communication method provided
    
    Example: EM = email
    
    Other common codes: TE = telephone number, FX = fax
  - PER-06 Communication number
    
    Required if PER-05 is usedType: String (AN)Length: 1-256
    
    Provides the value for the communication method
    
    Example: contact@buyer.com
Example: PER*CN*Contact Name*TE*8885559876*EM*contact@buyer.com~

ITD - Terms of sale or deferred terms of sale

Optional Max use: 13

Provides payment terms for the invoice

Example

ITD*01*3*2**30**30~

ITD field breakdown

ITD-01

Terms type code

OptionalType: String (ID)Length: 2

Specifies the type of payment terms used

Example: 01 = basic or standard payment term

Other common codes: 02 = end of month, 03 = specific date
ITD-02

Terms basis date code

OptionalType: String (ID)Length: 1-2

Specifies which date the payment terms are based on

Example: 3 = invoice date

Other common codes: 1 = shipping date, 2 = delivery date
ITD-03

Terms discount percent

OptionalType: Decimal number (R)

Provides the payment discount percentage when a discount applies

Example: 2 = 2 percent
ITD-05

Terms discount days due

OptionalType: Numeric (N0)

Provides the number of days allowed for a discount

Example: 30
ITD-07

Terms net days

OptionalType: Numeric (N0)

Provides the number of days until the invoice is due

Example: 30

DTM - Date and time reference

Optional Max use: 10

Provides a relevant date for the invoice

Example

DTM*011*20221225~

DTM field breakdown

DTM-01

Date or time qualifier

RequiredType: String (ID)Length: 3

Specifies the type of date provided

Example: 011 = actual shipping date

Other common codes: 001 = cancel after date, 010 = shipping requested on date, 106 = required by date
DTM-02

Date

RequiredFormat: YYYYMMDD

Provides the date

Example: 20221225 = December 25, 2022

Detail

Provides the invoice item details, which are described in the subsections below

Note: Repeat these segments for each line item, starting with IT1.

IT1 - Baseline item data

Required Max use: 100000

Provides the main details about each line item

Example

IT1*101*3*EA*41.15**BP*45L017*VP*CART12-ITEM123~

IT1 field breakdown

IT1-01

Assigned identification

OptionalType: String (AN)Length: 1-20

Provides the line item identifier, which is often the line number

Example: 101
IT1-02

Quantity invoiced

RequiredType: Decimal number (R)

Provides the quantity of the line item

Example: 3
IT1-03

Unit of measure

RequiredType: String (ID)Length: 2

Specifies the unit of measure for the quantity

Example: EA = each
IT1-04

Unit price

OptionalType: Decimal number (R)

Provides the price of one unit

Example: 41.15
IT1-06 / IT1-07
Product or service identifier

Optional

Provides an item identifier, such as a part number or Stock Keeping Unit (SKU)
- IT1-06 Identifier qualifier
  
  Required if IT1-07 is usedType: String (ID)Length: 2
  
  Specifies the type of item identifier provided
  
  Example: BP = buyer's part number
- IT1-07 Identifier
  
  Required if IT1-06 is usedType: String (AN)Length: 1-80
  
  Provides the identifier
  
  Example: 45L017
Example: BP*45L017
IT1-08 / IT1-09
Additional product or service identifier

Optional

Provides an additional item identifier, such as to indicate a specific color or packaging option
- IT1-08 Identifier qualifier
  
  Required if IT1-09 is usedType: String (ID)Length: 2
  
  Specifies the type of additional item identifier provided
  
  Example: VP = vendor's part number
- IT1-09 Identifier
  
  Required if IT1-08 is usedType: String (AN)Length: 1-80
  
  Provides the identifier
  
  Example: CART12-ITEM123
Example: VP*CART12-ITEM123

PID - Product or item description

Optional Max use: 1000

Provides a description for each line item

Example

PID*F****Low Arc Kitchen Faucet: Dominion Faucets, Silver, Chrome Finish, 1.75 gpm Fl~

PID field breakdown

PID-01

Item description type

RequiredType: String (ID)Length: 1

Specifies the description format

Example: F = free-form text
PID-05

Description

Required if PID-01 is F or XType: String (AN)Length: 1-80

Provides the item description text

Example: Low Arc Kitchen Faucet: Dominion Faucets, Silver, Chrome Finish, 1.75 gpm Fl

Summary

Ends the invoice and the payload using the summary details described in the subsections below

TDS - Total monetary value summary

Required Max use: 1

Provides the total value of the invoice

Example

TDS*13209~

TDS field breakdown

TDS-01

Total invoice amount

RequiredType: Numeric (N2)Length: 1-15

Provides the total invoice amount

Example: 13209 = 132.09

TXI - Tax information

Optional Max use: 10

Provides a tax amount for the invoice

Example

TXI*ST*8.64~

TXI field breakdown

TXI-01

Tax type code

RequiredType: String (ID)Length: 2

Specifies the type of tax provided

Example: ST = state sales tax

Other common codes: GS = goods and services tax, SU = sales and use tax, VA = value added tax
TXI-02

Monetary amount

RequiredType: Decimal number (R)

Provides the tax amount

Example: 8.64

SAC - Service, promotion, allowance, or charge information

Optional Max use: 25

Provides an allowance or charge that applies to the invoice

Example

SAC*C*D240***1009~

SAC field breakdown

SAC-01

Allowance or charge indicator

RequiredType: String (ID)Length: 1

Specifies whether the value is an allowance or a charge

Example: C = charge

Other common codes: A = allowance, P = promotion, S = service
SAC-02

Service, promotion, allowance, or charge code

RequiredType: String (ID)Length: 4

Specifies the type of allowance or charge provided

Example: D240 = freight
SAC-05

Amount

RequiredType: Numeric (N2)

Provides the allowance or charge amount

Example: 1009 = 10.09

CTT - Transaction totals

Optional Max use: 1

Provides the line item total for the invoice

Example

CTT*1~

CTT field breakdown

CTT-01

Number of line items

Required if CTT is usedType: Numeric (N0)Length: 1-6

Provides the total number of IT1 segments in the invoice

Example: 1

SE - Transaction set trailer

Required Max use: 1

Ends the invoice

Example

SE*21*0001~

SE field breakdown

SE-01

Number of included segments

RequiredType: Numeric (N0)Min value: 1

Provides the total number of segments from ST through SE

Example: 21
SE-02

Transaction set control number

RequiredType: String (AN)Length: 4-9

Provides the same control number as ST-02

Example: 0001

GE - Functional group trailer

Required Max use: 1

Ends the functional group that contains the invoice

Example

GE*1*2~

GE field breakdown

GE-01

Number of transaction sets included

RequiredType: Numeric (N0)

Provides the number of invoices in the group

Recommended value: 1
GE-02

Group control number

RequiredType: Numeric (N0)Length: 1-9

Provides the same control number as GS-06

Example: 2

IEA - Interchange control trailer

Required Max use: 1

Ends the payload

Example

IEA*1*000000002~

IEA field breakdown

IEA-01

Number of included functional groups

RequiredType: Numeric (N0)

Provides the number of functional groups in the payload

Recommended value: 1
IEA-02

Interchange control number

RequiredType: Numeric (N0)Length: 9

Provides the same control number as ISA-13

Example: 000000002

Request payload (to TradeCentric)

Request segment details

Envelope

ISA - Interchange control header

Authorization information qualifier

Authorization information

Security information qualifier

Security information

Sender qualifier

Sender identifier

Receiver qualifier

Receiver identifier

Interchange date

Interchange time

Interchange control standards identifier

Interchange control version code

Interchange control number

Acknowledgment requested

Interchange usage indicator code

Component element separator

GS - Functional group header

Functional identifier code

Application sender's code

Application receiver's code

Group date

Group time

Group control number

Responsible agency code

Version or release code

Heading

ST - Transaction set header

Transaction set identifier code

Transaction set control number

BIG - Beginning segment for invoice

Invoice date

Invoice identifier

PO date

Buyer PO identifier

REF - Reference information

Reference identification qualifier

Reference identification

N1 loop - Parties, addresses, and contacts

Name

Address information

Geographic location

Administrative communications contact

ITD - Terms of sale or deferred terms of sale

Terms type code

Terms basis date code

Terms discount percent

Terms discount days due

Terms net days

DTM - Date and time reference

Date or time qualifier

Date

Detail

IT1 - Baseline item data

Assigned identification

Quantity invoiced

Unit of measure

Unit price

Product or service identifier

Additional product or service identifier

PID - Product or item description

Item description type

Description

Summary

TDS - Total monetary value summary

Total invoice amount

TXI - Tax information

Tax type code

Monetary amount

SAC - Service, promotion, allowance, or charge information

Allowance or charge indicator

Service, promotion, allowance, or charge code

Amount

CTT - Transaction totals

Number of line items

SE - Transaction set trailer

Number of included segments