Backfill Straddle Removal Orders
POST/api/amazon/:integrationInstance/removal-orders/backfill-straddle
One-time repair for removal orders that straddle the integration's FBA inventory tracking start date. Before the straddle fix, removal shipments dispatched before go-live were dropped during report import, leaving the surviving removal orders with zero receivable shipments and phantom shrinkage.
Any valid API token can call this endpoint — no specific scope required. Manage tokens.
Queues a background job; returns a job id (tracked_job_log_id) for polling progress. Per instance, the job: (1) re-creates the dropped removal shipment rows by replaying the stored report payloads where they still exist (replay is idempotent — checksum de-duplication re-inserts only the previously-missing rows and never touches existing receipts, discards or inventory adjustments), (2) surfaces reports whose source payload is no longer available so an operator can act (quantities are never fabricated), and (3) re-evaluates the receipt status of every straddling removal order. Instances without an FBA inventory tracking start date no-op cleanly.
Body fields:
- dry_run (boolean, optional, default false) — compute and record the same counts in the job results without writing any changes.
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.