Skip to main content

Create AWD Inbound Order from Plan

POST 

/api/amazon/:integrationInstance/draft-inbound-plans/:draft_inbound_plan/awd/orders

Create the plan's AWD inbound order at Amazon as a DRAFT from its ready lines (see Get AWD Plan Readiness), and optionally confirm it in the same call. The plan must be verified (status verified, verified with adjustments, configured, or submitted) and its ship-from warehouse must have a complete address.

Required scope: integrations:write

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

Idempotent: if the plan already has a live (not cancelled or expired) order, that order is re-read from Amazon and returned instead of creating another, so a retry after a timeout is safe.

Body (all optional):

  • destination_region (string|null): preferred AWD region, us-west, us-east, us-southcentral or us-southeast; null lets Amazon choose
  • external_reference (string|null, ≤240): your reference on the Amazon order (default SKU-IP{plan id}; made unique per account)
  • confirm (boolean, default false): confirm the draft straight away (see Confirm AWD Inbound Order)

When Amazon rejects the draft, the 422 lists per-MSKU errors[] and details.manual_entry (each included line's msku, sku, units, case_pack_qty, cases) plus details.seller_central_url, so the order can be keyed in Seller Central instead. A 409 means another request is creating the same order; wait and re-read the plan.

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 plan belongs to a different Amazon account than the one in the URL.

Request​

Responses​

OK

Response Headers
    Content-Type