DSCO
/
Drop Ship Invoice v5010
  • Specification
  • EDI Inspector
Import guide into your account
Stedi maintains this guide based on public documentation from DSCO. Contact DSCO for official EDI specifications. To report any errors in this guide, please contact us.
Go to Stedi Network
DSCO logo

X12 810 Drop Ship Invoice v5010

X12 Release 5010

This X12 Transaction Set 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
  • ^ Repetition
EDI sample
  • Sample
View the latest version of this implementation guide as an interactive webpage
https://www.stedi.com/app/guides/view/dsco/drop-ship-invoice-v5010/01HBGR6BPBY3JBC4FA74WT9817
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
0100
Transaction Set Header
Max use 1
Required
BIG
0200
Beginning Segment for Invoice
Max use 1
Required
CUR
0400
Currency
Max use 1
Optional
REF
0500
Ship Notice/Manifest Number
Max use 1
Optional
REF
0500
Bill of Lading Number or Carrier's Reference Number (PRO/Invoice)
Max use 1
Optional
REF
0500
Buyer Identification
Max use 1
Optional
REF
0500
Customer Order Number
Max use 12
Optional
REF
0500
Internal Order Number
Max use 1
Optional
REF
0500
Internal Vendor Number
Max use 1
Optional
REF
0500
Mutually Defined
Max use 1
Optional
REF
0500
Seller's Invoice Number
Max use 1
Optional
REF
0500
Special Charge or Allowance Code
Max use 1
Optional
REF
0500
Vendor ID Number
Max use 1
Optional
Buying Party (Purchaser)
ITD
1300
Terms of Sale/Deferred Terms of Sale
Max use 1
Optional
DTM
1400
Shipped
Max use 10
Optional
PID
1600
Product/Item Description
Max use 200
Optional
detail
IT1 Loop
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 identifying 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 identifying 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

Code indicating 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

Code indicating 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
I65
Repetition Separator
Required
String (AN)
Min 1Max 1

Type is not applicable; the repetition separator is a delimiter and not a data element; this field provides the delimiter used to separate repeated occurrences of a simple data element or a composite data structure; this value must be different than the data element separator, component element separator, and the segment terminator

^
Repetition Separator
ISA-12
I11
Interchange Control Version Number
Required
Identifier (ID)

Code specifying the version number of the interchange control segments

00501
Standards Approved for Publication by ASC X12 Procedures Review Board through October 2003
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 indicating sender's request for an interchange acknowledgment

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

Code indicating 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)
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

GS-04
373
Date
Required
Date (DT)
CCYYMMDD format

Date expressed as CCYYMMDD where CC represents the first two digits of the calendar year

GS-05
337
Time
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 identifying the issuer of the standard; this code is used in conjunction with Data Element 480

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

005010
Standards Approved for Publication by ASC X12 Procedures Review Board through October 2003

Heading

ST
0100
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) is 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
0200
Heading > BIG

Beginning Segment for Invoice

RequiredMax use 1

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

Example
BIG-01
373
Date
Required
Date (DT)
CCYYMMDD format

Date expressed as CCYYMMDD where CC represents the first two digits of the calendar year

  • BIG01 is the invoice issue date.
Usage notes

Date invoice was generated.

Future dates are not valid. Should be the same as the shipment date.

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

Identifying number assigned by issuer

Usage notes

Assigned by sender.

BIG-03
373
Date
Optional
Date (DT)
CCYYMMDD format

Date expressed as CCYYMMDD where CC represents the first two digits of the calendar year

  • BIG03 is the date assigned by the purchaser to purchase order.
BIG-04
324
Purchase Order Number
Required
String (AN)
Min 1Max 22

Identifying number for Purchase Order assigned by the orderer/purchaser

Usage notes

PO Number

CUR
0400
Heading > CUR

Currency

OptionalMax use 1

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

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

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

BY
Buying Party (Purchaser)
CUR-02
100
Currency Code
Required
Identifier (ID)

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

USD
US Dollar
REF
0500
Heading > REF

Ship Notice/Manifest Number

OptionalMax use 1

To specify identifying information

Example
Variants (all may be used)
REFBill of Lading Number or Carrier's Reference Number (PRO/Invoice)REFBuyer IdentificationREFCustomer Order NumberREFInternal Order NumberREFInternal Vendor NumberREFMutually DefinedREFSeller's Invoice NumberREFSpecial Charge or Allowance CodeREFVendor ID Number
At least one of Reference Identification (REF-02) or Description (REF-03) is required
REF-01
128
Reference Identification Qualifier
Required
Identifier (ID)

Code qualifying the Reference Identification

MA
Ship Notice/Manifest Number
REF-02
127
Reference Identification
Optional
String (AN)
Min 1Max 50

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

Usage notes

The Ship Carrier Manifest ID - Used with LTL shipments.

REF-03
352
Description
Optional
String (AN)

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

ship_carrier_manifest_id
Ship Carrier Manifest ID

(Optional)

The Ship Carrier Manifest ID - Used with LTL shipments.

REF
0500
Heading > REF

Bill of Lading Number or Carrier's Reference Number (PRO/Invoice)

OptionalMax use 1

To specify identifying information

Usage notes

See trading partner specific guides

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

Code qualifying the Reference Identification

BM
Bill of Lading Number
CN
Carrier's Reference Number (PRO/Invoice)
REF-02
127
Reference Identification
Optional
String (AN)
Min 1Max 50

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

Usage notes

Ship Tracking Number

REF
0500
Heading > REF

Buyer Identification

OptionalMax use 1

To specify identifying information

Example
At least one of Reference Identification (REF-02) or Description (REF-03) is required
REF-01
128
Reference Identification Qualifier
Required
Identifier (ID)

Code qualifying the Reference Identification

YD
Buyer Identification
REF-02
127
Reference Identification
Optional
String (AN)
Min 1Max 50

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

Usage notes

Account ID assigned by the supplier for the retailer that sent the order.

REF-03
352
Description
Optional
String (AN)

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

invoice_buyer_id
Invoice Buyer ID

Optional

REF
0500
Heading > REF

Customer Order Number

OptionalMax use 12

To specify identifying information

Example
At least one of Reference Identification (REF-02) or Description (REF-03) is required
REF-01
128
Reference Identification Qualifier
Required
Identifier (ID)

Code qualifying the Reference Identification

CO
Customer Order Number
REF-02
127
Reference Identification
Optional
String (AN)
Min 1Max 50

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

Usage notes

Account ID assigned by the retailer for the supplier in which the order was sent to.

REF-03
352
Description
Optional
String (AN)

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

invoice_seller_id
Invoice Seller ID

Optional

REF
0500
Heading > REF

Internal Order Number

OptionalMax use 1

To specify identifying information

Example
At least one of Reference Identification (REF-02) or Description (REF-03) is required
REF-01
128
Reference Identification Qualifier
Required
Identifier (ID)

Code qualifying the Reference Identification

IL
Internal Order Number
REF-02
127
Reference Identification
Optional
String (AN)
Min 1Max 50

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

Usage notes

Unique order identifier as provided by the supplier.

REF-03
352
Description
Optional
String (AN)

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

supplier_order_number
Supplier Order Number

Optional

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

Code qualifying the Reference Identification

IA
Internal Vendor Number
REF-02
127
Reference Identification
Optional
String (AN)
Min 1Max 50

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

Usage notes

Trading Partner ID is used as the first priority, otherwise the Dsco Supplier ID will be utilized.

REF
0500
Heading > REF

Mutually Defined

OptionalMax use >1

To specify identifying information

Example
At least one of Reference Identification (REF-02) or Description (REF-03) is required
REF-01
128
Reference Identification Qualifier
Required
Identifier (ID)

Code qualifying the Reference Identification

