Amazon
/
Retail Invoice
  • Specification
  • EDI Inspector
Stedi maintains this guide based on public documentation from Amazon. Contact Amazon for official EDI specifications. To report any errors in this guide, please contact us.
Go to Stedi Network
Amazon logo

X12 810 Retail Invoice

X12 Release 4010

This Draft Standard for Trial Use contains the format and establishes the data contents of the Invoice Transaction Set (810) for use within the context of an Electronic Data Interchange (EDI) environment. The transaction set can be used to provide for customary and established business and industry practice relative to the billing for goods and services provided.

Delimiters
  • ~ Segment
  • * Element
  • > Component
EDI samples
  • Example with Tax
View the latest version of this implementation guide as an interactive webpage
https://www.stedi.com/app/guides/view/amazon/retail-invoice/01H16G9CW3P7QM9673TH14B7Y5
Powered by
Build EDI implementation guides at stedi.com
Overview
ISA
-
Interchange Control Header
Max use 1
Required
GS
-
Functional Group Header
Max use 1
Required
heading
ST
010
Transaction Set Header
Max use 1
Required
BIG
020
Beginning Segment for Invoice
Max use 1
Required
CUR
040
Currency
Max use 1
Required
Bill To
ITD
130
Terms of Sale/Deferred Terms of Sale
Max use 1
Required
summary
TDS
010
Total Monetary Value Summary
Max use 1
Required
TXI
020
Tax Information
Max use 10
Optional
SAC Loop
CTT
070
Transaction Totals
Max use 1
Required
SE
080
Transaction Set Trailer
Max use 1
Required
GE
-
Functional Group Trailer
Max use 1
Required
IEA
-
Interchange Control Trailer
Max use 1
Required
ISA

Interchange Control Header

RequiredMax use 1

To start and identify an interchange of zero or more functional groups and interchange-related control segments

Example
ISA-01
I01
Authorization Information Qualifier
Required
Identifier (ID)

Code to identify the type of information in the Authorization Information

00
No Authorization Information Present (No Meaningful Information in I02)
ISA-02
I02
Authorization Information
Required
String (AN)
Min 10Max 10

Information used for additional identification or authorization of the interchange sender or the data in the interchange; the type of information is set by the Authorization Information Qualifier (I01)

ISA-03
I03
Security Information Qualifier
Required
Identifier (ID)

Code to identify the type of information in the Security Information

00
No Security Information Present (No Meaningful Information in I04)
ISA-04
I04
Security Information
Required
String (AN)
Min 10Max 10

This is used for identifying the security information about the interchange sender or the data in the interchange; the type of information is set by the Security Information Qualifier (I03)

ISA-05
I05
Interchange ID Qualifier
Required
Identifier (ID)
Min 2Max 2

Qualifier to designate the system/method of code structure used to designate the sender or receiver ID element being qualified

Codes
ISA-06
I06
Interchange Sender ID
Required
String (AN)
Min 15Max 15

Identification code published by the sender for other parties to use as the receiver ID to route data to them; the sender always codes this value in the sender ID element

ISA-07
I05
Interchange ID Qualifier
Required
Identifier (ID)
Min 2Max 2

Qualifier to designate the system/method of code structure used to designate the sender or receiver ID element being qualified

Codes
ISA-08
I07
Interchange Receiver ID
Required
String (AN)
Min 15Max 15

Identification code published by the receiver of the data; When sending, it is used by the sender as their sending ID, thus other parties sending to them will use this as a receiving ID to route data to them

ISA-09
I08
Interchange Date
Required
Date (DT)
YYMMDD format

Date of the interchange

ISA-10
I09
Interchange Time
Required
Time (TM)
HHMM format

Time of the interchange

ISA-11
I10
Interchange Control Standards Identifier
Required
Identifier (ID)

Code to identify the agency responsible for the control standard used by the message that is enclosed by the interchange header and trailer

U
U.S. EDI Community of ASC X12, TDCC, and UCS
ISA-12
I11
Interchange Control Version Number
Required
Identifier (ID)

This version number covers the interchange control segments

00401
Draft Standards for Trial Use Approved for Publication by ASC X12 Procedures Review Board through October 1997
ISA-13
I12
Interchange Control Number
Required
Numeric (N0)
Min 9Max 9

A control number assigned by the interchange sender

ISA-14
I13
Acknowledgment Requested
Required
Identifier (ID)
Min 1Max 1

Code sent by the sender to request an interchange acknowledgment (TA1)

0
No Acknowledgment Requested
1
Interchange Acknowledgment Requested
ISA-15
I14
Usage Indicator
Required
Identifier (ID)
Min 1Max 1

Code to indicate whether data enclosed by this interchange envelope is test, production or information

I
Information
P
Production Data
T
Test Data
ISA-16
I15
Component Element Separator
Required
String (AN)
Min 1Max 1

Type is not applicable; the component element separator is a delimiter and not a data element; this field provides the delimiter used to separate component data elements within a composite data structure; this value must be different than the data element separator and the segment terminator

>
Component Element Separator

Functional Group Header

RequiredMax use 1

To indicate the beginning of a functional group and to provide control information

Example
GS-01
479
Functional Identifier Code
Required
Identifier (ID)

Code identifying a group of application related transaction sets

IN
Invoice Information (810,819)
GS-02
142
Application Sender's Code
Required
String (AN)
Min 2Max 15

Code identifying party sending transmission; codes agreed to by trading partners

