Walmart
/
[4010] Purchase Order
  • Specification
  • EDI Inspector
Import guide into your account
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 Stedi Network
Walmart logo

X12 850 [4010] 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
  • sample
View the latest version of this implementation guide as an interactive webpage
https://www.stedi.com/app/guides/view/walmart-edi/4010-purchase-order/01GYCWWWP7E0X6DKGRT0P94H4H
Powered by
Build EDI implementation guides at stedi.com
Overview
ISA
-
Interchange Control Header
Max use 1
Required
GS
-
Functional Group Header
Max use 1
Required
heading
ST
010
Transaction Set Header
Max use 1
Required
BEG
020
Beginning Segment for Purchase Order
Max use 1
Required
REF
050
Customer Order Number
Max use 1
Required
REF
050
Facility Id Number
Max use 1
Optional
REF
050
Internal Vendor Number
Max use 1
Optional
REF
050
Walmart Store Number
Max use 1
Optional
CTP
090
Pricing Information
Max use 1
Required
CSH
110
Sales Requirements
Max use 5
Required
DTM
150
Customer Order
Max use 10
Required
DTM
150
Date/Time Reference
Max use 10
Optional
N9 Loop
detail
PO1 Loop
PO1
010
Baseline Item Data
Max use 1
Required
Data Source
GE
-
Functional Group Trailer
Max use 1
Required
IEA
-
Interchange Control Trailer
Max use 1
Required
ISA

Interchange Control Header

RequiredMax use 1

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

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

Code to identify the type of information in the Authorization Information

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

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

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

Code to identify the type of information in the Security Information

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

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

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

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

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

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

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

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

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

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

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

Date of the interchange

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

Time of the interchange

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

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

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

This version number covers the interchange control segments

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

A control number assigned by the interchange sender

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

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

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

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

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

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

>
Component Element Separator

Functional Group Header

RequiredMax use 1

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

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

Code identifying a group of application related transaction sets

PO
Purchase Order (850)
GS-02
142
Application Sender's Code
Required
String (AN)
Min 2Max 15

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

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

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

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

Date expressed as CCYYMMDD

GS-05
337
Time
Required
Time (TM)
HHMM, HHMMSS, HHMMSSD, or HHMMSSDD format

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

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

Assigned number originated and maintained by the sender

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

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

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

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

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

Heading

ST
010
Heading > ST

Transaction Set Header

RequiredMax use 1

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

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

Code uniquely identifying a Transaction Set

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

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

BEG
020
Heading > BEG

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
Identifier (ID)

Code identifying purpose of transaction set

00
Original
BEG-02
92
Purchase Order Type Code
Required
Identifier (ID)

Code specifying the type of Purchase Order

DS
Dropship
BEG-03
324
Purchase Order Number
Required
String (AN)
Min 1Max 22

Identifying number for Purchase Order assigned by the orderer/purchaser

BEG-05
373
Date
Required
Date (DT)
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
Heading > REF

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)
REFFacility Id NumberREFInternal Vendor NumberREFWalmart Store Number
REF-01
128
Reference Identification Qualifier
Required
Identifier (ID)

Code qualifying the Reference Identification

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

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

REF
050
Heading > REF

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
Identifier (ID)

Code qualifying the Reference Identification

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

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

REF
050
Heading > REF

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
Identifier (ID)

Code qualifying the Reference Identification

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

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

REF
050
Heading > REF

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
Identifier (ID)

Code qualifying the Reference Identification

ST
Store Number
REF-02
127
Reference Identification
Optional
String (AN)
Min 1Max 30

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

CTP
090
Heading > CTP

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
Identifier (ID)

Code indicating class of trade

RS
Resale
CTP-03
212
Unit Price
Required
Decimal number (R)
Min 1Max 15

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

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

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
Decimal number (R)
Min 1Max 15

Numeric value of quantity

Usage notes

Always 1 unit quantity.

CTP-05
C001
Composite Unit of Measure
Optional
To identify a composite unit of measure (See Figures Appendix for examples of use)
C001-01
355
Unit or Basis for Measurement Code
Required
Identifier (ID)

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

EA
Each
CSH
110
Heading > CSH

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
Identifier (ID)

Code to identify a specific requirement or agreement of sale

P2
Ship As Soon As Possible
SC
Ship Complete
DTM
150
Heading > DTM

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
Identifier (ID)

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

806
Customer Order
DTM-02
373
Date
Optional
Date (DT)
CCYYMMDD format

Date expressed as CCYYMMDD

DTM
150
Heading > DTM

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
Identifier (ID)

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
Date (DT)
CCYYMMDD format

Date expressed as CCYYMMDD

N9 Loop
RequiredMax >1
N9
295
Heading > N9 Loop > N9

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
Identifier (ID)

Code qualifying the Reference Identification

ZZ
Mutually Defined
N9-02
127
Reference Identification
Optional
String (AN)

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
Heading > N9 Loop > MSG

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
String (AN)
Min 1Max 264

Free-form message text

MSG-02
934
Printer Carriage Control Code
Optional
Identifier (ID)

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
Numeric (N0)
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).

N9 Loop end
N1 Loop
RequiredMax >1
N1
310
Heading > N1 Loop > N1

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
Identifier (ID)

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
String (AN)
Min 1Max 60

Free-form name

N3
330
Heading > N1 Loop > N3

Address Information

RequiredMax use 2

To specify the location of the named party

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

Address information

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

Address information

N4
340
Heading > N1 Loop > N4

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
String (AN)
Min 2Max 30

Free-form text for city name

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

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

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

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

