X12 Release 4010
Delimiters: ~ Segment * Element > Component
Certified August 11, 2023
Hub Group \ Unyson
X12 940 Warehouse Shipping Order
This Draft Standard for Trial Use contains the format and establishes the data contents of the Warehouse Shipping Order Transaction Set (940) for use within the context of an Electronic Data Interchange (EDI) environment.
X12 940 Warehouse Shipping Order
Heading
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
ISA01
I01
Authorization Information Qualifier
Required
ID
Min 2 Max 2
Code to identify the type of information in the Authorization Information
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
ISA02
I02
Authorization Information
Required
alphanumeric (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)
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
ISA03
I03
Security Information Qualifier
Required
ID
Min 2 Max 2
Code to identify the type of information in the Security Information
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
ISA04
I04
Security Information
Required
alphanumeric (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)
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
ISA05
I05
Interchange ID Qualifier
Required
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
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
ISA06
I06
Interchange Sender ID
Required
alphanumeric (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
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
ISA07
I05
Interchange ID Qualifier
Required
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
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
ISA08
I07
Interchange Receiver ID
Required
alphanumeric (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
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
ISA09
I08
Interchange Date
Required
date (DT)
Min 6 Max 6
Date of the interchange
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
ISA10
I09
Interchange Time
Required
time (TM)
Min 4 Max 4
Time of the interchange
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
ISA11
I10
Interchange Control Standards Identifier
Required
ID
Min 1 Max 1
Code to identify the agency responsible for the control standard used by the message that is enclosed by the interchange header and trailer
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
ISA12
I11
Interchange Control Version Number
Required
ID
Min 5 Max 5
This version number covers the interchange control segments
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
ISA13
I12
Interchange Control Number
Required
numeric (N0)
Min 9 Max 9
A control number assigned by the interchange sender
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
ISA14
I13
Acknowledgment Requested
Required
ID
Min 1 Max 1
Code sent by the sender to request an interchange acknowledgment (TA1)
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
ISA15
I14
Usage Indicator
Required
ID
Min 1 Max 1
Code to indicate whether data enclosed by this interchange envelope is test, production or information
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
ISA16
I15
Component Element Separator
Required
undefined ()
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
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
GS
Functional Group Header
Required
Max Use 1
To indicate the beginning of a functional group and to provide control information
GS01
479
Functional Identifier Code
Required
ID
Min 2 Max 2
Code identifying a group of application related transaction sets
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
GS02
142
Application Sender's Code
Required
alphanumeric (AN)
Min 2 Max 15
Code identifying party sending transmission; codes agreed to by trading partners
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
GS03
124
Application Receiver's Code
Required
alphanumeric (AN)
Min 2 Max 15
Code identifying party receiving transmission. Codes agreed to by trading partners
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
GS04
373
Date
Required
longDate (DT)
Min 8 Max 8
Date expressed as CCYYMMDD
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
GS05
337
Time
Required
time (TM)
Min 4 Max 8
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)
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
GS06
28
Group Control Number
Required
numeric (N0)
Min 1 Max 9
Assigned number originated and maintained by the sender
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
GS07
455
Responsible Agency Code
Required
ID
Min 1 Max 2
Code used in conjunction with Data Element 480 to identify the issuer of the standard
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
GS08
480
Version / Release / Industry Identifier Code
Required
alphanumeric (AN)
Min 1 Max 12
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
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
ST
Transaction Set Header
Required
Max Use 1
To indicate the start of a transaction set and to assign a control number
ST01
143
Transaction Set Identifier Code
Required
ID
Min 3 Max 3
Code uniquely identifying a Transaction Set
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
ST02
329
Transaction Set Control Number
Required
alphanumeric (AN)
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
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
W05
Shipping Order Identification
Required
Max Use 1
To transmit identifying numbers and other basic data for this transaction set
Syntax Notes
If any of W0504 or W0505 are present, then all are required.
W0501
473
Order Status Code
Required
ID
Min 1 Max 1
Code identifying purpose of transaction set
N
Original
W0502
285
Depositor Order Number
Required
alphanumeric (AN)
Min 1 Max 22
Identifying number for warehouse shipping order assigned by the depositor
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
W0503
324
Purchase Order Number
Optional
alphanumeric (AN)
Min 1 Max 22
Identifying number for Purchase Order assigned by the orderer/purchaser
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
N1 loop
Required
Min Items
Max Loop 10
N1
Name
Required
Max Use 1
To identify a party by type of organization, name, and code
Syntax Notes
At least one of N102 or N103 is required.
If any of N103 or N104 are present, then all are required.
N101
98
Entity Identifier Code
Required
ID
Min 2 Max 3
Code identifying an organizational entity, a physical location, property or an individual
WH
Warehouse
N102
93
Name
Required
alphanumeric (AN)
Min 1 Max 60
Free-form name
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
N103
66
Identification Code Qualifier
Required
ID
Min 1 Max 2
Code designating the system/method of code structure used for Identification Code (67)
54
Warehouse
N104
67
Identification Code
Required
alphanumeric (AN)
Min 2 Max 80
Code identifying a party or other code
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
N1
Name
Required
Max Use 1
To identify a party by type of organization, name, and code
Syntax Notes
At least one of N102 or N103 is required.
If any of N103 or N104 are present, then all are required.
N101
98
Entity Identifier Code
Required
ID
Min 2 Max 3
Code identifying an organizational entity, a physical location, property or an individual
ST
Ship To
N102
93
Name
Required
alphanumeric (AN)
Min 1 Max 60
Free-form name
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
N103
66
Identification Code Qualifier
Optional
Min 1 Max 1
Code designating the system/method of code structure used for Identification Code (67)
N104
67
Identification Code
Optional
Min 1 Max 1
Code identifying a party or other code
N1
Name
Required
Max Use 1
To identify a party by type of organization, name, and code
Syntax Notes
At least one of N102 or N103 is required.
If any of N103 or N104 are present, then all are required.
N101
98
Entity Identifier Code
Required
ID
Min 2 Max 3
Code identifying an organizational entity, a physical location, property or an individual
BT
Bill-to-Party
SO
Sold To If Different From Bill To
OB
Ordered By
N102
93
Name
Required
alphanumeric (AN)
Min 1 Max 60
Free-form name
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
N103
66
Identification Code Qualifier
Optional
Min 1 Max 1
Code designating the system/method of code structure used for Identification Code (67)
N104
67
Identification Code
Optional
Min 1 Max 1
Code identifying a party or other code
N3
Address Information
Required
Max Use 2
To specify the location of the named party
N301
166
Address Information
Required
alphanumeric (AN)
Min 1 Max 55
Address information
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
N302
166
Address Information
Optional
alphanumeric (AN)
Min 1 Max 55
Address information
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
N3
Address Information
Optional
Max Use 2
To specify the location of the named party
N301
166
Address Information
Required
alphanumeric (AN)
Min 1 Max 55
Address information
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
N302
166
Address Information
Optional
alphanumeric (AN)
Min 1 Max 55
Address information
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
N4
Geographic Location
Required
Max Use 1
To specify the geographic place of the named party
Syntax Notes
If N406 is present, then and N405 is required.
N401
19
City Name
Required
alphanumeric (AN)
Min 2 Max 30
Free-form text for city name
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
N402
156
State or Province Code
Required
ID
Min 2 Max 2
Code (Standard State/Province) as defined by appropriate government agency
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
N403
116
Postal Code
Required
ID
Min 3 Max 15
Code defining international postal zone code excluding punctuation and blanks (zip code for United States)
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
N404
26
Country Code
Optional
ID
Min 2 Max 3
Code identifying the country
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
N4
Geographic Location
Optional
Max Use 1
To specify the geographic place of the named party
Syntax Notes
If N406 is present, then and N405 is required.
N401
19
City Name
Required
alphanumeric (AN)
Min 2 Max 30
Free-form text for city name
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
N402
156
State or Province Code
Required
ID
Min 2 Max 2
Code (Standard State/Province) as defined by appropriate government agency
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
N403
116
Postal Code
Required
ID
Min 3 Max 15
Code defining international postal zone code excluding punctuation and blanks (zip code for United States)
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
N404
26
Country Code
Optional
ID
Min 2 Max 3
Code identifying the country
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
PER
Administrative Communications Contact
Optional
Max Use 5
To identify a person or office to whom administrative communications should be directed
Syntax Notes
If any of PER03 or PER04 are present, then all are required.
If any of PER05 or PER06 are present, then all are required.
If any of PER07 or PER08 are present, then all are required.
PER01
366
Contact Function Code
Optional
ID
Min 2 Max 2
Code identifying the major duty or responsibility of the person or group named
AA
Authorized Representative
PER02
93
Name
Required
alphanumeric (AN)
Min 1 Max 60
Free-form name
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
PER03
365
Communication Number Qualifier
Optional
ID
Min 2 Max 2
Code identifying the type of communication number
TE
Telephone
PER04
364
Communication Number
Optional
alphanumeric (AN)
Min 1 Max 80
Complete communications number including country or area code when applicable
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
N9
Reference Identification
Optional
Max Use 10
To transmit identifying information as specified by the Reference Identification Qualifier
Syntax Notes
At least one of N902 or N903 is required.
If N906 is present, then and N905 is required.
N901
128
Reference Identification Qualifier
Optional
ID
Min 2 Max 3
Code qualifying the Reference Identification
AEM
Distribution Center Number
DP
Department Number
XY
Other Unlisted Type of Reference Number
ST
Store Number
IA
Internal Vendor Number
IT
Internal Customer Number
W9
Special Packaging Instruction Number
SO
Shipper's Order (Invoice Number)
98
Container/Packaging Specification Number
PK
Packing List Number
PL
Price List Number
GK
Third Party Reference Number
3J
Office Number
MR
Merchandise Type Code
LO
Load Planning Number
BB
Authorization Number
PHC
Process Handling Code
6P
Group Number
PD
Promotion/Deal Number
SI
Shipper's Identifying Number for Shipment (SID)
YD
Buyer Identification
AAO
Carrier Assigned Code
T1
Tax Exchange Code
AO
Appointment Number
VR
Vendor ID Number
N902
127
Reference Identification
Optional
alphanumeric (AN)
Min 1 Max 30
Reference information as defined for a particular Transaction Set or as specified by the Reference Identification Qualifier
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
N903
369
Free-form Description
Optional
alphanumeric (AN)
Min 1 Max 45
Free-form descriptive text
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
G61
Contact
Optional
Max Use 3
To identify a person or office to whom communications should be directed
Syntax Notes
If any of G6103 or G6104 are present, then all are required.
G6101
366
Contact Function Code
Optional
ID
Min 2 Max 2
Code identifying the major duty or responsibility of the person or group named
DC
Delivery Contact
SR
Sales Representative or Department
G6102
93
Name
Required
alphanumeric (AN)
Min 1 Max 60
Free-form name
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
G6103
365
Communication Number Qualifier
Optional
ID
Min 2 Max 2
Code identifying the type of communication number
TE
Telephone
G6104
364
Communication Number
Optional
alphanumeric (AN)
Min 1 Max 80
Complete communications number including country or area code when applicable
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
G62
Date/Time
Optional
Max Use 10
To specify pertinent dates and times
Syntax Notes
At least one of G6201 or G6203 is required.
If any of G6201 or G6202 are present, then all are required.
If any of G6203 or G6204 are present, then all are required.
G6201
432
Date Qualifier
Optional
ID
Min 2 Max 2
Code specifying type of date
10
Requested Ship Date/Pick-up Date
01
Cancel After This Date
02
Delivery Requested on This Date
04
Purchase Order Date
G6202
373
Date
Optional
longDate (DT)
Min 8 Max 8
Date expressed as CCYYMMDD
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
NTE
Note/Special Instruction
Optional
To transmit information in a free-form format, if necessary, for comment or special instruction
NTE01
363
Note Reference Code
Optional
ID
Min 3 Max 3
Code identifying the functional area or purpose for which the note applies
GEN
Entire Transaction Set
WHI
Warehouse Instruction
BOL
Bill of Lading Note
ALL
All Documents
CAJ
Type of Business
NTE02
352
Description
Required
alphanumeric (AN)
Min 1 Max 80
A free-form description to clarify the related data elements and their content
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
W66
Warehouse Carrier Information
Optional
Max Use 1
To specify transportation instructions relating to shipment
Syntax Notes
If any of W6608 or W6609 are present, then all are required.
W6601
146
Shipment Method of Payment
Optional
ID
Min 2 Max 2
Code identifying payment terms for transportation charges
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
W6602
91
Transportation Method/Type Code
Optional
ID
Min 1 Max 2
Code specifying the method or type of transportation for the shipment
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
W6610
140
Standard Carrier Alpha Code
Optional
ID
Min 2 Max 4
Standard Carrier Alpha Code
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
LX loop
Required
Min Items
Max Loop undefined
LX
Assigned Number
Required
Max Use 1
To reference a line number in a transaction set
LX01
554
Assigned Number
Required
numeric (N0)
Min 1 Max 6
Number assigned for differentiation within a transaction set
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
W01 loop
Required
W01
98
Line Item Detail
Required
Min 1 Max 1
Max Use 1
To transmit basic and most frequent shipment-related line-item data elements
Syntax Notes
At least one of W0103 or W0104 is required.
If any of W0104 or W0105 are present, then all are required.
If any of W0106 or W0107 are present, then all are required.
If any of W0110 or W0111 are present, then all are required.
If any of W0115 or W0116 are present, then all are required.
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
W0101
330
Quantity Ordered
Required
decimal (R)
Min 1 Max 15
Quantity ordered
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
W0102
355
Unit or Basis for Measurement Code
Required
ID
Min 2 Max 2
Code specifying the units in which a value is being expressed, or manner in which a measurement has been taken
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
W0103
438
U.P.C. Case Code
Required
alphanumeric (AN)
Min 12 Max 12
Code (Universal Product Code - U.P.C.) including two high order digits identifying the "system" (U.S. Grocery = 00, 06 or 07; U.S. Drug = 03); using the U.S. Grocery system, the next ten digits are: Manufacturer (5) Case Code (5)
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
W0104
235
Product/Service ID Qualifier
Required
ID
Min 2 Max 2
Code identifying the type/source of the descriptive number used in Product/Service ID (234)
VN
Vendor's (Seller's) Item Number
W0105
234
Product/Service ID
Required
alphanumeric (AN)
Min 1 Max 48
Identifying number for a product or service
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
W0106
235
Product/Service ID Qualifier
Required
ID
Min 2 Max 2
Code identifying the type/source of the descriptive number used in Product/Service ID (234)
CB
Buyer's Catalog Number
W0107
234
Product/Service ID
Required
alphanumeric (AN)
Min 1 Max 48
Identifying number for a product or service
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
W0113
451
Warehouse Lot Number
Required
alphanumeric (AN)
Min 1 Max 12
Reference number assigned by the warehouse
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
W0115
235
Product/Service ID Qualifier
Required
ID
Min 2 Max 2
Code identifying the type/source of the descriptive number used in Product/Service ID (234)
UK
U.P.C./EAN Shipping Container Code (1-2-5-5-1)
W0116
234
Product/Service ID
Required
alphanumeric (AN)
Min 1 Max 48
Identifying number for a product or service
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
G69
98
Line Item Detail
Optional
Min 1 Max 1
Max Use 5
To describe an item in free-form format
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
G6901
369
Free-form Description
Optional
alphanumeric (AN)
Min 1 Max 45
Free-form descriptive text
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
W20
98
Line-Item Detail
Optional
Min 1 Max 1
Max Use 3
To specify packing details of the items shipped
Syntax Notes
If any of W2002 or W2003 are present, then all are required.
If any of W2004, W2005 or W2006 are present, then all are required.
If any of W2008 or W2009 are present, then all are required.
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
W2001
356
Pack
Optional
numeric (N0)
Min 1 Max 6
The number of inner containers, or number of eaches if there are no inner containers, per outer container
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
W2002
357
Size
Optional
decimal (R)
Min 1 Max 8
Size of supplier units in pack
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
W2003
355
Unit or Basis for Measurement Code
Optional
ID
Min 2 Max 2
Code specifying the units in which a value is being expressed, or manner in which a measurement has been taken
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
W2010
397
Color
Optional
alphanumeric (AN)
Min 1 Max 10
Free-form description of color
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
AMT
98
Monetary Amount
Optional
Min 1 Max 1
Max Use 1
To indicate the total monetary amount
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
AMT01
522
Amount Qualifier Code
Optional
ID
Min 1 Max 3
Code to qualify amount
LP
List Price
4T
Cost of Goods Sold
AMT02
782
Monetary Amount
Optional
decimal (R)
Min 1 Max 18
Monetary amount
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
W76
Total Shipping Order
Optional
Max Use 1
To specify summary details of total items shipped in terms of quantity, weight, and volume
Syntax Notes
If any of W7602 or W7603 are present, then all are required.
If any of W7604 or W7605 are present, then all are required.
If W7606 is present, then and W7603 is required.
W7601
330
Quantity Ordered
Optional
decimal (R)
Min 1 Max 15
Quantity ordered
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
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)
SE01
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
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here
SE02
329
Transaction Set Control Number
Required
alphanumeric (AN)
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
123
Description Goes Here
123
Description Goes Here
123
Description Goes Here