GS-03
124
Application Receiver's Code
Required
String (AN)
Min 2Max 15

Code identifying party receiving transmission. Codes agreed to by trading partners

Required
Date (DT)
CCYYMMDD format

Date expressed as CCYYMMDD

Required
Time (TM)
HHMM, HHMMSS, HHMMSSD, or HHMMSSDD format

Time expressed in 24-hour clock time as follows: HHMM, or HHMMSS, or HHMMSSD, or HHMMSSDD, where H = hours (00-23), M = minutes (00-59), S = integer seconds (00-59) and DD = decimal seconds; decimal seconds are expressed as follows: D = tenths (0-9) and DD = hundredths (00-99)

GS-06
28
Group Control Number
Required
Numeric (N0)
Min 1Max 9

Assigned number originated and maintained by the sender

GS-07
455
Responsible Agency Code
Required
Identifier (ID)
Min 1Max 2

Code used in conjunction with Data Element 480 to identify the issuer of the standard

T
Transportation Data Coordinating Committee (TDCC)
X
Accredited Standards Committee X12
GS-08
480
Version / Release / Industry Identifier Code
Required
String (AN)

Code indicating the version, release, subrelease, and industry identifier of the EDI standard being used, including the GS and GE segments; if code in DE455 in GS segment is X, then in DE 480 positions 1-3 are the version number; positions 4-6 are the release and subrelease, level of the version; and positions 7-12 are the industry or trade association identifiers (optionally assigned by user); if code in DE455 in GS segment is T, then other formats are allowed

004010
Draft Standards Approved for Publication by ASC X12 Procedures Review Board through October 1997

Heading

ST
010
Heading > ST

Transaction Set Header

RequiredMax use 1

To indicate the start of a transaction set and to assign a control number

Example
ST-01
143
Transaction Set Identifier Code
Required
Identifier (ID)

Code uniquely identifying a Transaction Set

  • The transaction set identifier (ST01) used by the translation routines of the interchange partners to select the appropriate transaction set definition (e.g., 810 selects the Invoice Transaction Set).
810
Invoice
ST-02
329
Transaction Set Control Number
Required
Numeric (N)
Min 4Max 9

Identifying control number that must be unique within the transaction set functional group assigned by the originator for a transaction set

BIG
020
Heading > BIG

Beginning Segment for Invoice

RequiredMax use 1

To indicate the beginning of an invoice transaction set and transmit identifying numbers and dates

Usage notes

Sample Data:
BIG2004103090109220041022U2093709
BIG20041030901092**U2093709

Example
Required
Date (DT)
CCYYMMDD format

Date expressed as CCYYMMDD

  • BIG01 is the invoice issue date.
Usage notes

Date when the invoice information was generated in the origins Accounting system. The invoice date should be on or after the PO# creation date.

BIG-02
76
Invoice Number
Required
String (AN)
Min 1Max 22

Identifying number assigned by issuer

Usage notes

Unique number relating to the charges defined in this document.

Optional
Date (DT)
CCYYMMDD format

Date expressed as CCYYMMDD

  • BIG03 is the date assigned by the purchaser to purchase order.
Usage notes

Date of the PO creation per Amazon 850 message.

BIG-04
324
Purchase Order Number
Required
String (AN)
Min 1Max 22

Identifying number for Purchase Order assigned by the orderer/purchaser

Usage notes

A valid Amazon purchase order number related to this invoice.

Formatting Notes: Annnnnnn

CUR
040
Heading > CUR

Currency

RequiredMax use 1

To specify the currency (dollars, pounds, francs, etc.) used in a transaction

Usage notes

Example:
CURBTUSD
CURBTCAD
CURBTEUR
CURBTJPY
CURBTGBP

Example
CUR-01
98
Entity Identifier Code
Required
Identifier (ID)

Code identifying an organizational entity, a physical location, property or an individual

BT
Bill-to-Party
CUR-02
100
Currency Code
Required
Identifier (ID)

Code (Standard ISO) for country in whose currency the charges are specified

CAD
Canadian Dollar
EUR
Euro
GBP
Pound Sterling
JPY
Yen
USD
US Dollar
N1 Bill To
RequiredMax 1
Usage notes

The N1*BT loop with bill-to name and address is required for Canada, Mexico, Australia, and Singapore vendors.

Sample Data:

US example (use address of ship-to FC):
N1BTAmazon.com
N31600 East Newlands Drive
N4
FernleyNV89408*US

Canada:
N1BTAmazon.com.ca Inc.
N340 King Street West 47th Floor
N4
TorontoONM5H 3Y2*CA

Japan:
N1BTAmazon Japan G.K.
N3Arco Tower Annex, 1-8-1 Shimomeguro, Meguro-ku
N4
TOKYO*153-0064JP

Domestic Mexico:
N1BTServicios Comerciales Amazon México S. de R.L. de C.V.TAACA140623TXA
N3Blvd. Manuel Ávila Camacho 36 P 10 y 12Lomas De Chapultepec I Secc
N4Miguel HidalgoDF11000MX

Import Mexico:
N1BTImportadora Amazon MexicoTAACA140623TXA
N3Blvd. Manuel Ávila Camacho 36 P 10 y 12Lomas De Chapultepec I Secc
N4Miguel HidalgoDF11000MX

Australia:
N1BTAmazon Commercial Services Pty LtdTA30616935623
N32 Park Street Level 37
N4
Sydney*2000AU

