Skip to main content

Update AWD Inbound Order Transport

PUT 

/api/amazon/:integrationInstance/awd/inbound-orders/:awd_inbound_order/transport

Send your own carrier's tracking for the order's shipment to Amazon and keep the carrier and tracking number on the shipment. Allowed once the order is CONFIRMED and its shipment exists, until the shipment is delivered, closed or cancelled; not for Seller Central orders.

Required scope: integrations:write

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Body:

  • carrier_code (string, required): the carrier's SCAC, 2–4 letters (trimmed and upper-cased), e.g. ODFL, UPSN. Any SCAC is accepted; GET /api/amazon/awd/carriers lists suggestions. Anything else answers 422 (A SCAC is 2 to 4 letters, e.g. MAEU or ODFL.)
  • booking_ids (string[], required, 1–5000): booking / PRO / tracking numbers
  • mode (string, optional): shipment (default; LTL/FTL, only the first booking ID is sent) or small_parcel (one tracking number per box, all are sent)

Errors. A refused action answers with {message, code, errors: [{msku, message, code}], details}: 422 when SKU.io refuses it before calling Amazon (wrong status, plan not ready) or Amazon rejects it (code: rejected); 403 not_authorized when Amazon has not granted the AWD role (reconnect the account); 404 not_found when Amazon no longer knows the order; 409 conflict while Amazon is still validating the order or refuses the change (details.amazon_reason); 429 rate_limited; 504 timeout. A 409, 429 or 504 changed nothing and can be retried.

Requires the integrations.sync permission.

Returns 404 when the order belongs to a different Amazon account than the one in the URL.

Request​

Responses​

OK

Response Headers
    Content-Type