N4-04
26
Country Code
Optional
Identifier (ID)
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
Identifier (ID)

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
String (AN)
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
Heading > N1 Loop > REF

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
Identifier (ID)

Code qualifying the Reference Identification

PN
Permit Number

Returns Permit Number. Additional data is populated in REF04.

REF-02
127
Reference Identification
Optional
String (AN)
Min 1Max 30

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

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
Optional
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
Identifier (ID)

Code qualifying the Reference Identification

ZZ
Mutually Defined
C040-02
127
Reference Identification
Required
String (AN)
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
Identifier (ID)

Code qualifying the Reference Identification

ZZ
Mutually Defined
C040-04
127
Reference Identification
Optional
String (AN)
Min 1Max 30

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

Usage notes

Returns Permit State

C040-05
128
Reference Identification Qualifier
Optional
Identifier (ID)

Code qualifying the Reference Identification

ZZ
Mutually Defined
C040-06
127
Reference Identification
Optional
String (AN)
Min 1Max 30

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

Usage notes

Returns Permit Zip Code

REF
350
Heading > N1 Loop > REF

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
Identifier (ID)

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
String (AN)
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).

PER
360
Heading > N1 Loop > PER

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
Identifier (ID)

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
String (AN)
Min 1Max 60

Free-form name

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

Code identifying the type of communication number

TE
Telephone
PER-04
364
Communication Number
Optional
String (AN)
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
Identifier (ID)

Code identifying the type of communication number

EM
Electronic Mail
PER-06
364
Communication Number
Optional
String (AN)
Min 1Max 80

Complete communications number including country or area code when applicable

TD5
390
Heading > N1 Loop > TD5

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
Identifier (ID)

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
Identifier (ID)

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
String (AN)

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
Identifier (ID)

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
String (AN)
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
Identifier (ID)

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
N1 Loop end
Heading end

Detail

PO1 Loop
RequiredMax >1
PO1
010
Detail > PO1 Loop > PO1

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
String (AN)
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
Decimal number (R)
Min 1Max 15

Quantity ordered

PO1-03
355
Unit or Basis for Measurement Code
Optional
Identifier (ID)

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

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

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

PO1-05
639
Basis of Unit Price Code
Optional
Identifier (ID)

Code identifying the type of unit price for an item

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

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
String (AN)
Min 1Max 48

Identifying number for a product or service

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

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
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

Wal-Mart Item UPC

PO1-10
235
Product/Service ID Qualifier
Optional
Identifier (ID)

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
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

Supplier's item SKU.

PID Loop
RequiredMax >1
PID
050
Detail > PO1 Loop > PID Loop > PID

Product/Item Description

RequiredMax use 1

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

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

Code indicating the format of a description

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

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

Usage notes

Item description.

PID Loop end
SAC Loop
RequiredMax >1
SAC
130
Detail > PO1 Loop > SAC Loop > SAC

Service, Promotion, Allowance, or Charge Information

RequiredMax use 1

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

Usage notes

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
Identifier (ID)

Code which indicates an allowance or charge for the service specified

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

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
Decimal number (R)
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
Identifier (ID)

Code indicating method of handling for an allowance or charge

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

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

Usage notes

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

SAC Loop end
N9 Data Source
OptionalMax >1
Usage notes

This segment contain dynamic-data elements for item configuration

Variants (all may be used)
Service Performed Code
N9
330
Detail > PO1 Loop > Data Source > N9

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
Identifier (ID)

Code qualifying the Reference Identification

S2
Data Source
N9-02
127
Reference Identification
Optional
String (AN)
Min 1Max 30

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

N9-03
369
Free-form Description
Optional
String (AN)
Min 1Max 45

Free-form descriptive text

Usage notes

This is the name of a dynamic data element.

MSG
340
Detail > PO1 Loop > Data Source > MSG

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
String (AN)
Min 1Max 264

Free-form message text

N9 Data Source end
N9 Service Performed Code
OptionalMax >1
Variants (all may be used)
Data Source
N9
330
Detail > PO1 Loop > Service Performed Code > N9

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
Identifier (ID)

Code qualifying the Reference Identification

QY
Service Performed Code
N9-02
127
Reference Identification
Optional
String (AN)

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
String (AN)
Min 1Max 45

Free-form descriptive text

N9-07
C040
Reference Identifier
Optional
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
Identifier (ID)

Code qualifying the Reference Identification

55
Sequence Number
C040-02
127
Reference Identification
Required
String (AN)
Min 1Max 30

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

MSG
340
Detail > PO1 Loop > Service Performed Code > MSG

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
String (AN)
Min 1Max 264

Free-form message text

N9 Service Performed Code end
PO1 Loop end
Detail end

Summary

CTT Loop
RequiredMax >1
CTT
010
Summary > CTT Loop > CTT

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
Numeric (N0)
Min 1Max 6

Total number of line items in the transaction set

CTT Loop end
SE
030
Summary > SE

Transaction Set Trailer

RequiredMax use 1

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

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

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

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

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

Summary end

Functional Group Trailer

RequiredMax use 1

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

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

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

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

Assigned number originated and maintained by the sender

Interchange Control Trailer

RequiredMax use 1

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

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

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

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

A control number assigned by the interchange sender

EDI Samples

sample

ISA*00* *00* *ZZ*SENDER *ZZ*RECEIVER *231106*1404*U*00401*000000001*0*T*>
GS*PO*SENDERGS*RECEIVERGS*20231106*140421*000000001*X*004010
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*37*0001
GE*1*000000001
IEA*1*000000001

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.