Skip to main content

Update Draft Inbound Plan

PUT 
/api/amazon/:integrationInstance/draft-inbound-plans/:draft_inbound_plan

Update a draft FBA inbound plan. Advancing the plan to a verified state reserves source-warehouse stock; if the warehouse lacks enough on-hand quantity the request returns 400 with a product error.

Not yet available to API tokens

This endpoint currently requires session authentication; Personal Access Token scope support is in progress.

Kit lines: a kit line in kit_stock mode that lacks pre-built stock — but whose components could assemble the requested quantity — returns a dedicated 400 error including buildable_from_components, hinting that the line should be switched to components mode (PATCH the item with kit_fulfillment_mode: components) so verification can allocate the component stock instead.

source_warehouse_id (integer, optional, must exist in warehouses) — move the ship-from to another supplier warehouse (Siber call review A2/D5/Q1). Allowed only while the draft is unsubmitted (status source_selected … configured, no Amazon plan yet) and only supplier → supplier; the supplier follows the warehouse, source_mode stays PURCHASE_ORDER, and the stored ship-from snapshot is cleared so submission reads the new warehouse's address. A draft already verified returns to skus_selected (workflow step 2) with every line's verified_quantity cleared, because the previous supplier's confirmations no longer hold. Refused with 422 on source_warehouse_id when the plan was submitted to Amazon ("…Use Cancel & Create Draft to move it."), when the current source is an own warehouse (a warehouse transfer reserves stock at its source), or when the new warehouse is not a supplier warehouse. Amazon itself receives the address in createInboundPlan; after that its own change path is cancel-and-recreate (or, before carriers are confirmed, a per-shipment updateShipmentSourceAddress this app does not drive).

Requires the integrations.update permission.

Returns 404 when the inbound plan (or a shipment, box, option or item nested under it) in the path belongs to a different Amazon account than the one in the URL.

Request​

Responses​

OK

Response Headers
    Content-Type