Singapore:
N1BTAmazon Asia-Pacific Holdings Private(PTE) LimitedTA201411358G
N31 Robinson Rd AIA Tower #17-00
N4
Singapore*048542SG

Comments:
For US PO's, use the address of the ship-to Amazon FC for the bill-to address. For other marketplaces, please use the correct bill-to addresses as provided above.

Variants (all may be used)
Remit ToShip To
N1
070
Heading > Bill To > N1

Name

RequiredMax use 1

To identify a party by type of organization, name, and code

Usage notes

Sample Data:
N1BTAmazon.com
N1BTAmazon.com.ca Inc.
N1BTAmazon Japan G.K.
N1BTServicios Comerciales Amazon México S. de R.L. de C.V.TAACA140623TXA
N1BTImportadora Amazon MexicoTAACA140623TXA
N1BTAmazon Commercial Services Pty LtdTA30616935623
N1BTAmazon Asia-Pacific Holdings Private(PTE) LimitedTA201411358G

Example
If either Identification Code Qualifier (N1-03) or Identification Code (N1-04) is present, then the other is required
N1-01
98
Entity Identifier Code
Required
Identifier (ID)

Code identifying an organizational entity, a physical location, property or an individual

BT
Bill-to-Party
Required
String (AN)
Min 1Max 60

Free-form name

Usage notes

This field will be the name of the Bill-to party.

N1-03
66
Identification Code Qualifier
Optional
Identifier (ID)

Code designating the system/method of code structure used for Identification Code (67)

Usage notes

This field is required for Mexico, Australia, and Singapore vendors.

TA
Taxpayer ID Number
N1-04
67
Identification Code
Optional
String (AN)
Min 2Max 80

Code identifying a party or other code

  • This segment, used alone, provides the most efficient method of providing organizational identification. To obtain this efficiency the "ID Code" (N104) must provide a key to the table maintained by the transaction processing party.
Usage notes

The Amazon tax ID is required for Mexico, Australia, and Singapore vendors.

Mexico: ACA140623TXA
Australia: 30616935623
Singapore: 201411358G

N2
080
Heading > Bill To > N2

Additional Name Information

OptionalMax use 2

To specify additional names or those longer than 35 characters in length

Usage notes

If applicable, this is additional name information for the bill-to address.

Example
Required
String (AN)
Min 1Max 60

Free-form name

Optional
String (AN)
Min 1Max 60

Free-form name

N3
090
Heading > Bill To > N3

Address Information

RequiredMax use 2

To specify the location of the named party

Usage notes

This segment is required for Canada, Mexico, Australia, and Singapore vendors.

Sample Data:

Canada:
N3*40 King Street West 47th Floor

Japan:
N3*ARCO TOWER ANNEX,1-8-1 Shimomeguro, Meguro-ku

Mexico:
N3Blvd. Manuel Ávila Camacho 36 P 10 y 12Lomas de Chapultepec I Secc

Australia:
2 Park Street Level 37

Singapore:
1 Robinson Rd AIA Tower #17-00

Example
N3-01
166
Address Information
Required
String (AN)
Min 1Max 55

Address information

N3-02
166
Address Information
Optional
String (AN)
Min 1Max 55

Address information

N4
100
Heading > Bill To > N4

Geographic Location

RequiredMax use 1

To specify the geographic place of the named party

Usage notes

This segment is required for Canada, Mexico, Australia, and Singapore vendors.

Sample Data:

N4FernleyNV89408US
N4TorontoONM5H 3Y2CA
N4TOKYO**153-0064JP
N4Miguel HidalgoDF11000MX
N4Sydney**2000AU
N4Singapore**048542SG

Example
N4-01
19
City Name
Required
String (AN)
Min 2Max 30

Free-form text for city name

  • A combination of either N401 through N404, or N405 and N406 may be adequate to specify a location.
N4-02
156
State or Province Code
Required
Identifier (ID)
Min 2Max 2

Code (Standard State/Province) as defined by appropriate government agency

  • N402 is required only if city name (N401) is in the U.S. or Canada.
Usage notes

Please note that the bill-to addresses for Japan, Australia, and Singapore do not have a state code. As such, this element can be left empty for those particular marketplaces.

N4-03
116
Postal Code
Required
Identifier (ID)
Min 3Max 15

Code defining international postal zone code excluding punctuation and blanks (zip code for United States)

N4-04
26
Country Code
Required
Identifier (ID)

Code identifying the country

AU
Australia
CA
Canada
DE
Germany
FR
France
GB
United Kingdom of Great Britain and Northern Ireland (the)
JP
Japan
MX
Mexico
SG
Singapore
US
United States of America (the)
N1 Bill To end
N1 Remit To
RequiredMax 1
Usage notes

The remit-to address MUST be the same as the Amazon AP department has on file. Please work with your AR department to verify this is a match. If the remit-to address does not match, the invoice will fail in processing.

Sample Data:
N1RIremit to name
N2additional nameadditional name
N3address
N4
citystatepostal code*countrycode

Variants (all may be used)
Bill ToShip To
N1
070
Heading > Remit To > N1

Name

RequiredMax use 1

To identify a party by type of organization, name, and code

Usage notes

Sample Data:
N1RIName of vendor

Example
N1-01
98
Entity Identifier Code
Required
Identifier (ID)

Code identifying an organizational entity, a physical location, property or an individual

RI
Remit To
Required
String (AN)
Min 1Max 60

Free-form name

Usage notes

This will be the name of the party receiving the payment of this invoice