ZZ
Mutually Defined
REF-02
127
Reference Identification
Optional
String (AN)
Min 1Max 50

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

REF-03
352
Description
Optional
String (AN)

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

external_batch_id
External Batch ID

Optional

Identifier of the batch that included this update. Usually the group number of an EDI transaction.

invoice_charge_title_1
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_10
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_11
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_12
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_13
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_14
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_15
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_16
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_17
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_18
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_19
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_2
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_20
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_21
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_22
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_23
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_24
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_25
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_26
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_27
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_28
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_29
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_3
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_30
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_31
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_32
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_33
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_34
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_35
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_36
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_37
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_38
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_39
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_4
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_40
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_41
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_42
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_43
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_44
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_45
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_46
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_47
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_48
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_49
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_5
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_50
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_51
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_52
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_53
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_54
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_55
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_56
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_57
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_58
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_59
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_6
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_60
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_61
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_62
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_63
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_64
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_65
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_66
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_67
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_68
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_69
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_7
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_70
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_71
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_72
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_73
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_74
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_75
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_76
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_77
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_78
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_79
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_8
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_80
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_81
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_82
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_83
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_84
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_85
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_86
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_87
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_88
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_89
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_9
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_90
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_91
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_92
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_93
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_94
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_95
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_96
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_97
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_98
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_charge_title_99
Invoice Charge Title

Optional

Provide a short explanation of any extra charges that cannot be specified within other fields. This is an invoice level charge.

invoice_line_items_subtotal
Invoice Line-items Subtotal

Optional

The sum of all line_item_subtotal values.

Format: 999.99 (The decimal place must be included)

invoice_subtotal_excluding_line_items
Invoice Subtotal Excluding Line Items

Optional

The sum of invoice_handling_amount, invoice_freight_amount and invoice_sales_tax_amount.

Format: 999.99 (The decimal place must be included)

ship_carrier
Ship Carrier

Conditional

The carrier that is shipping the package.

See trading partner specific guides

ship_carrier_manifest_id
Ship Carrier Manifest ID

Optional

The Ship Carrier Manifest ID - Used with LTL shipments.

ship_method
Ship Method

Conditional

The shipment method that the package was shipped.

See trading partner specific guides

ship_sscc_barcode
Ship SSCC-Barcode

Conditional

The SSCC-Barcode generated for the ship-to store label.

See trading partner specific guides

ship_to_store_number
Ship-To Store Number

(Optional)

Store number to which the order was shipped.

ship_transportation_method_code
Ship Transportation Method Code

Optional

The transportation method code assigned by the carrier for the shipped package. Possible values include: 'A' for Air, 'J' for Motor, 'R' for Rail, 'S' for Ocean/Ship.

ship_unit_of_measurement_code
Ship Unit Of Measurement Code

Optional

The unit of measurement code. Typically 'EA' for 'Each'. 'PR' for 'Pair' is also acceptable.

shipping_service_level_code
Shipping Service Level Code

Conditional

Used in conjunction with ship_carrier and ship_method, this allows the retailer to pass their own code, or the code that the supplier is expecting, using a pre-defined code that is agreed to between the Supplier and Retailer. Available service codes can be found in Appendix B at the end of this document.

See trading partner specific guides

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

Code qualifying the Reference Identification

IV
Seller's Invoice Number
REF-02
127
Reference Identification
Optional
String (AN)
Min 1Max 50

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

Usage notes

Vendor's Packing Slip Number, Picking Ticket Number or Control Number.

REF
0500
Heading > REF

Special Charge or Allowance Code

OptionalMax use 1

To specify identifying information

Example
At least one of Reference Identification (REF-02) or Description (REF-03) is required
REF-01
128
Reference Identification Qualifier
Required
Identifier (ID)

Code qualifying the Reference Identification

Usage notes

The amount being charged for invoice_charge_title_x.

Format: 999.99 (The decimal place must be included)

22
Special Charge or Allowance Code
REF-02
127
Reference Identification
Optional
String (AN)
Min 1Max 50

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

REF-03
352
Description
Optional
String (AN)

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

Usage notes

All codes optional.

invoice_charge_amount_1
Invoice Charge Amount
invoice_charge_amount_10
Invoice Charge Amount
invoice_charge_amount_11
Invoice Charge Amount
invoice_charge_amount_12
Invoice Charge Amount
invoice_charge_amount_13
Invoice Charge Amount
invoice_charge_amount_14
Invoice Charge Amount
invoice_charge_amount_15
Invoice Charge Amount
invoice_charge_amount_16
Invoice Charge Amount
invoice_charge_amount_17
Invoice Charge Amount
invoice_charge_amount_18
Invoice Charge Amount
invoice_charge_amount_19
Invoice Charge Amount
invoice_charge_amount_2
Invoice Charge Amount
invoice_charge_amount_20
Invoice Charge Amount
invoice_charge_amount_21
Invoice Charge Amount
invoice_charge_amount_22
Invoice Charge Amount
invoice_charge_amount_23
Invoice Charge Amount
invoice_charge_amount_24
Invoice Charge Amount
invoice_charge_amount_25
Invoice Charge Amount
invoice_charge_amount_26
Invoice Charge Amount
invoice_charge_amount_27
Invoice Charge Amount
invoice_charge_amount_28
Invoice Charge Amount
invoice_charge_amount_29
Invoice Charge Amount
invoice_charge_amount_3
Invoice Charge Amount
invoice_charge_amount_30
Invoice Charge Amount
invoice_charge_amount_31
Invoice Charge Amount
invoice_charge_amount_32
Invoice Charge Amount
invoice_charge_amount_33
Invoice Charge Amount
invoice_charge_amount_34
Invoice Charge Amount
invoice_charge_amount_35
Invoice Charge Amount
invoice_charge_amount_36
Invoice Charge Amount
invoice_charge_amount_37
Invoice Charge Amount
invoice_charge_amount_38
Invoice Charge Amount
invoice_charge_amount_39
Invoice Charge Amount
invoice_charge_amount_4
Invoice Charge Amount
invoice_charge_amount_40
Invoice Charge Amount
invoice_charge_amount_41
Invoice Charge Amount
invoice_charge_amount_42
Invoice Charge Amount
invoice_charge_amount_43
Invoice Charge Amount
invoice_charge_amount_44
Invoice Charge Amount
invoice_charge_amount_45
Invoice Charge Amount
invoice_charge_amount_46
Invoice Charge Amount
invoice_charge_amount_47
Invoice Charge Amount
invoice_charge_amount_48
Invoice Charge Amount
invoice_charge_amount_49
Invoice Charge Amount
invoice_charge_amount_5
Invoice Charge Amount
invoice_charge_amount_50
Invoice Charge Amount
invoice_charge_amount_51
Invoice Charge Amount
invoice_charge_amount_52
Invoice Charge Amount
invoice_charge_amount_53
Invoice Charge Amount
invoice_charge_amount_54
Invoice Charge Amount
invoice_charge_amount_55
Invoice Charge Amount
invoice_charge_amount_56
Invoice Charge Amount
invoice_charge_amount_57
Invoice Charge Amount
invoice_charge_amount_58
Invoice Charge Amount
invoice_charge_amount_59
Invoice Charge Amount
invoice_charge_amount_6
Invoice Charge Amount
invoice_charge_amount_60
Invoice Charge Amount
invoice_charge_amount_61
Invoice Charge Amount
invoice_charge_amount_62
Invoice Charge Amount
invoice_charge_amount_63
Invoice Charge Amount
invoice_charge_amount_64
Invoice Charge Amount
invoice_charge_amount_65
Invoice Charge Amount
invoice_charge_amount_66
Invoice Charge Amount
invoice_charge_amount_67
Invoice Charge Amount
invoice_charge_amount_68
Invoice Charge Amount
invoice_charge_amount_69
Invoice Charge Amount
invoice_charge_amount_7
Invoice Charge Amount
invoice_charge_amount_70
Invoice Charge Amount
invoice_charge_amount_71
Invoice Charge Amount
invoice_charge_amount_72
Invoice Charge Amount
invoice_charge_amount_73
Invoice Charge Amount
invoice_charge_amount_74
Invoice Charge Amount
invoice_charge_amount_75
Invoice Charge Amount
invoice_charge_amount_76
Invoice Charge Amount
invoice_charge_amount_77
Invoice Charge Amount
invoice_charge_amount_78
Invoice Charge Amount
invoice_charge_amount_79
Invoice Charge Amount
invoice_charge_amount_8
Invoice Charge Amount
invoice_charge_amount_80
Invoice Charge Amount
invoice_charge_amount_81
Invoice Charge Amount
invoice_charge_amount_82
Invoice Charge Amount
invoice_charge_amount_83
Invoice Charge Amount
invoice_charge_amount_84
Invoice Charge Amount
invoice_charge_amount_85
Invoice Charge Amount
invoice_charge_amount_86
Invoice Charge Amount
invoice_charge_amount_87
Invoice Charge Amount
invoice_charge_amount_88
Invoice Charge Amount
invoice_charge_amount_89
Invoice Charge Amount
invoice_charge_amount_9
Invoice Charge Amount
invoice_charge_amount_90
Invoice Charge Amount
invoice_charge_amount_91
Invoice Charge Amount
invoice_charge_amount_92
Invoice Charge Amount
invoice_charge_amount_93
Invoice Charge Amount
invoice_charge_amount_94
Invoice Charge Amount
invoice_charge_amount_95
Invoice Charge Amount
invoice_charge_amount_96
Invoice Charge Amount
invoice_charge_amount_97
Invoice Charge Amount
invoice_charge_amount_98
Invoice Charge Amount
invoice_charge_amount_99
Invoice Charge Amount
REF
0500
Heading > REF

