  

 

Tracelink University

 ## Breadcrumb

1. [Home](/)
2. [Resources](/resources/resource-center)
3. [TraceLink University](/resources/tracelink-university)
 
  

 

 

# Warehouse shipping order (X12)

 

 

 

 

 

 

 

 

- [Download PDF](/node/627901/pdf)
- [Share](#)
    - [ LinkedIn ](https://www.linkedin.com/shareArticle?mini=true&url=https://www.tracelink.com/resources/tracelink-university/warehouse-shipping-order-x12&title=Warehouse shipping order (X12)&summary=Warehouse shipping orders allow companies to exchange data with their remote warehouses or third-party warehouse Partners about requests for purchased product to be shipped to a buyer's location without giving these Partners access to their serialization system of record. &source=TraceLink "LinkedIn")
    - [ Facebook ](https://www.facebook.com/share.php?u=https://www.tracelink.com/resources/tracelink-university/warehouse-shipping-order-x12&t=Warehouse shipping order (X12) "Facebook")
    - [ Mail ](mailto:?subject=Warehouse shipping order (X12)+|+TraceLink&body=https://www.tracelink.com/resources/tracelink-university/warehouse-shipping-order-x12 "Mail")
    - [ Twitter ](https://twitter.com/intent/tweet?text=Warehouse shipping order (X12) https://www.tracelink.com/resources/tracelink-university/warehouse-shipping-order-x12&via=TraceLink "Twitter")
 
 

 

 

 

 

#### Table of contents

 

 

 

Warehouse shipping orders allow companies to exchange data with their remote warehouses or third-party warehouse Partners about requests for purchased product to be shipped to a buyer's location without giving these Partners access to their serialization system of record. Warehouse shipping orders can be used to request that products in a given purchase order be shipped to a buyer's location from a supplier's remote or third-party warehouses and confirm that the supplier's remote warehouses or third-party warehouses has shipped the requested product via a warehouse shipping advice.

Suppliers use warehouse shipping orders to communicate requests to their remote or third-party warehouse for purchased product to be shipped from the supplier's remote or third-party warehouse to a buyer's location.

 ![](/sites/default/files/tech_comms/mpl/Content/Resources/Images/global_images/note_tip_24x24.png) Contact your TraceLink Services representative for more information about integrating with this message.

 

- **Message Type**: MPC\_WAREHOUSE\_SHIP\_ORDER (Warehouse Shipping Order)
- **X12 Format**: 940
- **Transform Names**: 
    - B2B\_EDI\_X12\_940\_WHS\_ShipOrder\_IB\_V4
    - B2B\_EDI\_X12\_940\_WHS\_ShipOrder\_OB\_V3
 
[![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Guidelines](#)            Input Element Occurs Length Description Example     ISA \[1…1\]  
 – **Required.**ISA interchange envelope. –     ISA01 \[1…1\]  
 2/2 **Required.**Qualifier for authorization control number in ISA02.

Valid values:

- `00` - No authorization info present.
- `03` - Additional data identification.
 
  00     ISA02 \[1…1\]  
 10/10 **Required.**Information used for additional identification or authorization of the interchange sender or the data in the interchange/ 10 spaces a valid entry. –     ISA03 \[1…1\]  
 2/2 **Required.**Qualifier for security information in ISA04.

Valid values:

- `00` - No security information present.
- `01` - Password.
 
  00     ISA04 \[1…1\]  
 10/10 **Required.**Identifies security information about the interchange sender or data. –     ISA05 \[1…1\]  
 2/2 **Required.**Interchange sender partner ID qualifier.

  07     ISA06 \[1…1\]  
 15/15 **Required.**EDI sender ID mapping to Interchange control group header. 7777776067344     ISA07 \[1…1\]  
 2/2 **Required.**Interchange receiver partner ID qualifier.

  01     ISA08 \[1…1\]  
 15/15 **Required.**EDI receiver ID mapping to file control header. 888888404358877     ISA09 \[1…1\]  
 6/6 **Required.**Interchange date in 6 char YYMMDD format. 20231021     ISA10 \[1…1\]  
 4/4 **Required.**Interchange time in 4 char HHMM format. 1420     ISA11 \[1…1\]  
 1/1 **Required.**Repetition separator. Delimiter that separates repeated occurrences of a data element or composite data structure. Must be different than the data element separator, component separator, and segment terminator. :–     ISA12 \[1…1\]  
 5/5 **Required.**Interchange control version number. Valid value is `00501`. 00501     ISA13 \[1…1\]  
 9/9 **Required.**Interchange Control Number for file control header 0000000000619827     ISA14 \[1…1\]  
 1/1 **Required.**Interchange level acknowledgement requested.

 Valid values:

- `0` - No acknowledgment requested.
- `1` - Interchange level acknowledgment requested.
 
  0     ISA15 \[1…1\]  
 1/2 **Required.**Indicates whether the interchange is for production, test, or information purposes.

Valid values:

- `I` - Information.
- `P` - Production data.
- `T` - Test data.
 
  P     ISA16 \[1…1\]  
 1/1 **Required.**Component element separator. Delimiter that separates data elements within a composite data structure. Must be different than the data element separator and segment terminator. &gt;   GS \[1…\*\]  
 – GS group functional envelope. Child of ISA. Only one GS group expected per interchange. –     GS01 \[1…1\]  
 2/2 **Required.**GS group function code. Valid value is `OW` - Ship Order. OW     GS02 \[1…1\]  
 2/15 **Required.**Application sender's code. 2222224043588     GS03 \[1…1\]  
 2/15 **Required.**Application receiver's code. TRACELINK     GS04 \[1…1\]  
 8/8 **Required.**Current date stamp in 8 char X12 date format YYYYMMDD. 20301020     GS05 \[1…1\]  
 4/8 **Required.**Current time stamp in 6 char X12 time format HHMMSS. 142000     GS06 \[1…1\]  
 1/9 **Required.**Group Control ID Number. 619827     GS07 \[1…1\]  
 1/2 **Required.**Responsible Agency Code. Valid value is `X`. X     GS08 \[1…1\]  
 1/12 **Required.**X12 message version code. Valid value is `00501`. 005010   ST \[1…\*\]  
 – ST transaction set envelope. Child of GS group. Only one ST transaction expected. –     ST01 \[1…1\]  
 3/3 **Required.**Transaction set identifier code. 940     ST02 \[1…1\]  
 4/9 **Required.**Transaction set ID number. Counter for each ST segment beginning with 1. 1     W05 \[1…1\]  
 – **Required.**Warehouse Shipment Order Identification. Child of ST transaction set. –       W0501 \[1…1\]  
 1/1 **Required.**Order Status Code.

Valid values:

- ` F` – Cancel
- `N` – Original(Create)
- `R` – Change
 
  N       W0502 \[0…1\]  
 1/22 Order number. Identifying number for warehouse shipping order. 12345       W0503 \[0…1\]  
 1/22 Purchase Order Number. 20230916       W0504 \[0…1\]  
 1/30 Shipment Identification Number assigned by the Shipper. –       W0505 \[0…1\]  
 1/12 Master Reference (Link) Number. –     N1 \[0…1\]  
 – N1: Name segment loop for

- Ship to party
- Sold to party
- Bill to party
- Supplier party
- Ship from party
- Carrier party
 
          N101 \[1…1\]  
 2/3 **Required.**Entity identifier code for party identifier and address information for

- Ship to party
- Sold to party
- Bill to party
- Supplier party
- Ship from party
- Carrier party
 
Valid value:

- `ST` – Ship to party
- `BT` – Bill to party
- `BY` – Buyer
- `SU` – Supplier party
- `SF` – Ship from party
- `CA` – Carrier
 
  SU       N102 \[1…1\]  
 1/60 **Required.**Name Supplier Inc       N103 \[1…1\]  
 1/2 **Required.**Identifier code qualifier.

Valid values:

- `01` – DUNS
- `09` – DUNS+4
- `11` – Drug Enforcement Agency registration number
- `21` – Health Industry Number
- `91` – Company identifier
- `92` – Company location identifier
- `UL` – Global Location Number
 
  1       N104 \[1…1\]  
 2/80 **Required.**Supplier party identifier, as qualified by N103. 9999992028677       N3 \[0…1\]  
 – N3: Address. Child of Ship to N1 Name segment. –         N301 \[1…1\]  
 1/55 **Required.**Street address 1. 123 Supplier Road         N302 \[0…1\]  
 1/55 Street address 2. Suite 123       N4 \[0…1\]  
 – N4: Geographic Location. Child of bill to N1 name segment. –         N401 \[1…1\]  
 2/30 **Required.**City name. SupplierCity         N402 \[1…1\]  
 2/2 **Required.**State or province code. Code (Standard state/province) as defined by appropriate government agency MA         N403 \[1…1\]  
 3/15 **Required.**Postal code. Code defining international postal zone code excluding punctuation and blanks. 01899         N404 \[1…1\]  
 2/3 **Required.**Country code. US     G62 \[0…1\]  
 – Date or time. –       G6201 \[1…1\]  
 2/30 **Required.**Date Qualifier.

Valid values:

- `02` – Requested delivery date
- `04` – Purchase Order date
- `10` – Dispatch date
- `17` – Estimated delivery date for shipment
- `37` – Ship not before than date
- `38` – Ship not later than date
- `54` – Delivery no later than date
- `85` – Date of issue (warehouse)
- `CL` – Date loading completed
- `BC` – Publication (document) date
 
  04       G6202 \[1…1\]  
 2/2 **Required.**Date. 20231101       G6203 \[1…1\]  
 3/15 **Required.**Time in HH:MM:SS format. –       G6204 \[1…1\]  
 2/3 **Required.**Time Code. –     NTE \[0…\*\]  
 – Note/Special Instruction. –       NTE01  \[0…1\]  
 – Note Reference Code.  –       NTE02  \[1…1\]  
 – **Required.**Description.  Free Form Text      LX \[0…\*\]  
 – Transaction Set Line Number Loop. –       LX01 \[1…1\]  
 1/6 **Required.**Transaction Set Line Number. 000001       W01 \[1…1\]  
 – **Required.**Warehouse Item Detail Loop. –         W0101 \[0…1\]  
 0/15 Quantity ordered. This is the total quantity in the ordered. 400         W0102 \[0…1\]  
 2/2 Unit or basis for measurement code.

[![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif).Valid values ](#)- `02` – Statute Mile
- `4G` – Microliter
- `AM` – Ampoule
- `AV` – Capsule
- `BD` – Bundle
- `BG` – Bag
- `BO` – Bottle
- `BX` – Box
- `C3` – Centiliter
- `CA` – Case
- `CC` – Cubic Centimeter
- `CF` – Cubic Feet
- `CG` – Card, Blister
- `CI` – Cubic Inches
- `CL` – Cylinder
- `CM` – Centimeter
- `CN` – Can
- `CP` – Crate
- `CQ` – Cartridge
- `CR` – Cubic Meters
- `CT` – Carton
- `DA` – Day
- `DI` – Dispenser
- `DK` – Kilometers
- `DL` – Deciliter
- `DM` – Decimeter
- `DR` – Drum
- `DS` – Display
- `DZ` – Dozen
- `EA` – Each
- `FO` – Fluid Ounce
- `FT` – Foot
- `GA` – Gallon
- `GL` – Gram/liter
- `GR` – Gram
- `GS` – Gross
- `H4` – Hectoliter
- `HF` – Hundred Feet
- `HR` – Hours
- `IN` – Inch
- `K6` – Kiloliters
- `KG` – Kilogram
- `KT` – Kit
- `LB` – Pounds
- `LF` – Linear Foot
- `LO` – Lot (unit of procurement)
- `LT` – Liter
- `LY` – Linear Yard
- `MC` – Microgram
- `ME` – Milligram
- `ML` – Milliliter
- `MM` – Millimeter
- `MO` – Months
- `MR` – Meter
- `OZ` – Ounces
- `PC` – Piece
- `PF` – Pallet
- `PK` – Package
- `PR` – Pair
- `PT` – Pint
- `QT` – Quart
- `RL` – Roll
- `SC` – Square Centimeter
- `SF` – Square Foot
- `SH` – Sheet
- `SI` – Square Inch
- `SM` – Square Meter
- `ST` – Set
- `SY` – Square Yard
- `T3` – Thousand Pieces
- `TB` – Tube
- `TH` – Thousand
- `TY` – Tray
- `U2` – Tablet
- `UM` – Million
- `UN` – Unit
- `V2` – Pouch
- `VI` – Vial
- `WK` – Week
- `YD` – Yard
- `YR` – Years
 
 

 

  CA         W0103 \[0…1\]  
 12/12 U.P.C. Case Code. Not used. –         W0104 \[0…1\]  
 2/2 Product or service ID qualifier.

[![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid values:](#)- `AV` – Manufacturer/Supplier's catalog number
- `BP` – Buyer's product number
- `FV` – Canada product number
- `IN` – Customer's(Buyer's) product item number
- `N1` – US National-Drug-Code-NDC442-with-hyphen-separators
- `N2` – US National-Drug-Code-NDC532-with-hyphen-separators
- `N3` – US National-Drug-Code-NDC541-with-hyphen-separators
- `N4` – US-National-Drug-Code-NDC542-with-hyphen-separators
- `MF` – Manufacturer's product identefier
- `PI` – Customer's (Purchaser's) material number
- `SK` – Stock keeping unit
- `UK` – GTIN14 identifier
- `UP or VC` – Universal product number (UPC)
- `VN` – Vendor (Supplier) material Number.
 
 

 

  VN         W0105 \[0…1\]  
 1/48 Product or service ID. 100021         W0106 \[0…1\]  
 2/2 Product or service ID qualifier.

[![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid values:](#)- `AV` – Manufacturer/Supplier's catalog number
- `BP` – Buyer's product number
- `FV` – Canada product number
- `IN` – Customer's(Buyer's) product item number
- `N1` – US National-Drug-Code-NDC442-with-hyphen-separators
- `N2` – US National-Drug-Code-NDC532-with-hyphen-separators
- `N3` – US National-Drug-Code-NDC541-with-hyphen-separators
- `N4` – US-National-Drug-Code-NDC542-with-hyphen-separators
- `MF` – Manufacturer's product identefier
- `PI` – Customer's (Purchaser's) material number
- `SK` – Stock keeping unit
- `UK` – GTIN14 identifier
- `UP or VC` – Universal product number (UPC)
- `VN` – Vendor (Supplier) material Number.
 
 

 

  UK         W0107 \[0…1\]  
 1/48 Product or service ID. 000000000228308706         W0108 \[0…1\]  
 1/12 Freight class code. –         W0109 \[0…1\]  
 1/12 Rate class code. –         W0110 \[0…1\]  
 1/10 Commodity code qualifier. Not used. –         W0111 \[0…1\]  
 1/2 Commodity code. Not used. –         W0112 \[0…1\]  
 1/1 Warehouse lot number. Not used. –         W0113 \[0…1\]  
 1/1 Product or service condition code. Not used. –         W0114 \[0…1\]  
 1/1 Pallet block and tiers. Not used. –         W0115 \[0…1\]  
 1/1 Product or service ID qualifier.

[![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid values:](#)- `AV` – Manufacturer/Supplier's catalog number
- `BP` – Buyer's product number
- `FV` – Canada product number
- `IN` – Customer's(Buyer's) product item number
- `N1` – US National-Drug-Code-NDC442-with-hyphen-separators
- `N2` – US National-Drug-Code-NDC532-with-hyphen-separators
- `N3` – US National-Drug-Code-NDC541-with-hyphen-separators
- `N4` – US-National-Drug-Code-NDC542-with-hyphen-separators
- `MF` – Manufacturer's product identefier
- `PI` – Customer's (Purchaser's) material number
- `SK` – Stock keeping unit
- `UK` – GTIN14 identifier
- `UP or VC` – Universal product number (UPC)
- `VN` – Vendor (Supplier) material Number.
 
 

 

  N4         W0116 \[0…1\]  
 1/1 Product or service ID. 12345-1234-12       G69 \[0…5\]  
 – Line item detail - description. –         G6901 \[0…1\]  
 0/45 Free-form description. SORITOL SR FCT 20MG 3X10 IL       N9 \[0…200\]  
 – Extended reference information. Instance 1 for lot number. –         N901 \[1…1\]  
 2/3 **Required.**Reference identification qualifier. Valid value is `LT` – Lot number. LT         N902 \[0…1\]  
 1/50 Reference identification. '3912J141         N903 \[0…1\]  
 1/45 Free form description. –         N904 \[0…1\]  
 8/8 Date in YYYYMMDD format. –         N905 \[0…1\]  
 4/8 Time in HHMMSS format. –       N9 \[0…200\]  
 – Extended reference information. Instance 2 for Purchase Order Number. –         N901 \[1…1\]  
 2/3 **Required.**Reference identification qualifier. Valid value is `PO` – Purchase order number. PO         N902 \[0…1\]  
 1/50 Reference identification. C0243554NLC         N903 \[0…1\]  
 1/45 Free form description. –         N904 \[0…1\]  
 8/8 Date in YYYYMMDD format. –         N905 \[0…1\]  
 4/8 Time in HHMMSS format. –       N9 \[0…1\]  
 – Extended reference information Instance 3 for Tracking Number. –         N901 \[1…1\]  
 2/3 **Required.**Reference identification qualifier. Valid value is `2I` – Tracking number. 2I         N902 \[0…1\]  
 1/50 Reference identification. K018293-00010         N903 \[0…1\]  
 1/45 Free form description. –         N904 \[0…1\]  
 8/8 Date in YYYYMMDD format. 2030926         N905 \[0…1\]  
 4/8 Time in HHMMSS format. 092521       N9 \[0…200\]  
 – Extended reference information. Instance 4 for line item number. –         N901 \[1…1\]  
 2/3 **Required.**Reference identification qualifier. Valid value is `LI` – Line item number. LI         N902 \[0…1\]  
 1/50 Reference identification. '00010       NTE \[0…\*\]  
 – Note or special instruction. –         NTE01 \[0…1\]  
 3/3 Note reference code.

Valid values:

- `BOL` – Bill of Lading Note
- `INT` – General Oder Instructions
- `LOI` – Loading Instructions
 
  INT         NTE02 \[0…1\]  
 1/80 Description Description     W76 \[0…1\]  
 – Total shipping order. Sum of quantity value in all line items. –       W7601 \[1…1\]  
 1/15 **Required.**Quantity. 500       W7602 \[0…1\]  
 1/10 Weight. –       W7603 \[0…1\]  
 2/2 Unit or basis for measurement code. EA     CTT   – CTT-Transaction totals. –       CTT01 \[1…1\]  
 1/6 **Required.**Total number of line items in the transaction set. 15   SE \[1…1\]  
 – **Required.**ST … SE transaction set trailer envelope. Child of GS group. Only one ST transaction expected. –     SE01  \[1…1\]  
 1/10  **Required.**Total count of segments in ST … SE transaction set including ST and SE segments. –     SE02  \[1…1\]  
 4/9  **Required.**Transaction set control number –   GE \[1…\*\]  
 – GS … GE functional group trailer envelope. Child of ISA interchange. Only one GS group expected. –     GE01 \[1…1\]  
 1/6 **Required.**Number of transaction sets in functional group 5     GE01 \[1…1\]  
 1/9 **Required.**Functional group control number 619827   IEA \[1…\*\]  
 – ISA … IEA interchange control trailer envelope. Only one interchange expected per transmission. –     IEA01 \[1…1\]  
 1/5 **Required.**Number of functional groups in interchange. 1     IEA02 \[1…1\]  
 9/9 **Required.**Interchange control number 0000000000619827    

 

[![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Example](#)```xml
ISA*00* ISA02*00* ISA04*20*Sender *ZZ*Receiver
*240129*1050*^*s10ss*11 *0*T*
GS*OW*2222224043588*TRACELINK*20240129*1050*619827*X*005010
ST*940*0001
W05*N*12345*4500003288
N1*ST*ShipTo*92*COMPANYSITEID
N3*ShipTo Address 1*ShipTo Address 2
N4*ShipTo City*YY*ST4545*JP
N1*BY*Buyer*11*001000286
N3*BY Street1*Street2
N4*BY City*PR*111111*US
N1*BT*BillTo*1*001000286
N3*BT Stella Maris*Condado Ave 14
N4*BT San Juan*PR*00902*US
N1*SU*SUPPLIER/VENDOR (LF/SU)*21*001000286
N3*Supplier Street1* Street2
N4*Supplier City*SU*33333*US
N1*SF*SHIPFROM (SF)*21*001000287
N3*ShipFrom Street1* Street2
N4*ShipFrom City*SF*33333*US
N1*CA*Carr*UL*1399999
N3*Carr Address 1*Dist Address 2
N4*Carr Cit*ZZ*DistPst*US
G62*02*20240211
G62*04*20240212
G62*10*20240213
G62*17*20240214
G62*37*20240215
G62*38*20240216
G62*54*20240217
G62*85*20240218
G62*CL*20240219
G62*BC*20240220
NTE**TEXT1
NTE**TEXT2
NTE**TEXT3
LX*1
W01*1002*EA*UPC456789012*BP*BP1*SK*SKU1********UK*GTIN14567
G69*Desc1
G69*Desc
N9*PO*PO1344
N9*LT*LT-35466
N9*D2*SU849065
N9*LI*464565
NTE**ITTEXTA
NTE**ITTEXTB
LX*2
W01*899*EA**IN*IN234*MF*MF5676567********VC*UP5656
G69*Desc1
G69*Desc2
N9*PO*PO1344
N9*LT*LT-35466
N9*D2*SU849065
N9*LI*464565
NTE**ITTEXTA
NTE**ITTEXTB
W76*10*100*01
SE*27*s28s
GE*29*30
IEA*11*321111112
```

 

 

 

 

 ![](/sites/default/files/tech_comms/mpl/Content/Resources/Images/global_images/note_tip_24x24.png) Review TraceLink's [API: Terms of Use](https://www.tracelink.com/legal-and-trust/api-terms-of-use)



 

 

 

 

#### Table of contents

 

 

 

 

 

 



 

##### Related Content

 

 [ ![Related content](https://www.tracelink.com/sites/default/files/2024-09/cloud.svg) ](/resources/tracelink-university/forecast-plan-idoc) 

#####  Forecast plan (IDoc) 

 Forecasting APIs allow companies to exchange data about anticipated product demand and supply availability with upstream supply chain Partners without giving these Partners access to their serialization system of record. 

 

 [View More](/resources/tracelink-university/forecast-plan-idoc) 

 

 [ ![Related content](https://www.tracelink.com/sites/default/files/2024-09/cloud.svg) ](/resources/tracelink-university/forecast-plan-x12) 

#####  Forecast plan (X12) 

 Forecasting APIs allow companies to exchange data about anticipated product demand and supply availability with upstream supply chain Partners without giving these Partners access to their serialization system of record. 

 

 [View More](/resources/tracelink-university/forecast-plan-x12) 

 

 [ ![Related content](https://www.tracelink.com/sites/default/files/2024-09/cloud.svg) ](/resources/tracelink-university/forecast-plan-response-idoc) 

#####  Forecast plan response (IDoc) 

 Forecasting APIs allow companies to exchange data about anticipated product demand and supply availability with downstream supply chain Partners without giving these Partners access to their serialization system of record. 

 

 [View More](/resources/tracelink-university/forecast-plan-response-idoc)