Skip to main content

Update AWD Inbound Order

PUT 

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

Change a DRAFT order created in SKU.io, then read it back from Amazon. Confirmed orders and orders created in Seller Central cannot be changed.

Required scope: integrations:write

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

Body (all optional; send only what changes):

  • destination_region (string|null): preferred AWD region, one of us-west, us-east, us-southcentral, us-southeast; null lets Amazon choose
  • origin_address (object|null): ship-from address, merged over the stored one. addressLine1, stateOrRegion and countryCode (2 letters) are required when the object is sent; name, addressLine2, city, postalCode (≤32), phoneNumber (≤32) are optional
  • packages_from_plan (boolean): rebuild the order's cases from its draft inbound plan's current lines (after editing quantities or case packs on the plan)

When Amazon moves the order to a different AWD warehouse because of the change, the response carries a top-level destination_moved_to with the new destination name and a message saying so.

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.update 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