N2
080
Heading > Remit To > N2

Additional Name Information

OptionalMax use 2

To specify additional names or those longer than 35 characters in length

Example
Required
String (AN)
Min 1Max 60

Free-form name

Optional
String (AN)
Min 1Max 60

Free-form name

N3
090
Heading > Remit To > N3

Address Information

RequiredMax use 2

To specify the location of the named party

Usage notes

Sample Data:
N3PO BOX 10307
N3
3925 NORTH HASTINGS WAY

Example
N3-01
166
Address Information
Required
String (AN)
Min 1Max 55

Address information

N3-02
166
Address Information
Optional
String (AN)
Min 1Max 55

Address information

N4
100
Heading > Remit To > N4

Geographic Location

RequiredMax use 1

To specify the geographic place of the named party

Usage notes

Sample Data:
N4SAN RAFAELCA949120307US
N4TorontoONM1H 2X3CA

Example
N4-01
19
City Name
Required
String (AN)
Min 2Max 30

Free-form text for city name

  • A combination of either N401 through N404, or N405 and N406 may be adequate to specify a location.
N4-02
156
State or Province Code
Required
Identifier (ID)
Min 2Max 2

Code (Standard State/Province) as defined by appropriate government agency

  • N402 is required only if city name (N401) is in the U.S. or Canada.
N4-03
116
Postal Code
Required
Identifier (ID)
Min 3Max 15

Code defining international postal zone code excluding punctuation and blanks (zip code for United States)

Usage notes

External Information: For US this is a good resource:
http://zip4.usps.com/zip4/welcome.jsp

Formatting Notes:
US: nnnnnnnnn
Canada; ana nan
Japan: nnn-nnnn
Great Britain: aan naa
France: nnnnn
Germany: nnnnn

N4-04
26
Country Code
Required
Identifier (ID)

Code identifying the country

AU
Australia
CA
Canada
DE
Germany
FR
France
GB
United Kingdom of Great Britain and Northern Ireland (the)
JP
Japan
MX
Mexico
SG
Singapore
US
United States of America (the)
N1 Remit To end
N1 Ship To
RequiredMax 1
Usage notes

This is the address of the Amazon FC that received the shipment.

Sample Data:
N1STAMAZON.COM
N31600 East Newlands Drive
N4
FernleyNV89408*US

N1STAMAZON.CA
N3500 MCCARTHY DRFAIRVIEW BUSINESS PARK
N4MISSISSAUGAONL5R 3W5CA

N1STNARITA
N32-13-1 Shiohama, Ichikawa-shi
N4
Chiba-KenCB272-0127*JP

Variants (all may be used)
Bill ToRemit To
N1
070
Heading > Ship To > N1

Name

RequiredMax use 1

To identify a party by type of organization, name, and code

Usage notes

Sample Data:
N1STAMAZON.COM
N1STAMAZON.CA
N1STAMAZON JAPAN G.K.

Example
N1-01
98
Entity Identifier Code
Required
Identifier (ID)

Code identifying an organizational entity, a physical location, property or an individual

ST
Ship To
Required
String (AN)
Min 1Max 60

Free-form name

Usage notes

This field will be the name of the party receiving a shipment of product

N2
080
Heading > Ship To > N2

Additional Name Information

OptionalMax use 2

To specify additional names or those longer than 35 characters in length

Example
Required
String (AN)
Min 1Max 60

Free-form name

Optional
String (AN)
Min 1Max 60

Free-form name

N3
090
Heading > Ship To > N3

Address Information

RequiredMax use 2

To specify the location of the named party

Usage notes

Sample Data:
N3COFFEYVILLE INDUSTRIAL PK2654 NO HIGHWAY 169
N3*2-13-1 Shiohama, Ichikawa-shi

Example
N3-01
166
Address Information
Required
String (AN)
Min 1Max 55

Address information

N3-02
166
Address Information
Optional
String (AN)
Min 1Max 55

Address information

N4
100
Heading > Ship To > N4

Geographic Location

RequiredMax use 1

To specify the geographic place of the named party

Usage notes

Sample Data:
N4COFFEYVILLEKS67337US
N4MISSISSAUGAOTL5R 3W5CA
N4Chiba-KenCB272-0127JP

Example
N4-01
19
City Name
Required
String (AN)
Min 2Max 30

Free-form text for city name

  • A combination of either N401 through N404, or N405 and N406 may be adequate to specify a location.
N4-02
156
State or Province Code
Required
Identifier (ID)
Min 2Max 2

Code (Standard State/Province) as defined by appropriate government agency

  • N402 is required only if city name (N401) is in the U.S. or Canada.
N4-03
116
Postal Code
Required
Identifier (ID)
Min 3Max 15

Code defining international postal zone code excluding punctuation and blanks (zip code for United States)

N4-04
26
Country Code
Required
Identifier (ID)

Code identifying the country

AU
Australia
CA
Canada
DE
Germany
FR
France
GB
United Kingdom of Great Britain and Northern Ireland (the)
JP
Japan
MX
Mexico
SG
Singapore
US
United States of America (the)
N1 Ship To end
ITD
130
Heading > ITD

Terms of Sale/Deferred Terms of Sale

RequiredMax use >1

To specify terms of sale

Usage notes

Specific requirements for payment terms will vary according to terms negotiated by an account manager. An Amazon Integration Specialist will work with you to implement applicable terms.

Sample Data:

Basic NET Days ex.30 NET Days
ITD013***2001032330

