Walmart
/
Invoice
  • 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 810 Invoice

X12 Release 5010

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

Delimiters
  • ~ Segment
  • * Element
  • > Component
  • ^ Repetition
EDI samples
  • None included
View the latest version of this implementation guide as an interactive webpage
https://www.stedi.com/app/guides/view/walmart-edi/invoice/01HRSY2D3E4DMQNCR34XPHSVZW
Powered by
Build EDI implementation guides at stedi.com
Overview
ISA
-
Interchange Control Header
Max use 1
Required
GS
-
Functional Group Header
Max use 1
Required
heading
ST
0100
Transaction Set Header
Max use 1
Required
BIG
0200
Beginning Segment for Invoice
Max use 1
Required
REF
0500
Reference Information
Max use 12
Optional
N1 Loop
ITD
1300
Terms of Sale/Deferred Terms of Sale
Max use 1
Required
DTM
1400
Date/Time Reference
Max use 10
Optional
FOB
1500
F.O.B. Related Instructions
Max use 1
Required
detail
IT1 Loop
GE
-
Functional Group Trailer
Max use 1
Required
IEA
-
Interchange Control Trailer
Max use 1
Required
ISA

Interchange Control Header

RequiredMax use 1

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

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

Code identifying the type of information in the Authorization Information

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

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

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

Code identifying the type of information in the Security Information

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

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

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

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

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

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

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

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

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

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

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

Date of the interchange

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

Time of the interchange

ISA-11
I65
Repetition Separator
Required
String (AN)
Min 1Max 1

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

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

Code specifying the version number of the interchange control segments

00501
Standards Approved for Publication by ASC X12 Procedures Review Board through October 2003
ISA-13
I12
Interchange Control Number
Required
Numeric (N0)
Min 9Max 9

A control number assigned by the interchange sender

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

Code indicating sender's request for an interchange acknowledgment

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

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

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

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

>
Component Element Separator

Functional Group Header

RequiredMax use 1

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

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

Code identifying a group of application related transaction sets

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

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

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

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

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

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

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

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

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

Assigned number originated and maintained by the sender

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

Code identifying the issuer of the standard; this code is used in conjunction with Data Element 480

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

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

005010VICS

Heading

ST
0100
Heading > ST

Transaction Set Header

RequiredMax use 1

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

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

Code uniquely identifying a Transaction Set

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

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

BIG
0200
Heading > BIG

Beginning Segment for Invoice

RequiredMax use 1

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

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

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

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

Identifying number assigned by issuer

Usage notes

Walmart Accounts Payable will only accept a maximum of 15 digits for the invoice number and will only post numeric characters. (Example: If invoice number 123456AB is sent, it will post in accounts payable as 123456.)

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

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

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

Retailer’s original purchase order date

BIG-04
324
Purchase Order Number
Optional
String (AN)
Min 1Max 22

Identifying number for Purchase Order assigned by the orderer/purchaser

Usage notes

Walmart's original 10-digit purchase order number.

BIG-07
640
Transaction Type Code
Optional
Identifier (ID)

Code specifying the type of transaction

  • BIG07 is used only to further define the type of invoice when needed.
Usage notes

This element (BIG07) should only be included when sending a credit or expense invoice.

CN
Credit Invoice

To send an acceptable Walmart store credit invoice the BIG07 must be set to 'CN' (Credit Invoice).

CT
Cost Type Invoice

Suppliers invoicing Department 99 with active items must send a 'CT' (Cost Type Invoice) in the BIG07.

REF
0500
Heading > REF

Reference Information

OptionalMax use 12

To specify identifying information

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

Code qualifying the Reference Identification

DP
Department Number

When sent, the Reference Identification (REF02) should contain the zero-padded 5-digit Walmart department number.

IA
Internal Vendor Number

At least one instance of the Reference Information (REF) segment with Internal Vendor Number (IA) qualifier is required by Walmart.
When sent, the Reference Identification (REF02) should contain the Walmart assigned 9-digit vendor number.

MR
Merchandise Type Code

When sent, the Reference Identification (REF02) should contain the zero-padded 4-digit Walmart purchase order type.

REF-02
127
Reference Identification
Required
String (AN)
Min 1Max 50

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

Usage notes

See REF01 for REF02 content requirements.

Example values
  • 00017
  • 123456170
  • 0020
