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

X12 850 Purchase Order

X12 Release 5010

This X12 Transaction Set 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
  • ^ Repetition
EDI samples
  • None included
View the latest version of this implementation guide as an interactive webpage
https://www.stedi.com/app/guides/view/williams-sonoma/purchase-order/01H2DTN1WANHVTKQENPD0HBC85
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
BEG
0200
Beginning Segment for Purchase Order
Max use 1
Required
CUR
0400
Currency
Max use 1
Optional
REF
0500
Reference Information
Max use 1
Required
PER
0600
Administrative Communications Contact
Max use 3
Optional
FOB
0800
F.O.B. Related Instructions
Max use 1
Optional
CSH
1100
Sales Requirements
Max use 5
Optional
ITD
1300
Terms of Sale/Deferred Terms of Sale
Max use 1
Optional
TD5
2400
Carrier Details (Routing Sequence/Transit Time)
Max use 1
Optional
TD3
2500
Carrier Details (Equipment)
Max use 12
Optional
N9 Loop
detail
PO1 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

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

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

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

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

Required
Date (DT)
CCYYMMDD format

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

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

005010
Standards Approved for Publication by ASC X12 Procedures Review Board through October 2003

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).
850
Purchase Order
ST-02
329
Transaction Set Control Number
Required
Numeric (N)
Min 4Max 9

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

BEG
0200
Heading > BEG

Beginning Segment for Purchase Order

RequiredMax use 1

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

Example
BEG-01
353
Transaction Set Purpose Code
Required
Identifier (ID)

Code identifying purpose of transaction set

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

Code specifying the type of Purchase Order

DR
Direct Ship

Ships directly to multiple stores.

DS
Dropship

Ships to consumer (may flow through a Williams Sonoma DC, but must still include a branded packing slip)

SA
Stand-alone Order

Ships directly to a DC or Store.

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

Identifying number for Purchase Order assigned by the orderer/purchaser

Required
Date (DT)
CCYYMMDD format

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

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

Purchase Order Date

CUR
0400
Heading > CUR

Currency

OptionalMax use 1

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

Example
CUR-01
98
Entity Identifier Code
Required
Identifier (ID)

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

BY
Buying Party (Purchaser)
CUR-02
100
Currency Code
Required
Identifier (ID)
Min 3Max 3

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

REF
0500
Heading > REF

Reference Information

RequiredMax use >1

To specify identifying information

Usage notes

On drop ship Purchase Orders, when REF01 = 19, REF02 will contain the Williams Sonoma division code that
determines which branded packing slip is to be used. REF03 will contain the full division name. Possible divisions are:
PB- Pottery Barn
WS- Williams Sonoma
WE- West Elm
PK - Pottery Barn Kids
PT - PBteen,
MG- Mark and Graham
RJ- Rejuvenation
WH- Williams Sonoma Home
GR- GreenRow There will never be drop ship orders for brand GR, so there is no corresponding branded packing slip for this division.
OT - Other: There will never be drop ship orders for brand OT, so there is no corresponding branded packing slip for this division.
If a perishable order, REF01 of PO will be present and REF03 will say 'Perishable'.

When REF01 = AN, REF02 will be one of the following Purchase Order SubTypes
Complimentary - Complimentary order for the consumer due to issues with the original order
Replacement - replacement order for the consumer due to issues with the original order
Regular - Regular Order

Example
At least one of Reference Identification (REF-02) or Description (REF-03) is required
REF-01
128
Reference Identification Qualifier
Required
Identifier (ID)

Code qualifying the Reference Identification

19
Division Identifier
87
Functional Category

WSI uses to advise the Purchase Order Category ('INT' for international and 'DOM' for domestic).

AN
Associated Purchase Orders

WSI Purchase Order Sub-Type

CO
Customer Order Number
DP
Department Number

Williams Sonoma Department Number

IA
Internal Vendor Number

Williams Sonoma assigned vendor ID - Mandatory

MR
Merchandise Type Code

Williams Sonoma Channel code to be used on the GS1-128 label.

PO
Purchase Order Number
REF-02
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

REF-03
352
Description
Optional
String (AN)
Min 1Max 80

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

PER
0600
Heading > PER

Administrative Communications Contact

OptionalMax use 3

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

Example
PER-01
366
Contact Function Code
Required
Identifier (ID)

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

BD
Buyer Name or Department
Required
String (AN)
Min 1Max 60

Free-form name

