Cancel Amazon Plan
POST/api/amazon/:integrationInstance/draft-inbound-plans/:draft_inbound_plan/cancel-amazon-plan
Cancel a draft inbound plan.
Any valid API token can call this endpoint — no specific scope required. Manage tokens.
Never-submitted plans are simply marked ABORTED locally and their reserved inventory is released.
Submitted plans are voided on Amazon; the original draft stays bound to its now-VOIDED Amazon plan as ABORTED history and remains visible on the Drafts tab. With create_draft=true (default) a fresh duplicate draft is returned for resubmission.
Flagged-SKU handling: MSKUs Amazon named in the plan's rejection problems (e.g. FBA_INB_0465 manufacturer-barcode errors) are automatically left out of the duplicate — unless msku_replacements maps them to an alternate listing (from → to), in which case the item is carried into the copy under the replacement MSKU with its label owner reset for reconfiguration. Dropped MSKUs are returned in excluded_flagged_mskus; applied swaps in replaced_mskus.
The resubmission copy preserves per-line kit assembly consent (kit_fulfillment_mode) and case-pack snapshots.
Requires Bearer token.
When a resubmission draft is created, the returned duplicate carries: excluded_flagged_mskus (SKUs Amazon flagged as invalid, dropped from the copy), replaced_mskus (flagged->alternate swaps applied), and — for fixable rejections that keep every SKU — resubmission_expiration_mskus (SKUs needing an expiration date), resubmission_address_issue (bool; the ship-from address needs fixing) and resubmission_other_problems (other messages to resolve before resubmitting).
Request
Responses
- 200
- 401
- 403
- 404
- 422
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.
Validation failed — the body is a field → messages map (Laravel shape) or the platform envelope with a stable machine-readable code. Fix the payload and resubmit.
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.