Vendor ID Number

OptionalMax use 1

To specify identifying information

Example
At least one of Reference Identification (REF-02) or Description (REF-03) is required
REF-01
128
Reference Identification Qualifier
Required
Identifier (ID)

Code qualifying the Reference Identification

VR
Vendor ID Number
REF-02
127
Reference Identification
Optional
String (AN)
Min 1Max 50

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

Usage notes

Account ID assigned by the retailer for the supplier in which the order was sent to.

REF-03
352
Description
Optional
String (AN)

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

invoice_seller_id
Invoice Seller ID

Optional

N1 Buying Party (Purchaser)
OptionalMax 1
N1
0700
Heading > Buying Party (Purchaser) > N1

Party Identification

RequiredMax use 1

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

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

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

BY
Buying Party (Purchaser)
N1-02
93
Name
Optional
String (AN)
Min 1Max 60

Free-form name

Usage notes

Supplier name that is displayed on the package address label and packing slip.

N2
0800
Heading > Buying Party (Purchaser) > N2

Additional Name Information

OptionalMax use 2

To specify additional names

Example
N2-01
93
Name
Required
String (AN)
Min 1Max 60

Free-form name

Usage notes

Buyer Company

N2-02
93
Name
Optional
String (AN)
Min 1Max 60

Free-form name

Usage notes

Buyer Attention

N3
0900
Heading > Buying Party (Purchaser) > N3

Party Location

OptionalMax use 2

To specify the location of the named party

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

Address information

Usage notes

First address line of Buyer that is displayed on the package address label and packing slip.

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

Address information

Usage notes

Second address line of Buyer that is displayed on the package address label and packing slip.

N4
1000
Heading > Buying Party (Purchaser) > N4

Geographic Location

OptionalMax use 1

To specify the geographic place of the named party

Example
N4-01
19
City Name
Optional
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.
Usage notes

Buyer City that should be displayed on the package address label and packing slip.

N4-02
156
State or Province Code
Optional
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

Buyer State that is displayed on the package address label and packing slip.

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

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

Usage notes

Buyer Zip code excluding punctuation (hyphens) and blanks. As displayed on the package address label and packing slip.

N4-04
26
Country Code
Optional
Identifier (ID)
Min 2Max 3

Code identifying the country

Usage notes

Buyer Country code. As displayed on the package address label and packing slip.

REF
1100
Heading > Buying Party (Purchaser) > REF

Location Number

OptionalMax use 1

To specify identifying information

Example
Variants (all may be used)
REFMutually Defined
At least one of Reference Identification (REF-02) or Description (REF-03) is required
REF-01
128
Reference Identification Qualifier
Required
Identifier (ID)

Code qualifying the Reference Identification

LU
Location Number
REF-02
127
Reference Identification
Optional
String (AN)
Min 1Max 50

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

Usage notes

The location code from where the package was shipped.

REF-03
352
Description
Optional
String (AN)

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

ship_from_location_code
Ship-From Location Code

Optional

REF
1100
Heading > Buying Party (Purchaser) > REF

Mutually Defined

OptionalMax use 12

To specify identifying information

Example
Variants (all may be used)
REFLocation Number
At least one of Reference Identification (REF-02) or Description (REF-03) is required
REF-01
128
Reference Identification Qualifier
Required
Identifier (ID)

Code qualifying the Reference Identification

ZZ
Mutually Defined
REF-02
127
Reference Identification
Optional
String (AN)
Min 1Max 50

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

Usage notes

The address type of the bill-to address. Is it 'Residential' or 'Commercial'?

REF-03
352
Description
Optional
String (AN)

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

ship_from_address_type
Ship-From Address Type

Optional

PER
1200
Heading > Buying Party (Purchaser) > PER

Administrative Communications Contact

OptionalMax use 3

To identify a person or office to whom administrative communications should be directed

Example
If either Communication Number Qualifier (PER-03) or Communication Number (PER-04) is present, then the other is required
If either Communication Number Qualifier (PER-05) or Communication Number (PER-06) is present, then the other is required
PER-01
366
Contact Function Code
Required
Identifier (ID)

Code identifying the major duty or responsibility of the person or group named

IC
Information Contact
PER-02
93
Name
Optional
String (AN)
Min 1Max 60

Free-form name

Usage notes

Ship-From Name

PER-03
365
Communication Number Qualifier
Optional
Identifier (ID)

Code identifying the type of communication number

TE
Telephone
PER-04
364
Communication Number
Optional
String (AN)

Complete communications number including country or area code when applicable

ship_from_phone
Ship-From Communications Contact

Optional

PER-05
365
Communication Number Qualifier
Optional
Identifier (ID)

Code identifying the type of communication number

EM
Electronic Mail
PER-06
364
Communication Number
Optional
String (AN)

Complete communications number including country or area code when applicable

ship_from_email
Ship-From Communications Contact

Optional

N1 Buying Party (Purchaser) end
N1 Remit To
OptionalMax 1
N1
0700
Heading > Remit To > N1

Party Identification

RequiredMax use 1

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

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
N1-02
93
Name
Optional
String (AN)
Min 1Max 60

Free-form name

Usage notes

Supplier name that is displayed on the package address label and packing slip.

N2
0800
Heading > Remit To > N2

Additional Name Information

OptionalMax use 2

To specify additional names

Example
N2-01
93
Name
Required
String (AN)
Min 1Max 60

Free-form name

Usage notes

Remit To Company

N2-02
93
Name
Optional
String (AN)
Min 1Max 60

Free-form name

Usage notes

Remit To Attention

N3
0900
Heading > Remit To > N3

Party Location

OptionalMax use 2

To specify the location of the named party

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

Address information

Usage notes

First address line of Remit To that is displayed on the package address label and packing slip.

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

Address information

Usage notes