FOB
0800
Heading > FOB

F.O.B. Related Instructions

OptionalMax use 1

To specify transportation instructions relating to shipment

Example
If Description (FOB-03) is present, then Location Qualifier (FOB-02) is required
If Transportation Terms Qualifier Code (FOB-04) is present, then Transportation Terms Code (FOB-05) is required
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
DF
Defined by Buyer and Seller
PP
Prepaid (by Seller)
FOB-02
309
Location Qualifier
Optional
Identifier (ID)

Code identifying type of location

  • FOB02 is the code specifying transportation responsibility location.
OR
Origin (Shipping Point)
FOB-03
352
Description
Optional
String (AN)
Min 1Max 80

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

FOB-04
334
Transportation Terms Qualifier Code
Optional
Identifier (ID)

Code identifying the source of the transportation terms

01
Incoterms
FOB-05
335
Transportation Terms Code
Optional
Identifier (ID)

Code identifying the trade terms which apply to the shipment transportation responsibility

CFR
Cost and Freight
CIF
Cost, Insurance, and Freight
CIP
Carriage and Insurance Paid To
CPT
Carriage Paid To
DDU
Deliver Duty Unpaid
DEQ
Delivered Ex Quay
EXW
Ex Works
FCA
Free Carrier
FOB
Free on Board
CSH
1100
Heading > CSH

Sales Requirements

OptionalMax use 5

To specify general conditions or requirements of the sale

Example
CSH-01
563
Sales Requirement Code
Optional
Identifier (ID)

Code to identify a specific requirement or agreement of sale

BK
Ship Partial - Balance Back Order
SC
Ship Complete
ITD
1300
Heading > ITD

Terms of Sale/Deferred Terms of Sale

OptionalMax use 1

To specify terms of sale

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

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

Usage notes

Terms Description

ITD-14
107
Payment Method Type Code
Optional
Identifier (ID)

Code identifying type of payment procedures

L
Letter of Credit
T
Wire Transfer
TD5
2400
Heading > TD5

Carrier Details (Routing Sequence/Transit Time)

OptionalMax use 1

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

Usage notes

If this is a flow through order (N101 of BY is present) then the TD504 element pertains to the first leg of the shipment and the TD505 and TD512 pertain to the second leg (final mile).

Example
TD5-04
91
Transportation Method/Type Code
Optional
Identifier (ID)

Code specifying the method or type of transportation for the shipment

A
Air
LT
Less Than Trailer Load (LTL)
M
Motor (Common Carrier)
O
Containerized Ocean
R
Rail
T
Best Way (Shippers Option)
U
Private Parcel Service
VE
Vessel, Ocean
TD5-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

Usage notes

Carrier Routing / Name

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

3D
Three Day Service
CG
Ground
CX
Express Service
G2
Standard Service
ON
Overnight
SE
Second Day
TD3
2500
Heading > TD3

Carrier Details (Equipment)

OptionalMax use 12

To specify transportation details relating to the equipment used by the carrier

Example
TD3-01
40
Equipment Description Code
Optional
Identifier (ID)

Code identifying type of equipment used for shipment

CN
Container
N9 Loop
OptionalMax 10
N9
2950
Heading > N9 Loop > N9

Extended Reference Information

RequiredMax use 1

To transmit identifying information as specified by the Reference Identification Qualifier

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

Code qualifying the Reference Identification

L1
Letters or Notes
N9-02
127
Reference Identification
Required
String (AN)

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

Usage notes

N902 will contain one of the following 3 characters codes to identify the type of note to
follow in MTX02.
. GEN: General Note
. SHP: Shipping Note
. PCK: Packing Slip Notes (To be included on the Branded Packing Slip.)
. GFT: Gift Notes (To be included on the Branded Packing Slip.)
. RTN: Return Instructions (To be included on the Branded Packing Slip.)

GEN
General Note
GFT
Gift Notes (To be included on the Branded Packing Slip.)
PCK
Packing Slip Notes (To be included on the Branded Packing Slip.)
RTN
Return Instructions (To be included on the Branded Packing Slip.)
SHP
Shipping Note
MTX
3000
Heading > N9 Loop > MTX

Text

RequiredMax use 1

To specify textual data

Example
MTX-02
1551
Textual Data
Required
String (AN)
Min 1Max 4096

To transmit large volumes of message text

Usage notes

