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

ISA Interchange Control Header

Required · Max use 1

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

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 10 Max 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 10 Max 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 2 Max 2

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

Codes

• 01: Duns (Dun & Bradstreet)
• 02: SCAC (Standard Carrier Alpha Code)
• 03: FMC (Federal Maritime Commission)
• 04: IATA (International Air Transport Association)
• 08: UCC EDI Communications ID (Comm ID)
• 09: X.121 (CCITT)
• 10: Department of Defense (DoD) Activity Address Code
• 11: DEA (Drug Enforcement Administration)
• 12: Phone (Telephone Companies)
• 13: UCS Code (The UCS Code is a Code Used for UCS Transmissions; it includes the Area Code and Telephone Number of a Modem; it Does Not Include Punctuation, Blanks or Access Code)
• 14: Duns Plus Suffix
• 15: Petroleum Accountants Society of Canada Company Code
• 16: Duns Number With 4-Character Suffix
• 17: American Bankers Association (ABA) Transit Routing Number (Including Check Digit, 9 Digit)
• 18: Association of American Railroads (AAR) Standard Distribution Code
• 19: EDI Council of Australia (EDICA) Communications ID Number (COMM ID)
• 20: Health Industry Number (HIN)
• 21: Integrated Postsecondary Education Data System, or (IPEDS)
• 22: Federal Interagency Commission on Education, or FICE
• 23: National Center for Education Statistics Common Core of Data 12-Digit Number for Pre-K-Grade 12 Institutes, or NCES
• 24: The College Board's Admission Testing Program 4-Digit Code of Postsecondary Institutes, or ATP
• 25: American College Testing Program 4-Digit Code of Postsecondary Institutions, or ACT
• 26: Statistics of Canada List of Postsecondary Institutions
• 27: Carrier Identification Number as assigned by Health Care Financing Administration (HCFA)
• 28: Fiscal Intermediary Identification Number as assigned by Health Care Financing Administration (HCFA)
• 29: Medicare Provider and Supplier Identification Number as assigned by Health Care Financing Administration (HCFA)
• 30: U.S. Federal Tax Identification Number
• 31: Jurisdiction Identification Number Plus 4 as assigned by the International Association of Industrial Accident Boards and Commissions (IAIABC)
• 32: U.S. Federal Employer Identification Number (FEIN)
• 33: National Association of Insurance Commissioners Company Code (NAIC)
• 34: Medicaid Provider and Supplier Identification Number as assigned by individual State Medicaid Agencies in conjunction with Health Care Financing Administration (HCFA)
• 35: Statistics Canada Canadian College Student Information System Institution Codes
• 36: Statistics Canada University Student Information System Institution Codes
• 37: Society of Property Information Compilers and Analysts
• AM: Association Mexicana del Codigo de Producto (AMECOP) Communication ID
• NR: National Retail Merchants Association (NRMA) - Assigned
• SN: Standard Address Number
• ZZ: Mutually Defined

ISA-06 · I06 · Interchange Sender ID · Required · String (AN) · Min 15 Max 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 2 Max 2

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

Codes

