The shipping advice we send back: 945

Summary

The 945 (warehouse shipping advice) tells the partner "this has shipped, and this is what shipped". The warehouse generates it automatically when one of the customer's shipments is closed, stores it as is, and today someone has to deliver it to the partner.

When it is generated

When a shipment is closed (Closing a shipment), if all three conditions are met:

The warehouse has the EDI module on.
The shipment's customer has an active partner profile in that warehouse.
That profile lists the 945 among the documents sent back.

It is generated for any closed shipment of that customer, whether it came through EDI, the API, the client portal or was entered by hand. It is generated in the background after the close: if it failed, the close would not be held up.

What it carries

Segment	Content
ISA / GS	The envelope, with the partner's id as receiver, version 00401 and its own control number that goes up one by one per partner.
ST	`945`.
W06	`W06N` followed by the warehouse shipment number.
N1*CA	The carrier, if the shipment has one.
W12	One line per shipment line: quantity ordered, quantity loaded, unit and the SKU with the VN qualifier.
W03	The total units loaded.
SE / GE / IEA	The end of the envelope, with the counts.

Example

Northern Trading Co.'s shipment SH-NT-00077 went out with 60 of 60 cases of NT-1001 and 18 of 30 pieces of NT-2040:

ST*945*0007~
W06*N*SH-NT-00077~
N1*CA*Southern Logistics~
W12*CC*60*60*0*CS**VN*NT-1001~
W12*CC*30*18*0*EA**VN*NT-2040~
W03*78~
SE*7*0007~

What it lacks today

Important: review this with the partner before going live. Today the 945 has gaps a demanding partner will reject:

It does not carry the partner's order number. The W06 carries our shipment number, not the reference the customer sent in their 940 or through the API. The partner has to match it some other way.
Every line is marked complete (CC), even when less than ordered was loaded. The quantities are real: in the example, 18 of 30.
It carries no ship date, tracking number, bill of lading number or destination.
The warehouse sender id is fixed and cannot be configured per warehouse.

How it reaches the partner

Today it does not get there on its own: there is no SFTP, AS2 or web service delivery for the 945. The file stays stored at the warehouse. If your customer needs it, write to us with the shipment number and we will hand it over so you can pass it on.

Frequently asked questions

Is there another way for the partner to hear about the close?

Yes: the "shipment closed" API callback, which is delivered automatically, carries the customer's reference and the loaded quantity per line. If the partner can receive it, it is the most complete option today. See Callbacks.