Advance Ship Notice (856) Specification
If you integrated with EDI earlier, refer to these docs.
In this guide, we walkthrough our basic EDI specification for Advanced Ship Notice (856) files. You can read through the full guide here.
Segment Summary
ID | Name | Loop ID | Required by Modern Dropship |
ST | Transaction Set Header | Mandatory | |
BSN | Beginning Segment for Ship Notice | Mandatory | |
HL | Hierarchical Level | HL | Mandatory |
TD5 | Carrier Details (Routing Sequence / Transit Time) | HL | Mandatory |
HL | Hierarchical Level | HL | Mandatory |
PRF | Purchase Order Reference | HL | Mandatory |
HL | Hierarchical Level | HL | Mandatory |
MAN | Marks and Numbers | HL | Mandatory |
DTM | Date/Time Reference | HL | Mandatory |
HL | Hierarchical Level | HL | Mandatory |
LIN | Item Identification | HL | Mandatory |
SN1 | Item Details (Shipment) | HL | Mandatory |
CTT | Transaction Totals | Mandatory | |
SE | Transaction Set Totals | Mandatory |
Segment Summary
ST
ID | Name | Required | Min | Max | Notes |
ST-01 | Transaction Set Identifier Code | True | 3 | 3 | Accepted Values: 856 |
ST-02 | Transaction set Control Number | True | 4 | 9 | Ex. 0001 |
BSN
ID | Name | Required | Min | Max | Notes |
BSN-01 | Transaction set Purpose Code | True | 2 | 2 | Accepted Values: 00 |
BSN-02 | Shipment Identification | True | 2 | 30 | Ex. 0101779964 |
BSN-03 | Date | True | 8 | 8 | Ex. 20211231 |
BSN-04 | Time | True | 4 | 8 | Ex. 1545 |
BSN-05 | Hierarchical Structure Code | False | 4 | 4 | Ex. 0001 |
Shipment Identification :: This value should be the code within your system. You are required to keep this unique within your system.
BSN-01
Code | Name |
00 | Original |
BSN-03
Expected form YYYYMMDD.
BSN-04
Expected format HHMM on a 24 hour clock.
Our servers operate using the UTC timezone.
HL
ID | Name | Required | Min | Max | Notes |
HL-01 | Hierarchical ID Number | True | 1 | 12 | Ex. 1, 2 |
HL-02 | Hierarchical Parent ID Number | True | 1 | 12 | Not required in Shipment HL loop. Ex. 1, 2, 3 |
HL-03 | Hierarchical Level Code | True | 1 | 2 | Accepted Values: S, O, P, I |
The shipment and order loop should be only used once.
HL-03
Code | Required | Name | Notes |
S | True | Shipment | |
O | True | Order | |
P | True | Pack | |
I | True | Item |
TD5
ID | Name | Required | Min | Max | Notes |
TD5-02 | Identification Code Qualifier | True | 1 | 2 | Accepted Values: 2 |
TD5-03 | Identification Code | True | 2 | 80 | We expect a SCAC Code |
TD5-05 | Routing | True | 1 | 35 | The carrier name. Ex. Canada Post |
TD5-02
Code | Name |
2 | Standard Carrier Alpha Code (SCAC) |
PRF
ID | Name | Required | Min | Max | Notes |
PRF-01 | Purchase Order Number | True | 1 | 22 | Ex. 4541828001 |
This is the same value as provided in BEG-03 within the Purchase Order (850).
MAN
ID | Name | Required | Min | Max | Notes |
MAN-01 | Marks and Numbers Qualifier | True | 1 | 2 | Accepted Values: CP |
MAN-02 | Marks and Numbers | True | 1 | 48 | This is the fulfillments tracking codes supplied by the carrier. Ex. 12345 |
MAN-01
Code | Name |
CP | Carrier-Assigned Package ID Number |
DTM
ID | Name | Required | Min | Max | Notes |
DTM-01 | Date/Time Qualifier | True | 3 | 3 | Accepted Values: 011 |
DTM-02 | Date | True | 8 | 8 | Ex. 20211231 |
DTM-01
Code | Name |
011 | Shipped |
DTM-02
Expected format: YYYYMMDD.
LIN
ID | Name | Required | Min | Max | Notes |
LIN-01 | Assigned Identification | True | 1 | 20 | Ex. 1, 2, 3 |
LIN-02 | Product ID Qualifier | True | 2 | 2 | Accepted Values: VC |
LIN-03 | Product ID | True | 1 | 48 | Ex. 896668000120 |
Assigned Identification should be the value provided in PO1-01 from the Purchase Order (850).
LIN-02
Code | Name | Notes |
VC | Variant Code |
SN1
ID | Name | Required | Min | Max | Notes |
SN1-02 | Number of Units Shipped | True | 1 | 10 | Ex. 1 |
SN1-03 | Unit for Measurement Code | True | 2 | 2 | Accepted Values: EA |
SN1-03
Code | Name |
EA | Each |
CTT
ID | Name | Required | Min | Max | Notes |
CTT-01 | Number of Line Items | True | 1 | 6 | Ex. 1 |
SE
ID | Name | Required | Min | Max | Notes |
SE-01 | Number of Included Segments | True | 1 | 10 | Ex. 14 |
SE-02 | Transaction Set Control Number | True | 4 | 9 | Ex. 0001 |
Samples
ISA*00* *00* *ZZ*SAMPLEISAID *01*117522184 *210423*1545*U*00401*000038025*0*P*}~
GS*SH*SAMPLEISAID*117522184*20210423*1545*38025*X*004010~
ST*856*0001~
BSN*06*0101779964*20210423*1545*0001~
HL*1**S~
TD1*CTN25*1****G*4.03*LB~
TD5**2*CPC*M*Canada Post*******G2~
HL*2*1*O~
PRF*4541828001***20210422~
HL*3*2*P~
MAN*CP*4010727162508201~
DTM*011*20210423~
HL*4*3*I~
LIN*3*VC*896668000120~
SN1**1*EA~
SE*14*0001~
GE*1*38025~
IEA*1*000038025~
