Advance Ship Notice (856) Specification

Nick Wehner Updated by Nick Wehner

This documentation is for users who have integrated with EDI in September 2024 or later.
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~

How did we do?

Connecting through Seller EDI

Contact