Skip to main content

SPS Commerce reference

Look up what a status, step, or message means. For how the pieces fit together, see How SPS Commerce EDI works.

Documents​

DocumentDirectionSent or received
Purchase order (850)ReceivedEvery five minutes, or when you click Check SPS for new orders
Acknowledgment (855)SentAs soon as the purchase order's sales order is created
Ship notice (856)SentWhen the shipment is recorded; with carton-level ship notices, when its packing is finalized
Invoice (810)SentRight after the shipment's ship notice, when invoices are turned on
Inventory advice (846)SentOnce a day at 5:00 UTC, one per retailer, when inventory advice is turned on

Purchase order statuses​

Shown in the Status column of the Purchase Orders tab.

StatusMeaning
PendingReceived and waiting to become a sales order
ValidatedChecked and about to become a sales order
Sales Order CreatedIts sales order exists; the acknowledgment is on its way
AcknowledgedIts acknowledgment was sent
ProcessedFinished
FailedIt couldn't become a sales order. Hover over the status for the reason, which is usually an item not mapped to a product yet

Document statuses​

Shown in the Status column of the Documents tab. Hover over Failed to read why.

StatusMeaning
ReceivedA purchase order SKU.io downloaded and hasn't finished reading yet
ProcessedA purchase order SKU.io read successfully
PreparingA document SKU.io is still building
SendingBuilt and on its way to SPS Commerce, including after Resend
SentSPS Commerce accepted it
FailedSPS Commerce didn't accept it, or a purchase order couldn't be read. A sent document that failed shows Resend

Dashboard tiles​

TileCounts
Purchase ordersEvery purchase order received, and how many became sales orders. Click to open the Purchase Orders tab
Acknowledgments sent (855)Acknowledgments sent, and how many failed. Click to list them on the Documents tab
Ship notices sent (856)Ship notices sent, and how many failed. Click to list them on the Documents tab
Need attentionPurchase orders that failed to become sales orders. Click to list them

Item mapping columns​

ColumnMeaning
Buyer part numberThe retailer's own number for the item. Once mapped, it's remembered for every future order
Vendor part numberThe number the retailer holds for your item. When it equals one of your product SKUs, the line maps itself
UPCThe barcode the retailer sent with the item, if any
Orders waitingPurchase orders that can't become sales orders until the item is mapped
UnitsTotal units of the item across the waiting orders
StatusActive, or Paused for a mapping you turned off, which purchase orders ignore

Cartons tab steps​

The steps across the top of a shipment's Cartons tab, with the caption each shows.

StepCaptions
Pack cartonsUnits left to pack, then the number of cartons
Finalizeassigns SSCC-18 numbers, then SSCC numbers assigned
Print labelsGS1-128 carton labels, then labels ready
Ship notice (856)sent when it ships, waiting for packing, being sent, sent to SPS or send failed
Invoice (810)sent after the ship notice, being sent, sent to SPS or send failed. Hidden when invoices are off

Packing messages​

MessageWhat to do
<SKU>: 6 packed but only 5 shipped.Reduce the quantity packed for that product
Carton 3 is empty. Remove it or pack something into it.Delete the empty carton, or add an item to it
Every shipped unit must be packed into a carton before packing can be finalized.Pack the units the Packing summary shows as Remaining
Set your GS1 company prefix in the SPS Commerce connection settings before finalizing packing.Enter your GS1 company prefix on the Settings tab
Packing is finalized and the cartons have SSCC numbers. Reopen packing to change them.Click Reopen packing first
The ship notice for these cartons has been sent, so they can no longer change.Nothing; the retailer already has these cartons

Label messages​

MessageWhat to do
Choose a carton label template for trading partner <ID> in the SPS Commerce connection settings.Pick the retailer's Label template on the Settings tab
Finalize packing first so every carton has its SSCC number.Click Finalize packing
This retailer's label needs: a bill of lading number, a carrier PRO number.Fill in the listed Freight details, save, then generate the labels again. The list can also name the carrier (SCAC), the shipping warehouse's address, or a shorter value for a field that's too long
SPS Commerce could not render the labels. Try again in a moment.SPS Commerce didn't respond; try again

Submit Now on a shipment​

On a shipment's Overview tab, Submit Now next to Channel Submission:

WhenWhat happens
The ship notice was sentIt's confirmed and the shipment shows as submitted
The ship notice failedIt's sent again
Carton-level, and the packing isn't finalizedNothing is sent; a message says the ship notice waits for its cartons
No ship notice yetOne is built and sent

Next steps​

Last verified: