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

X12 810 Invoice

X12 Release 4010

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

Delimiters
  • ~ Segment
  • * Element
  • > Component
EDI sample
    View the latest version of this implementation guide as an interactive webpage
    Powered by
    Build EDI implementation guides at stedi.com
    Overview
    ISA
    -
    Interchange Control Header
    Max use 1
    Required
    GS
    -
    Functional Group Header
    Max use 1
    Required
    heading
    ST
    010
    Transaction Set Header
    Max use 1
    Required
    BIG
    020
    Beginning Segment for Invoice
    Max use 1
    Required
    NTE
    030
    Note/Special Instruction
    Max use 100
    Optional
    CUR
    040
    Currency
    Max use 1
    Optional
    REF
    050
    Reference Identification
    Max use 12
    Optional
    PER
    060
    Administrative Communications Contact
    Max use 3
    Optional
    N1 Loop
    ITD
    130
    Terms of Sale/Deferred Terms of Sale
    Max use 1
    Optional
    DTM
    140
    Date/Time Reference
    Max use 10
    Optional
    FOB
    150
    F.O.B. Related Instructions
    Max use 1
    Optional
    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

    Code to identify the type of information in the Authorization Information

    00
    No Authorization Information Present (No Meaningful Information in I02)
    ISA-02
    I02
    Authorization Information
    Required
    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

    Code to identify the type of information in the Security Information

    00
    No Security Information Present (No Meaningful Information in I04)
    ISA-04
    I04
    Security Information
    Required
    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
    Min 2Max 2

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

    Codes
    ISA-06
    I06
    Interchange Sender ID
    Required
    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
    Min 2Max 2

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

    Codes
    ISA-08
    I07
    Interchange Receiver ID
    Required
    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
    YYMMDD format

    Date of the interchange

    ISA-10
    I09
    Interchange Time
    Required
    HHMM format

    Time of the interchange

    ISA-11
    I10
    Interchange Control Standards Identifier
    Required

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

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

    This version number covers the interchange control segments

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

    A control number assigned by the interchange sender

    ISA-14
    I13
    Acknowledgment Requested
    Required
    Min 1Max 1

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

    0
    No Acknowledgment Requested
    1
    Interchange Acknowledgment Requested
    ISA-15
    I14
    Usage Indicator
    Required
    Min 1Max 1

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

    I
    Information
    P
    Production Data
    T
    Test Data
    ISA-16
    I15
    Component Element Separator
    Required
    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

    Code identifying a group of application related transaction sets

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

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

    GS-03
    124
    Application Receiver's Code
    Required
    Min 2Max 15

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

    GS-04
    373
    Date
    Required
    CCYYMMDD format

    Date expressed as CCYYMMDD

    GS-05
    337
    Time
    Required
    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
    Min 1Max 9

    Assigned number originated and maintained by the sender

    GS-07
    455
    Responsible Agency Code
    Required
    Min 1Max 2

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

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

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

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

    Heading

    ST
    010

    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

    Code uniquely identifying a Transaction Set

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

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

    BIG
    020

    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
    CCYYMMDD format

    Date expressed as CCYYMMDD

    • BIG01 is the invoice issue date.
    BIG-02
    76
    Invoice Number
    Required
    Min 1Max 22

    Identifying number assigned by issuer

    BIG-03
    373
    Date
    Optional
    CCYYMMDD format

    Date expressed as CCYYMMDD

    • BIG03 is the date assigned by the purchaser to purchase order.
    BIG-04
    324
    Purchase Order Number
    Optional
    Min 1Max 22

    Identifying number for Purchase Order assigned by the orderer/purchaser

    BIG-05
    328
    Release Number
    Optional
    Min 1Max 30

    Number identifying a release against a Purchase Order previously placed by the parties involved in the transaction

    BIG-07
    640
    Transaction Type Code
    Optional

    Code specifying the type of transaction

    • BIG07 is used only to further define the type of invoice when needed.
    CR
    Credit Memo
    DR
    Debit Memo
    PR
    Product (or Service)
    BIG-08
    353
    Transaction Set Purpose Code
    Optional

    Code identifying purpose of transaction set

    00
    Original
    NTE
    030

    Note/Special Instruction

    OptionalMax use 100

    To transmit information in a free-form format, if necessary, for comment or special instruction

    Example
    NTE-01
    363
    Note Reference Code
    Optional
    Min 3Max 3

    Code identifying the functional area or purpose for which the note applies

    NTE-02
    352
    Description
    Required
    Min 1Max 80

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

    CUR
    040

    Currency

    OptionalMax use 1

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

    Example
    If Date (CUR-08) is present, then Date/Time Qualifier (CUR-07) is required
    CUR-01
    98
    Entity Identifier Code
    Required
    Min 2Max 3

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

    CUR-02
    100
    Currency Code
    Required
    Min 3Max 3

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

    CUR-03
    280
    Exchange Rate
    Optional
    Min 4Max 10

    Value to be used as a multiplier conversion factor to convert monetary value from one currency to another

    CUR-07
    374
    Date/Time Qualifier
    Optional
    Min 3Max 3

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

    CUR-08
    373
    Date
    Optional
    CCYYMMDD format

    Date expressed as CCYYMMDD

    REF
    050

    Reference Identification

    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

    Code qualifying the Reference Identification

    12
    Billing Account
    BM
    Bill of Lading Number
    CN
    Carrier's Reference Number (PRO/Invoice)
    CR
    Customer Reference Number
    EU
    End User's Purchase Order Number
    MA
    Ship Notice/Manifest Number
    PG
    Product Group
    PK
    Packing List Number
    SA
    Salesperson
    ST
    Store Number
    VN
    Vendor Order Number
    VR
    Vendor ID Number
    ZZ
    Mutually Defined
    REF-02
    127
    Reference Identification
    Optional
    Min 1Max 30

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

    REF-03
    352
    Description
    Optional
    Min 1Max 80

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

    PER
    060

    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
    PER-01
    366
    Contact Function Code
    Required

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

    AP
    Accounts Payable Department
    AR
    Accounts Receivable Department
    BD
    Buyer Name or Department
    IC
    Information Contact
    RE
    Receiving Contact
    SR
    Sales Representative or Department
    PER-02
    93
    Name
    Optional
    Min 1Max 60

    Free-form name

    PER-03
    365
    Communication Number Qualifier
    Optional

    Code identifying the type of communication number

    EM
    Electronic Mail
    FX
    Facsimile
    TE
    Telephone
    PER-04
    364
    Communication Number
    Optional
    Min 1Max 80

    Complete communications number including country or area code when applicable

    N1 Loop
    OptionalMax >1
    N1
    070

    Name

    RequiredMax use 1

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

    Example
    At least one of Name (N1-02) or Identification Code Qualifier (N1-03) is required
    If either Identification Code Qualifier (N1-03) or Identification Code (N1-04) is present, then the other is required
    N1-01
    98
    Entity Identifier Code
    Required

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

    BS
    Bill and Ship To
    BT
    Bill-to-Party
    RE
    Party to receive commercial invoice remittance
    SF
    Ship From
    ST
    Ship To
    N1-02
    93
    Name
    Optional
    Min 1Max 60

    Free-form name

    N1-03
    66
    Identification Code Qualifier
    Optional

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

    91
    Assigned by Seller or Seller's Agent
    92
    Assigned by Buyer or Buyer's Agent
    N1-04
    67
    Identification Code
    Optional
    Min 2Max 80

    Code identifying a party or other code

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

    Additional Name Information

    OptionalMax use 2

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

    Example
    N2-01
    93
    Name
    Required
    Min 1Max 60

    Free-form name

    N2-02
    93
    Name
    Optional
    Min 1Max 60

    Free-form name

    N3
    090

    Address Information

    OptionalMax use 2

    To specify the location of the named party

    Example
    N3-01
    166
    Address Information
    Required
    Min 1Max 55

    Address information

    N3-02
    166
    Address Information
    Optional
    Min 1Max 55

    Address information

    N4
    100

    Geographic Location

    OptionalMax use 1

    To specify the geographic place of the named party

    Example
    If Location Identifier (N4-06) is present, then Location Qualifier (N4-05) is required
    N4-01
    19
    City Name
    Optional
    Min 2Max 30

    Free-form text for city name

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

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

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

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

    N4-04
    26
    Country Code
    Optional
    Min 2Max 3

    Code identifying the country

    N4-05
    309
    Location Qualifier
    Optional

    Code identifying type of location

    94
    Receiver's Location Code
    N4-06
    310
    Location Identifier
    Optional
    Min 1Max 30

    Code which identifies a specific location

    ITD
    130

    Terms of Sale/Deferred Terms of Sale

    OptionalMax use >1

    To specify terms of sale

    Example
    If Terms Deferred Due Date (ITD-09) is present, then at least one of Deferred Amount Due (ITD-10) or Percent of Invoice Payable (ITD-11) is required
    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

    Code identifying type of payment terms

    • If the code in ITD01 is "04", then ITD07 or ITD09 is required and either ITD10 or ITD11 is required; if the code in ITD01 is "05", then ITD06 or ITD07 is required.
    01
    Basic
    02
    End of Month (EOM)
    03
    Fixed Date
    04
    Deferred or Installment
    05
    Discount Not Applicable
    08
    Basic Discount Offered
    09
    Proximo
    12
    10 Days After End of Month (10 EOM)
    14
    Previously agreed upon
    17
    Terms not Applicable
    ZZ
    Mutually Defined
    ITD-02
    333
    Terms Basis Date Code
    Optional

    Code identifying the beginning of the terms period

    1
    Ship Date
    2
    Delivery Date
    3
    Invoice Date
    4
    Specified Date
    7
    Effective Date
    8
    Invoice Transmission Date
    09
    Purchase Order Date
    15
    Receipt of Goods
    ZZ
    Mutually Defined
    ITD-03
    338
    Terms Discount Percent
    Optional
    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

    ITD-04
    370
    Terms Discount Due Date
    Optional
    CCYYMMDD format

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

    ITD-05
    351
    Terms Discount Days Due
    Optional
    Min 1Max 3

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

    ITD-06
    446
    Terms Net Due Date
    Optional
    CCYYMMDD format

    Date when total invoice amount becomes due expressed in format CCYYMMDD

    ITD-07
    386
    Terms Net Days
    Optional
    Min 1Max 3

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

    ITD-08
    362
    Terms Discount Amount
    Optional
    Min 1Max 10

    Total amount of terms discount

    ITD-09
    388
    Terms Deferred Due Date
    Optional
    CCYYMMDD format

    Date deferred payment or percent of invoice payable is due expressed in format CCYYMMDD

    ITD-10
    389
    Deferred Amount Due
    Optional
    Min 1Max 10

    Deferred amount due for payment

    ITD-11
    342
    Percent of Invoice Payable
    Optional
    Min 1Max 5

    Amount of invoice payable expressed in percent

    ITD-12
    352
    Description
    Optional
    Min 1Max 80

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

    ITD-13
    765
    Day of Month
    Optional
    Min 1Max 2

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

    ITD-14
    107
    Payment Method Code
    Optional
    Min 1Max 2

    Code identifying type of payment procedures

    ITD-15
    954
    Percent
    Optional
    Min 1Max 10

    Percentage expressed as a decimal

    • ITD15 is the percentage applied to a base amount used to determine a late payment charge.
    DTM
    140

    Date/Time Reference

    OptionalMax use 10

    To specify pertinent dates and times

    Example
    DTM-01
    374
    Date/Time Qualifier
    Required

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

    011
    Shipped
    DTM-02
    373
    Date
    Optional
    CCYYMMDD format

    Date expressed as CCYYMMDD

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

    FOB
    150

    F.O.B. Related Instructions

    OptionalMax use 1

    To specify transportation instructions relating to shipment

    Example
    If Description (FOB-03) is present, then Location Qualifier (FOB-02) is required
    FOB-01
    146
    Shipment Method of Payment
    Required

    Code identifying payment terms for transportation charges

    • FOB01 indicates which party will pay the carrier.
    CC
    Collect
    PB
    Customer Pick-up/Backhaul
    PC
    Prepaid but Charged to Customer
    PO
    Prepaid Only
    PP
    Prepaid (by Seller)
    TP
    Third Party Pay
    FOB-02
    309
    Location Qualifier
    Optional

    Code identifying type of location

    • FOB02 is the code specifying transportation responsibility location.
    DE
    Destination (Shipping)
    OA
    Origin (After Loading on Equipment)
    OR
    Origin (Shipping Point)
    ZZ
    Mutually Defined
    FOB-03
    352
    Description
    Optional
    Min 1Max 80

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

    Detail

    IT1 Loop
    OptionalMax >1
    IT1
    010

    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 Unit or Basis for Measurement Code (IT1-03) or Unit Price (IT1-04) is present, then the other is required
    If either Product/Service ID Qualifier (IT1-06) or Product/Service ID (IT1-07) is present, then the other is required
    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-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
    If either Product/Service ID Qualifier (IT1-20) or Product/Service ID (IT1-21) is present, then the other is required
    If either Product/Service ID Qualifier (IT1-22) or Product/Service ID (IT1-23) is present, then the other is required
    If either Product/Service ID Qualifier (IT1-24) or Product/Service ID (IT1-25) is present, then the other is required
    IT1-01
    350
    Assigned Identification
    Optional
    Min 1Max 20

    Alphanumeric characters assigned for differentiation within a transaction set

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

    Line number from PO should be used here.

    IT1-02
    358
    Quantity Invoiced
    Optional
    Min 1Max 10

    Number of units invoiced (supplier units)

    IT1-03
    355
    Unit or Basis for Measurement Code
    Optional
    Min 2Max 2

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

    IT1-04
    212
    Unit Price
    Optional
    Min 1Max 15

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

    IT1-05
    639
    Basis of Unit Price Code
    Optional
    Min 2Max 2

    Code identifying the type of unit price for an item

    IT1-06
    235
    Product/Service ID Qualifier
    Optional

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

    • IT106 through IT125 provide for ten different product/service IDs for each item. For example: Case, Color, Drawing No., U.P.C. No., ISBN No., Model No., or SKU.
    BP
    Buyer's Part Number
    IT1-07
    234
    Product/Service ID
    Optional
    Min 1Max 48

    Identifying number for a product or service

    IT1-08
    235
    Product/Service ID Qualifier
    Optional

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

    VP
    Vendor's (Seller's) Part Number
    IT1-09
    234
    Product/Service ID
    Optional
    Min 1Max 48

    Identifying number for a product or service

    IT1-10
    235
    Product/Service ID Qualifier
    Optional

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

    UP
    U.P.C. Consumer Package Code (1-5-5-1)
    IT1-11
    234
    Product/Service ID
    Optional
    Min 1Max 48

    Identifying number for a product or service

    IT1-12
    235
    Product/Service ID Qualifier
    Optional

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

    MF
    Manufacturer

    Return if sent on PO.

    IT1-13
    234
    Product/Service ID
    Optional
    Min 1Max 48

    Identifying number for a product or service

    IT1-14
    235
    Product/Service ID Qualifier
    Optional

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

    CH
    Country of Origin Code
    IT1-15
    234
    Product/Service ID
    Optional
    Min 1Max 48

    Identifying number for a product or service

    IT1-16
    235
    Product/Service ID Qualifier
    Optional

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

    PO
    Purchase Order Number
    IT1-17
    234
    Product/Service ID
    Optional
    Min 1Max 48

    Identifying number for a product or service

    IT1-18
    235
    Product/Service ID Qualifier
    Optional

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

    RP
    Replaced Part Number
    IT1-19
    234
    Product/Service ID
    Optional
    Min 1Max 48

    Identifying number for a product or service

    IT1-20
    235
    Product/Service ID Qualifier
    Optional

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

    SS
    Superseded Part Number
    IT1-21
    234
    Product/Service ID
    Optional
    Min 1Max 48

    Identifying number for a product or service

    IT1-22
    235
    Product/Service ID Qualifier
    Optional
    Min 2Max 2

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

    IT1-23
    234
    Product/Service ID
    Optional
    Min 1Max 48

    Identifying number for a product or service

    IT1-24
    235
    Product/Service ID Qualifier
    Optional
    Min 2Max 2

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

    IT1-25
    234
    Product/Service ID
    Optional
    Min 1Max 48

    Identifying number for a product or service

    QTY
    015

    Backorder Quantity

    OptionalMax use 5

    To specify quantity information

    • The QTY segment is used to specify a quantity of units which are expected as payments, e.g., trade-ins or returns.
    Example
    Variants (all may be used)
    QTYOriginal Quantity
    QTY-01
    673
    Quantity Qualifier
    Required

    Code specifying the type of quantity

    BQ
    Backorder Quantity
    QTY-02
    380
    Quantity
    Optional
    Min 1Max 15

    Numeric value of quantity

    QTY
    015

    Original Quantity

    OptionalMax use 5

    To specify quantity information

    • The QTY segment is used to specify a quantity of units which are expected as payments, e.g., trade-ins or returns.
    Example
    Variants (all may be used)
    QTYBackorder Quantity
    QTY-01
    673
    Quantity Qualifier
    Required

    Code specifying the type of quantity

    38
    Original Quantity
    QTY-02
    380
    Quantity
    Optional
    Min 1Max 15

    Numeric value of quantity

    CTP
    050

    Pricing Information

    OptionalMax use 25

    To specify pricing information

    Example
    CTP-01
    687
    Class of Trade Code
    Optional

    Code indicating class of trade

    MF
    Manufacturer
    CTP-02
    236
    Price Identifier Code
    Optional

    Code identifying pricing specification

    DSC
    Discount Amount Allowed
    CTP-03
    212
    Unit Price
    Optional
    Min 1Max 15

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

    • See Figures Appendix for an example detailing the use of CTP03 and CTP04.
    • See Figures Appendix for an example detailing the use of CTP03, CTP04 and CTP07.
    PID Loop
    OptionalMax >1
    PID
    060

    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

    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-05
    352
    Description
    Optional
    Min 1Max 80

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

    PO4
    100

    Item Physical Details

    OptionalMax use 1

    To specify the physical qualities, packaging, weights, and dimensions relating to the item

    Example
    PO4-01
    356
    Pack
    Optional
    Min 1Max 6

    The number of inner containers, or number of eaches if there are no inner containers, per outer container

    REF
    120

    Reference Identification

    OptionalMax use >1

    To specify identifying information

    Example
    REF-01
    128
    Reference Identification Qualifier
    Required

    Code qualifying the Reference Identification

    PK
    Packing List Number
    REF-02
    127
    Reference Identification
    Optional
    Min 1Max 30

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

    SAC Loop
    OptionalMax >1
    SAC
    180

    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
    At least one of Service, Promotion, Allowance, or Charge Code (SAC-02) or Agency Qualifier Code (SAC-03) is required
    If either Agency Qualifier Code (SAC-03) or Agency Service, Promotion, Allowance, or Charge Code (SAC-04) is present, then the other is required
    If either Allowance/Charge Percent Qualifier (SAC-06) or Percent (SAC-07) is present, then the other is required
    If either Unit or Basis for Measurement Code (SAC-09) or Quantity (SAC-10) is present, then the other is required
    If Quantity (SAC-11) is present, then Quantity (SAC-10) is required
    If Reference Identification (SAC-13) is present, then at least one of Service, Promotion, Allowance, or Charge Code (SAC-02) or Agency Service, Promotion, Allowance, or Charge Code (SAC-04) is required
    If Option Number (SAC-14) is present, then Reference Identification (SAC-13) is required
    If Language Code (SAC-16) is present, then Description (SAC-15) is required
    SAC-01
    248
    Allowance or Charge Indicator
    Required

    Code which indicates an allowance or charge for the service specified

    • If SAC01 is "A" or "C", then at least one of SAC05, SAC07, or SAC08 is required.
    A
    Allowance
    C
    Charge
    SAC-02
    1300
    Service, Promotion, Allowance, or Charge Code
    Optional
    Min 4Max 4

    Code identifying the service, promotion, allowance, or charge

    SAC-03
    559
    Agency Qualifier Code
    Optional
    Min 2Max 2

    Code identifying the agency assigning the code values

    SAC-04
    1301
    Agency Service, Promotion, Allowance, or Charge Code
    Optional
    Min 1Max 10

    Agency maintained code identifying the service, promotion, allowance, or charge

    • SAC04 may be used to uniquely identify the service, promotion, allowance, or charge. In addition, it may be used in conjunction to further the code in SAC02.
    SAC-05
    610
    Amount
    Optional
    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.
    SAC-06
    378
    Allowance/Charge Percent Qualifier
    Optional

    Code indicating on what basis allowance or charge percent is calculated

    3
    Discount/Gross
    Z
    Mutually Defined
    SAC-07
    332
    Percent
    Optional
    Min 1Max 6

    Percent expressed as a percent

    SAC-08
    118
    Rate
    Optional
    Min 1Max 9

    Rate expressed in the standard monetary denomination for the currency specified

    • SAC08 is the allowance or charge rate per unit.
    SAC-09
    355
    Unit or Basis for Measurement Code
    Optional

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

    EA
    Each
    SAC-10
    380
    Quantity
    Optional
    Min 1Max 15

    Numeric value of quantity

    • SAC10 and SAC11 is the quantity basis when the allowance or charge quantity is different from the purchase order or invoice quantity.
    • SAC10 and SAC11 used together indicate a quantity range, which could be a dollar amount, that is applicable to service, promotion, allowance, or charge.
    • In some business applications, it is necessary to advise the trading partner of the actual dollar amount that a particular allowance, charge, or promotion was based on to reduce ambiguity. This amount is commonly referred to as "Dollar Basis Amount". It is represented in the SAC segment in SAC10 using the qualifier "DO" - Dollars in SAC09.
    SAC-11
    380
    Quantity
    Optional
    Min 1Max 15

    Numeric value of quantity

    SAC-12
    331
    Allowance or Charge Method of Handling Code
    Optional

    Code indicating method of handling for an allowance or charge

    02
    Off Invoice
    06
    Charge to be Paid by Customer
    ZZ
    Mutually Defined
    SAC-13
    127
    Reference Identification
    Optional
    Min 1Max 30

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

    • SAC13 is used in conjunction with SAC02 or SAC04 to provide a specific reference number as identified by the code used.
    SAC-14
    770
    Option Number
    Optional
    Min 1Max 20

    A unique number identifying available promotion or allowance options when more than one is offered

    • SAC14 is used in conjunction with SAC13 to identify an option when there is more than one option of the promotion.
    SAC-15
    352
    Description
    Optional
    Min 1Max 80

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

    SAC-16
    819
    Language Code
    Optional
    Min 2Max 3

    Code designating the language used in text, from a standard code list maintained by the International Standards Organization (ISO 639)

    • SAC16 is used to identify the language being used in SAC15.

    Summary

    TDS
    010

    Total Monetary Value Summary

    RequiredMax use 1

    To specify the total invoice discounts and amounts

    Example
    TDS-01
    610
    Amount
    Required
    Min 1Max 15

    Monetary amount

    • TDS01 is the total amount of invoice (including charges, less allowances) before terms discount (if discount is applicable).
    TDS-02
    610
    Amount
    Optional
    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.
    TDS-03
    610
    Amount
    Optional
    Min 1Max 15

    Monetary amount

    • TDS03 is the amount of invoice due if paid by terms discount due date (total invoice or installment amount less cash discount).
    TDS-04
    610
    Amount
    Optional
    Min 1Max 15

    Monetary amount

    • TDS04 indicates the total amount of terms discount.
    TXI
    020

    Tax Information

    OptionalMax use 10

    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), Percent (TXI-03) or Tax Exempt Code (TXI-06) is required
    If Dollar Basis For Percent (TXI-08) is present, then Percent (TXI-03) is required
    TXI-01
    963
    Tax Type Code
    Required

    Code specifying the type of tax

    EV
    Environmental Tax
    FD
    Federal Tax
    FT
    Federal Excise Tax
    GS
    Goods and Services Tax
    OH
    Other Taxes
    PG
    State or Provincial Tax on Goods
    SA
    State or Provincial Fuel Tax
    SL
    State and Local Tax
    SP
    State/Provincial Tax
    ST
    State Sales Tax
    TXI-02
    782
    Monetary Amount
    Optional
    Min 1Max 15

    Monetary amount

    • TXI02 is the monetary amount of the tax.
    TXI-03
    954
    Percent
    Optional
    Min 1Max 10

    Percentage expressed as a decimal

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

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

    TXI-05
    956
    Tax Jurisdiction Code
    Optional

    Code identifying the taxing jurisdiction

    AB
    Alberta
    BC
    British Columbia
    MB
    Manitoba
    NB
    New Brunswick
    NF
    Newfoundland
    NS
    Nova Scotia
    NT
    Northwest Territories
    ON
    Ontario
    PE
    Prince Edward Island
    QC
    Quebec
    SK
    Saskatchewan
    YT
    Yukon
    TXI-06
    441
    Tax Exempt Code
    Optional

    Code identifying exemption status from sales and use tax

    G
    Exempt (Provincial Sales Tax)
    TXI-07
    662
    Relationship Code
    Optional
    Min 1Max 1

    Code indicating the relationship between entities

    • TXI07 is a code indicating the relationship of the price or amount to the associated segment.
    TXI-08
    828
    Dollar Basis For Percent
    Optional
    Min 1Max 9

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

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

    TXI-10
    350
    Assigned Identification
    Optional
    Min 1Max 20

    Alphanumeric characters assigned for differentiation within a transaction set

    CAD
    030

    Carrier Detail

    OptionalMax use 1

    To specify transportation details for the transaction

    Example
    At least one of Standard Carrier Alpha Code (CAD-04) or Routing (CAD-05) is required
    If Reference Identification Qualifier (CAD-07) is present, then Reference Identification (CAD-08) is required
    CAD-01
    91
    Transportation Method/Type Code
    Optional

    Code specifying the method or type of transportation for the shipment

    7
    Mail
    A
    Air
    AE
    Air Express
    AF
    Air Freight
    M
    Motor (Common Carrier)
    T
    Best Way (Shippers Option)
    U
    Private Parcel Service
    ZZ
    Mutually defined
    CAD-03
    207
    Equipment Number
    Optional
    Min 1Max 10

    Sequencing or serial part of an equipment unit's identifying number (pure numeric form for equipment number is preferred)

    CAD-04
    140
    Standard Carrier Alpha Code
    Optional
    Min 2Max 4

    Standard Carrier Alpha Code

    CAD-05
    387
    Routing
    Optional
    Min 1Max 35

    Free-form description of the routing or requested routing for shipment, or the originating carrier's identity

    CAD-07
    128
    Reference Identification Qualifier
    Optional

    Code qualifying the Reference Identification

    Usage notes

    If sent in the REF will map to this location.

    BN
    Booking Number
    CN
    Carrier's Reference Number (PRO/Invoice)
    CAD-08
    127
    Reference Identification
    Optional
    Min 1Max 30

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

    AMT
    035

    Monetary Amount

    OptionalMax use >1

    To indicate the total monetary amount

    Example
    AMT-01
    522
    Amount Qualifier Code
    Required

    Code to qualify amount

    1
    Line Item Total
    T
    Tax
    TT
    Total Transaction Amount
    ZZ
    Mutually Defined
    AMT-02
    782
    Monetary Amount
    Required
    Min 1Max 15

    Monetary amount

    AMT-03
    478
    Credit/Debit Flag Code
    Optional
    Min 1Max 1

    Code indicating whether amount is a credit or debit

    SAC Loop
    OptionalMax >1
    SAC
    040

    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
    If either Allowance/Charge Percent Qualifier (SAC-06) or Percent (SAC-07) is present, then the other is required
    SAC-01
    248
    Allowance or Charge Indicator
    Required

    Code which indicates an allowance or charge for the service specified

    • If SAC01 is "A" or "C", then at least one of SAC05, SAC07, or SAC08 is required.
    A
    Allowance
    C
    Charge
    SAC-02
    1300
    Service, Promotion, Allowance, or Charge Code
    Optional
    Min 4Max 4

    Code identifying the service, promotion, allowance, or charge

    SAC-05
    610
    Amount
    Optional
    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.
    SAC-06
    378
    Allowance/Charge Percent Qualifier
    Optional

    Code indicating on what basis allowance or charge percent is calculated

    3
    Discount/Gross
    SAC-07
    332
    Percent
    Optional
    Min 1Max 6

    Percent expressed as a percent

    SAC-08
    118
    Rate
    Optional
    Min 1Max 9

    Rate expressed in the standard monetary denomination for the currency specified

    • SAC08 is the allowance or charge rate per unit.
    SAC-12
    331
    Allowance or Charge Method of Handling Code
    Optional

    Code indicating method of handling for an allowance or charge

    02
    Off Invoice
    06
    Charge to be Paid by Customer
    SAC-15
    352
    Description
    Optional
    Min 1Max 80

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

    ISS Loop
    OptionalMax >1
    ISS
    060

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

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

    EA
    Each
    ISS-03
    81
    Weight
    Optional
    Min 1Max 10

    Numeric value of weight

    ISS-04
    355
    Unit or Basis for Measurement Code
    Optional

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

    LB
    Pound
    CTT
    070

    Transaction Totals

    OptionalMax use 1

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

    • Number of line items (CTT01) is the accumulation of the number of IT1 segments.
      If used, hash total (CTT02) is the sum of the value of quantities invoiced (IT102) for each IT1 segment.
    Example
    CTT-01
    354
    Number of Line Items
    Required
    Min 1Max 6

    Total number of line items in the transaction set

    CTT-02
    347
    Hash Total
    Optional
    Min 1Max 10

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

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

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

    SE
    080

    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
    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
    Min 4Max 9

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

    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
    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
    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
    Min 1Max 5

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

    IEA-02
    I12
    Interchange Control Number
    Required
    Min 9Max 9

    A control number assigned by the interchange sender

    EDI Samples

    Sample

    BIG*20090903*7777777*20090825*555555*123**DR*00
    NTE*ZZZ*INVOICE NOTES HERE
    CUR*ZZ*CUR*1.200****ZZZ*20100101
    REF*BM*061149554563379
    REF*PK*1384324004*PACKING LIST
    PER*AR*ACCOUNTS RECEIVABLE CONTACT*TE*5555555555
    N1*ST*SHIP TO NAME*92*SHIP TO CODE
    N3*44444 INDUSTRY LANE*BUILDING A
    N4*WINTER PARK*OH*55555*US*94*0001
    N1*BT*BILL TO NAME*92*BILL TO CODE
    N2*BILL TO NAME 2*BILL TO NAME 3
    N3*BILL TO ADDRESS 1*BILL TO ADDRESS 2
    N3*PO BOX 12345*BIN 1
    N4*SPRINGVILLE*OH*44444
    N1*SF*SHIP FROM NAME*92*SHIP FROM CODE
    N3*3456 PECAN GROVE RD
    N4*DIXON*GA*23232
    N1*RE*REMIT TO NAME*92*REMIT TO CODE
    N3*P O BOX 111111
    N4*ATLANTA*GA*30368
    ITD*01*3*2.00*20100131*15*20100228*30*5*20100315*5*100*2% 2ND 15TH*15*E*10
    DTM*011*20090903*1200
    FOB*PP*DE*DESTINATION
    IT1*1*5*EA*2.1*PE*BP*BUY PART 1*VP*VEN PART 1***MF*ABC*CH*US*PO*555555*RP*ORIG BP 1
    QTY*38*5
    CTP*MF*DSC*2.1
    PID*F****PART 1 DESCRIPTION
    PO4*1
    REF*PK*88888
    SAC*A*A260*ZZ*AGENCY**Z*1*1*EA*1*10*02*123456*654321*ADVERTISING ALLOWANCE*EN
    IT1*2*15*EA*8.88*PE*BP*BUY PART 2*VP*VEN PART 2*UP*123456789321*********SS*ORIG BP 1
    PID*F****PART 2 DESCRIPTION
    TDS*999*1010*999*100
    TXI*SP*2.2*3*CD*ON*G*O*75*444444444*111111
    CAD*M**11111*FDEX*FEDEX GROUND**CN*TRACKING NUMBER
    AMT*1*999*D
    SAC*A*E750***862*******06***NEW STORE DISCOUNT
    ISS*20*EA*1*LB
    CTT*2*20

    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.