Basic Net Days/% Discount ex. 2% 10, 60 NET Days
ITD0132200103151020010323*60

End of Month ex. Due 150 days from the end of month
ITD023***20010323150

Fixed Date/Discount: ex. 2% 15TH, 30 NET Days
ITD0332200103231520010323*30

Fixed Date: ex.15TH DUE
ITD0332001032310***15

Proximo / Proxy: ex. 2% 15 PROX 120
ITD0932200103231520010323*120

Example
If Terms Discount Percent (ITD-03) is present, then at least one of Terms Discount Due Date (ITD-04), Terms Discount Days Due (ITD-05) or Day of Month (ITD-13) is required
ITD-01
336
Terms Type Code
Optional
Identifier (ID)

Code identifying type of payment terms

  • If the code in ITD01 is "04", then ITD07 or ITD09 is required and either ITD10 or ITD11 is required; if the code in ITD01 is "05", then ITD06 or ITD07 is required.
01
Basic
02
End of Month (EOM)
03
Fixed Date
09
Proximo
23
Payment Due Upon Receipt of Invoice
41
Letter of Credit
ITD-02
333
Terms Basis Date Code
Optional
Identifier (ID)

Code identifying the beginning of the terms period

3
Invoice Date
ITD-03
338
Terms Discount Percent
Optional
Decimal number (R)
Min 1Max 6

Terms discount percentage, expressed as a percent, available to the purchaser if an invoice is paid on or before the Terms Discount Due Date

Usage notes

This field will contain the discount percent value as a whole number (no decimal point), which is good until the discount due date. Please see examples.

Formatting Notes: nnn

ITD-04
370
Terms Discount Due Date
Optional
Date (DT)
CCYYMMDD format

Date payment is due if discount is to be earned expressed in format CCYYMMDD

Usage notes

Date payment is due if discount is to be earned

ITD-05
351
Terms Discount Days Due
Optional
Numeric (N0)
Min 1Max 3

Number of days in the terms discount period by which payment is due if terms discount is earned

Usage notes

This field will contain the number of calendar days from the Base Date until the discount is no longer valid.

Formatting Notes: nnn

ITD-06
446
Terms Net Due Date
Optional
Date (DT)
CCYYMMDD format

Date when total invoice amount becomes due expressed in format CCYYMMDD

Usage notes

Date when total invoice amount becomes due.

ITD-07
386
Terms Net Days
Optional
Numeric (N0)
Min 1Max 3

Number of days until total invoice amount is due (discount not applicable)

Usage notes

This field will contain the number of calendar days from the Base Date until the total amount on the invoice is due.

ITD-13
765
Day of Month
Optional
Numeric (N0)
Min 1Max 2

The numeric value of the day of the month between 1 and the maximum day of the month being referenced

Usage notes

If terms are a fixed date, this will be the day of each month when the payment is due.

Formatting Notes: nn

Heading end

Detail

IT1 Loop
RequiredMax >1
IT1
010
Detail > IT1 Loop > IT1

Baseline Item Data (Invoice)

RequiredMax use 1

To specify the basic and most frequently used line item data for the invoice and related transactions

Usage notes

Sample Data:
IT10011EA11.96NTUP025091005628POF6580987
IT1
0011EA60.75NTIB0895031892*
PO*F6580987

Example
IT1-01
350
Assigned Identification
Required
String (AN)
Min 1Max 20

Alphanumeric characters assigned for differentiation within a transaction set

  • IT101 is the purchase order line item identification.
Usage notes

This field will be a unique number related to this line item.

Formatting Notes: nnn

IT1-02
358
Quantity Invoiced
Required
Decimal number (R)
Min 1Max 10

Number of units invoiced (supplier units)

Usage notes

This field will be the number of units related to this invoice. Quantity must be greater than zero (0).

IT1-03
355
Unit or Basis for Measurement Code
Required
Identifier (ID)

Code specifying the units in which a value is being expressed, or manner in which a measurement has been taken

Usage notes

The same unit of measurement code provided in the Amazon Purchase Order should be used.

CA
Case
EA
Each
UN
Unit
IT1-04
212
Unit Price
Required
Decimal number (R)
Min 1Max 15

Price per unit of product, service, commodity, etc.

Usage notes

This field will be the cost of the item per unit.

Formatting Notes: nnnnn.nn

IT1-05
639
Basis of Unit Price Code
Required
Identifier (ID)

Code identifying the type of unit price for an item

NT
Net
IT1-06
235
Product/Service ID Qualifier
Required
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

  • IT106 through IT125 provide for ten different product/service IDs for each item. For example: Case, Color, Drawing No., U.P.C. No., ISBN No., Model No., or SKU.
BP
Buyer's Part Number
EN
European Article Number (EAN) (2-5-5-1)
IB
International Standard Book Number (ISBN)
UA
U.P.C./EAN Case Code (2-5-5)
UK
U.P.C./EAN Shipping Container Code (1-2-5-5-1)
UP
U.P.C. Consumer Package Code (1-5-5-1)
VN
Vendor's (Seller's) Item Number
IT1-07
234
Product/Service ID
Required
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

The value in this field must match the item identifier in the corresponding order file.

IT1-08
235
Product/Service ID Qualifier
Optional
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

BP
Buyer's Part Number
VN
Vendor's (Seller's) Item Number
IT1-09
234
Product/Service ID
Required
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

A value in this field is optional and determined by the sender.

Formatting Notes: ASIN:nnnnnnnnnn