Second address line of Remit To that is displayed on the package address label and packing slip.

N4
1000
Heading > Remit To > N4

Geographic Location

OptionalMax use 1

To specify the geographic place of the named party

Example
N4-01
19
City Name
Optional
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.
Usage notes

Remit To City that should be displayed on the package address label and packing slip.

N4-02
156
State or Province Code
Optional
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

Remit To State that is displayed on the package address label and packing slip.

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

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

Usage notes

Remit To Zip code excluding punctuation (hyphens) and blanks. As displayed on the package address label and packing slip.

N4-04
26
Country Code
Optional
Identifier (ID)
Min 2Max 3

Code identifying the country

Usage notes

Remit To Country code. As displayed on the package address label and packing slip.

N1 Remit To end
N1 Ship From
OptionalMax 1
N1
0700
Heading > Ship From > N1

Party Identification

RequiredMax use 1

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

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

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

SF
Ship From
N1-02
93
Name
Optional
String (AN)
Min 1Max 60

Free-form name

Usage notes

Supplier name that is displayed on the package address label and packing slip.

N2
0800
Heading > Ship From > N2

Additional Name Information

OptionalMax use 2

To specify additional names

Example
N2-01
93
Name
Required
String (AN)
Min 1Max 60

Free-form name

Usage notes

Ship-From Company

N2-02
93
Name
Optional
String (AN)
Min 1Max 60

Free-form name

Usage notes

Ship-From Attention

N3
0900
Heading > Ship From > N3

Party Location

OptionalMax use 2

To specify the location of the named party

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

Address information

Usage notes

First address line of Ship-From that is displayed on the package address label and packing slip.

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

Address information

Usage notes

Second address line of Ship-From that is displayed on the package address label and packing slip.

N4
1000
Heading > Ship From > N4

Geographic Location

OptionalMax use 1

To specify the geographic place of the named party

Example
N4-01
19
City Name
Optional
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.
Usage notes

Ship-From City that should be displayed on the package address label and packing slip.

N4-02
156
State or Province Code
Optional
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

Ship-From State that is displayed on the package address label and packing slip.

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

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

Usage notes

Ship-From Zip code excluding punctuation (hyphens) and blanks. As displayed on the package address label and packing slip.

N4-04
26
Country Code
Optional
Identifier (ID)
Min 2Max 3

Code identifying the country

Usage notes

Ship-From Country code. As displayed on the package address label and packing slip.

REF
1100
Heading > Ship From > REF

Mutually Defined

OptionalMax use 12

To specify identifying information

Example
Variants (all may be used)
REFLocation Number
At least one of Reference Identification (REF-02) or Description (REF-03) is required
REF-01
128
Reference Identification Qualifier
Required
Identifier (ID)

Code qualifying the Reference Identification

ZZ
Mutually Defined
REF-02
127
Reference Identification
Optional
String (AN)
Min 1Max 50

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

Usage notes

The address type of the bill-to address. Is it 'Residential' or 'Commercial'?

REF-03
352
Description
Optional
String (AN)

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

ship_from_address_type
Ship-From Address Type

Optional

REF
1100
Heading > Ship From > REF

Location Number

OptionalMax use 1

To specify identifying information

Example
Variants (all may be used)
REF Mutually Defined
At least one of Reference Identification (REF-02) or Description (REF-03) is required
REF-01
128
Reference Identification Qualifier
Required
Identifier (ID)

Code qualifying the Reference Identification

LU
Location Number
REF-02
127
Reference Identification
Optional
String (AN)
Min 1Max 50

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

Usage notes

The location code from where the package was shipped.

REF-03
352
Description
Optional
String (AN)

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

ship_from_location_code
Ship-From Location Code

Optional

PER
1200
Heading > Ship From > PER

Administrative Communications Contact

OptionalMax use 3

To identify a person or office to whom administrative communications should be directed

Example
If either Communication Number Qualifier (PER-03) or Communication Number (PER-04) is present, then the other is required
If either Communication Number Qualifier (PER-05) or Communication Number (PER-06) is present, then the other is required
PER-01
366
Contact Function Code
Required
Identifier (ID)

Code identifying the major duty or responsibility of the person or group named

IC
Information Contact
PER-02
93
Name
Optional
String (AN)
Min 1Max 60

Free-form name

Usage notes

Ship-From Name

PER-03
365
Communication Number Qualifier
Optional
Identifier (ID)

Code identifying the type of communication number

TE
Telephone
PER-04
364
Communication Number
Optional
String (AN)

Complete communications number including country or area code when applicable

ship_from_phone
Ship-From Communications Contact

Optional

PER-05
365
Communication Number Qualifier
Optional
Identifier (ID)

Code identifying the type of communication number

EM
Electronic Mail
PER-06
364
Communication Number
Optional
String (AN)

Complete communications number including country or area code when applicable

ship_from_email
Ship-From Communications Contact

Optional

N1 Ship From end
N1 Ship To
OptionalMax >1
N1
0700
Heading > Ship To > N1

Party Identification

RequiredMax use 1

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

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
N1-02
93
Name
Optional
String (AN)
Min 1Max 60

Free-form name

Usage notes

Customer name that should be displayed on the package address label and packing slip.

N2
0800
Heading > Ship To > N2

Additional Name Information

OptionalMax use 2

To specify additional names

Example
N2-01
93
Name
Required
String (AN)
Min 1Max 60

Free-form name

Usage notes

Ship-To Company

N2-02
93
Name
Optional
String (AN)
Min 1Max 60

Free-form name

Usage notes

Ship-To Attention

N3
0900
Heading > Ship To > N3

Party Location

OptionalMax use 2

To specify the location of the named party

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

Address information

Usage notes

First address line of Ship-To that should be displayed on the package address label and packing slip.

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

Address information

Usage notes

Second address line of Ship-To that should be displayed on the package address label and packing slip.

N4
1000
Heading > Ship To > N4

Geographic Location

OptionalMax use 1

To specify the geographic place of the named party

Example
N4-01
19
City Name
Optional
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.
Usage notes

Ship-To City that should be displayed on the package address label and packing slip.

N4-02
156
State or Province Code
Optional
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

Ship-To State that should be displayed on the package address label and packing slip.

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

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

Usage notes

Ship-To Zip code excluding punctuation (hyphens) and blanks. Should be displayed on the package address label and packing slip.

N4-04
26
Country Code
Optional
Identifier (ID)
Min 2Max 3

Code identifying the country

Usage notes

Ship-To Country code. Should be displayed on the package address label and packing slip.

REF
1100
Heading > Ship To > REF

Mutually Defined

OptionalMax use 12

To specify identifying information

Example
At least one of Reference Identification (REF-02) or Description (REF-03) is required
REF-01
128
Reference Identification Qualifier
Required
Identifier (ID)

Code qualifying the Reference Identification

ZZ
Mutually Defined
REF-02
127
Reference Identification
Optional
String (AN)
Min 1Max 50

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

REF-03
352
Description
Optional
String (AN)

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

ship_address_type
Ship-To Address Type

Optional

The address type of the ship-to address. Is it 'Residential' or 'Commercial'?

ship_to_store_number
Ship-To Store Number

Optional

Store number to which the order was shipped.

PER
1200
Heading > Ship To > PER

Administrative Communications Contact

OptionalMax use 3

To identify a person or office to whom administrative communications should be directed

Example
If either Communication Number Qualifier (PER-03) or Communication Number (PER-04) is present, then the other is required
If either Communication Number Qualifier (PER-05) or Communication Number (PER-06) is present, then the other is required
PER-01
366
Contact Function Code
Required
Identifier (ID)

Code identifying the major duty or responsibility of the person or group named

OC
Order Contact
PER-02
93
Name
Optional
String (AN)
Min 1Max 60

Free-form name

