Skip to main content

Submit Box Contents (3PL Portal)

POST 
/api/amazon/:integrationInstance/draft-inbound-plans/fulfillment-portal/:token/box-contents

Anonymous 3PL portal submission of packed box contents. Access is granted by the opaque :token in the URL (the packet's portal_token) — no bearer auth. The submission is stored verbatim on the packet's portal_submission.boxes JSON.

Authorization

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

Validation

  • boxes — required array, 1..1000 boxes
  • boxes.*.box_number — required integer 1..100000, distinct across boxes
  • boxes.*.length / boxes.*.width / boxes.*.height — optional numeric 0..1000000 (per-box carton dimensions)
  • boxes.*.dimension_unit — optional string, one of IN, CM
  • boxes.*.weight — optional numeric 0..1000000
  • boxes.*.weight_unit — optional string, one of LB, KG
  • boxes.*.amazon_fba_carton_template_id — optional integer, must exist in amazon_fba_carton_templates (provenance marker set when the 3PL picks a saved carton preset; kept even after manual dimension edits)
  • boxes.*.lines — required array, 1..1000 lines per box
  • boxes.*.lines.*.sku — required string, max 255
  • boxes.*.lines.*.quantity — required integer 1..1000000

The dimension/weight fields are optional so a bare SKU+quantity submission still validates, but the portal offers the same full-featured box entry (carton presets + L×W×H + weight) the internal packing station uses. Returns the refreshed portal payload (same shape as GET .../fulfillment-portal/:token).

Request​

Responses​

OK

Response Headers
    Content-Type