IT1-10
235
Product/Service ID Qualifier
Required
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

PO
Purchase Order Number
IT1-11
234
Product/Service ID
Required
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

This field will be the Amazon PO number related to this item.

Formatting Notes: Annnnnnn

TXI
040
Detail > IT1 Loop > TXI

Tax Information

OptionalMax use 10

To specify tax information

Usage notes

Tax is required at both the line item and summary level, based on country requirements. This segment is not required for US vendors.

• If the line item is not taxable, 0% tax lines should be included at both line and summary level.
• If the line item is taxable, the valid tax lines should be included at both line and summary level.

Please note that Québec CA vendors need to provide TXI segments and tax info for both the GST/HST and QST.

Sample Data:
TXIGS18.997
TXI
GS1.7157
TXIGS700.5137*F
TXI
ST14.949.975

Example
TXI-01
963
Tax Type Code
Required
Identifier (ID)

Code specifying the type of tax

Usage notes

"ST" is only used to specify Québec sales tax

GS
Goods and Services Tax
ST
State Sales Tax
VA
Value Added Tax
ZZ
Mutually Defined
TXI-02
782
Monetary Amount
Required
Decimal number (R)
Min 1Max 15

Monetary amount

  • TXI02 is the monetary amount of the tax.
TXI-03
954
Percent
Required
Decimal number (R)
Min 1Max 10

Percentage expressed as a decimal

  • TXI03 is the tax percent expressed as a decimal.
Usage notes

This field will be the tax percentage that will be applied to this line item.

Formatting Notes: nn.nnn

TXI-06
441
Tax Exempt Code
Optional
Identifier (ID)

Code identifying exemption status from sales and use tax

Usage notes

Internal Information: Use this code to identify goods that are subject to customer accounting

External Information: This is only applicable for Singapore. TXI06 will be F when claiming Customer Accounting i.e., when items are mobile phones, memory cards and off-the-shelf/canned software and invoice value of these items is greater than 10K SGD. This value is not to be included when reporting the total tax and total invoice in the summary level

F
Exempt (Goods and Services Tax)
CTP
050
Detail > IT1 Loop > CTP

Pricing Information

OptionalMax use 25

To specify pricing information

Usage notes

The CTP segment is required if price information is supplied in the CTP segment in the 855 for these items.

Sample Data:
CTPSLP19.95DIS*.55
CTPSLP19.95DIS*1

Example
If Price Multiplier Qualifier (CTP-06) is present, then Multiplier (CTP-07) is required
CTP-02
236
Price Identifier Code
Optional
Identifier (ID)

Code identifying pricing specification

LPR
List Price
SLP
Suggested List Price
CTP-03
212
Unit Price
Optional
Decimal number (R)
Min 1Max 15

Price per unit of product, service, commodity, etc.

  • See Figures Appendix for an example detailing the use of CTP03 and CTP04.
  • See Figures Appendix for an example detailing the use of CTP03, CTP04 and CTP07.
Usage notes

This field will be the list/suggested list price for this item per unit.

Formatting Notes: nnnnn.nn

CTP-06
648
Price Multiplier Qualifier
Optional
Identifier (ID)

Code indicating the type of price multiplier

DIS
Discount Multiplier
CTP-07
649
Multiplier
Optional
Decimal number (R)
Min 1Max 10

Value to be used as a multiplier to obtain a new value

  • CTP07 is a multiplier factor to arrive at a final discounted price. A multiplier of .90 would be the factor if a 10% discount is given.
Usage notes

This field will be a decimal that reflects Amazon's discount from the list/suggested list price.

The discount multiplier multiplied by the list price (CTP03) equals the net price (IT104).

If Amazon has a 20% discount, the discount multiplier would be .8.

REF
120
Detail > IT1 Loop > REF

Reference Identification

OptionalMax use >1

To specify identifying information

Usage notes

This is the tracking number provided by your carrier for this item.

Sample Data:
REF2I982103923402394823

Example
REF-01
128
Reference Identification Qualifier
Required
Identifier (ID)

Code qualifying the Reference Identification

2I
Tracking Number
REF-02
127
Reference Identification
Optional
String (AN)
Min 1Max 30

Reference information as defined for a particular Transaction Set or as specified by the Reference Identification Qualifier

IT1 Loop end
Detail end

Summary

TDS
010
Summary > TDS

Total Monetary Value Summary

RequiredMax use 1

To specify the total invoice discounts and amounts

Usage notes

Sample Data:
TDS*2634

Example
TDS-01
610
Amount
Required
Numeric (N2)
Min 1Max 15

Monetary amount

  • TDS01 is the total amount of invoice (including charges, less allowances) before terms discount (if discount is applicable).
Usage notes

This field will be the total invoice amount including and applicable charges, allowances and tax.

TXI
020
Summary > TXI

Tax Information

OptionalMax use 10

To specify tax information

Usage notes

This segment provides the total tax for the invoice and includes the vendor's tax identification number as required by country.

** Do not use for US marketplace. Any US invoice received with the TXI segment will fail to be processed.**

For US states that charge an enviromental impact tax or similiar, please use the SAC segment instead.

The vendor's assigned tax ID is required in the TXI09 for Mexico, Canada, Singapore, and Australia vendors (GST ID/ HST ID/ QST ID/ ABN).

For Québec CA vendors, please note that two TXI summary segments are needed: One with GST/HST ID and one with the QST ID.