If N902 =

  • GEN - MTX02 is a General Note
  • SHP - MTX02 is a Shipping Note
  • PCK - MTX02 is a Packing Slip note (to be put on the Branded Packing Slip)
  • GFT - MTX02 is a Gfit Note (To be included on the Branded Packing Slip.)
  • RTN - MTX02 is a Return Instruction (To be included on the Branded Packing Slip.
N9 Loop end
N1 Loop
OptionalMax 4
N1
3100
Heading > N1 Loop > N1

Party Identification

RequiredMax use 1

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

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

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

AG
Agent/Agency

Import Agent

BT
Bill-to-Party

Legal Williams Sonoma Entity to be returned on Invoices

BY
Buying Party (Purchaser)

Conumer Buying Party
If this address is present it indicates this consumer order is flowing through a Williams Sonoma DC. A Branded Packing Slip must be included inside the carton and a GS1-128 label included on the outside.

FW
Forwarder

Freight Forwarder

SO
Sold To If Different From Bill To

Consumer Sold To address, to be included on the branded packing slip.

ST
Ship To

Either a header or line level ship to will always be provided.

VN
Vendor
Optional
String (AN)
Min 1Max 60

Free-form name

N1-03
66
Identification Code Qualifier
Optional
Identifier (ID)

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

92
Assigned by Buyer or Buyer's Agent
N1-04
67
Identification Code
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.
N2
3200
Heading > N1 Loop > N2

Additional Name Information

OptionalMax use 2

To specify additional names

Example
Required
String (AN)
Min 1Max 60

Free-form name

N3
3300
Heading > N1 Loop > N3

Party Location

OptionalMax use 2

To specify the location of the named party

Usage notes

Will be present when N101 = ST

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

Geographic Location

OptionalMax use 1

To specify the geographic place of the named party

Usage notes

Will be present when N101 = ST.

Example
N4-01
19
City Name
Required
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
Required
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

PER
3600
Heading > N1 Loop > PER

Administrative Communications Contact

OptionalMax use 1

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

Example
If either Communication Number Qualifier (PER-03) or Communication Number (PER-04) is present, then the other is required
If either Communication Number Qualifier (PER-05) or Communication Number (PER-06) is present, then the other is required
PER-01
366
Contact Function Code
Required
Identifier (ID)

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

IC
Information Contact
Optional
String (AN)
Min 1Max 60

Free-form name

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

Code identifying the type of communication number

TE
Telephone
PER-04
364
Communication Number
Optional
String (AN)
Min 1Max 256

Complete communications number including country or area code when applicable

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

Code identifying the type of communication number

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

Complete communications number including country or area code when applicable

N1 Loop end
Heading end

Detail

PO1 Loop
RequiredMax 100000
PO1
0100
Detail > PO1 Loop > PO1

Baseline Item Data

RequiredMax use 1

To specify basic and most frequently used line item data

  • PO102 is required.
Example
If 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
If either Product/Service ID Qualifier (PO1-12) or Product/Service ID (PO1-13) is present, then the other is required
PO1-01
350
Assigned Identification
Required
String (AN)
Min 1Max 20

Alphanumeric characters assigned for differentiation within a transaction set

  • PO101 is the line item identification.
Usage notes

PO Line #

PO1-02
380
Quantity
Required
Decimal number (R)
Min 1Max 15

Numeric value of quantity

  • PO102 is quantity ordered.
PO1-03
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
PO1-04
212
Unit Price
Required
Decimal number (R)
Min 1Max 15

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

PO1-06
235
Product/Service ID Qualifier
Required
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.
SK
Stock Keeping Unit (SKU)

Williams Sonoma assigned SKU

PO1-07
234
Product/Service ID
Required
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

The Williams Sonoma SKU must be included on the branded packing slip. If Subline/component items are present on the order, it is the master/bundled item that must be included on the branded packing slip.

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)

VN
Vendor's (Seller's) Item Number
PO1-09
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

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)

UP
UCC - 12
PO1-11
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

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

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

UK
GTIN 14-digit Data Structure
PO1-13
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

CUR
0200
Detail > PO1 Loop > CUR

Currency

OptionalMax use 1

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

Example
CUR-01
98
Entity Identifier Code
Required
Identifier (ID)

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

BY
Buying Party (Purchaser)
CUR-02
100
Currency Code
Required
Identifier (ID)
Min 3Max 3

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

CTP Loop
OptionalMax 1
CTP
0400
Detail > PO1 Loop > CTP Loop > CTP