Usage notes

Ship-To Name

PER-03
365
Communication Number Qualifier
Optional
Identifier (ID)

Code identifying the type of communication number

TE
Telephone
PER-04
364
Communication Number
Optional
String (AN)

Complete communications number including country or area code when applicable

ship_to_phone
Ship-To Communications Contact

Optional

PER-05
365
Communication Number Qualifier
Optional
Identifier (ID)

Code identifying the type of communication number

EM
Electronic Mail
PER-06
364
Communication Number
Optional
String (AN)

Complete communications number including country or area code when applicable

ship_to_email
Ship-To Communications Contact

Optional

N1 Ship To end
N1 Sold To If Different From Bill To
OptionalMax >1
N1
0700
Heading > Sold To If Different From Bill To > N1

Party Identification

RequiredMax use 1

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

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

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

SO
Sold To If Different From Bill To
N1-02
93
Name
Optional
String (AN)
Min 1Max 60

Free-form name

Usage notes

Supplier name that is displayed on the package address label and packing slip.

N2
0800
Heading > Sold To If Different From Bill To > N2

Additional Name Information

OptionalMax use 2

To specify additional names

Example
N2-01
93
Name
Required
String (AN)
Min 1Max 60

Free-form name

Usage notes

Seller Company

N2-02
93
Name
Optional
String (AN)
Min 1Max 60

Free-form name

Usage notes

Seller Attention

N3
0900
Heading > Sold To If Different From Bill To > N3

Party Location

OptionalMax use 2

To specify the location of the named party

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

Address information

Usage notes

First address line of Seller that is displayed on the package address label and packing slip.

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

Address information

Usage notes

Second address line of Seller that is displayed on the package address label and packing slip.

N4
1000
Heading > Sold To If Different From Bill To > N4

Geographic Location

OptionalMax use 1

To specify the geographic place of the named party

Example
N4-01
19
City Name
Optional
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.
Usage notes

Seller City that should be displayed on the package address label and packing slip.

N4-02
156
State or Province Code
Optional
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

Seller State that is displayed on the package address label and packing slip.

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

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

Usage notes

Seller Zip code excluding punctuation (hyphens) and blanks. As displayed on the package address label and packing slip.

N4-04
26
Country Code
Optional
Identifier (ID)
Min 2Max 3

Code identifying the country

Usage notes

Seller Country code. As displayed on the package address label and packing slip.

N1 Sold To If Different From Bill To end
ITD
1300
Heading > ITD

Terms of Sale/Deferred Terms of Sale

OptionalMax use >1

To specify terms of sale

Usage notes

See trading partner specific guides

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
If Terms Discount Amount (ITD-08) 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)
05
Discount Not Applicable
08
Basic Discount Offered
12
10 Days After End of Month (10 EOM)
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

Percentage of merchandise cost discounted if invoice is paid before the terms discount due date (ITD04).

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 where CC represents the first two digits of the calendar year

Usage notes

Date payment is due to qualify for discount.

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

Number of days from the invoice date that discounted invoice is due.

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

Date when total invoice amount becomes due expressed in format CCYYMMDD where CC represents the first two digits of the calendar year

Usage notes

Date payment of invoice in full is 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

Number of days until total invoice amount is due.

ITD-08
362
Terms Discount Amount
Optional
Numeric (N2)
Min 1Max 10

Total amount of terms discount

Usage notes

Dollar amount of invoice merchandise cost discounted if invoice is paid on or before Terms Discount Due Date (ITD04).

Format: 999.99 (The decimal place must be included)

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 using codes '02' or '12' in ITD01, this is the number of days after EOM the invoice is due.

DTM
1400
Heading > DTM

Shipped

OptionalMax use 10

To specify pertinent dates and times

Usage notes

See trading partner specific guides

Example
DTM-01
374
Date/Time Qualifier
Required
Identifier (ID)

Code specifying type of date or time, or both date and time

011
Shipped
DTM-02
373
Date
Optional
Date (DT)
CCYYMMDD format

Date expressed as CCYYMMDD where CC represents the first two digits of the calendar year

DTM-03
337
Time
Optional
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)

Usage notes

Time Shipped in format HHMM.

PID
1600
Heading > PID

Product/Item Description

OptionalMax use 200

To describe a product or process in coded or free-form format

Example
PID-01
349
Item Description Type
Required
Identifier (ID)

Code indicating the format of a description

  • If PID01 equals "F", then PID05 is used. If PID01 equals "S", then PID04 is used. If PID01 equals "X", then both PID04 and PID05 are used.
F
Free-form
PID-04
751
Product Description Code
Optional
String (AN)

A code from an industry code list which provides specific data about a product characteristic

  • PID04 should be used for industry-specific product description codes.
FL
FLSA Compliance Flag

Conditional

Sent for FLSA compliance flag.

Heading end

Detail

IT1 Loop
RequiredMax >1
IT1
0100
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

Example
If either Product/Service ID Qualifier (IT1-08) or Product/Service ID (IT1-09) is present, then the other is required
If either Product/Service ID Qualifier (IT1-10) or Product/Service ID (IT1-11) is present, then the other is required
If either Product/Service ID Qualifier (IT1-12) or Product/Service ID (IT1-13) is present, then the other is required
If either Product/Service ID Qualifier (IT1-14) or Product/Service ID (IT1-15) is present, then the other is required
If either Product/Service ID Qualifier (IT1-16) or Product/Service ID (IT1-17) is present, then the other is required
If either Product/Service ID Qualifier (IT1-18) or Product/Service ID (IT1-19) is present, then the other is required
IT1-01
350
Assigned Identification
Optional
String (AN)
Min 1Max 20

Alphanumeric characters assigned for differentiation within a transaction set

  • IT101 is the line item identification.
Usage notes

Invoice line number is required when there are two or more line items with the same-SKU.

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

Number of units invoiced (supplier units)

Usage notes

Units shipped per line item.

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

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

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

Usage notes

Price per unit.

Format: 999.99 (The decimal place must be included.)

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

Code identifying the type of unit price for an item

LE
Catalog Price per Each
QT
Quoted

Default

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.
SK
Stock Keeping Unit (SKU)
IT1-07
234
Product/Service ID
Required
String (AN)
Min 1Max 70

Identifying number for a product or service

Usage notes

The SKU of the item. A limit of 70 characters is enforced. A SKU is required. If a SKU is not available you may duplicate the UPC or EAN to this field.

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
CB
Buyer's Catalog Number
EM
Equipment Identification Number
EN
EAN/UCC - 13
IB
International Standard Book Number (ISBN)
MG
Manufacturer's Part Number
PD
Part Number Description
SN
Serial Number
UK
GTIN 14-digit Data Structure
UP
UCC - 12
IT1-09
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

When the Qualifier is 'UP': Universal Product Code (UPC)
When the Qualifier is 'EN': European Article Number (EAN)
When the Qualifier is 'IB': International Standard Book Number (ISBN)
When the Qualifier is 'UK': Global Trade Number (GTIN)
When the Qualifier is 'BP': Partner SKU
When the Qualifier is 'CB': Retailer Item Identifier
When the Qualifier is 'EM': Dsco Item ID
When the Qualifier is 'PD': Line Item Title
When the Qualifier is 'SN': Serial Numbers are '^^' separated, meaning that if there is '^^' in this field there are multiple serial numbers

IT1-10
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
CB
Buyer's Catalog Number
EM
Equipment Identification Number
EN
EAN/UCC - 13
IB
International Standard Book Number (ISBN)
MG
Manufacturer's Part Number
PD
Part Number Description
SN
Serial Number
UK
GTIN 14-digit Data Structure
UP
UCC - 12
IT1-11
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