Sample Data:
Québec CA:
TXIGS1.235*****24.62VENDORTAXID
TXIST79.429.975*****796.19VENDORTAXID

Example
TXI-01
963
Tax Type Code
Required
Identifier (ID)

Code specifying the type of tax

Usage notes

"ST" is only used to specify Québec sales tax.

GS
Goods and Services Tax
ST
State Sales Tax
VA
Value Added Tax
ZZ
Mutually Defined
TXI-02
782
Monetary Amount
Required
Decimal number (R)
Min 1Max 15

Monetary amount

  • TXI02 is the monetary amount of the tax.
Usage notes

This field will be the total tax amount applied to the invoice for the rate specified in the TXI03.

Formatting Notes: nnnnn.nn

TXI-03
954
Percent
Required
Decimal number (R)
Min 1Max 10

Percentage expressed as a decimal

  • TXI03 is the tax percent expressed as a decimal.
Usage notes

This field will be a tax rate applied to the invoice.

Formatting Notes: nn.nnn

TXI-06
441
Tax Exempt Code
Optional
Identifier (ID)

Code identifying exemption status from sales and use tax

Usage notes

Data in this field is required if you are shipping product over a border into another country and you are tax exempt in that country.

F
Exempt (Goods and Services Tax)
T
Totally Exempt
TXI-08
828
Dollar Basis For Percent
Required
Decimal number (R)
Min 1Max 9

Dollar basis to be used in the percent calculation of the allowance, charge or tax

Usage notes

This field will contain the invoice amount that is taxable at the rate specified in the TXI03.

TXI-09
325
Tax Identification Number
Required
String (AN)
Min 1Max 20

Number assigned to a purchaser (buyer, orderer) by a taxing jurisdiction (state, county, etc.); often called a tax exemption number or certificate number

Usage notes

This element contains the vendor's tax ID number.
The burden of providing a tax ID is on the billing party.
This element is required for Mexico, Canada, Singapore, and Australia vendors (GST ID/ HST ID/ QST ID/ ABN).

SAC Loop
OptionalMax >1
Usage notes

The SAC loop should ONLY be sent when an actual charge is applied to this invoice's total.

SAC
040
Summary > SAC Loop > SAC

Service, Promotion, Allowance, or Charge Information

RequiredMax use 1

To request or identify a service, promotion, allowance, or charge; to specify the amount or percentage for the service, promotion, allowance, or charge

Usage notes

Sample Data:
SACCD240278*******Freight

Example
SAC-01
248
Allowance or Charge Indicator
Required
Identifier (ID)

Code which indicates an allowance or charge for the service specified

  • If SAC01 is "A" or "C", then at least one of SAC05, SAC07, or SAC08 is required.
A
Allowance
C
Charge
SAC-02
1300
Service, Promotion, Allowance, or Charge Code
Required
Identifier (ID)

Code identifying the service, promotion, allowance, or charge

B720
Cooperative Advertising/Merchandising Allowance (Performance)
C000
Defective Allowance
C260
Discount - Incentive
C310
Discount
C530
Duty Charge
C680
Environmental Protection Service
D240
Freight
D500
Handling
D920
Insurance Fee
D930
Insurance Placement Cost Charge
F800
Promotional Allowance
G730
Service Charge (with Cash Discount)
G970
Small Order Charge
H000
Special Allowance
H020
Special Circus Trains
I410
Unsaleable Merchandise Allowance
SAC-05
610
Amount
Required
Numeric (N2)
Min 1Max 15

Monetary amount

  • SAC05 is the total amount for the service, promotion, allowance, or charge.
  • If SAC05 is present with SAC07 or SAC08, then SAC05 takes precedence.
Usage notes

This field will be the amount related to this charge.

SAC-15
352
Description
Optional
String (AN)
Min 1Max 80

A free-form description to clarify the related data elements and their content

Usage notes

This field will be a free-formed description of this charge.

TXI
050
Summary > SAC Loop > TXI

Tax Information

OptionalMax use 10

To specify tax information

Usage notes

This segment is only required if the preceding SAC segment is taxable.

Sample Data:
TXIGS18.99*7

Example
TXI-01
963
Tax Type Code
Required
Identifier (ID)

Code specifying the type of tax

GS
Goods and Services Tax
VA
Value Added Tax
ZZ
Mutually Defined
TXI-02
782
Monetary Amount
Required
Decimal number (R)
Min 1Max 15

Monetary amount

  • TXI02 is the monetary amount of the tax.
TXI-03
954
Percent
Required
Decimal number (R)
Min 1Max 10

Percentage expressed as a decimal

  • TXI03 is the tax percent expressed as a decimal.
Usage notes

This field will be the tax percentage that will be applied to this charge.

Formatting Notes: nn.nnn

SAC Loop end
CTT
070
Summary > CTT

Transaction Totals

RequiredMax use 1

To transmit a hash total for a specific element in the transaction set

  • Number of line items (CTT01) is the accumulation of the number of IT1 segments.
    If used, hash total (CTT02) is the sum of the value of quantities invoiced (IT102) for each IT1 segment.
Usage notes

Number of line items (CTT01) is the accumulation of the number of IT1 segments.
Hash total (CTT02) is the sum of the value of quantities invoiced (IT102) for each IT1 segment.

Sample Data:
CTT1010
CTT36

Example
CTT-01
354
Number of Line Items
Required
Numeric (N0)
Min 1Max 6

Total number of line items in the transaction set

Usage notes

This field will contain the logical count of IT1 segments in this 810.