Pricing Information

RequiredMax use 1

To specify pricing information

Usage notes

The retail price must be included on the branded packing slip.
If there are subline items - the master bundle item is the SKU and Price that is included on the branded packing slip.

Example
CTP-02
236
Price Identifier Code
Required
Identifier (ID)

Code identifying pricing specification

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

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

  • See Figures Appendix for an example detailing the use of CTP03 and CTP04.
  • See Figures Appendix for an example detailing the use of CTP03, CTP04 and CTP07.
CUR
0430
Detail > PO1 Loop > CTP Loop > CUR

Currency

OptionalMax use 1

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

Example
CUR-01
98
Entity Identifier Code
Required
Identifier (ID)

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

LW
Customer
CUR-02
100
Currency Code
Required
Identifier (ID)
Min 3Max 3

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

Usage notes

If present, the customer currency must be included on the branded packing slip.

CTP Loop end
MEA
0490
Detail > PO1 Loop > MEA

Measurements

OptionalMax use 40

To specify physical measurements or counts, including dimensions, tolerances, variances, and weights

(See Figures Appendix for example of use of C001)

Example
MEA-02
738
Measurement Qualifier
Optional
Identifier (ID)

Code identifying a specific product or process characteristic to which a measurement applies

HT
Height
LN
Length
VOL
Volume
WD
Width
WT
Weight
MEA-03
739
Measurement Value
Optional
Decimal number (R)
Min 1Max 15

The value of the measurement

MEA-04
C001
Composite Unit of Measure
OptionalMax 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

CC
Cubic Centimeter
CD
Carat
CI
Cubic Inches
CM
Centimeter
FT
Foot
IN
Inch
KG
Kilogram
LB
Pound
MM
Millimeter
OZ
Ounce - Av
PID Loop
RequiredMax 5
PID
0500
Detail > PO1 Loop > PID Loop > PID

Product/Item Description

RequiredMax use 1

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

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

Code indicating the format of a description

  • If PID01 equals "F", then PID05 is used. If PID01 equals "S", then PID04 is used. If PID01 equals "X", then both PID04 and PID05 are used.
F
Free-form
PID-02
750
Product/Process Characteristic Code
Required
Identifier (ID)

Code identifying the general class of a product or process characteristic

08
Product
09
Sub-product

Import description

PID-05
352
Description
Required
String (AN)
Min 1Max 80

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

PID Loop end
PO4
0900
Detail > PO1 Loop > PO4

Item Physical Details

OptionalMax use >1

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

Example
Required
Numeric (N0)
Min 1Max 6

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

Usage notes

Outer Pack Value.

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

The number of eaches per inner container

Usage notes

Inner Pack Value

REF
1000
Detail > PO1 Loop > REF

Reference Information Route Number

OptionalMax use >1

To specify identifying information

Usage notes

When REF01 = RU, REF02 is the WSI Ship Via Code and REF03 is the WSI assigned HUB code.
If present, both must be included on the GS1 Shipping Label.

Example
Variants (all may be used)
REFReference Information Tarrif Number
REF-01
128
Reference Identification Qualifier
Required
Identifier (ID)

Code qualifying the Reference Identification

RU
Route Number
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

REF-03
352
Description
Optional
String (AN)
Min 1Max 80

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

REF
1000
Detail > PO1 Loop > REF

Reference Information Tarrif Number

OptionalMax use >1

To specify identifying information

Usage notes

When REF01 = RU, REF02 is the WSI Ship Via Code and REF03 is the WSI assigned HUB code.
If present, both must be included on the GS1 Shipping Label.

Example
Variants (all may be used)
REFReference Information Route Number
REF-01
128
Reference Identification Qualifier
Required
Identifier (ID)

Code qualifying the Reference Identification

TS
Tariff Number
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

REF-03
352
Description
Optional
String (AN)
Min 1Max 80

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

SAC Loop
OptionalMax >1
SAC
1300
Detail > PO1 Loop > SAC Loop > SAC

Service, Promotion, Allowance, or Charge Information

RequiredMax use 1

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

Example
SAC-01
248
Allowance or Charge Indicator
Required
Identifier (ID)

Code which indicates an allowance or charge for the service specified

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

Code identifying the service, promotion, allowance, or charge

A470
Art Work

Used for Personalization charges.

D500
Handling
F155
Packaging
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.
SAC Loop end
ITD
1500
Detail > PO1 Loop > ITD

