Skip to main content

Import Boxes (CSV)

POST 
/api/amazon/:integrationInstance/draft-inbound-plans/:draft_inbound_plan/boxes/import

Import box contents for a packing group from a CSV file (multipart/form-data). Boxes are created or updated by box_number and item quantities are added per row.

Authorization

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

Form fields:

  • file (file, required) — CSV file (.csv/.txt), max 2MB
  • amazon_fba_inbound_packing_group_id (integer, required) — must exist and must belong to this draft inbound plan (422 otherwise)

CSV columns (header row required; column names are case-insensitive):

  • box_number (required) — positive whole number; rows with the same box number go into the same box. A box number already used by a DIFFERENT packing group on this plan is rejected
  • sku (required) — matched case-insensitively against the plan items' product SKU or MSKU; must resolve to an item that is part of the selected packing group
  • quantity (required) — positive whole number; added to the box's quantity for that item
  • weight, length, width, height (optional) — numbers > 0; when present they update the box's measurements

The import is all-or-nothing: every row is validated first, and any invalid row aborts the entire import with row-numbered error messages (422). On success the response includes a summary (boxes_created, items_imported) plus the full refreshed box list for the plan.

Request​

Responses​

OK

Response Headers
    Content-Type