Skip to main content

Submit Packing Information

POST 
/api/amazon/:integrationInstance/draft-inbound-plans/:draft_inbound_plan/packing/submit

Submit box content information for every packing group of the plan's confirmed packing option in a single request (FBA Inbound v2024-03-20 setPackingInformation operation). Amazon requires all of the confirmed option's package grouping ids together, so submission is plan-level rather than per-group — submitting one group at a time is rejected with "Provided package grouping ids are incorrect. Expected all of [...]".

Authorization

Any valid API token can call this endpoint — no specific scope required. Manage tokens.

Fields:

  • sources (object, optional) — map of packing group id => content information source. Each value is one of BOX_CONTENT_PROVIDED, MANUAL_PROCESS, BARCODE_2D. Groups omitted from the map (or the whole sources object omitted) default to BOX_CONTENT_PROVIDED. With BOX_CONTENT_PROVIDED a group's per-box item contents are submitted; MANUAL_PROCESS and BARCODE_2D submit box dimensions/weights without item contents

Confirmed packing option required: if the plan has no confirmed packing option, returns 422 with the message under errors.packing_option ("Confirm a packing option before submitting box contents.").

Pre-flight validation (applies to each group whose source is BOX_CONTENT_PROVIDED; any failure returns 422 with messages under errors.packing_group):

  • The packing group must have at least one box
  • Every box must have length, width, height, AND weight greater than zero
  • The plan may not exceed 5,000 boxes
  • Per-MSKU packed totals across the group's boxes must EXACTLY equal the packing group's planned quantities (no shortfalls, overages, or MSKUs outside the group)
  • No box item may have an expiration date in the past

This is an asynchronous endpoint: it dispatches a tracked background job and returns { "data": { "tracked_job_log_id": <id> } } immediately. Progress is visible via the tracked job log endpoints, and the underlying Amazon operation is resolved by the amazon_inbound_operations poller (a background job).

Tracked job name: Submit FBA Box Contents: {plan name}.

Request​

Responses​

OK

Response Headers
    Content-Type