Skip to content

Shipments

To fulfill an order, the dropshipper must create one or more shipments, each linked to specific order lines.

Shipments are initially created in the packed state. Further updates to a shipment’s status are made using the Update Shipment endpoint.

Shipment Lifecycle

There are two possible shipment workflows: - Standard delivery flow, when the shipment moves through the following states: packed → shipped → delivered - Canceled before shipment, when the shipment is canceled before it leaves the warehouse: packed → canceled.

Note

A shipment which has already transitioned to the shipped state cannot be canceled anymore.

Shipment State Timestamps

Every shipment state must include the actual timestamp when the event occurred:

Shipment state Required field
packed packed_at
shipped shipped_at
delivered delivered_at
canceled canceled_at

Tracking Information

While optional at the time of shipment creation, the following fields must be provided when updating a shipment to the shipped state:

  • carrier: must be a valid carrier name, such as USPS, UPS, FedEx, etc.
  • tracking_number: must be unique in the system
  • tracking_url: should also include the tracking_number

Note

Tracking information can be updated via the API only during the packed → shipped transition.