CTT-02
347
Hash Total
Required
Decimal number (R)
Min 1Max 10

Sum of values of the specified data element. All values in the data element will be summed without regard to decimal points (explicit or implicit) or signs. Truncation will occur on the left most digits if the sum is greater than the maximum size of the hash total of the data element.

## Example:
-.0018 First occurrence of value being hashed.
.18 Second occurrence of value being hashed.
1.8 Third occurrence of value being hashed.
18.01 Fourth occurrence of value being hashed.

1855 Hash total prior to truncation.
855 Hash total after truncation to three-digit field.

Usage notes

This field will be the total number of items being invoices (sum of all IT102).

SE
080
Summary > SE

Transaction Set Trailer

RequiredMax use 1

To indicate the end of the transaction set and provide the count of the transmitted segments (including the beginning (ST) and ending (SE) segments)

Example
SE-01
96
Number of Included Segments
Required
Numeric (N0)
Min 1Max 10

Total number of segments included in a transaction set including ST and SE segments

SE-02
329
Transaction Set Control Number
Required
Numeric (N)
Min 4Max 9

Identifying control number that must be unique within the transaction set functional group assigned by the originator for a transaction set

Summary end

Functional Group Trailer

RequiredMax use 1

To indicate the end of a functional group and to provide control information

Example
GE-01
97
Number of Transaction Sets Included
Required
Numeric (N0)
Min 1Max 6

Total number of transaction sets included in the functional group or interchange (transmission) group terminated by the trailer containing this data element

GE-02
28
Group Control Number
Required
Numeric (N0)
Min 1Max 9

Assigned number originated and maintained by the sender

Interchange Control Trailer

RequiredMax use 1

To define the end of an interchange of zero or more functional groups and interchange-related control segments

Example
IEA-01
I16
Number of Included Functional Groups
Required
Numeric (N0)
Min 1Max 5

A count of the number of functional groups included in an interchange

IEA-02
I12
Interchange Control Number
Required
Numeric (N0)
Min 9Max 9

A control number assigned by the interchange sender

EDI Samples

Example with Tax

ISA*00* *00* *ZZ*VENDOR *ZZ*AMAZON *090322*1001*U*00400*000001631*0*T*>~
GS*IN*VENDOR*AMAZON*20090322*1001*480*X*004010~
ST*810*0001~
BIG*20090320*5002841638*20090311*Q6515853~
CUR*BT*CAD~
N1*RI*VENDORNAME~
N3*PO BOX 1234~
N4*TORONTO*ON*M5W 5M5*CA~
N1*ST*AMAZON CANADA~
N3*500 MCCARTHY DR*FAIRVIEW BUSINESS PARK~
N4*MISSISSAUGA*ON*L5R 3W5*CA~
N1*BT*AMAZON.CA~
N3*40 King Street West 47th Floor~
N4*Toronto*ON*M5H 3Y2*CA~
ITD*01*3*****60~
IT1*1*4*EA*12.6*NT*UP*786936788990*VN*1012380100000*PO*Q6515853~
TXI*GS*2.52*5~
IT1*2*30*EA*29.5*NT*UP*786936785951*VN*1000570100000*PO*Q6515853~
TXI*GS*44.25*5~
IT1*3*90*EA*22.5*NT*UP*786936735321*VN*0543900100000*PO*Q6515853~
TXI*GS*101.25*5~
IT1*4*5*EA*29.5*NT*UP*786936785968*VN*1000570200000*PO*Q6515853~
TXI*GS*7.38*5~
TDS*326330~
TXI*GS*155.4*5*****3108*954090650~
CTT*4*129~
SE*25*0001~
GE*1*480~
IEA*1*000001631~

Example without Tax

ISA*00* *00* *ZZ*VENDOR *ZZ*AMAZON *090323*0112*U*00400*810200249*0*T*>~
GS*IN*VENDOR*AMAZON*20090323*0112*810200249*X*004010~
ST*810*0001~
BIG*20090322*I5599913*20090316*S8672793~
CUR*BT*USD~
N1*RI*VENDORNAME~
N3*PO BOX 1234~
N4*SAN RAFAEL*CA*60693*US~
N1*ST*AMAZON.COM~
N3*500 MCCARTHY DR*FAIRVIEW BUSINESS PARK~
N4*LEWISBERRY*PA*17339*US~
N1*BT*AMAZON.COM~
N3*500 MCCARTHY DR*FAIRVIEW BUSINESS PARK~
N4*LEWISBERRY*PA*17339*US~
ITD*01*3*2**30**31~
IT1*1*3*EA*140*NT*UP*038456895995*VN*040YP0U*PO*S8672793~
IT1*2*3*EA*125*NT*UP*038567499788*VN*0264CBS*PO*S8672793~
IT1*3*3*EA*130*NT*UP*038845668944*VN*040YP0K*PO*S8672793~
IT1*4*3*EA*182.5*NT*UP*13256548489*VN*5297YPS*PO*S8672793~
TDS*173250~
CTT*4*12~
SE*20*0001~
GE*1*810200249~
IEA*1*810200249~

Stedi is a registered trademark of Stedi, Inc. All names, logos, and brands of third parties listed on this page are trademarks of their respective owners (including “X12”, which is a trademark of X12 Incorporated). Stedi, Inc. and its products and services are not endorsed by, sponsored by, or affiliated with these third parties. Use of these names, logos, and brands is for identification purposes only, and does not imply any such endorsement, sponsorship, or affiliation.