Terms of Sale/Deferred Terms of Sale

OptionalMax use 2

To specify terms of sale

Example
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-12
352
Description
Optional
String (AN)
Min 1Max 80

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

SDQ
1900
Detail > PO1 Loop > SDQ

Destination Quantity

OptionalMax use 500

To specify destination and quantity detail

Example
If either Identification Code (SDQ-05) or Quantity (SDQ-06) is present, then the other is required
If either Identification Code (SDQ-07) or Quantity (SDQ-08) is present, then the other is required
If either Identification Code (SDQ-09) or Quantity (SDQ-10) is present, then the other is required
If either Identification Code (SDQ-11) or Quantity (SDQ-12) is present, then the other is required
If either Identification Code (SDQ-13) or Quantity (SDQ-14) is present, then the other is required
If either Identification Code (SDQ-15) or Quantity (SDQ-16) is present, then the other is required
If either Identification Code (SDQ-17) or Quantity (SDQ-18) is present, then the other is required
If either Identification Code (SDQ-19) or Quantity (SDQ-20) is present, then the other is required
If either Identification Code (SDQ-21) or Quantity (SDQ-22) is present, then the other is required
SDQ-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
SDQ-02
66
Identification Code Qualifier
Optional
Identifier (ID)

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

  • SDQ02 is used only if different than previously defined in the transaction set.
92
Assigned by Buyer or Buyer's Agent
SDQ-03
67
Identification Code
Required
String (AN)
Min 2Max 80

Code identifying a party or other code

  • SDQ03 is the store number.
SDQ-04
380
Quantity
Required
Decimal number (R)
Min 1Max 15

Numeric value of quantity

SDQ-05
67
Identification Code
Optional
String (AN)
Min 2Max 80

Code identifying a party or other code

SDQ-06
380
Quantity
Optional
Decimal number (R)
Min 1Max 15

Numeric value of quantity

SDQ-07
67
Identification Code
Optional
String (AN)
Min 2Max 80

Code identifying a party or other code

SDQ-08
380
Quantity
Optional
Decimal number (R)
Min 1Max 15

Numeric value of quantity

SDQ-09
67
Identification Code
Optional
String (AN)
Min 2Max 80

Code identifying a party or other code

SDQ-10
380
Quantity
Optional
Decimal number (R)
Min 1Max 15

Numeric value of quantity

SDQ-11
67
Identification Code
Optional
String (AN)
Min 2Max 80

Code identifying a party or other code

SDQ-12
380
Quantity
Optional
Decimal number (R)
Min 1Max 15

Numeric value of quantity

SDQ-13
67
Identification Code
Optional
String (AN)
Min 2Max 80

Code identifying a party or other code

SDQ-14
380
Quantity
Optional
Decimal number (R)
Min 1Max 15

Numeric value of quantity

SDQ-15
67
Identification Code
Optional
String (AN)
Min 2Max 80

Code identifying a party or other code

SDQ-16
380
Quantity
Optional
Decimal number (R)
Min 1Max 15

Numeric value of quantity

SDQ-17
67
Identification Code
Optional
String (AN)
Min 2Max 80

Code identifying a party or other code

SDQ-18
380
Quantity
Optional
Decimal number (R)
Min 1Max 15

Numeric value of quantity

SDQ-19
67
Identification Code
Optional
String (AN)
Min 2Max 80

Code identifying a party or other code

SDQ-20
380
Quantity
Optional
Decimal number (R)
Min 1Max 15

Numeric value of quantity

SDQ-21
67
Identification Code
Optional
String (AN)
Min 2Max 80

Code identifying a party or other code

SDQ-22
380
Quantity
Optional
Decimal number (R)
Min 1Max 15

Numeric value of quantity

DTM
2100
Detail > PO1 Loop > DTM

Date/Time Reference

RequiredMax use 10

To specify pertinent dates and times

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

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

001
Cancel After
002
Delivery Requested
036
Expiration

If present, 036 will be the expiration date of the corresponding TC202 Harmonized Tariff Code.

037
Ship Not Before
038
Ship No Later
Required
Date (DT)
CCYYMMDD format

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

TC2
2350
Detail > PO1 Loop > TC2

Commodity

OptionalMax use >1

To identify a commodity or a group of commodities or a tariff page commodity

Example
TC2-01
23
Commodity Code Qualifier
Required
Identifier (ID)

