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

X12 850 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 sample
    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
    REF
    050
    Customer Order Number
    Max use 1
    Required
    REF
    050
    Walmart Store Number
    Max use 1
    Optional
    REF
    050
    Internal Vendor Number
    Max use 1
    Optional
    REF
    050
    Facility Id Number
    Max use 1
    Optional
    CTP
    090
    Pricing Information
    Max use 1
    Required
    CSH
    110
    Sales Requirements
    Max use 5
    Required
    DTM
    150
    Date/Time Reference
    Max use 10
    Optional
    DTM
    150
    Customer Order
    Max use 10
    Required
    N9 Loop
    detail
    PO1 Loop
    PO1
    010
    Baseline Item Data
    Max use 1
    Required
    Service Performed Code
    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

    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
    BEG-03
    324
    Purchase Order Number
    Required
    Min 1Max 22

    Identifying number for Purchase Order assigned by the orderer/purchaser

    BEG-05
    373
    Date
    Required
    CCYYMMDD format

    Date expressed as CCYYMMDD

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

    Date this Purchase Order was created.

    REF
    050

    Customer Order Number

    RequiredMax use >1

    To specify identifying information

    Usage notes

    Contains the customer's order number (13-digit numeric).
    This number may not be unique across all Purchase Orders.

    Example
    Variants (all may be used)
    REFWalmart Store NumberREFInternal Vendor NumberREFFacility Id Number
    REF-01
    128
    Reference Identification Qualifier
    Required

    Code qualifying the Reference Identification

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

    REF
    050

    Walmart Store Number

    OptionalMax use >1

    To specify identifying information

    Usage notes

    Contains the Wal-mart Store Number for ship to store orders

    Example
    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

    REF
    050

    Internal Vendor Number

    OptionalMax use >1

    To specify identifying information

    Usage notes

    Walmart Assigned Internal Vendor Number. This is not to be used even though always send in the order file.

    Example
    REF-01
    128
    Reference Identification Qualifier
    Required

    Code qualifying the Reference Identification

    IA
    Internal Vendor 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

    REF
    050

    Facility Id Number

    OptionalMax use >1

    To specify identifying information

    Usage notes

    Walmart.com Assigned Facility id Number. This segment will be send only if the vendor has multiple ship points or Facilities. REF-02 has the Facility Number from where the order is to be shipped.

    Example
    REF-01
    128
    Reference Identification Qualifier
    Required

    Code qualifying the Reference Identification

    VR
    Vendor ID 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

    CTP
    090

    Pricing Information

    RequiredMax use >1

    To specify pricing information

    Usage notes

    Contains the total retail amount of this Purchase Order. It may be used to validate the data consistency of this message.

    Example
    CTP-01
    687
    Class of Trade Code
    Required

    Code indicating class of trade

    RS
    Resale
    CTP-03
    212
    Unit Price
    Required
    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

    Total retail price for this Purchase Order, including all lines, charges and adjustments. Note: For gift orders this value is zero.

    CTP-04
    380
    Quantity
    Required
    Min 1Max 15

    Numeric value of quantity

    Usage notes

    Always 1 unit quantity.

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

    Sales Requirements

    RequiredMax use 5

    To specify general conditions or requirements of the sale

    Usage notes

    Contains a code used to suppress split-shipments within a facility.

    Example
    CSH-01
    563
    Sales Requirement Code
    Optional

    Code to identify a specific requirement or agreement of sale

    P2
    Ship As Soon As Possible
    SC
    Ship Complete
    DTM
    150

    Date/Time Reference

    OptionalMax use 10

    To specify pertinent dates and times

    Usage notes

    There may be a DTM segment containing a date on which the customer has requested the item be delivered (DTM01 = "002"). This option is not supported by all suppliers.

    DTM01= “010” is for expected ship date and is optional

    DTM01= “009” is for Order Processing date(OPD) and is optional

    Example
    Variants (all may be used)
    DTMCustomer Order
    DTM-01
    374
    Date/Time Qualifier
    Required

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

    002
    Delivery Requested
    009
    Process
    010
    Expected ship date
    DTM-02
    373
    Date
    Optional
    CCYYMMDD format

    Date expressed as CCYYMMDD

    DTM
    150

    Customer Order

    RequiredMax use 10

    To specify pertinent dates and times

    Example
    Variants (all may be used)
    DTMDate/Time Reference
    DTM-01
    374
    Date/Time Qualifier
    Required

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

    806
    Customer Order
    DTM-02
    373
    Date
    Optional
    CCYYMMDD format

    Date expressed as CCYYMMDD

    N9 Loop
    RequiredMax >1
    N9
    295

    Reference Identification

    RequiredMax use 1

    To transmit identifying information as specified by the Reference Identification Qualifier

    Usage notes

    The N9 segments with N9-01=ZZ are always send in the order file. This is not to be used. Presently the N9-02 always contains the above mentioned values.

    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

    LASTDELIVERYMSG
    Last Delivery Message
    MARKETINGMSG
    Marketing Message
    RETURNSMSG
    Returns Message
    MSG
    300

    Message Text

    OptionalMax use 1000

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

    Usage notes

    The MSG segments with MSG-02=AA are always send in the order file. This is not to be used
    Each message may have four lines and contain up to 100 characters of data per line

    Example
    If Number (MSG-03) is present, then Printer Carriage Control Code (MSG-02) is required
    MSG-01
    933
    Free-Form Message Text
    Required
    Min 1Max 264

    Free-form message text

    MSG-02
    934
    Printer Carriage Control Code
    Optional

    A field to be used for the control of the line feed of the receiving printer

    • MSG02 is not related to the specific characteristics of a printer, but identifies top of page, advance a line, etc.
    AA
    Advance The Specified Number of Lines Before Print
    MSG-03
    1470
    Number
    Optional
    Min 1Max 9

    A generic number

    • MSG03 is the number of lines to advance before printing.
    • If MSG02 is "AA - Advance the specified number of lines before print" then MSG03 is required.
    Usage notes

    Message line number (1 to 4).

    N1 Loop
    RequiredMax >1
    N1
    310

    Name

    RequiredMax use 1

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

    Usage notes

    This loop contains three addresses related to this Purchase Order, and this segment (N101) defines the type of data to follow.
    The N1 loop when N101=ST (Ship to) address is always send in the 850.
    The N1 loop when N101=BT (Bill To) address is optional
    FD is used to specify the physical address of a Walmart facility for the case of orders using ship code 81 and 91 (Walmart transportation ). In that case the optional N103/N104 elements are populated to provide the Walmart ID number for the facility N102 will be populated with ‘RDC’ or ‘WPM’ for this case.

    Example
    N1-01
    98
    Entity Identifier Code
    Required

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

    BT
    Bill-to-Party
    FD
    Physical Address
    RT
    Returned to
    ST
    Ship To
    N1-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

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

    Address information

    N3-02
    166
    Address Information
    Optional
    Min 1Max 55

    Address information

    N4
    340

    Geographic Location

    RequiredMax 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

    Usage notes

    ISA ALPHA-3 Country Code. For a list of codes, see http://www.un.org/Depts/unsd/methods/m49alpha.htm.

    N4-05
    309
    Location Qualifier
    Optional

    Code identifying type of location

    Usage notes

    Used only for Integrated Shipping (backhaul). Value ‘GL’.

    GL
    Freight Station Geographic Location
    N4-06
    310
    Location Identifier
    Optional
    Min 1Max 30

    Code which identifies a specific location

    Usage notes

    Used only for Integrated Shipping (backhaul). Value GLN (Global Location Number) of facility.

    REF
    350

    Reference Identification

    OptionalMax use 12

    To specify identifying information

    Usage notes

    Segments mandatory with REF01 = "4N" and “OD” for N101 = "ST".
    Segments mandatory with REF01 = "PN" and "PHC" for N101 = "RT".

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

    Code qualifying the Reference Identification

    4N
    Special Payment Reference Number

    Description of billing payment method. For gift orders, this is replaced by non-descriptive text.

    OD
    Original Return Request Reference Number

    Returns TC Number

    PHC
    Process Handling Code

    Returns Method Code of “RC” (Not pre-paid), “RP” (pre-paid) or “RS” (return to vendor).

    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

    REF01 = "4N": Description of billing payment method. For gift orders, this is replaced by non-descriptive text.
    REF01 = "OD": Returns TC Number
    REF01 = "PN": Returns Permit Number. Additional data is populated in REF04.
    REF01 = "PHC": Returns Method Code of "RC" (Not pre-paid), "RP" (pre-paid) or "RS" (return to vendor).

    REF
    350

    Permit Number

    OptionalMax use 12

    To specify identifying information

    Usage notes

    Segments mandatory with REF01 = "4N" and “OD” for N101 = "ST".
    Segments mandatory with REF01 = "PN" and "PHC" for N101 = "RT".

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

    Code qualifying the Reference Identification

    PN
    Permit Number

    Returns Permit Number. Additional data is populated in REF04.

    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

    REF01 = "4N": Description of billing payment method. For gift orders, this is replaced by non-descriptive text.
    REF01 = "OD": Returns TC Number
    REF01 = "PN": Returns Permit Number. Additional data is populated in REF04.
    REF01 = "PHC": Returns Method Code of "RC" (Not pre-paid), "RP" (pre-paid) or "RS" (return to vendor).

    REF-04
    C040
    Reference Identifier
    To identify one or more reference numbers or identification numbers as specified by the Reference Qualifier
    Usage notes

    Only used if REF01 = "PN".

    If either Reference Identification Qualifier (C040-03) or Reference Identification (C040-04) is present, then the other is required
    If either Reference Identification Qualifier (C040-05) or Reference Identification (C040-06) is present, then the other is required
    C040-01
    128
    Reference Identification Qualifier
    Required

    Code qualifying the Reference Identification

    ZZ
    Mutually Defined
    C040-02
    127
    Reference Identification
    Required
    Min 1Max 30

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

    Usage notes

    Returns Permit City

    C040-03
    128
    Reference Identification Qualifier
    Optional

    Code qualifying the Reference Identification

    ZZ
    Mutually Defined
    C040-04
    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

    Returns Permit State

    C040-05
    128
    Reference Identification Qualifier
    Optional

    Code qualifying the Reference Identification

    ZZ
    Mutually Defined
    C040-06
    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

    Returns Permit Zip Code

    PER
    360

    Administrative Communications Contact

    OptionalMax use >1

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

    Usage notes

    Segment mandatory with PER01 = "BI" for N101 = "BT".
    Segment mandatory with PER01 = "RE" for N101 = "ST".

    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

    BI
    Bill Inquiry Contact
    RE
    Receiving Contact
    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

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

    Complete communications number including country or area code when applicable

    Usage notes

    Telephone number as 10-digit string with no punctuation.

    PER-05
    365
    Communication Number Qualifier
    Optional

    Code identifying the type of communication number

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

    Complete communications number including country or area code when applicable

    TD5
    390

    Carrier Details (Routing Sequence/Transit Time)

    OptionalMax use 12

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

    Example
    If Identification Code Qualifier (TD5-02) is present, then Identification Code (TD5-03) is required
    If Location Qualifier (TD5-07) is present, then Location Identifier (TD5-08) is required
    TD5-01
    133
    Routing Sequence Code
    Optional

    Code describing the relationship of a carrier to a specific shipment movement

    O
    Origin Carrier (Air, Motor, or Ocean)
    TD5-02
    66
    Identification Code Qualifier
    Optional

    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.
    93
    Code assigned by the organization originating the transaction set
    TD5-03
    67
    Identification Code
    Optional

    Code identifying a party or other code

    Usage notes

    A carrier method code as defined by Walmart.com. Carrier method up to 4 digits numeric.
    The value of this element determines whether this is a site-to-home or site-to-store order.
    Carrier codes for site-to-store orders are – 77,78,79,80, 88, 90, 92 and 97 (highlighted in blue in the list below).

    01
    USPS 3rd Class
    02
    UPS Ground
    03
    Clark Transport
    04
    Yellow Freight System
    05
    USPS Express Mail
    07
    USPS 4th Inter
    08
    UPS Basic
    09
    UPS Second day Air
    10
    USPS First Class
    12
    Silver Star
    13
    UPS Second Day Ground
    14
    Consolidation
    16
    UPS Next Day Air
    17
    Common Carrier
    19
    FedEx Express Saver (3 Day Service)
    20
    FedEx Ground
    21
    FedEx Priority Overnight
    22
    FedEx Two Day
    23
    FedEx Priority Overnight (duplicate or 21)
    24
    FedEx Standard Overnight (PM Delivery)
    26
    UPS Next Day Air Saver
    29
    UPS 3 Day Select
    30
    USPS Priority Mail
    31
    USPS Priority Mail
    32
    OLD Dominion Freight Line LTL
    33
    Newgistics
    34
    Airborne Ground Delivery
    35
    Airborne Express
    36
    Airborne
    37
    Airborne 2-DAY
    38
    UPS Ground
    41
    ABF Freight System
    42
    Bekins
    43
    Pilot Freight Basic Delivery
    44
    FedEx Priority Overnight w/Saturday Delivery
    45
    UPS Next Day Air Saver (Saturday Delivery)
    46
    SmartMail
    47
    USPS Media Mail
    48
    USPS Bound Printed Matter
    50
    Bekins Premium
    51
    USA Truck
    52
    Contract Freighers, Inc
    53
    Crete Carrier
    54
    Eagle Global Logistics - Three Day Service
    55
    Eagle Global Logistics - Economy
    56
    US Xpress
    57
    Heartland Express
    58
    Dart Transit
    61
    UPS Ground (CTN, GA)
    62
    UPS Ground (Parsippany, NJ)
    63
    UPS Ground (Chicago, IL)
    64
    UPS Ground (Vernon, CA)
    65
    FedEx SmartPost - BMC
    66
    FedEx SmartPost - DDU
    67
    FedEx Home Delivery
    68
    Streamlite
    69
    UPS Mail Innovations BPM
    70
    UPS Mail Innovations
    71
    USPS
    72
    Sun Delivery, Inc
    73
    APX-DDU
    76
    APX-BMC FedEx Standard Overnight - S2S
    77
    Direct to Store FedEx Priority Overnight
    78
    Direct to Store FedEx Two Day
    79
    Direct to Store FedEx, Ground
    80
    Direct to Store UPS, Ground
    81
    In-Store delivery through WPM RDC
    82
    Seko Worldwide
    83
    DHL@home
    84
    DHL@home(expedited)
    85
    DHL 2nd Day
    86
    DHL Next Day 03:00pm
    87
    FTD Florist
    88
    Direct to Store UPS Next Day Air
    89
    1 Hour Burn on Demand
    90
    Direct to Store – Freight
    91
    In-Store delivery through Bypass WPM
    92
    Direct to Store via UPS Ground Sort (Jewelry & Media)
    95
    Fulfilled with Inventory from a Wal-Mart Store
    96
    UPS Next Day Air Saver - S2S
    97
    Direct to Store UPS, second Day Air
    98
    Downloads
    99
    In-Store Pickup
    100
    DHL Next Day 12:00pm
    101
    DHL Next Day w/Sat
    TD5-07
    309
    Location Qualifier
    Optional

    Code identifying type of location

    Usage notes

    If the customer chose in-store pickup, then TD507 and TD508 are required to specify the store number. All suppliers do not support this delivery method.

    IS
    In Store
    TD5-08
    310
    Location Identifier
    Optional
    Min 1Max 30

    Code which identifies a specific location

    Usage notes

    Wal-Mart Store Number if TD507 = "IS".

    TD5-12
    284
    Service Level Code
    Optional

    Code indicating the level of transportation service or the billing service offered by the transportation carrier

    Usage notes

    Code indicating the service level chosen by the customer for this order.

    DF
    Value shipping
    ND
    Next Day Air
    SE
    Second Day
    SG
    Standard Ground
    ZZ
    Mutually Defined

    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.
    Example
    If Unit or Basis for Measurement Code (PO1-03) is present, then Quantity Ordered (PO1-02) is required
    If Basis of Unit Price Code (PO1-05) is present, then Unit Price (PO1-04) is required
    If either Product/Service ID Qualifier (PO1-06) or Product/Service ID (PO1-07) 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
    If either Product/Service ID Qualifier (PO1-10) or Product/Service ID (PO1-11) is present, then the other is required
    PO1-01
    350
    Assigned Identification
    Optional
    Min 1Max 20

    Alphanumeric characters assigned for differentiation within a transaction set

    • PO101 is the line item identification.
    Usage notes

    Unique identifier for this Purchase Order Line. This number is necessary when responding with a status update or shipping notification.

    PO1-02
    330
    Quantity Ordered
    Optional
    Min 1Max 15

    Quantity ordered

    PO1-03
    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
    PO1-04
    212
    Unit Price
    Optional
    Min 1Max 15

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

    PO1-05
    639
    Basis of Unit Price Code
    Optional

    Code identifying the type of unit price for an item

    QE
    Quoted Price per Each
    PO1-06
    235
    Product/Service ID Qualifier
    Optional

    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.
    BP
    Buyer's Part Number
    PO1-07
    234
    Product/Service ID
    Optional
    Min 1Max 48

    Identifying number for a product or service

    PO1-08
    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)
    PO1-09
    234
    Product/Service ID
    Optional
    Min 1Max 48

    Identifying number for a product or service

    Usage notes

    Wal-Mart Item UPC

    PO1-10
    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
    PO1-11
    234
    Product/Service ID
    Optional
    Min 1Max 48

    Identifying number for a product or service

    Usage notes

    Supplier's item SKU.

    PID Loop
    RequiredMax >1
    PID
    050

    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

    Usage notes

    Item description.

    SAC Loop
    RequiredMax >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

    SAC02 = "D340": Charge to the customer for each item - always present.
    SAC02 = "G830": Charge to the customer for shipping and handling - always present.
    SAC02 = "H850": Charge to the customer for sales tax - always present.

    The below segments are not always present in the 850.
    SAC02 = "H000": Allowance to the customer for customer service adjustment or promotion - present only if non-zero.
    SAC02 = "H151": Charge to the customer for value-added service - present only if non-zero.

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

    Code identifying the service, promotion, allowance, or charge

    D340
    Goods and Services Charge

    Charge to the customer for each item – always present.

    G830
    Shipping and Handling

    Charge to the customer for shipping and handling – always present.

    H000
    Special Allowance

    Allowance to the customer for customer service adjustment or promotion – present only if non-zero.

    H151
    Special Services

    Charge to the customer for value-added service – present only if non-zero.

    H850
    Tax

    Charge to the customer for sales tax – always present.

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

    Retail price per unit. Note: For gift orders this value is zero.

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

    Code indicating method of handling for an allowance or charge

    15
    Information Only
    SAC-15
    352
    Description
    Optional
    Min 1Max 80

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

    Usage notes

    A free-text description is supplied if SAC02 is "H000" or "H151".

    N9 Service Performed Code
    OptionalMax >1
    Variants (all may be used)
    N9Data Source
    N9
    330

    Reference Identification

    RequiredMax use 1

    To transmit identifying information as specified by the Reference Identification Qualifier

    Usage notes

    This segment contain value-added services that the customer has requested

    The N9 segments with N901=QY will be send when the order is a Gift order with Gift message, Gift wrapping or Gift Tag

    Example
    At least one of Reference Identification (N9-02) or Free-form Description (N9-03) is required
    N9-01
    128
    Reference Identification Qualifier
    Required

    Code qualifying the Reference Identification

    QY
    Service Performed Code
    N9-02
    127
    Reference Identification
    Optional

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

    Usage notes

    This is a value-added service code as defined by Walmart.com.

    VGM
    Gift Message (Four Lines)
    VGT
    Gift Tag (To/From)
    VGW
    Gift Wrapping
    VSR
    Signature on Delivery
    N9-03
    369
    Free-form Description
    Optional
    Min 1Max 45

    Free-form descriptive text

    N9-07
    C040
    Reference Identifier
    To identify one or more reference numbers or identification numbers as specified by the Reference Qualifier
    Usage notes

    Then this contains a unique sequence number for each value-added service request.

    C040-01
    128
    Reference Identification Qualifier
    Required

    Code qualifying the Reference Identification

    55
    Sequence Number
    C040-02
    127
    Reference Identification
    Required
    Min 1Max 30

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

    MSG
    340

    Message Text

    OptionalMax use 1000

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

    Usage notes

    There is one MSG element for each value-added service data element. MSG01 will contain a name/value pair separated by a "|" character (e.g. "LINE1|Hi Mom").

    There will 4 MSG segments containing 4 lines of text when N9-02=VGM.

    When N9-02=VSR ,MSG-01 =SOD|Y for signature on delivery

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

    Free-form message text

    N9 Data Source
    OptionalMax >1
    Usage notes

    This segment contain dynamic-data elements for item configuration

    Variants (all may be used)
    N9Service Performed Code
    N9
    330

    Reference Identification

    RequiredMax use 1

    To transmit identifying information as specified by the Reference Identification Qualifier

    Example
    At least one of Reference Identification (N9-02) or Free-form Description (N9-03) is required
    N9-01
    128
    Reference Identification Qualifier
    Required

    Code qualifying the Reference Identification

    S2
    Data Source
    N9-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

    N9-03
    369
    Free-form Description
    Optional
    Min 1Max 45

    Free-form descriptive text

    Usage notes

    This is the name of a dynamic data element.

    MSG
    340

    Message Text

    OptionalMax use 1000

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

    Usage notes

    There are MSG segments containing the dynamic-data value corresponding to the N903 dynamic-data name. The data will be split into 264 character blocks, so there may be one or many MSG segments depending on the length of the data.

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

    Free-form message text

    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.
    Example
    CTT-01
    354
    Number of Line Items
    Required
    Min 1Max 6

    Total number of line items in the transaction set

    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

    sample

    ST*850*0001
    BEG*00*DS*12635837**20070413
    REF*CO*8890500613298
    CTP*RS**41.28*1*EA
    CSH*SC
    DTM*806*20180412
    DTM*002*20180416
    DTM*010*20180412
    N9*ZZ*MARKETINGMSG
    MSG*0*AA*1
    MSG*0*AA*2
    MSG*0*AA*3
    MSG*0*AA*4
    N9*ZZ*RETURNSMSG
    MSG*0*AA*1
    MSG*0*AA*2
    MSG*0*AA*3
    MSG*0*AA*4
    N9*ZZ*LASTDELIVERYMSG
    MSG*0*AA*1
    MSG*0*AA*2
    MSG*0*AA*3
    MSG*0*AA*4
    N1*ST*Tom Smith
    N3*12323 ABC Street*
    N4*lowell*MA*01854*USA
    REF*4N*MC-1114
    REF*OD*71324148259778701029
    PER*RE*Tom Smith*TE*9780032345
    TD5*O*93*02*********SG
    PO1*1*1*EA*23.50*QE*BP*3335027*UP*0083645300100*VP*SW-306
    PID*F****Star Wars Darth Vader Lightaber - Episode III, .45 Scaled Re
    SAC*N*D340******33.63****15
    SAC*N*G830******5.97****15
    SAC*N*H850******1.68****15
    CTT*1
    SE*40*0001

    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.