• 01: Duns (Dun & Bradstreet)
• 02: SCAC (Standard Carrier Alpha Code)
• 03: FMC (Federal Maritime Commission)
• 04: IATA (International Air Transport Association)
• 08: UCC EDI Communications ID (Comm ID)
• 09: X.121 (CCITT)
• 10: Department of Defense (DoD) Activity Address Code
• 11: DEA (Drug Enforcement Administration)
• 12: Phone (Telephone Companies)
• 13: UCS Code (The UCS Code is a Code Used for UCS Transmissions; it includes the Area Code and Telephone Number of a Modem; it Does Not Include Punctuation, Blanks or Access Code)
• 14: Duns Plus Suffix
• 15: Petroleum Accountants Society of Canada Company Code
• 16: Duns Number With 4-Character Suffix
• 17: American Bankers Association (ABA) Transit Routing Number (Including Check Digit, 9 Digit)
• 18: Association of American Railroads (AAR) Standard Distribution Code
• 19: EDI Council of Australia (EDICA) Communications ID Number (COMM ID)
• 20: Health Industry Number (HIN)
• 21: Integrated Postsecondary Education Data System, or (IPEDS)
• 22: Federal Interagency Commission on Education, or FICE
• 23: National Center for Education Statistics Common Core of Data 12-Digit Number for Pre-K-Grade 12 Institutes, or NCES
• 24: The College Board's Admission Testing Program 4-Digit Code of Postsecondary Institutes, or ATP
• 25: American College Testing Program 4-Digit Code of Postsecondary Institutions, or ACT
• 26: Statistics of Canada List of Postsecondary Institutions
• 27: Carrier Identification Number as assigned by Health Care Financing Administration (HCFA)
• 28: Fiscal Intermediary Identification Number as assigned by Health Care Financing Administration (HCFA)
• 29: Medicare Provider and Supplier Identification Number as assigned by Health Care Financing Administration (HCFA)
• 30: U.S. Federal Tax Identification Number
• 31: Jurisdiction Identification Number Plus 4 as assigned by the International Association of Industrial Accident Boards and Commissions (IAIABC)
• 32: U.S. Federal Employer Identification Number (FEIN)
• 33: National Association of Insurance Commissioners Company Code (NAIC)
• 34: Medicaid Provider and Supplier Identification Number as assigned by individual State Medicaid Agencies in conjunction with Health Care Financing Administration (HCFA)
• 35: Statistics Canada Canadian College Student Information System Institution Codes
• 36: Statistics Canada University Student Information System Institution Codes
• 37: Society of Property Information Compilers and Analysts
• AM: Association Mexicana del Codigo de Producto (AMECOP) Communication ID
• NR: National Retail Merchants Association (NRMA) - Assigned
• SN: Standard Address Number
• ZZ: Mutually Defined

ISA-08 · I07 · Interchange Receiver ID · Required · String (AN) · Min 15 Max 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 9 Max 9

A control number assigned by the interchange sender

ISA-14 · I13 · Acknowledgment Requested · Required · Identifier (ID) · Min 1 Max 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 1 Max 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 1 Max 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

GS Functional Group Header

Required · Max use 1

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

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 2 Max 15

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

GS-03 · 124 · Application Receiver's Code · Required · String (AN) · Min 2 Max 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 1 Max 9

Assigned number originated and maintained by the sender

GS-07 · 455 · Responsible Agency Code · Required · Identifier (ID) · Min 1 Max 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

010 Heading > ST

ST Transaction Set Header

Required · Max use 1

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

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

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

020 Heading > BEG

BEG Beginning Segment for Purchase Order

Required · Max use 1

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

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 1 Max 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.

050 Heading > REF

REF Customer Order Number

Required · Max 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.

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 1 Max 30

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

050 Heading > REF

REF Facility Id Number

Optional · Max 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.

Variants (all may be used)

REFCustomer Order NumberREFInternal Vendor NumberREFWalmart Store Number

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 1 Max 30

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

050 Heading > REF

REF Internal Vendor Number

Optional · Max 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.

Variants (all may be used)

REFCustomer Order NumberREFFacility Id NumberREFWalmart Store Number

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 1 Max 30

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

050 Heading > REF

REF Walmart Store Number

Optional · Max use >1

To specify identifying information

Usage notes

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

Variants (all may be used)

REFCustomer Order NumberREFFacility Id NumberREFInternal Vendor Number

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 1 Max 30

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

090 Heading > CTP

CTP Pricing Information

Required · Max 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.

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 1 Max 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 1 Max 15

Numeric value of quantity

Usage notes

Always 1 unit quantity.

CTP-05 · C001 · Composite Unit of Measure · Optional Max use 1 · 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

110 Heading > CSH

CSH Sales Requirements

Required · Max use 5

To specify general conditions or requirements of the sale

Usage notes

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

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

150 Heading > DTM

DTM Customer Order

Required · Max use 10

To specify pertinent dates and times

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

150 Heading > DTM

DTM Date/Time Reference

Optional · Max 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

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 Required Max >1

295 Heading > N9 Loop > N9

N9 Reference Identification

Required · Max 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.

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

300 Heading > N9 Loop > MSG

MSG Message Text

Optional · Max 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

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 1 Max 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 1 Max 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 Required Max >1

310 Heading > N1 Loop > N1