When the Qualifier is 'UP': Universal Product Code (UPC)
When the Qualifier is 'EN': European Article Number (EAN)
When the Qualifier is 'IB': International Standard Book Number (ISBN)
When the Qualifier is 'UK': Global Trade Number (GTIN)
When the Qualifier is 'BP': Partner SKU
When the Qualifier is 'CB': Retailer Item Identifier
When the Qualifier is 'EM': Dsco Item ID
When the Qualifier is 'PD': Line Item Title
When the Qualifier is 'SN': Serial Numbers are '^^' separated, meaning that if there is '^^' in this field there are multiple serial numbers

IT1-12
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
CB
Buyer's Catalog Number
EM
Equipment Identification Number
EN
EAN/UCC - 13
IB
International Standard Book Number (ISBN)
MG
Manufacturer's Part Number
PD
Part Number Description
SN
Serial Number
UK
GTIN 14-digit Data Structure
UP
UCC - 12
IT1-13
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

When the Qualifier is 'UP': Universal Product Code (UPC)
When the Qualifier is 'EN': European Article Number (EAN)
When the Qualifier is 'IB': International Standard Book Number (ISBN)
When the Qualifier is 'UK': Global Trade Number (GTIN)
When the Qualifier is 'BP': Partner SKU
When the Qualifier is 'CB': Retailer Item Identifier
When the Qualifier is 'EM': Dsco Item ID
When the Qualifier is 'PD': Line Item Title
When the Qualifier is 'SN': Serial Numbers are '^^' separated, meaning that if there is '^^' in this field there are multiple serial numbers

IT1-14
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
CB
Buyer's Catalog Number
EM
Equipment Identification Number
EN
EAN/UCC - 13
IB
International Standard Book Number (ISBN)
MG
Manufacturer's Part Number
PD
Part Number Description
SN
Serial Number
UK
GTIN 14-digit Data Structure
UP
UCC - 12
IT1-15
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

When the Qualifier is 'UP': Universal Product Code (UPC)
When the Qualifier is 'EN': European Article Number (EAN)
When the Qualifier is 'IB': International Standard Book Number (ISBN)
When the Qualifier is 'UK': Global Trade Number (GTIN)
When the Qualifier is 'BP': Partner SKU
When the Qualifier is 'CB': Retailer Item Identifier
When the Qualifier is 'EM': Dsco Item ID
When the Qualifier is 'PD': Line Item Title
When the Qualifier is 'SN': Serial Numbers are '^^' separated, meaning that if there is '^^' in this field there are multiple serial numbers

IT1-16
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
CB
Buyer's Catalog Number
EM
Equipment Identification Number
EN
EAN/UCC - 13
IB
International Standard Book Number (ISBN)
MG
Manufacturer's Part Number
PD
Part Number Description
SN
Serial Number
UK
GTIN 14-digit Data Structure
UP
UCC - 12
IT1-17
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

When the Qualifier is 'UP': Universal Product Code (UPC)
When the Qualifier is 'EN': European Article Number (EAN)
When the Qualifier is 'IB': International Standard Book Number (ISBN)
When the Qualifier is 'UK': Global Trade Number (GTIN)
When the Qualifier is 'BP': Partner SKU
When the Qualifier is 'CB': Retailer Item Identifier
When the Qualifier is 'EM': Dsco Item ID
When the Qualifier is 'PD': Line Item Title
When the Qualifier is 'SN': Serial Numbers are '^^' separated, meaning that if there is '^^' in this field there are multiple serial numbers

IT1-18
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
CB
Buyer's Catalog Number
EM
Equipment Identification Number
EN
EAN/UCC - 13
IB
International Standard Book Number (ISBN)
MG
Manufacturer's Part Number
PD
Part Number Description
SN
Serial Number
UK
GTIN 14-digit Data Structure
UP
UCC - 12
IT1-19
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

When the Qualifier is 'UP': Universal Product Code (UPC)
When the Qualifier is 'EN': European Article Number (EAN)
When the Qualifier is 'IB': International Standard Book Number (ISBN)
When the Qualifier is 'UK': Global Trade Number (GTIN)
When the Qualifier is 'BP': Partner SKU
When the Qualifier is 'CB': Retailer Item Identifier
When the Qualifier is 'EM': Dsco Item ID
When the Qualifier is 'PD': Line Item Title
When the Qualifier is 'SN': Serial Numbers are '^^' separated, meaning that if there is '^^' in this field there are multiple serial numbers

PID Loop
OptionalMax >1
PID
0600
Detail > IT1 Loop > PID Loop > PID

Product/Item Description

RequiredMax use 1

To describe a product or process in coded or free-form format

Example
PID-01
349
Item Description Type
Required
Identifier (ID)

Code indicating the format of a description

  • If PID01 equals "F", then PID05 is used. If PID01 equals "S", then PID04 is used. If PID01 equals "X", then both PID04 and PID05 are used.
X
Semi-structured (Code and Text)
PID-05
352
Description
Optional
String (AN)
Min 1Max 80

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

Usage notes

Line-Item Carb Formaldehyde Compliance Code

PID Loop end
REF
1200
Detail > IT1 Loop > REF

Ship Notice/Manifest Number

OptionalMax use 1

To specify identifying information

Example
At least one of Reference Identification (REF-02) or Description (REF-03) is required
REF-01
128
Reference Identification Qualifier
Required
Identifier (ID)

Code qualifying the Reference Identification

MA
Ship Notice/Manifest Number
REF-02
127
Reference Identification
Optional
String (AN)
Min 1Max 50

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

Usage notes

The Line-Item Ship Carrier Manifest ID - Used with LTL shipments.

REF-03
352
Description
Optional
String (AN)

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

line_item_ship_carrier_manifest_id
Line-Item Ship Carrier Manifest ID

(Optional)

The Line-Item Ship Carrier Manifest ID - Used with LTL shipments.

REF
1200
Detail > IT1 Loop > REF

Carrier's Reference Number (PRO/Invoice)

OptionalMax use 1

To specify identifying information

Usage notes

See trading partner specific guides

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

Code qualifying the Reference Identification

CN
Carrier's Reference Number (PRO/Invoice)
REF-02
127
Reference Identification
Optional
String (AN)
Min 1Max 50

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

Usage notes

Shipment Tracking Number

REF
1200
Detail > IT1 Loop > REF

Loan Acquisition Number

OptionalMax use 1

To specify identifying information

Usage notes

See trading partner specific guides

Example
At least one of Reference Identification (REF-02) or Description (REF-03) is required
REF-01
128
Reference Identification Qualifier
Required
Identifier (ID)

Code qualifying the Reference Identification

GM
Loan Acquisition Number
REF-02
127
Reference Identification
Optional
String (AN)
Min 1Max 50

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

Usage notes

The SSCC-Barcode generated for the item-level ship-to-store label.

REF-03
352
Description
Optional
String (AN)

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

line_item_sscc_barcode
Line-Item SSCC-Barcode

Conditional

REF
1200
Detail > IT1 Loop > REF

Mutually Defined

OptionalMax use >1

To specify identifying information

Example
At least one of Reference Identification (REF-02) or Description (REF-03) is required
REF-01
128
Reference Identification Qualifier
Required
Identifier (ID)

Code qualifying the Reference Identification

ZZ
Mutually Defined
REF-02
127
Reference Identification
Optional
String (AN)
Min 1Max 50

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

REF-03
352
Description
Optional
String (AN)

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

line_item_commission_percentage
Line-Item Commission Percentage

Optional

The percentage that supplier has set for the given trading partner to calculate the commission amount for an item when sold.

line_item_dsco_package_id
Line-Item Dsco Package ID

(Not used by Suppliers - Only included in Retailer Exports)

Package ID generated by Dsco to uniquely identify the shipment.

line_item_extended_amount
Line-Item Extended Amount

Optional

