Set Prep Details
POST/api/amazon/:integrationInstance/draft-inbound-plans/:draft_inbound_plan/set-prep-details
Sets Amazon SP-API prep details (prep category + prep types) for MSKUs on the draft inbound plan whose prep category is unknown. The request is forwarded to Amazon's setPrepDetails operation for the plan's marketplace (derived from the destination warehouse's country); Amazon's raw response (an operationId you can use to correlate the asynchronous SP-API operation) is returned under data.
This endpoint currently requires session authentication; Personal Access Token scope support is in progress.
Request body fields:
mskuPrepDetails(array, required) — one entry per MSKUmskuPrepDetails[].msku(string, required) — the Amazon seller SKUmskuPrepDetails[].prepCategory(string, required) — one ofADULT,BABY,FC_PROVIDED,FRAGILE,GRANULAR,HANGER,LIQUID,NONE,PERFORATED,SET,SHARP,SMALL,TEXTILEmskuPrepDetails[].prepTypes(array of strings, required) — SP-API prep types (e.g.ITEM_POLYBAGGING,ITEM_BUBBLEWRAP,ITEM_LABELING,ITEM_NO_PREP)
Business rule: when prepCategory is NONE, prepTypes must include ITEM_NO_PREP (422 otherwise). A 422 is also returned when Amazon rejects the request.
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.
Unprocessable Entity
Response Headers
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.