N1 Loop
OptionalMax 200
N1
0700
Heading > N1 Loop > N1

Party Identification

RequiredMax use 1

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

Usage notes

One or more N1 segment iterations is required to meet Walmart requirements. See the N101 for details on which N1 qualifiers are needed.

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

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

ST
Ship To

At least on instance of the Party Identification (N1) segment with Ship To (ST) qualifier is required by Walmart.
When sent, the Name (N102), Identification Code Qualifier (N103), and Identification Code (N104) are required by Walmart.

SU
Supplier/Manufacturer

Walmart requires an instance of the N1 be sent with a N101 of 'SU'.
When sent, Walmart requires the Name (N102) contain the free-form vendor name.

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

Free-form name

Usage notes

When the Party Identification (N101) contains a Ship To qualifier (ST), the Name (N102) is required by Walmart and should contain a free-format description of the location including the 5-digit location number. (Example: WAL-MART WHSE# 06009 or WALMART STORE 00100)

Example values
  • SUPPLIER NAME
  • WAL-MART 100
  • WAL-MART WHSE# 06009
  • WALMART STORE 00100
N1-03
66
Identification Code Qualifier
Optional
Identifier (ID)

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

UL
Global Location Number (GLN)

The Identification Code Qualifier (N103) must contain a Global Location Number (UL) qualifier when the Entity Identification Code (N101) contains a Ship To (ST) qualifier.
When sent, the Identification Code (N104) must contain a 13-digit Global Location Number for the Walmart Facility to which the product was initially delivered.

N1-04
67
Identification Code
Optional
String (AN)
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.
N3
0900
Heading > N1 Loop > N3

Party Location

OptionalMax use 2

To specify the location of the named party

Usage notes

The N3 (Party Location) is recommended when N101 is 'ST' (Ship To)

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
1000
Heading > N1 Loop > N4

Geographic Location

OptionalMax use 1

To specify the geographic place of the named party

Example
N4-01
19
City Name
Optional
String (AN)
Min 2Max 30

Free-form text for city name

  • A combination of either N401 through N404, or N405 and N406 may be adequate to specify a location.
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

N1 Loop end
ITD
1300
Heading > ITD

Terms of Sale/Deferred Terms of Sale

RequiredMax use >1

To specify terms of sale

Example
If Terms Discount Percent (ITD-03) is present, then Terms Discount Days Due (ITD-05) is required
If Terms Discount Amount (ITD-08) is present, then Terms Discount Days Due (ITD-05) is required
ITD-01
336
Terms Type Code
Required
Identifier (ID)

Code identifying type of payment terms

  • If the code in ITD01 is "04", then ITD07 or ITD09 is required and either ITD10 or ITD11 is required; if the code in ITD01 is "05", then ITD06 or ITD07 is required.
02
End of Month (EOM)
05
Discount Not Applicable
08
Basic Discount Offered
ITD-02
333
Terms Basis Date Code
Required
Identifier (ID)

Code identifying the beginning of the terms period

1
Ship Date
3
Invoice Date
7
Effective Date
15
Receipt of Goods
ITD-03
338
Terms Discount Percent
Optional
Decimal number (R)
Min 1Max 6

Terms discount percentage, expressed as a percent, available to the purchaser if an invoice is paid on or before the Terms Discount Due Date

Usage notes

The percent is sent with a decimal point only when needed, e.g., 10.5% is sent as ‘‘10.5’’, and 2% is sent as ‘‘2’’.

ITD-05
351
Terms Discount Days Due
Optional
Numeric (N0)
Min 1Max 3

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

ITD-07
386
Terms Net Days
Optional
Numeric (N0)
Min 1Max 3

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

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

Total amount of terms discount

ITD-12
352
Description
Optional
String (AN)
Min 1Max 80

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

DTM
1400
Heading > DTM

Date/Time Reference

OptionalMax use 10

To specify pertinent dates and times

Usage notes

This segment may need to be sent multiple times with different listed qualifiers (DTM01) to communicate all necessary invoice details.

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

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

007
Effective

At least one instance of the Date/Time Reference (DTM) segment with Effective (007) qualifier is required by Walmart when the Terms Basis Date Code (ITD02) contains an Effective Date (7) qualifier.
When sent, the Date (DTM02) should contain the agreed upon effective date for the terms.

011
Shipped

At least one instance of the Date/Time Reference (DTM) segment with Shipped (011) qualifier is required by Walmart when the Terms Basis Date Code (ITD02) contains a Ship Date (1) qualifier.
When sent, the Date (DTM02) should contain the date the product being invoiced was shipped.

DTM-02
373
Date
Required
Date (DT)
CCYYMMDD format

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

FOB
1500
Heading > FOB

F.O.B. Related Instructions

RequiredMax use 1

To specify transportation instructions relating to shipment

Example
FOB-01
146
Shipment Method of Payment
Required
Identifier (ID)

Code identifying payment terms for transportation charges

  • FOB01 indicates which party will pay the carrier.
CC
Collect
PP
Prepaid (by Seller)
Heading end

Detail

IT1 Loop
RequiredMax 200000
IT1
0100
Detail > IT1 Loop > IT1

Baseline Item Data (Invoice)

RequiredMax use 1

To specify the basic and most frequently used line item data for the invoice and related transactions

Example
If either Quantity Invoiced (IT1-02), Unit or Basis for Measurement Code (IT1-03) or Unit Price (IT1-04) are present, then the others are required
If either Product/Service ID Qualifier (IT1-06) or Product/Service ID (IT1-07) is present, then the other is required
If either Product/Service ID Qualifier (IT1-08) or Product/Service ID (IT1-09) is present, then the other is required
If either Product/Service ID Qualifier (IT1-10) or Product/Service ID (IT1-11) is present, then the other is required
If either Product/Service ID Qualifier (IT1-12) or Product/Service ID (IT1-13) is present, then the other is required
If either Product/Service ID Qualifier (IT1-14) or Product/Service ID (IT1-15) is present, then the other is required
If either Product/Service ID Qualifier (IT1-16) or Product/Service ID (IT1-17) is present, then the other is required
If either Product/Service ID Qualifier (IT1-18) or Product/Service ID (IT1-19) is present, then the other is required
If either Product/Service ID Qualifier (IT1-20) or Product/Service ID (IT1-21) is present, then the other is required
If either Product/Service ID Qualifier (IT1-22) or Product/Service ID (IT1-23) is present, then the other is required
If either Product/Service ID Qualifier (IT1-24) or Product/Service ID (IT1-25) is present, then the other is required
IT1-02
358
Quantity Invoiced
Optional
Decimal number (R)
Min 1Max 15

Number of units invoiced (supplier units)

Usage notes

To send an acceptable Walmart store credit invoice the IT102 should be sent with a negative quantity equal to the quantity being credited.
The quantity being credited cannot exceed the total amount that was invoiced.

Example values
  • 1080
  • -1080
IT1-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

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

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

Usage notes

The price is sent with a decimal point only when needed, e.g., $15.95
would be sent as ‘‘15.95’’, and $29.00 would be sent as ‘‘29’’.
To indicate a no charge item or free goods, IT104 will contain a single zero (0) and IT105 will contain code NC.

To send an acceptable Walmart store credit invoice the IT104 should remain a positive value.

IT1-06
235
Product/Service ID Qualifier
Optional
Identifier (ID)

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

  • IT106 through IT125 provide for ten different product/service IDs for each item. For example: Case, Color, Drawing No., U.P.C. No., ISBN No., Model No., or SKU.
Usage notes

Walmart requires one or more of the following 'Product/Service ID Qualifier' elements (IT106-IT124 [Even]) be sent in the IT1:
. 'IN' (Buyer's Item Number)
. 'EN' (GTIN-13)
. 'UP' (GTIN-12)

CH
Country of Origin Code

US Country of Origin labeling (COOL) Act compliance requires:
. One 'Product/Service ID Qualifier' element (IT106-IT124 [Even]) containing a 'CH' (Country of Origin code) qualifier
. A corresponding 'Product/Service ID' element (IT107-IT125 [Odd]) containing a ISO-3133-1 2-character alpha country code

EN
GTIN-13

A 13-digit GS1 Identification Key composed of a GS1 Company Prefix, Item Reference and Check Digit used to identify trade items

IN
Buyer's Item Number

Walmart 9-digit Item Number

LT
Lot Number

US Country of Origin labeling (COOL) Act compliance requires:
. One 'Product/Service ID Qualifier' element (IT106-IT124 [Even]) containing a 'LT' (Lot Number) qualifier
. A corresponding 'Product/Service ID' element (IT107-IT125 [Odd]) containing a Lot Number

UK
GTIN-14

A 14-digit GS1 Identification Key composed of an Indicator Digit, GS1 Company Prefix, Item Reference and Check Digit used to identify trade items

UP
GTIN-12

A 12-digit GS1 Identification Key composed of a GS1 Company Prefix, Item Reference, and Check Digit used to identify trade items

ZZ
Mutually Defined

US Country of Origin labeling (COOL) Act compliance requires:
. One 'Product/Service ID Qualifier' element (IT106-IT124 [Even]) containing a 'ZZ' (Mutually Defined) qualifier
. A corresponding 'Product/Service ID' element (IT107-IT125 [Odd]) containing a one of the following Method of Catch types:
. FARM RAISED
. WILD CAUGHT
. NA (For non-seafood items only)

IT1-07
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

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

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

CH
Country of Origin Code
EN
GTIN-13
IN
Buyer's Item Number
LT
Lot Number
UK
GTIN-14
UP
GTIN-12
ZZ
Mutually Defined
IT1-09
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

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

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

Usage notes

Walmart requires one or more of the following 'Product/Service ID Qualifier' elements (IT106-IT124 [Even]) be sent in the IT1:
. 'IN' (Buyer's Item Number)
. 'EN' (GTIN-13)
. 'UP' (GTIN-12)

CH
Country of Origin Code
EN
GTIN-13
IN
Buyer's Item Number
LT
Lot Number
UK
GTIN-14
UP
GTIN-12
ZZ
Mutually Defined
IT1-11
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

IT1-12
235
Product/Service ID Qualifier
Optional
Identifier (ID)

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

Usage notes

Walmart requires one or more of the following 'Product/Service ID Qualifier' elements (IT106-IT124 [Even]) be sent in the IT1:
. 'IN' (Buyer's Item Number)
. 'EN' (GTIN-13)
. 'UP' (GTIN-12)

CH
Country of Origin Code
EN
GTIN-13
IN
Buyer's Item Number
LT
Lot Number
UK
GTIN-14
UP
GTIN-12
ZZ
Mutually Defined
IT1-13
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

IT1-14
235
Product/Service ID Qualifier
Optional
Identifier (ID)

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

Usage notes

Walmart requires one or more of the following 'Product/Service ID Qualifier' elements (IT106-IT124 [Even]) be sent in the IT1:
. 'IN' (Buyer's Item Number)
. 'EN' (GTIN-13)
. 'UP' (GTIN-12)

CH
Country of Origin Code
EN
GTIN-13
IN
Buyer's Item Number
LT
Lot Number
UK
GTIN-14
UP
GTIN-12
ZZ
Mutually Defined
IT1-15
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

IT1-16
235
Product/Service ID Qualifier
Optional
Identifier (ID)

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

Usage notes

Walmart requires one or more of the following 'Product/Service ID Qualifier' elements (IT106-IT124 [Even]) be sent in the IT1:
. 'IN' (Buyer's Item Number)
. 'EN' (GTIN-13)
. 'UP' (GTIN-12)

CH
Country of Origin Code
EN
GTIN-13
IN
Buyer's Item Number
LT
Lot Number
UK
GTIN-14
UP
GTIN-12
ZZ
Mutually Defined
IT1-17
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

IT1-18
235
Product/Service ID Qualifier
Optional
Identifier (ID)

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

Usage notes

Walmart requires one or more of the following 'Product/Service ID Qualifier' elements (IT106-IT124 [Even]) be sent in the IT1:
. 'IN' (Buyer's Item Number)
. 'EN' (GTIN-13)
. 'UP' (GTIN-12)

CH
Country of Origin Code
EN
GTIN-13
IN
Buyer's Item Number
LT
Lot Number
UK
GTIN-14
UP
GTIN-12
ZZ
Mutually Defined
IT1-19
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

IT1-20
235
Product/Service ID Qualifier
Optional
Identifier (ID)

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

Usage notes

Walmart requires one or more of the following 'Product/Service ID Qualifier' elements (IT106-IT124 [Even]) be sent in the IT1:
. 'IN' (Buyer's Item Number)
. 'EN' (GTIN-13)
. 'UP' (GTIN-12)

CH
Country of Origin Code
EN
GTIN-13
IN
Buyer's Item Number
LT
Lot Number
UK
GTIN-14
UP
GTIN-12
ZZ
Mutually Defined
IT1-21
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

IT1-22
235
Product/Service ID Qualifier
Optional
Identifier (ID)

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

Usage notes

Walmart requires one or more of the following 'Product/Service ID Qualifier' elements (IT106-IT124 [Even]) be sent in the IT1:
. 'IN' (Buyer's Item Number)
. 'EN' (GTIN-13)
. 'UP' (GTIN-12)

CH
Country of Origin Code
EN
GTIN-13
IN
Buyer's Item Number
LT
Lot Number
UK
GTIN-14
UP
GTIN-12
ZZ
Mutually Defined
IT1-23
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

IT1-24
235
Product/Service ID Qualifier
Optional
Identifier (ID)

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

Usage notes

Walmart requires one or more of the following 'Product/Service ID Qualifier' elements (IT106-IT124 [Even]) be sent in the IT1:
. 'IN' (Buyer's Item Number)
. 'EN' (GTIN-13)
. 'UP' (GTIN-12)

CH
Country of Origin Code
EN
GTIN-13
IN
Buyer's Item Number
LT
Lot Number
UK
GTIN-14
UP
GTIN-12
ZZ
Mutually Defined
IT1-25
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

PID Loop
OptionalMax 1000
PID
0600
Detail > IT1 Loop > PID Loop > PID

Product/Item Description

RequiredMax use 1

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

Usage notes

In addition to communicating Compliance detail the PID segment can be used to communicate Product descriptions using a PID01 qualifier of 'F' (Free-form) and PID05.

For compliance with California Air Resource Board's Air Toxic Control Measure (CARB) or TSCA (Toxic Substances Control Act) Title VI for formaldehyde emissions a PID with a 'S' (Structured) in the PID01, 'VI' (VICS EDI) in the PID03, and the applicable selection from the codelist provided in the PID04 and PID05.

Example
If Product Description Code (PID-04) is present, then Agency Qualifier Code (PID-03) is required
At least one of Product Description Code (PID-04) or Description (PID-05) is required
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

Used along with free-format PID05 to send Product Descriptions.

S
Structured (From Industry Code List)

Used for compliance with California Air Resource Board's Air Toxic Control Measure (CARB) see segment note.

PID-03
559
Agency Qualifier Code
Optional
Identifier (ID)

Code identifying the agency assigning the code values

  • Use PID03 to indicate the organization that publishes the code list being referred to.
VI
Voluntary Inter-Industry Commerce Standard (VICS) EDI

Used for compliance with California Air Resource Board's Air Toxic Control Measure (CARB) see segment note.

PID-04
751
Product Description Code
Optional
String (AN)

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

  • PID04 should be used for industry-specific product description codes.
GM04COMPFE
California Air Resources Board (CARB) Formaldehyde Act

Indication of compliance with CARB Rule
Used for compliance with California Air Resource Board's Air Toxic Control Measure (CARB) see segment note.

GM04COMPTS
TSCA (Toxic Substances Control Act) Title VI
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

Free Format Item Description sent here. For compliance use see codelist:
Code Name

  • 2: CARB Phase II Compliant
    Description: All composite wood materials sold with the product are
    compliant with Phase 2 of the CARB formaldehyde emissions rules.
  • 3: CARB No Additional Formaldehyde compliant
    Description: Product is exempt from compliance testing because it is
    fabricated using CARB approved "No Added Formaldehyde" materials.
  • 4: CARB Ultra Low Emission Formaldehyde compliant
    Description: Product is exempt from compliance testing because it is
    fabricated using CARB approved "Ultra Low Emission Formaldehyde"
    material.
  • 5: TSCA Title VI Compliant
PID Loop end
PO4
1000
Detail > IT1 Loop > PO4

Item Physical Details

OptionalMax use 1

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

Usage notes

This segment is required when the IT103 contains a Unit of Measure of 'CA' (Cases) and is used to identify the number of selling units are in a case. Do not send if the IT103 contains a Unit of Measure in 'EA' (Eaches).

Example
PO4-01
356
Pack
Optional
Numeric (N0)
Min 1Max 6

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

PO4-14
810
Inner Pack
Optional
Numeric (N0)
Min 1Max 6

The number of eaches per inner container

SAC Loop
OptionalMax >1
SAC
1800
Detail > IT1 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

Example
If either Allowance/Charge Percent Qualifier (SAC-06) or Percent, Decimal Format (SAC-07) is present, then the other is required
If either Unit or Basis for Measurement Code (SAC-09) or Quantity (SAC-10) is present, then the other is required
SAC-01
248
Allowance or Charge Indicator
Required
Identifier (ID)

Code which indicates an allowance or charge for the service specified

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

Code identifying the service, promotion, allowance, or charge

A260
Advertising Allowance
B000
Central Buy
B270
Collect Surcharge

Collection Allowance

B720
Cooperative Advertising/Merchandising Allowance (Performance)
B950
Damaged Merchandise
C000
Defective Allowance
C310
Discount
C320
Display Allowance
C490
Drum Deposit
C530
Duty Charge
C540
Early Buy Allowance
C550
Early Payment Allowance
C580
Emergency Service
D170
Free Goods
D240
Freight

Accepted as an allowance only; charges not accepted with this code.

D500
Handling
E720
New Distribution Allowance
E740
New Store Allowance
E750
New Store Discount
F180
Pallet
F210
Parish/County Sales Tax (only)

County Excise Tax

F330
Pickup and Delivery
F670
Price and Marketing Allowance
F800
Promotional Allowance
F910
Quantity Discount
F970
Rebate
G470
Restocking Charge

Restocking Fee

G970
Small Order Charge

Order Quantity Fee

H010
Special Buy
H420
Storage in Transit
H505
Sugar Fee

Sugar Sweetened Beverage Tax

H560
Swell
H750
Tax - Sales Tax (State and Local)

Pre-collected/Prepaid Sales Tax

H770
Tax - State Tax

State Excise Tax

H780
Tax - Super Fund Excise Tax

Federal Superfund

H910
Temperature Protection
H920
Temporary Allowance
I170
Trade Discount
I310
Truckload Discount
I410
Unsaleable Merchandise Allowance
I530
Volume Discount
I570
Warehouse
SAC-05
610
Amount
Required
Numeric (N2)
Min 1Max 15

Monetary amount

  • SAC05 is the total amount for the service, promotion, allowance, or charge.
  • If SAC05 is present with SAC07 or SAC08, then SAC05 takes precedence.
Usage notes

When a Service, Promotion, Allowance or Charge (SAC) segment is sent this element is required by Walmart.

SAC-06
378
Allowance/Charge Percent Qualifier
Optional
Identifier (ID)

Code indicating on what basis allowance or charge percent is calculated

1
Item List Cost
2
Item Net Cost
3
Discount/Gross

All allowances are off the gross price including cash discount.

4
Discount/Net

All allowances are off the gross price. Cash discounts are off the net.

5
Base Price per Unit

Line item discount

6
Base Price Amount
7
Base Price Amount Less Previous Discount

Declining balance method

SAC-07
332
Percent, Decimal Format
Optional
Decimal number (R)
Min 1Max 6

Percent given in decimal format (e.g., 0.0 through 100.0 represents 0% through 100%)

Usage notes

The percent is sent with a decimal point only when needed, e.g., 10.5% is sent as ‘‘10.5’’, and 2% is sent as ‘‘2’’.

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.
SAC-09
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

CA
Case
EA
Each
SAC-10
380
Quantity
Optional
Decimal number (R)
Min 1Max 15

Numeric value of quantity

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

When SAC02 contains code D170, this data element is required and will contain the quantity of free goods. The unit of measure is in SAC09.
SAC10 alone is used to indicate a specific quantity which could be a dollar amount, that is applicable to the service, promotion, allowance, or charge.

SAC-12
331
Allowance or Charge Method of Handling Code
Optional
Identifier (ID)

Code indicating method of handling for an allowance or charge

02
Off Invoice

The allowance or charge amount will be reflected in the total transaction amount, e.g., Total Invoice Amount = Merchandise Price + Charges - Allowances.

06
Charge to be Paid by Customer

When the order/item is a direct ship to the customer, or end consumer of the retailer, the allowance or charge amount is the responsibility of the customer or end consumer. If it is not a drop ship to the customer of the retailer, then the allowance or charge amount is the responsibility of the retailer. The exact method of adjudication
has been agreed to by the trading partners. The amount will not be reflected in the total invoice amount.

SAC Loop end
IT1 Loop end
Detail end

Summary

TDS
0100
Summary > TDS

Total Monetary Value Summary

RequiredMax use 1

To specify the total invoice discounts and amounts

Example
TDS-01
610
Amount
Required
Numeric (N2)
Min 1Max 15

Monetary amount

  • TDS01 is the total amount of invoice (including charges, less allowances) before terms discount (if discount is applicable).
Usage notes

Walmart Note(s): Two decimal places are assumed. Example: 1526 will be interpreted as 15.26

Walmart Credit Invoice Note(s): To send an acceptable Walmart store credit invoice the TDS01 (Amount) must be negative to offset the amount of the original invoice.

Example values
  • 422169
  • -422169
TXI
0200
Summary > TXI

Tax Information

OptionalMax use >1

To specify tax information

Usage notes

Only send tax(s) that apply. If multiple taxes apply multiple TXI segments may be sent. (Example Quebec QST and Canadian GST are commonly both sent.) If an item is sold in an area were tax is typically applied as a non-taxable or tax exempt the TXI is still required and should have a zero in the TXI02 and the typical tax percent in the TXI03. This applies to both Canadian and US Puerto Rico tax types.

Example
If either Tax Jurisdiction Code Qualifier (TXI-04) or Tax Jurisdiction Code (TXI-05) is present, then the other is required
TXI-01
963
Tax Type Code
Required
Identifier (ID)

Code specifying the type of tax

BE
Harmonized Sales Tax
GS
Goods and Services Tax
PG
State or Provincial Tax on Goods
SE
State Excise Tax
ST
State Sales Tax
TXI-02
782
Monetary Amount
Required
Decimal number (R)
Min 1Max 15

Monetary amount

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

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

  • TXI03 is the tax percent expressed as a decimal.
Example values
  • 6
  • 7.5
TXI-04
955
Tax Jurisdiction Code Qualifier
Optional
Identifier (ID)

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

SP
State or Province
TXI-05
956
Tax Jurisdiction Code
Optional
String (AN)

Code identifying the taxing jurisdiction

HI
Hawaii
PR
Puerto Rico
QST
Québec sales tax
TXI-08
828
Dollar Basis For Percent
Optional
Decimal number (R)
Min 1Max 9

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

TXI-09
325
Tax Identification Number
Optional
String (AN)
Min 1Max 20

Number assigned to a purchaser (buyer, orderer) by a taxing jurisdiction (state, county, etc.); often called a tax exemption number or certificate number

Usage notes

The Tax Identification Number (TXI09) is required by Walmart when the Tax Type Code contains one of the following qualifiers: Harmonized Sales Tax (BE), Goods and Services Tax (GS), or State or Provincial Tax on Goods (PG)

Example values
  • 687649098RT0001
  • 1098765743TQ0001
CAD
0300
Summary > CAD

Carrier Details

OptionalMax use 1

To specify transportation details for the transaction

Usage notes

The CAD segment is required for backhaul shipments, but is recommended for all shipments.

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

Code specifying the method or type of transportation for the shipment

T
Best Way (Shippers Option)
CAD-04
140
Standard Carrier Alpha Code
Optional
Identifier (ID)
Min 2Max 4

Standard Carrier Alpha Code

CAD-05
387
Routing
Optional
String (AN)
Min 1Max 35

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

CAD-07
128
Reference Identification Qualifier
Optional
Identifier (ID)

Code qualifying the Reference Identification

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

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

SAC Loop
OptionalMax >1
SAC
0400
Summary > 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

There is one segment for each Allowance, Charge, Service, or Promotion being specified. If this segment appears in the summary area of the transaction set, the data applies to the entire transaction set. If this
segment appears in the detail area of the transaction set, the data applies only to that line item. The data specified in the summary area is exclusive of the data specified in the detail area; it is not the sum of the
data in the detail area, i.e., allowances or charges. SAC04 contains special service requirement codes and special processing codes. This code list is maintained in Section III of this guideline.

Example
If either Allowance/Charge Percent Qualifier (SAC-06) or Percent, Decimal Format (SAC-07) is present, then the other is required
If either Unit or Basis for Measurement Code (SAC-09) or Quantity (SAC-10) is present, then the other is required
SAC-01
248
Allowance or Charge Indicator
Required
Identifier (ID)

Code which indicates an allowance or charge for the service specified

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

Code identifying the service, promotion, allowance, or charge

A260
Advertising Allowance
B000
Central Buy
B270
Collect Surcharge
B720
Cooperative Advertising/Merchandising Allowance (Performance)
B950
Damaged Merchandise
C000
Defective Allowance
C220
Development Charge
C310
Discount
C320
Display Allowance
C490
Drum Deposit
C530
Duty Charge
C540
Early Buy Allowance
C550
Early Payment Allowance
C580
Emergency Service
D170
Free Goods
D240
Freight
D500
Handling
E720
New Distribution Allowance
E740
New Store Allowance
E750
New Store Discount
F180
Pallet
F210
Parish/County Sales Tax (only)
F910
Quantity Discount
F920
Quantity Surcharge
F970
Rebate
G470
Restocking Charge
G970
Small Order Charge
H010
Special Buy
H420
Storage in Transit
H560
Swell
H750
Tax - Sales Tax (State and Local)
H770
Tax - State Tax
H780
Tax - Super Fund Excise Tax
H910
Temperature Protection
H920
Temporary Allowance
I170
Trade Discount
I310
Truckload Discount
I410
Unsaleable Merchandise Allowance
I530
Volume Discount
I570
Warehouse
SAC-05
610
Amount
Optional
Numeric (N2)
Min 1Max 15

Monetary amount

  • SAC05 is the total amount for the service, promotion, allowance, or charge.
  • If SAC05 is present with SAC07 or SAC08, then SAC05 takes precedence.
Usage notes

When SAC01 contains code A or code C, then this data element is
required. This will resolve any differences between the sender’s and receiver’s system calculations of amounts, i.e., rounding errors when allowances or charges are expressed in percentages or rates.

SAC-06
378
Allowance/Charge Percent Qualifier
Optional
Identifier (ID)

Code indicating on what basis allowance or charge percent is calculated

1
Item List Cost
2
Item Net Cost
3
Discount/Gross
4
Discount/Net
5
Base Price per Unit
7
Base Price Amount Less Previous Discount
SAC-07
332
Percent, Decimal Format
Optional
Decimal number (R)
Min 1Max 6

Percent given in decimal format (e.g., 0.0 through 100.0 represents 0% through 100%)

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.
SAC-09
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

CA
Case
EA
Each
SAC-10
380
Quantity
Optional
Decimal number (R)
Min 1Max 15

Numeric value of quantity

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

When SAC02 contains code D170, this data element is required and
will contain the quantity of free goods. The unit of measure is in SAC09.
SAC10 alone is used to indicate a specific quantity which could be a dollar amount, that is applicable to the service, promotion, allowance, or charge.

SAC-12
331
Allowance or Charge Method of Handling Code
Optional
Identifier (ID)

Code indicating method of handling for an allowance or charge

02
Off Invoice
06
Charge to be Paid by Customer
SAC Loop end
ISS Loop
OptionalMax >1
ISS
0600
Summary > ISS Loop > ISS

Invoice Shipment Summary

RequiredMax use 1

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

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

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

Usage notes

Walmart cannot accept an ISS01 (Number of Units Shipped) of One Hundred Thousand or more units. Please use an appropriate Unit of Measure or do not send the ISS if this causes an issue on your Walmart invoice.

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

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

CA
Case
EA
Each
ISS-03
81
Weight
Optional
Decimal number (R)
Min 1Max 10

Numeric value of weight

Usage notes

Walmart cannot accept an ISS03 (Weight) of One Hundred Thousand or more units. Please use an appropriate Unit of Measure or do not send the ISS if this causes an issue on your Walmart invoice.

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

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

KG
Kilogram
LB
Pound
ISS Loop end
CTT
0700
Summary > CTT

Transaction Totals

OptionalMax use 1

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

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

Total number of line items in the transaction set

SE
0800
Summary > SE

Transaction Set Trailer

RequiredMax use 1

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

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

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

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

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

Summary end

Functional Group Trailer

RequiredMax use 1

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

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

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

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

Assigned number originated and maintained by the sender

Interchange Control Trailer

RequiredMax use 1

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

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

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

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

A control number assigned by the interchange sender

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.