The amount of line_item_unit_price multiplied by line_item_quantity.

Format: 999.99 (The decimal place must be included)

line_item_handling_amount
Line-Item Handling Amount

Optional

The total amount being charged for handling charges for this specific line_item_sku.

Format: 999.99 (The decimal place must be included)

line_item_msrp
Line-Item MSRP

Optional

The MSRP or current selling price of the given line-item.

line_item_promotion_amount
Line-Item Promotion Amount

Optional

The amount being discounted for each line_item_sku for the given line_item_promotion_reference.

Format: 999.99 (The decimal place must be included)

line_item_promotion_reference
Line-Item Promotion Reference

Optional

If the line_item_unit_price is discounted because of a promotion that the supplier is running, this field can be used to reference the promotion's title or description.

line_item_ship_amount
Line-Item Ship Amount

Optional

The total amount being charged for shipping for this specific line_item_sku.

Format: 999.99 (The decimal place must be included)

line_item_ship_carrier
Line-Item Ship Carrier

Conditional

The carrier that shipped the package that included this specific line_item_sku.

line_item_ship_carrier_manifest_id
Line-Item Ship Carrier Manifest ID

Optional

The Line-Item Ship Carrier Manifest ID - Used with LTL shipments.

line_item_ship_method
Line-Item Ship Method

Conditional

The shipping method used by the carrier to ship the package that included this specific line_item_sku.

See trading partner specific guides

line_item_ship_transportation_method_code
Line-Item Ship Transportation Method Code

Optional

The transportation method code assigned by the carrier for the shipped package. Possible values include: 'A' for Air, 'J' for Motor, 'R' for Rail, 'S' for Ocean/Ship.

line_item_ship_unit_of_measurement_code
Line-Item Ship Unit Of Measurement Code

Optional

The line-item unit of measurement code. Typically 'EA' for 'Each'. 'PR' for 'Pair' is also acceptable.

line_item_ship_weight
Line-Item Ship Weight

Optional

Weight of the item shipped in the package.

line_item_ship_weight_units
Line-Item Ship Weight Units

Optional

Unit of measurement for the weight of the item.

line_item_shipping_service_level_code
Line-Item Shipping Service Level Code

Conditional

Used in conjunction with line_item_ship_carrier and line_item_ship_method, this allows the supplier to provide a predefined shipping code that the retailer will recognize.

See trading partner specific guides

line_item_sscc_barcode
Line-Item SSCC-Barcode

(Conditional)

The SSCC-Barcode generated for the item-level ship-to-store label

line_item_subtotal
Line-Item Subtotal

Optional

The total of the following fields:
line_item_extended_amount
line_item_handling_amount
line_item_ship_amount
line_item_promotion_amount
line_item_tax_amount

Format: 999.99 (The decimal place must be included)

line_item_tax_amount
Line-Item Tax Amount

Optional

The amount of tax being charged for this line_item_sku.

Format: 999.99 (The decimal place must be included)

shipping_service_level_code
shipping_service_level_code
REF
1200
Detail > IT1 Loop > REF

Third Party Reference Number

OptionalMax use 1

To specify identifying information

Example
At least one of Reference Identification (REF-02) or Description (REF-03) is required
REF-01
128
Reference Identification Qualifier
Required
Identifier (ID)

Code qualifying the Reference Identification

GK
Third Party Reference Number
REF-02
127
Reference Identification
Optional
String (AN)
Min 1Max 50

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

Usage notes

Unit of measurement for the weight of the item.

REF-03
352
Description
Optional
String (AN)

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

line_item_carb_certifier_id
Line-Item Carb Certifier ID

Optional

DTM
1500
Detail > IT1 Loop > DTM

Date/Time Reference

OptionalMax use 10

To specify pertinent dates and times

Example
DTM-01
374
Date/Time Qualifier
Required
Identifier (ID)

Code specifying type of date or time, or both date and time

011
Shipped
DTM-02
373
Date
Optional
Date (DT)
CCYYMMDD format

Date expressed as CCYYMMDD where CC represents the first two digits of the calendar year

Usage notes

Line Item Shipped date.

DTM-03
337
Time
Optional
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)

Usage notes

Time Shipped in format HHMM.

SAC Sales Tax
OptionalMax 1
Variants (all may be used)
Taxable Amount of Sale
SAC
1800
Detail > IT1 Loop > Sales Tax > 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

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.
C
Charge
SAC-02
1300
Service, Promotion, Allowance, or Charge Code
Required
Identifier (ID)

Code identifying the service, promotion, allowance, or charge

D360
Sales Tax
SAC-05
610
Amount
Optional
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

Amount of Sales Tax – Implied Decimal – EDI Type N2

TXI Loop
OptionalMax >1
TXI
1900
Detail > IT1 Loop > Sales Tax > TXI Loop > TXI

Tax Information

RequiredMax use 1

To specify tax information

Example
If either Tax Jurisdiction Code Qualifier (TXI-04) or Tax Jurisdiction Code (TXI-05) is present, then the other is required
At least one of Monetary Amount (TXI-02), Percentage as Decimal (TXI-03) or Tax Exempt Code (TXI-06) is required
TXI-01
963
Tax Type Code
Required
Identifier (ID)

Code specifying the type of tax

CG
Federal Value-added Tax (GST) on Goods

Goods and Services tax.

SP
State/Provincial Tax

Provincial sales tax.

ST
State Sales Tax

Quebec sales tax.

VA
Value Added Tax

Harmonized sales tax.

ZA
911-City Tax

Denotes tax code indicating VAT Blended.

ZB
911-County Tax

Denotes tax code indicating VAT Reduced.

ZC
911-Excise Tax

Denotes tax code indicating VAT Standard.

ZD
911-State Tax

Denotes tax code indicating VAT Zero.

TXI-02
782
Monetary Amount
Optional
Decimal number (R)
Min 1Max 15

Monetary amount

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

Percentage expressed as a decimal (e.g., 0.0 through 1.0 represents 0% through 100%)

  • TXI03 is the tax percent expressed as a decimal.
TXI-04
955
Tax Jurisdiction Code Qualifier
Optional
Identifier (ID)
Min 2Max 2

Code identifying the source of the data used in tax jurisdiction code

TXI-05
956
Tax Jurisdiction Code
Optional
String (AN)
Min 1Max 10

Code identifying the taxing jurisdiction

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

Code identifying exemption status from sales and use tax

TXI-09
325
Tax Identification Number
Optional
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

Tax Registration Number

TXI-10
350
Assigned Identification
Optional
String (AN)
Min 1Max 20

Alphanumeric characters assigned for differentiation within a transaction set

Usage notes

Tax Description

TXI Loop end
SAC Sales Tax end
SAC Taxable Amount of Sale
OptionalMax >1
Variants (all may be used)
Sales Tax
SAC
1800
Detail > IT1 Loop > Taxable Amount of Sale > 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

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.
C
Charge
SAC-02
1300
Service, Promotion, Allowance, or Charge Code
Required
Identifier (ID)

Code identifying the service, promotion, allowance, or charge

D340
Taxable Amount of Sale
SAC-05
610
Amount
Optional
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

Taxable Amount of Sale – Implied Decimal – EDI Type N2

SAC Taxable Amount of Sale end
SLN Loop
OptionalMax 1
SLN
2000
Detail > IT1 Loop > SLN Loop > SLN

Subline Item Detail

RequiredMax use 1

To specify product subline detail item data

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

Alphanumeric characters assigned for differentiation within a transaction set

  • SLN01 is the identifying number for the subline item.
  • SLN01 is related to (but not necessarily equivalent to) the baseline item number. Example: 1.1 or 1A might be used as a subline number to relate to baseline number 1.
Usage notes

Numeric Identifier

SLN-03
662
Relationship Code
Required
Identifier (ID)