Code identifying the commodity coding system used for Commodity Code

A
Harmonized Tariff Schedule of the United States Annotated
TC2-02
22
Commodity Code
Required
String (AN)
Min 1Max 30

Code describing a commodity or group of commodities

N9 Loop
OptionalMax 10
N9
3300
Detail > PO1 Loop > N9 Loop > N9

Extended Reference Information

RequiredMax use 1

To transmit identifying information as specified by the Reference Identification Qualifier

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

Code qualifying the Reference Identification

L1
Letters or Notes
N9-02
127
Reference Identification
Required
String (AN)

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

Usage notes

N902 will contain one of the following 3 characters codes to identify the type of note to follow in MTX02. Customization notes will include gift wrap, personalization and monogram font and color details when applicable.
. GEN: General Note
. CCG: Customizations
. SHP: Shipping Note - To be included on the sidemark label.

CCG
Customizations
GEN
General Note
SHP
Shipping Note

To be included on the sidemark label

MTX
3400
Detail > PO1 Loop > N9 Loop > MTX

Text

RequiredMax use 1

To specify textual data

Example
MTX-02
1551
Textual Data
Required
String (AN)
Min 1Max 4096

To transmit large volumes of message text

Usage notes

If N902 =

  • GEN - MTX02 is a General Note
  • CCG - MTX02 is a Customization.
N9 Loop end
N1 Loop
OptionalMax >1
N1
3500
Detail > PO1 Loop > N1 Loop > N1

Party Identification

RequiredMax use 1

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

Example
N1-01
98
Entity Identifier Code
Required
Identifier (ID)

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

CT
Country of Origin
Optional
String (AN)
Min 1Max 60

Free-form name

N4
3800
Detail > PO1 Loop > N1 Loop > N4

Geographic Location

OptionalMax use 1

To specify the geographic place of the named party

Example
N4-04
26
Country Code
Optional
Identifier (ID)
Min 2Max 3

Code identifying the country

N1 Loop end
SLN Loop
OptionalMax 1000
Usage notes

If component items are sent in the SLN segment, that is the level of items that should be returned on the 855, 856, and 810

SLN
4700
Detail > PO1 Loop > SLN Loop > SLN

Subline Item Detail

RequiredMax use 1

To specify product subline detail item data

Example
If either Product/Service ID Qualifier (SLN-09) or Product/Service ID (SLN-10) is present, then the other is required
If either Product/Service ID Qualifier (SLN-11) or Product/Service ID (SLN-12) is present, then the other is required
If either Product/Service ID Qualifier (SLN-13) or Product/Service ID (SLN-14) is present, then the other is required
If either Product/Service ID Qualifier (SLN-15) or Product/Service ID (SLN-16) is present, then the other is required
SLN-01
350
Assigned Identification
Required
String (AN)
Min 1Max 20

Alphanumeric characters assigned for differentiation within a transaction set

  • SLN01 is the identifying number for the subline item.
  • SLN01 is related to (but not necessarily equivalent to) the baseline item number. Example: 1.1 or 1A might be used as a subline number to relate to baseline number 1.
SLN-03
662
Relationship Code
Required
Identifier (ID)

Code indicating the relationship between entities

  • SLN03 is the configuration code indicating the relationship of the subline item to the baseline item.
I
Included
SLN-04
380
Quantity
Required
Decimal number (R)
Min 1Max 15

Numeric value of quantity

Usage notes

This is the quantity of the component item included in the kit.
PO102 * SLN04 is the total quantity of the component being ordered.

SLN-05
C001
Composite Unit of Measure
RequiredMax 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
SLN-06
212
Unit Price
Required
Decimal number (R)
Min 1Max 15

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

SLN-09
235
Product/Service ID Qualifier
Required
Identifier (ID)

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

  • SLN09 through SLN28 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.
SK
Stock Keeping Unit (SKU)
SLN-10
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

SLN-11
235
Product/Service ID Qualifier
Optional
Identifier (ID)

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

VN
Vendor's (Seller's) Item Number
SLN-12
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

SLN-13
235
Product/Service ID Qualifier
Optional
Identifier (ID)

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

UP
UCC - 12
SLN-14
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

SLN-15
235
Product/Service ID Qualifier
Optional
Identifier (ID)

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

UK
GTIN 14-digit Data Structure
SLN-16
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

PID
4900
Detail > PO1 Loop > SLN Loop > PID

Product/Item Description

