Carrier Connection Statuses

Rating, Dispatch, Tracking, eBOL, and Document requests all move through a set of statuses as Shipwell works with the carrier. The following are the possible statuses you'll see for each.

Dispatch Statuses

The following are the possible statuses for a dispatch. See Dispatch for the full lifecycle.

Name	Description
`QUOTING`	A rate has been requested but the shipment has not yet been tendered to a carrier.
`QUOTING_ACCEPTED`	A rate has been accepted and is ready to be tendered to the carrier.
`PENDING`	The dispatch request has been created and is waiting to be tendered.
`TENDERED`	The shipment has been offered to the carrier and is awaiting their response.
`CARRIER_CONFIRMED`	The carrier has accepted the tender.
`DISPATCHED`	The booking is finalized and scheduled for pickup.
`IN_TRANSIT`	The carrier has picked up the shipment and is hauling it.
`AT_PICKUP`	The shipment has arrived at the pickup location.
`AT_DELIVERY`	The shipment has arrived at the delivery location.
`COMPLETED`	The shipment has been delivered and the dispatch is closed out.
`CANCELLED`	The dispatch was cancelled before completion.
`ERROR`	The dispatch could not proceed due to an error.

Note

Not every dispatch passes through every status above — some are skipped depending on the carrier and shipment. CANCELLED and ERROR can occur at various points rather than only at the end.

Carrier Response Types

After a shipment is tendered, the carrier responds with one of the following:

Name	Description
`ACCEPT`	The carrier commits to the booking.
`DECLINE`	The carrier turns down the tender.
`REVOKE`	The carrier withdraws a booking it had previously accepted.

Request Statuses (Rating, Tracking, eBOL, Documents)

Rating, Tracking, eBOL, and Document requests are processed as asynchronous jobs, and each moves through the following statuses:

Name	Description
`PROCESSING`	The request has been submitted and Shipwell is waiting on the carrier's response.
`COMPLETED`	The carrier responded successfully and results are available.
`ERRORED`	Something went wrong communicating with the carrier.
`CANCELLED`	The request was cancelled before it completed.
`FAILED`	The request could not be completed.
`EXPIRED`	The carrier did not respond within the allowed time.

Tracking Event Types

Tracking updates are normalized into the following event types regardless of carrier. See Tracking for more detail.

Name	Description
`PICKED_UP`	The carrier has taken possession of the shipment.
`IN_TRANSIT`	The shipment is moving toward its destination.
`ARRIVED_AT_STOP`	The shipment has reached an intermediate or final stop.
`OUT_FOR_DELIVERY`	The shipment is on its final leg to the delivery location.
`DELIVERED`	The shipment has been delivered.
`EXCEPTION`	Something unexpected has happened, such as a delay or missed appointment.
`LOCATION_UPDATE`	A positional update was reported without a change in status.