Code indicating the relationship between entities

  • SLN03 is the configuration code indicating the relationship of the subline item to the baseline item.
O
Information Only
SLN-04
380
Quantity
Optional
Decimal number (R)
Min 1Max 15

Numeric value of quantity

Usage notes

line_item_original_order_quantity

SLN-05
C001
Composite Unit of Measure
OptionalMax use 1
To identify a composite unit of measure (See Figures Appendix for examples of use)
C001-01
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

EA
Each
SLN Loop end
IT1 Loop end
Detail end

Summary

TDS
0100
Summary > TDS

Total Monetary Value Summary

RequiredMax use 1

To specify the total invoice discounts and amounts

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

Total amount of the invoice plus all charges minus all allowances.

Format: 999.99 (The decimal place must be included)

TDS-02
610
Amount
Optional
Numeric (N2)
Min 1Max 15

Monetary amount

  • TDS02 indicates the amount upon which the terms discount amount is calculated.
  • TDS02 is required if the dollar value subject to discount is not equal to the dollar value of TDS01.
Usage notes

Total amount of invoice eligible for terms discount.

Format: 999.99 (The decimal place must be included)

AMT
0350
Summary > AMT

Handling Charges

OptionalMax use 1

To indicate the total monetary amount

Example
Variants (all may be used)
AMTSales Tax
AMT-01
522
Amount Qualifier Code
Required
Identifier (ID)

Code to qualify amount

OH
Handling Charges
AMT-02
782
Monetary Amount
Required
Decimal number (R)
Min 1Max 15

Monetary amount

AMT
0350
Summary > AMT

Sales Tax

OptionalMax use 1

To indicate the total monetary amount

Example
Variants (all may be used)
AMTHandling Charges
AMT-01
522
Amount Qualifier Code
Required
Identifier (ID)

Code to qualify amount

F7
Sales Tax
AMT-02
782
Monetary Amount
Required
Decimal number (R)
Min 1Max 15

Monetary amount

SAC Credit
OptionalMax 1
Variants (all may be used)
FreightSales TaxTaxable Amount of Sale
SAC
0400
Summary > Credit > 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

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
SAC-02
1300
Service, Promotion, Allowance, or Charge Code
Required
Identifier (ID)

Code identifying the service, promotion, allowance, or charge

B800
Credit
SAC-05
610
Amount
Optional
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

Amount of Credits – Implied Decimal – EDI Type N2

SAC Credit end
SAC Freight
OptionalMax >1
Variants (all may be used)
CreditSales TaxTaxable Amount of Sale
SAC
0400
Summary > Freight > 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

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.
C
Charge
SAC-02
1300
Service, Promotion, Allowance, or Charge Code
Required
Identifier (ID)

Code identifying the service, promotion, allowance, or charge

D240
Freight
SAC-05
610
Amount
Optional
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

Invoice Freight Amount in format: 9999.99 (The decimal place must be included0.

SAC Freight end
SAC Sales Tax
OptionalMax 1
Variants (all may be used)
CreditFreightTaxable Amount of Sale
SAC
0400
Summary > Sales Tax > 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

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.
C
Charge
SAC-02
1300
Service, Promotion, Allowance, or Charge Code
Required
Identifier (ID)

Code identifying the service, promotion, allowance, or charge

D360
Sales Tax
SAC-05
610
Amount
Optional
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

Amount of Sales Tax – Implied Decimal – EDI Type N2

TXI Loop
OptionalMax >1
TXI
0500
Summary > Sales Tax > TXI Loop > TXI

Tax Information

RequiredMax use 1

To specify tax information

Example
If either Tax Jurisdiction Code Qualifier (TXI-04) or Tax Jurisdiction Code (TXI-05) is present, then the other is required
At least one of Monetary Amount (TXI-02), Percentage as Decimal (TXI-03) or Tax Exempt Code (TXI-06) is required
TXI-01
963
Tax Type Code
Required
Identifier (ID)

Code specifying the type of tax

CG
Federal Value-added Tax (GST) on Goods

Goods and Services tax.

SP
State/Provincial Tax

Provincial sales tax.

ST
State Sales Tax

Quebec sales tax.

VA
Value Added Tax

Harmonized sales tax.

ZA
911-City Tax

Denotes tax code indicating VAT Blended.

ZB
911-County Tax

Denotes tax code indicating VAT Reduced.

ZC
911-Excise Tax

Denotes tax code indicating VAT Standard.

ZD
911-State Tax

Denotes tax code indicating VAT Zero.

TXI-02
782
Monetary Amount
Optional
Decimal number (R)
Min 1Max 15

Monetary amount

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

Percentage expressed as a decimal (e.g., 0.0 through 1.0 represents 0% through 100%)

  • TXI03 is the tax percent expressed as a decimal.
TXI-04
955
Tax Jurisdiction Code Qualifier
Optional
Identifier (ID)
Min 2Max 2

Code identifying the source of the data used in tax jurisdiction code

TXI-05
956
Tax Jurisdiction Code
Optional
String (AN)
Min 1Max 10

Code identifying the taxing jurisdiction

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

Code identifying exemption status from sales and use tax

TXI-09
325
Tax Identification Number
Optional
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

Tax Registration Number

TXI-10
350
Assigned Identification
Optional
String (AN)
Min 1Max 20

Alphanumeric characters assigned for differentiation within a transaction set

Usage notes

Tax Description

TXI Loop end
SAC Sales Tax end
SAC Taxable Amount of Sale
OptionalMax 1
Variants (all may be used)
CreditFreightSales Tax
SAC
0400
Summary > Taxable Amount of Sale > 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

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.
C
Charge
SAC-02
1300
Service, Promotion, Allowance, or Charge Code
Required
Identifier (ID)

Code identifying the service, promotion, allowance, or charge

D340
Taxable Amount of Sale
SAC-05
610
Amount
Optional
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

Taxable Amount of Sale – Implied Decimal – EDI Type N2

SAC Taxable Amount of Sale end
ISS Loop
OptionalMax >1
ISS
0600
Summary > ISS Loop > ISS

Invoice Shipment Summary

RequiredMax use 1

To specify summary details of total items shipped in terms of quantity, weight, and volume

Example
If either Number of Units Shipped (ISS-01) or Unit or Basis for Measurement Code (ISS-02) is present, then the other is required
If either Weight (ISS-03) or Unit or Basis for Measurement Code (ISS-04) is present, then the other is required
ISS-01
382
Number of Units Shipped
Optional
Decimal number (R)
Min 1Max 10

Numeric value of units shipped in manufacturer's shipping units for a line item or transaction set

ISS-02
355
Unit or Basis for Measurement Code
Optional
Identifier (ID)

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

Usage notes

Ship Unit of Measurement Code

BX
Box
CA
Case (Carton)
EA
Each
PK
Package
ISS-03
81
Weight
Optional
Decimal number (R)
Min 1Max 10

Numeric value of weight

Usage notes

Total Weight of shipment.

ISS-04
355
Unit or Basis for Measurement Code
Optional
Identifier (ID)

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

Usage notes

Ship Weight Unit of Measurement Code.

50
Actual Kilograms
LB
Pound
OZ
Ounce - Av
ISS Loop end
CTT
0700
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 CTT02 is the hash total of the quantities invoiced (IT102) for each IT1 segment.
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

Number of line items in the transaction set.

SE
0800
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

Sample

ST*810*000020001~
BIG*20200313*INV11150439**11150439~
CUR*BY*USD~
ITD*01*3****20200411*30~
DTM*011*20200313*1200~
IT1*1*3*EA*5.5*QT*SK*98989898~
IT1*2*1*EA*5.75*QT*SK*999999~
TDS*2225~
CTT*2~
SE*10*000020001~

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.