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.
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
- 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
Response Headers
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.