Skip to main content

Start Seller Central Hand-off

POST 

/api/amazon/:integrationInstance/draft-inbound-plans/:draft_inbound_plan/awd/seller-central-handoff

Finish an AWD plan in Seller Central after Amazon rejected its draft in SKU.io. Returns the reference to type as the shipment name in Seller Central → Send to AWD, and the case groups (packagesToInbound) to enter. The plan's reservation and draft transfer are synced to those packages and stay held.

Required scope: integrations:write

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

When the shipment sync later sees an order SKU.io doesn't know, it is linked to this plan (order source: handoff) if its externalReferenceId equals the reference, or, when no reference was typed, if its units per MSKU equal these packages and it was created after the hand-off. Only an unambiguous match (one plan) is linked. A hand-off with no order after 90 days releases the reservation, cancels the plan and raises an "AWD Seller Central Hand-off Expired" alert.

Calling it again keeps the same reference. The plan's awd_handoff (on the plan resource) shows the pending hand-off.

Refused (422) for a plan that does not ship to AWD, is cancelled, already has a live AWD order (code: awd_order_live), has no SKU ready for AWD, or whose source can't cover the reservation (code: insufficient_stock). 409 (code: awd_plan_busy) while another create, update or confirm on the plan is running.

Requires the integrations.update 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