N1 Name

Required · Max 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.

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 1 Max 60

Free-form name

330 Heading > N1 Loop > N3

N3 Address Information

Required · Max use 2

To specify the location of the named party

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

Address information

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

Address information

340 Heading > N1 Loop > N4

N4 Geographic Location

Required · Max use >1

To specify the geographic place of the named party

If Location Identifier (N4-06) is present, then Location Qualifier (N4-05) is required

N4-01 · 19 · City Name · Optional · String (AN) · Min 2 Max 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 2 Max 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 3 Max 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 2 Max 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 1 Max 30

Code which identifies a specific location

Usage notes

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

350 Heading > N1 Loop > REF

REF Permit Number

Optional · Max 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".

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 1 Max 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 Max use 1 · 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 1 Max 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 1 Max 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 1 Max 30

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

Usage notes

Returns Permit Zip Code

350 Heading > N1 Loop > REF

REF Reference Identification

Optional · Max 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".

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 1 Max 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).

360 Heading > N1 Loop > PER

PER Administrative Communications Contact

Optional · Max 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".

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 1 Max 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 1 Max 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 1 Max 80

Complete communications number including country or area code when applicable

390 Heading > N1 Loop > TD5

TD5 Carrier Details (Routing Sequence/Transit Time)

Optional · Max use 12

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

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

Detail

PO1 Loop Required Max >1

010 Detail > PO1 Loop > PO1

PO1 Baseline Item Data

Required · Max use 1

To specify basic and most frequently used line item data

• PO102 is required.

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 1 Max 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 1 Max 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 1 Max 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 1 Max 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 1 Max 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 1 Max 48

Identifying number for a product or service

Usage notes

Supplier's item SKU.

PID Loop Required Max >1

050 Detail > PO1 Loop > PID Loop > PID

PID Product/Item Description

Required · Max use 1

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

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 1 Max 80

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

Usage notes

Item description.

SAC Loop Required Max >1

130 Detail > PO1 Loop > SAC Loop > SAC

SAC Service, Promotion, Allowance, or Charge Information

Required · Max 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.

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 1 Max 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 1 Max 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 Data Source Optional Max >1

Usage notes

This segment contain dynamic-data elements for item configuration

Variants (all may be used)

Service Performed Code

330 Detail > PO1 Loop > Data Source > N9

N9 Reference Identification

Required · Max use 1

To transmit identifying information as specified by the Reference Identification Qualifier

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 1 Max 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 1 Max 45

Free-form descriptive text

Usage notes

This is the name of a dynamic data element.

340 Detail > PO1 Loop > Data Source > MSG

MSG Message Text

Optional · Max 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.

MSG-01 · 933 · Free-Form Message Text · Required · String (AN) · Min 1 Max 264

Free-form message text

N9 Service Performed Code Optional Max >1

Variants (all may be used)

Data Source

330 Detail > PO1 Loop > Service Performed Code > N9

N9 Reference Identification

Required · Max 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

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 1 Max 45

Free-form descriptive text

N9-07 · C040 · Reference Identifier · Optional Max use 1 · 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 1 Max 30

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

340 Detail > PO1 Loop > Service Performed Code > MSG

MSG Message Text

Optional · Max 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

MSG-01 · 933 · Free-Form Message Text · Required · String (AN) · Min 1 Max 264

Free-form message text

Summary

CTT Loop Required Max >1

010 Summary > CTT Loop > CTT

CTT Transaction Totals

Required · Max 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.

CTT-01 · 354 · Number of Line Items · Required · Numeric (N0) · Min 1 Max 6

Total number of line items in the transaction set

030 Summary > SE

SE Transaction Set Trailer

Required · Max 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)

SE-01 · 96 · Number of Included Segments · Required · Numeric (N0) · Min 1 Max 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 4 Max 9

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

GE Functional Group Trailer

Required · Max use 1

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

GE-01 · 97 · Number of Transaction Sets Included · Required · Numeric (N0) · Min 1 Max 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 1 Max 9

Assigned number originated and maintained by the sender

IEA Interchange Control Trailer

Required · Max use 1

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

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

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

IEA-02 · I12 · Interchange Control Number · Required · Numeric (N0) · Min 9 Max 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