RequiredMax use 1000

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

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

Code indicating the format of a description

  • If PID01 equals "F", then PID05 is used. If PID01 equals "S", then PID04 is used. If PID01 equals "X", then both PID04 and PID05 are used.
F
Free-form
PID-02
750
Product/Process Characteristic Code
Required
Identifier (ID)

Code identifying the general class of a product or process characteristic

08
Product
PID-05
352
Description
Required
String (AN)
Min 1Max 80

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

MEA
5025
Detail > PO1 Loop > SLN Loop > MEA

Measurements

OptionalMax use >1

To specify physical measurements or counts, including dimensions, tolerances, variances, and weights

(See Figures Appendix for example of use of C001)

Example
MEA-02
738
Measurement Qualifier
Required
Identifier (ID)

Code identifying a specific product or process characteristic to which a measurement applies

HT
Height
LN
Length
VOL
Volume
WD
Width
WT
Weight
MEA-03
739
Measurement Value
Required
Decimal number (R)
Min 1Max 15

The value of the measurement

MEA-04
C001
Composite Unit of Measure
RequiredMax 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

CC
Cubic Centimeter
CD
Carat
CI
Cubic Inches
CM
Centimeter
FT
Foot
IN
Inch
KG
Kilogram
LB
Pound
MM
Millimeter
OZ
Ounce - Av
TC2
5050
Detail > PO1 Loop > SLN Loop > TC2

Commodity

OptionalMax use >1

To identify a commodity or a group of commodities or a tariff page commodity

Example
TC2-01
23
Commodity Code Qualifier
Required
Identifier (ID)

Code identifying the commodity coding system used for Commodity Code

A
Harmonized Tariff Schedule of the United States Annotated
TC2-02
22
Commodity Code
Required
String (AN)
Min 1Max 30

Code describing a commodity or group of commodities

DTM
5150
Detail > PO1 Loop > SLN Loop > DTM

Date/Time Reference

OptionalMax use 10

To specify pertinent dates and times

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

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

036
Expiration

If present, 036 will be the expiration date of the corresponding TC202 Harmonized Tariff Code

Required
Date (DT)
CCYYMMDD format

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

CTP
5160
Detail > PO1 Loop > SLN Loop > CTP

Pricing Information

OptionalMax use 25

To specify pricing information

Example
CTP-02
236
Price Identifier Code
Required
Identifier (ID)

Code identifying pricing specification

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

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

  • See Figures Appendix for an example detailing the use of CTP03 and CTP04.
  • See Figures Appendix for an example detailing the use of CTP03, CTP04 and CTP07.
N9 Loop
OptionalMax >1
N9
5230
Detail > PO1 Loop > SLN Loop > N9 Loop > N9

Extended Reference Information

RequiredMax use 1

To transmit identifying information as specified by the Reference Identification Qualifier

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

Code qualifying the Reference Identification

L1
Letters or Notes
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

N902 will contain one of the following 3 characters codes to identify the type of note to follow in MTX02. Customization notes will include gift wrap, personalization and monogram font and color details when applicable.

  • GEN: General Note
  • CCG: Customizations
CCG
Customizations
GEN
General Note
MTX
5250
Detail > PO1 Loop > SLN Loop > N9 Loop > MTX

Text

OptionalMax use >1

To specify textual data

Example
MTX-02
1551
Textual Data
Optional
String (AN)
Min 1Max 4096

To transmit large volumes of message text

Usage notes

If N902 =

  • GEN - MTX02 is a General Note
  • CCG - MTX02 is a Customization.
N9 Loop end
SAC Loop
OptionalMax >1
SAC
5260
Detail > PO1 Loop > SLN 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
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
Required
Identifier (ID)

Code identifying the service, promotion, allowance, or charge

A470
Art Work

Used for Personalization costs

D500
Handling
F155
Packaging
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.
SAC Loop end
SLN Loop end
PO1 Loop end
Detail end

Summary

CTT Loop
OptionalMax 1
CTT
0100
Summary > CTT Loop > CTT

Transaction Totals

RequiredMax use 1

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

  • The number of line items (CTT01) is the accumulation of the number of PO1 segments. If used, hash total (CTT02) is the sum of the value of quantities ordered (PO102) for each PO1 segment.
Example
CTT-01
354
Number of Line Items
Required
Numeric (N0)
Min 1Max 6

Total number of line items in the transaction set

CTT Loop end
SE
0300
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.