Connecting through Seller EDI for Wholesale - Advance Ship Notice (856) Specification
In this guide, we walkthrough our basic EDI specification for Advanced Ship Notice (856) files.
Segment Summary
ID | Name | Loop ID | Required by Convictional |
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 | Name | Notes |
S | Shipment | |
O | Order | |
P | Pack | |
I | 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: UP, EN, OT |
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 |
UP | UPC Codes | |
EN | European Article Number | |
OT | Internal Number | This is the Convictional Variant ID. |
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*UP*896668000120~
SN1**1*EA~
SE*14*0001~
GE*1*38025~
IEA*1*000038025~
