Amazon
/
Direct Fulfillment Purchase Order
  • Specification
  • EDI Inspector
Import
Stedi maintains this guide based on public documentation from Amazon. Contact Amazon for official EDI specifications. To report any errors in this guide, please contact us.
Go to EDI Guide Catalog
Amazon logo

X12 850 Direct Fulfillment Purchase Order

X12 Release 4010

This Draft Standard for Trial Use contains the format and establishes the data contents of the Purchase Order Transaction Set (850) 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 placement of purchase orders for goods and services. This transaction set should not be used to convey purchase order changes or purchase order acknowledgment information.

Delimiters
  • ~ Segment
  • * Element
  • > Component
EDI samples
    View the latest version of this implementation guide as an interactive webpage
    Powered by
    Build free 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
    BEG
    020
    Beginning Segment for Purchase Order
    Max use 1
    Required
    CUR
    040
    Currency
    Max use 1
    Required
    REF
    050
    Order Number
    Max use 1
    Optional
    REF
    050
    Store Number
    Max use 1
    Optional
    DTM
    150
    Requested Ship
    Max use 10
    Optional
    DTM
    150
    Delivery Requested
    Max use 10
    Optional
    N9 Loop
    detail
    PO1 Loop
    PO1
    010
    Baseline Item Data
    Max use 1
    Required
    CTP Loop
    MSG
    289
    Title or Description of goods
    Max use 1
    Optional
    MSG
    290
    Gift Message
    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

    PO
    Purchase Order (850)
    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).
    850
    Purchase Order
    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

    BEG
    020

    Beginning Segment for Purchase Order

    RequiredMax use 1

    To indicate the beginning of the Purchase Order Transaction Set and transmit identifying numbers and dates

    Usage notes

    BEG^00^DS^TesT0008596^^20070808~

    Example
    BEG-01
    353
    Transaction Set Purpose Code
    Required

    Code identifying purpose of transaction set

    00
    Original
    BEG-02
    92
    Purchase Order Type Code
    Required

    Code specifying the type of Purchase Order

    DS
    Dropship

    Always "DS" for regular non-gift orders. Amazon-branded packing slip will include prices.

    SS
    Supply or Service Order

    Always "SS" for B2B Orders. This will be the indicator that the Amazon-branded packing slip should include prices.

    ZZ
    Mutually Defined

    Always "ZZ" for gift orders. This will be the indicator that the Amazon-branded packing slip should not include prices.

    BEG-03
    324
    Purchase Order Number
    Required
    Min 1Max 22

    Identifying number for Purchase Order assigned by the orderer/purchaser

    Usage notes

    This will be the Amazon encrypted Shipment ID, which is case sensitive. This number is unique - if a duplicate Shipment ID is ever received it should be rejected via the OFR (855).

    Format: AlphaNumeric

    Example: DjntsVrFN (Dj2sV3fN is a different Shipment ID than Dj2Sv3FN).

    This number should appear on the Amazon-branded packing slip and must be returned to Amazon in the OFR (855), ASN (856), and INV (810) messages.

    BEG-05
    373
    Date
    Required
    CCYYMMDD format

    Date expressed as CCYYMMDD

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

    This is the Order Date (CCYYMMDD) expressed in UTC format. This should appear on the packing slip.

    CUR
    040

    Currency

    RequiredMax use 1

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

    Usage notes

    CUR^BT^USD~

    Example
    CUR-01
    98
    Entity Identifier Code
    Required

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

    BT
    Bill-to-Party
    CUR-02
    100
    Currency Code
    Required

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

    USD
    US Dollar
    REF
    050

    Order Number

    OptionalMax use >1

    To specify identifying information

    Usage notes

    REF^OQ^100-0000000-3091800~

    Example
    Variants (all may be used)
    REFStore Number
    REF-01
    128
    Reference Identification Qualifier
    Required

    Code qualifying the Reference Identification

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

    Usage notes

    This will be the Amazon.com 19 digit Customer Order Number.

    Format: Numeric 3-7-7

    Example: 123-1234567-1234567
    *Dashes will be included.
    This number is NOT unique and may be used with more than one shipment. This number will appear on the packing slip and must be returned to Amazon in the INV (810) message.

    REF^OQ^100-0000000-3091800~

    REF
    050

    Store Number

    OptionalMax use >1

    To specify identifying information

    Usage notes

    REF^ST^1~

    Example
    Variants (all may be used)
    REFOrder Number
    REF-01
    128
    Reference Identification Qualifier
    Required

    Code qualifying the Reference Identification

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

    Usage notes

    This is an internal Amazon.com code representing the web-site where the customer order was placed. This value does not need to be returned to Amazon in any other messages.

    DTM
    150

    Requested Ship

    OptionalMax use 10

    To specify pertinent dates and times

    Usage notes

    Date/Time that order is expected to be shipped. Also known as Requested Ship date or Expected Ship date (ExSD).

    DTM^010^20180330^1200*GM~

    Example
    Variants (all may be used)
    DTMDelivery Requested
    If Time Code (DTM-04) is present, then Time (DTM-03) is required
    DTM-01
    374
    Date/Time Qualifier
    Required

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

    010
    Requested Ship
    DTM-02
    373
    Date
    Optional
    CCYYMMDD format

    Date expressed as CCYYMMDD

    Usage notes

    Date expressed 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)

    Usage notes

    Time expressed HHMM.

    DTM-04
    623
    Time Code
    Optional

    Code identifying the time. In accordance with International Standards Organization standard 8601, time can be specified by a + or - and an indication in hours in relation to Universal Time Coordinate (UTC) time; since + is a restricted character, + and - are substituted by P and M in the codes that follow

    GM
    Greenwich Mean Time
    DTM
    150

    Delivery Requested

    OptionalMax use 10

    To specify pertinent dates and times

    Usage notes

    Date/Time that order is expected to be Delivered. Also known as Delivery Requested date or Promised Delivery date (PDD).

    DTM^002^20180405^1200*GM~

    Example
    Variants (all may be used)
    DTMRequested Ship
    If Time Code (DTM-04) is present, then Time (DTM-03) is required
    DTM-01
    374
    Date/Time Qualifier
    Required

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

    002
    Delivery Requested
    DTM-02
    373
    Date
    Optional
    CCYYMMDD format

    Date expressed as CCYYMMDD

    Usage notes

    Date expressed 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)

    Usage notes

    Time expressed HHMM.

    DTM-04
    623
    Time Code
    Optional

    Code identifying the time. In accordance with International Standards Organization standard 8601, time can be specified by a + or - and an indication in hours in relation to Universal Time Coordinate (UTC) time; since + is a restricted character, + and - are substituted by P and M in the codes that follow

    GM
    Greenwich Mean Time
    N9 Loop
    RequiredMax >1
    N9
    295

    Reference Identification

    RequiredMax use 1

    To transmit identifying information as specified by the Reference Identification Qualifier

    Usage notes

    N9^ZZ^01~

    Example
    N9-01
    128
    Reference Identification Qualifier
    Required

    Code qualifying the Reference Identification

    ZZ
    Mutually Defined
    N9-02
    127
    Reference Identification
    Optional

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

    01
    This shipment completes your order.
    02
    We've sent this part of your order to ensure quicker service. The other items will ship separately at not additional shipping cost.
    03
    As you requested, we've sent this part of your order to ensure quicker service. The other items will ship separately.
    04
    This shipment represents part of your gift. The other portion of your gift is shipping separately.
    05
    We hope you enjoy your gift, and we'd love to see you soon at www.amazon.com.
    06
    For detailed information about your orders, please visit Your Account. You can also print invoices, change your email address and payment settings, alter your communication preferences, and much more - 24 hours a day - at http://www.amazon.com/your-account.
    07
    Visit http://www.amazon.com/returns to return any item - including gifts - in unopened or original condition within 30 days for a full refund (other restrictions apply). Please have your order ID ready. Thanks for shopping at Amazon.com, and please come again!
    MSG
    300

    Message Text

    RequiredMax use 1000

    To provide a free-form format that allows the transmission of text information

    Usage notes

    MSG^This shipment completes your order.~

    Example
    MSG-01
    933
    Free-Form Message Text
    Required
    Min 1Max 264

    Free-form message text

    Usage notes

    Text of Order Status Message, related to Order Status Message Code. The most current order status message will be provided by Amazon.com

    If 01 then Order Status Message = This shipment completes your order.

    If 02 then Order Status Message = We've sent this part of your order to ensure quicker service. The other items will ship separately at not additional shipping cost.

    If 03 then Order Status Message = As you requested, we've sent this part of your order to ensure quicker service. The other items will ship separately.

    If 04 then Order Status Message = This shipment represents part of your gift. The other portion of your gift is shipping separately.

    If 05 then Order Status Message = We hope you enjoy your gift, and we'd love to see you soon at www.amazon.com.

    If 06 then Order Status Message = For detailed information about your orders, please visit Your Account. You can also print invoices, change your email address and payment settings, alter your communication preferences, and much more - 24 hours a day - at http://www.amazon.com/your-account.

    If 07 then Order Status Message = Visit http://www.amazon.com/returns to return any item - including gifts - in unopened or original condition within 30 days for a full refund (other restrictions apply). Please have your order ID ready. Thanks for shopping at Amazon.com, and please come again!

    This will appear on the Amazon-branded packing slip.

    N1 Bill-to-Party
    RequiredMax >1
    Variants (all may be used)
    N1Ship FromN1Ship ToN1Customer
    N1
    310

    Name

    RequiredMax use 1

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

    Usage notes

    N1^BT^Amazon.com.kydc,Inc.^92^KYDC~

    Example
    N1-01
    98
    Entity Identifier Code
    Required

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

    BT
    Bill-to-Party
    N1-02
    93
    Name
    Required
    Min 1Max 60

    Free-form name

    Usage notes

    This will be the name of the Amazon location to bill for goods and services. This may vary by FC. May vary by order (e.g. Amazon.com.kydc.Inc).

    N1-03
    66
    Identification Code Qualifier
    Required

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

    92
    Assigned by Buyer or Buyer's Agent
    N1-04
    67
    Identification Code
    Required

    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.
    KYDC
    Amazon.com.kydc, Inc
    NVDC
    Fulfill.tnds, Inc
    TNDS
    Amazon.com.nvdc, Inc
    N1 Ship From
    RequiredMax >1
    Variants (all may be used)
    N1Bill-to-PartyN1Ship ToN1Customer
    N1
    310

    Name

    RequiredMax use 1

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

    Usage notes

    N1^SF^ABCD^92^ABCD~

    Example
    N1-01
    98
    Entity Identifier Code
    Required

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

    SF
    Ship From
    N1-02
    93
    Name
    Required
    Min 1Max 60

    Free-form name

    Usage notes

    This will be the Amazon code representing the warehouse that the order should ship from. This is usually a four character alpha code (e.g. ABCD).

    N1-03
    66
    Identification Code Qualifier
    Required

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

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

    Code identifying a party or other code

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

    This will be the Amazon code representing the warehouse that the order should ship from. This is usually a four character alpha code (e.g. ABCD). Same as N102.

    N1 Ship To
    RequiredMax >1
    Variants (all may be used)
    N1Bill-to-PartyN1Ship FromN1Customer
    N1
    310

    Name

    RequiredMax use 1

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

    Usage notes

    N1^ST^Harry Potter~

    Example
    N1-01
    98
    Entity Identifier Code
    Required

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

    ST
    Ship To
    N1-02
    93
    Name
    Required
    Min 1Max 50

    Free-form name

    Usage notes

    Ship To Name. This is a free form text field and may contain special characters (standard UTF8). Max length is 50 characters. This should appear on the Amazon-branded packing slip.

    N2
    320

    Additional Name Information

    OptionalMax use 2

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

    Usage notes

    N2^Darla Dinkins~

    Example
    N2-01
    93
    Name
    Required
    Min 1Max 50

    Free-form name

    Usage notes

    Ship To Attention. This is a free form text field and may contain special characters (standard UTF8). Max length is 50 characters. This should appear on the Amazon-branded packing slip.

    If Ship To Attention is not provided by the customer, but Address Line 3 is provided, N201 will contain a space and N202 will contain Address Line 3.

    N2-02
    93
    Name
    Optional
    Min 1Max 60

    Free-form name

    Usage notes

    Ship To Address Line 3. This is a free form text field and may contain special characters (standard UTF8). Max length is 60 characters. This should appear on the Amazon-branded packing slip.

    N3
    330

    Address Information

    RequiredMax use 2

    To specify the location of the named party

    Usage notes

    N3^4 Privet Drive~

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

    Address information

    Usage notes

    Ship To Address Line 1. This is a free form text field and may contain special characters (standard UTF8). Max length is 60 characters. This should appear on the Amazon-branded packing slip.

    N3-02
    166
    Address Information
    Optional
    Min 1Max 60

    Address information

    Usage notes

    Ship To Address Line 2. This is a free form text field and may contain special characters (standard UTF8). Max length is 60 characters. This should appear on the Amazon-branded packing slip.

    N4
    340

    Geographic Location

    RequiredMax use >1

    To specify the geographic place of the named party

    Usage notes

    N4^Little Whinging^CA^90033-4310^US^CC^United States~

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

    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 Name. Max length is 50 characters. This should appear on the Amazon-branded packing slip.

    N4-02
    156
    State or Province Code
    Required
    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 or Province. This should appear on the Amazon-branded packing slip.

    N4-03
    116
    Postal Code
    Required
    Min 3Max 15

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

    Usage notes

    Ship To Postal Code. Max length is 15 characters. This should appear on the Amazon-branded packing slip.

    N4-04
    26
    Country Code
    Required
    Min 2Max 3

    Code identifying the country

    Usage notes

    Ship To Country Code. ISO 2 character country code will be used. This should appear on the Amazon-branded packing slip.

    N4-05
    309
    Location Qualifier
    Optional

    Code identifying type of location

    CC
    Country
    N4-06
    310
    Location Identifier
    Optional
    Min 1Max 30

    Code which identifies a specific location

    Usage notes

    Ship To Country Name. Max length is 30 characters.

    TD5
    390

    Carrier Details (Routing Sequence/Transit Time)

    RequiredMax use 12

    To specify the carrier and sequence of routing and provide transit time information

    Usage notes

    TD5^^92^UPS_DOM_3DAY_RES^^^^ZZ^RES~

    Example
    If Location Qualifier (TD5-07) is present, then Location Identifier (TD5-08) is required
    TD5-02
    66
    Identification Code Qualifier
    Required

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

    • When specifying a routing sequence to be used for the shipment movement in lieu of specifying each carrier within the movement, use TD502 to identify the party responsible for defining the routing sequence, and use TD503 to identify the actual routing sequence, specified by the party identified in TD502.
    92
    Assigned by Buyer or Buyer's Agent
    TD5-03
    67
    Identification Code
    Required
    Min 2Max 80

    Code identifying a party or other code

    Usage notes

    Amazon.com defined Ship Method Codes indicating shipping carrier and shipment service level. Ship Method Codes are case and format sensitive. The Ship Method Code sent in the 850 should be the same Ship Method Code returned in the corresponding 856.

    Ship Method Codes are vendor specific and will be provided to each vendor during the implementation process.

    Value examples:
    USPS_DS (Priority Mail)
    USPS_SMART_MAIL
    UPS_2ND
    UPS_DOM_3DAY_RES
    UPS_GR_COM
    UPS_GR_RES
    UPS_NEXT
    UPS_NEXT_SAVER
    FEDEX_NEXT_PRI
    FEDEX_NEXT_STD
    FEDEX_SECOND
    FEDEX_3DAY

    To see the full list of ship methods in use -- including both the code and the friendly name -- search the Help section on 'ship methods'.

    TD5-07
    309
    Location Qualifier
    Optional

    Code identifying type of location

    ZZ
    Mutually Defined
    TD5-08
    310
    Location Identifier
    Optional
    Min 1Max 30

    Code which identifies a specific location

    Usage notes

    This field specifies the "Ship to Address Type".

    N1 Customer
    RequiredMax >1
    Variants (all may be used)
    N1Bill-to-PartyN1Ship FromN1Ship To
    N1
    310

    Name

    RequiredMax use 1

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

    Usage notes

    N1^LW^Lord Voldemort~

    Example
    N1-01
    98
    Entity Identifier Code
    Required

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

    LW
    Customer
    N1-02
    93
    Name
    Required
    Min 1Max 50

    Free-form name

    Usage notes

    Customer Bill To Name. This is a free form text field and may contain special characters (standard UTF8). Max length is 50 characters. This should appear on the Amazon-branded packing slip.

    N2
    320

    Additional Name Information

    OptionalMax use 2

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

    Usage notes

    N2^Darla Hopkins~

    Example
    N2-01
    93
    Name
    Required
    Min 1Max 60

    Free-form name

    Usage notes

    Customer Bill To Address Line 3. This is a free from text field and may contain special characters (standard UTF8). Max length is 60 characters. This should appear on the Amazon-branded packing slip. Note: Bill To Address can be International.

    N2-02
    93
    Name
    Optional
    Min 1Max 60

    Free-form name

    N3
    330

    Address Information

    RequiredMax use 2

    To specify the location of the named party

    Usage notes

    N3^4 Privet Drive~

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

    Address information

    Usage notes

    Customer Bill To Address Line 1. This is a free from text field and may contain special characters (standard UTF8). Max length is 60 characters. This should appear on the Amazon-branded packing slip.

    Bill To Address can be International.

    N3-02
    166
    Address Information
    Optional
    Min 1Max 60

    Address information

    Usage notes

    Customer Bill To Address Line 2. This is a free from text field and may contain special characters (standard UTF8). Max length is 60 characters. This should appear on the Amazon-branded packing slip.

    Bill To Address can be International.

    N4
    340

    Geographic Location

    RequiredMax use >1

    To specify the geographic place of the named party

    Usage notes

    N4^LOS ANGELES^CA^90033-4310^US~

    Example
    N4-01
    19
    City Name
    Required
    Min 2Max 50

    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

    Customer Bill To City Name. Max length is 50 characters. This should appear on the Amazon-branded packing slip.

    Bill To Address can be International.

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

    Customer Bill To State. This should appear on the Amazon-branded packing slip.

    Bill To Address can be International.

    N4-03
    116
    Postal Code
    Required
    Min 3Max 15

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

    Usage notes

    Customer Bill To Postal Code. Max length is 15 characters. This should appear on the Amazon-branded packing slip.

    Bill To Address can be International.

    N4-04
    26
    Country Code
    Required
    Min 2Max 3

    Code identifying the country

    Usage notes

    Customer Bill To Country Code. ISO 2 character country code will be used. This should appear on the Amazon-branded packing slip.

    Bill To Address can be International.

    PER
    360

    Administrative Communications Contact

    OptionalMax use >1

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

    Usage notes

    PER^ZZ^^^^TE^1212613979~

    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

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

    ZZ
    Mutually Defined
    PER-02
    93
    Name
    Optional
    Min 1Max 60

    Free-form name

    Usage notes

    Customer Bill To Party Name. This is a free form text field and may contain special characters (standard UTF8). This field is optional and only sent when provided by the customer.

    PER-03
    365
    Communication Number Qualifier
    Optional

    Code identifying the type of communication number

    EM
    Electronic Mail
    PER-04
    364
    Communication Number
    Optional
    Min 1Max 80

    Complete communications number including country or area code when applicable

    Usage notes

    Customer Bill To Party Email Address. This is a free form text field and may contain special characters (standard UTF8). This field is optional and only sent when provided by the customer.

    PER-05
    365
    Communication Number Qualifier
    Optional

    Code identifying the type of communication number

    TE
    Telephone
    PER-06
    364
    Communication Number
    Optional
    Min 1Max 80

    Complete communications number including country or area code when applicable

    Usage notes

    Customer Bill To Party Phone Number. This is a free form text field and may contain special characters (standard UTF8). This field is optional and only sent when provided by the customer.

    Detail

    PO1 Loop
    RequiredMax >1
    PO1
    010

    Baseline Item Data

    RequiredMax use 1

    To specify basic and most frequently used line item data

    • PO102 is required.
    Usage notes

    PO1^1^1^EA^6.35^NT^SK^1110007^^^TP^Kitchen^BL^1^ZZ^Amazon.com, LLC~

    Example
    If Basis of Unit Price Code (PO1-05) is present, then Unit Price (PO1-04) is required
    If either Product/Service ID Qualifier (PO1-12) or Product/Service ID (PO1-13) is present, then the other is required
    If either Product/Service ID Qualifier (PO1-10) or Product/Service ID (PO1-11) is present, then the other is required
    If either Product/Service ID Qualifier (PO1-08) or Product/Service ID (PO1-09) is present, then the other is required
    PO1-01
    350
    Assigned Identification
    Required
    Min 1Max 20

    Alphanumeric characters assigned for differentiation within a transaction set

    • PO101 is the line item identification.
    Usage notes

    Line Item ID. The Line Item ID must be retained and referred to in subsequent messages (855, 856, 810). This number is generally sequential (1, 2, 3, etc.).

    The combination of PO101 and PO107 should remain constant throughout the order cycle and across messages. Whenever the number in PO101 is used the information will reference the item in PO107.

    PO1-02
    330
    Quantity Ordered
    Required
    Min 1Max 15

    Quantity ordered

    Usage notes

    Quantity Ordered. This should appear on the p-slip.

    PO1-03
    355
    Unit or Basis for Measurement Code
    Required

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

    EA
    Each
    PO1-04
    212
    Unit Price
    Optional
    Min 1Max 15

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

    Usage notes

    This is Amazon's Expected Cost for the product, not including fulfillment charges.

    Format: Two Decimals (e.g. 9.00). This should Not be on the Amazon-branded packing slip.

    PO1-05
    639
    Basis of Unit Price Code
    Optional

    Code identifying the type of unit price for an item

    NT
    Net
    PO1-06
    235
    Product/Service ID Qualifier
    Required

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

    • PO106 through PO125 provide for ten different product/service IDs per each item. For example: Case, Color, Drawing No., U.P.C. No., ISBN No., Model No., or SKU.
    SK
    Stock Keeping Unit (SKU)
    PO1-07
    234
    Product/Service ID
    Required
    Min 1Max 48

    Identifying number for a product or service

    Usage notes

    This will be the Product ID of the item being ordered. This should appear on the Amazon-branded packing slip.

    Product ID's will vary by vendor and will be agreed upon before beginning the implementation process (SKU, UPC, ASIN, etc.).

    PO1-08
    235
    Product/Service ID Qualifier
    Optional

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

    B6
    Author Code
    PO1-09
    234
    Product/Service ID
    Optional
    Min 1Max 48

    Identifying number for a product or service

    Usage notes

    Author Name. This will only be sent when applicable. If sent, this should appear on the Amazon-branded packing slip.

    PO1-10
    235
    Product/Service ID Qualifier
    Optional

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

    B4
    Binding Code
    TP
    Product Type Code
    PO1-11
    234
    Product/Service ID
    Optional
    Min 1Max 48

    Identifying number for a product or service

    Usage notes

    This will be the Binding Description (e.g. Hardback). This will only be sent when applicable. If sent, this should appear on the Amazon-branded packing slip.

    PO1-12
    235
    Product/Service ID Qualifier
    Optional

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

    BL
    Brand/Label
    PO1-13
    234
    Product/Service ID
    Optional
    Min 1Max 48

    Identifying number for a product or service

    Usage notes

    This will be the Merchant Branding of the item. This value does not need to be printed on the Amazon-branded packing slip or returned to Amazon in any corresponding messages.

    PO1-14
    235
    Product/Service ID Qualifier
    Required

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

    ZZ
    Mutually Defined
    PO1-15
    234
    Product/Service ID
    Required
    Min 1Max 48

    Identifying number for a product or service

    Usage notes

    This will be the Seller Of Record of the item. This should appear on the Amazon-branded packing slip.

    CTP Loop
    OptionalMax >1
    CTP
    040

    Pricing Information

    RequiredMax use 1

    To specify pricing information

    Usage notes

    CTP^^PUR^14.17~

    Example
    CTP-02
    236
    Price Identifier Code
    Optional

    Code identifying pricing specification

    PUR
    Purchase
    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.
    Usage notes

    This will be the Amazon Price to Customer.

    Format: Two Decimals (e.g. 9.00). This will be in the currency expressed in CUR02. This should appear on the Amazon-branded packing slip.

    SAC Loop
    OptionalMax >1
    SAC
    130

    Service, Promotion, Allowance, or Charge Information

    RequiredMax use 1

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

    Usage notes

    SAC^S^B790^^^^^^^^^^^^^N~

    Example
    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.
    S
    Service
    SAC-02
    1300
    Service, Promotion, Allowance, or Charge Code
    Optional

    Code identifying the service, promotion, allowance, or charge

    B790
    Crafting
    SAC-15
    352
    Description
    Optional

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

    Usage notes

    This will be used to indicate Gift Wrap usage.

    Valid Values:
    Y - Yes, the item is to be gift wrapped
    N - No, the item is not to be gift wrapped

    If this segment is not sent, the item is not to be gift wrapped.

    N
    No, the item is not to be gift wrapped
    Y
    Yes, the item is to be gift wrapped
    MSG
    289

    Title or Description of goods

    OptionalMax use 1

    To provide a free-form format that allows the transmission of text information

    Usage notes

    Product description or book title to be printed at the line item level on the Amazon-branded packing slip

    Example:
    MSG^Designer Mug with Lid, Red~

    Example
    MSG-01
    933
    Free-Form Message Text
    Required
    Min 1Max 264

    Free-form message text

    Usage notes

    Title or Description of goods. May contain special characters (standard UTF8) Max length is 264. This should appear on the Amazon-branded packing slip.

    MSG
    290

    Gift Message

    OptionalMax use 1

    To provide a free-form format that allows the transmission of text information

    Usage notes

    Gift Message to be printed beneath line item on Amazon-branded packing slip

    Example:
    MSG^Happy Birthday, I hope you enjoy your gift!~

    Example
    MSG-01
    933
    Free-Form Message Text
    Required
    Min 1Max 264

    Free-form message text

    Usage notes

    This will be the Gift Message. This is a free form text field and may contain special characters (standard UTF8). This field is not edited, it is sent as the customer has entered it. Max length is 264 characters. This should appear on the Amazon-branded packing slip.

    Summary

    CTT Loop
    RequiredMax >1
    CTT
    010

    Transaction Totals

    RequiredMax use 1

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

    • The number of line items (CTT01) is the accumulation of the number of PO1 segments. If used, hash total (CTT02) is the sum of the value of quantities ordered (PO102) for each PO1 segment.
    Usage notes

    CTT^1^1~

    Example
    CTT-01
    354
    Number of Line Items
    Required
    Min 1Max 6

    Total number of line items in the transaction set

    Usage notes

    Total number of line items in the transaction set.

    CTT-02
    347
    Hash Total
    Required
    Min 1Max 10

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

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

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

    Usage notes

    This will be the total number of units being requested.

    SE
    030

    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

    B2B Order

    ISA*00* *00* *ZZ*AMAZONDS *01*RECEIVERID *220428*1230*U*00401*000000013*0*P*>~
    GS*PO*AMAZONDS*RECEIVERID*20220428*123038*96*X*004010~
    ST*850*0001~
    BEG*00*SS*T7Fd9Zn55**20220428~
    CUR*BT*USD~
    REF*OQ*002-9977742-6703449~
    REF*ST*1~
    DTM*010*20220503*2030*GM~
    DTM*002*20220507*0659*GM~
    N9*ZZ*03~
    MSG*As you requested, we've sent this part of your order to ensure quicker service. The other items will ship separately.~
    N9*ZZ*06~
    MSG*For detailed information about your orders, please visit Your Account. You can also print invoices, change your e-mail address and payment settings, alter your communication preferences, and much more-24 hours a day-at http://www.amazon.com/your-account.~
    N9*ZZ*07~
    MSG*Visit http://www.amazon.com/returns to return any item-including gifts-in unopened or original condition within 30 days for a full refund(other restrictions apply). Please have your order ID ready. Thanks for shopping at Amazon.com, and please come again!~
    N1*BT*Amazon.com.kydc,Inc.*92*KYDC~
    N1*SF*WHSE*92*WHSE~
    N1*ST*Jennifer Smith~
    N3*93 Hardwood Ln~
    N4*Rochester*NY*14616-1629*US*CC*United States~
    TD5**92*UPS_GR_RES****ZZ*RES~
    N1*LW*Jennifer Smith~
    N3*93 Hardwood Ln~
    N4*Rochester*NY*14616-1629*US~
    PER*ZZ****TE*2065551214~
    PO1*1*1*EA*2.41*NT*SK*1092189***TP*Kitchen*BL*1*ZZ*Amazon.com, LLC~
    CTP**PUR*6.54~
    MSG*Chicago Cutlery Essentials 3-1/2-Inch Parer Knife~
    CTT*1*1~
    SE*28*0001~
    GE*1*96~
    IEA*1*000000013~

    Gift Order

    ISA*00* *00* *ZZ*AMAZONDS *ZZ*RECEIVERID *220428*1230*U*00401*000000021*0*P*>~
    GS*PO*AMAZONDS*RECEIVERID*20220428*123038*98*X*004010~
    ST*850*0001~
    BEG*00*ZZ*T7Fd9Zn57**20220428~
    CUR*BT*USD~
    REF*OQ*123-4567890-1234567~
    REF*ST*1~
    DTM*010*20220503*2030*GM~
    DTM*002*20220507*0659*GM~
    N9*ZZ*05~
    MSG*We hope you enjoy your gift, and we'd love to see you soon at www.amazon.com.~
    N9*ZZ*06~
    MSG*For detailed information about your orders, please visit Your Account. You can also print invoices, change your email address and payment settings, alter your communication preferences, and much more - 24 hours a day - at http://www.amazon.com/your-account.~
    N9*ZZ*07~
    MSG*Visit http://www.amazon.com/returns to return any item - including gifts - in unopened or original condition within 30 days for a full refund (other restrictions apply). Please have your order ID ready. Thanks for shopping at Amazon.com, and please come again!~
    N1*BT*Amazon.com.KYDC Inc*92*KYDC~
    N1*SF*WHSE*92*WHSE~
    N1*ST*William Smith~
    N2*William Smith~
    N3*1415 Lake Lane~
    N4*Auburn*WA*98092*US~
    TD5**92*UPS_GR_RES****ZZ*RES~
    N1*LW*Sam Smith~
    N3*135 Mountain Rd~
    N4*Orting*WA*98391*US~
    PO1*1*1*EA*22.10*NT*SK*B0000E2RIA*****BL*1*ZZ*Amazon.com~
    SAC*S*B790*************Y~
    MSG*Elephant Vanilla Chai, 4lb.~
    MSG*Happy Anniversary!~
    CTT*1*1~
    SE*29*0001~
    GE*1*98~
    IEA*1*000000021~

    Multiple Item Order

    ISA*00* *00* *ZZ*AMAZONDS *01*RECEIVERID *220428*1230*U*00401*000000040*1*P*>~
    GS*PO*AMAZONDS*RECEIVERID*20220428*123038*95*X*004010~
    ST*850*0001~
    BEG*00*DS*T7Fd9Zn54**20220428~
    CUR*BT*USD~
    REF*OQ*111-3973054-1555434~
    REF*ST*1~
    DTM*010*20220503*2030*GM~
    DTM*002*20220507*0659*GM~
    N9*ZZ*01~
    MSG*This shipment completes your order.~
    N9*ZZ*06~
    MSG*For detailed information about your orders, please visit Your Account. You can also print invoices, change your e-mail address and payment settings, alter your communication preferences, and much more-24 hours a day-at http://www.amazon.com/your-account.~
    N9*ZZ*07~
    MSG*Visit http://www.amazon.com/returns to return any item-including gifts-in unopened or original condition within 30 days for a full refund(other restrictions apply). Please have your order ID ready. Thanks for shopping at Amazon.com, and please come again!~
    N1*BT*Amazon.com.kydc,Inc.*92*KYDC~
    N1*SF*WHSE*92*WHSE~
    N1*ST*Charlie Smith~
    N2*Darla Smith~
    N3*11254 Main St*Suite 112~
    N4*Seattle*WA*98104*US*CC*United States~
    TD5**92*UPS_GR_RES****ZZ*RES~
    N1*LW*Amber Smith~
    N3*123 Anderson Avenue~
    N4*Seattle*WA*98103*US~
    PER*ZZ****TE*2065551212~
    PO1*1*3*EA*18.04*NT*SK*1617*****BL*1*ZZ*Amazon.com~
    CTP**PUR*19.99~
    MSG*Wide Tracker Activity Walker~
    PO1*2*2*EA*54.42*NT*SK*4927*****BL*1*ZZ*Amazon.com~
    CTP**PUR*59.99~
    MSG*Deluxe Cozy Convertible~
    PO1*3*1*EA*18*NT*SK*9876*****BL*1*ZZ*Amazon.com~
    CTP**PUR*34.99~
    MSG*Red Rattle~
    CTT*3*6~
    SE*35*0001~
    GE*1*95~
    IEA*1*000000040~

    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.