Overview
How to send seller stock to the marketplace warehouse (Full, FBA).
A fulfillment inbound shipment moves stock from the seller warehouse to the marketplace warehouse (Full, FBA and similar). It has items with quantity and receivedQuantity, a destination and a status. Without it, the units you sent would still count as available in the local warehouse.
Where it fits in the journey: Stay in sync.
Endpoints
| Method | Path | What it does |
|---|---|---|
GET | /v1/fulfillment-inbound-shipments | List shipments |
POST | /v1/fulfillment-inbound-shipments | Create shipment |
GET | /v1/fulfillment-inbound-shipments/{id} | Get shipment |
PATCH | /v1/fulfillment-inbound-shipments/{id} | Update shipment |
DELETE | /v1/fulfillment-inbound-shipments/{id} | Cancel shipment |
All require Authorization: Bearer mk_your_api_key. See Authentication.
States
draft → submitted → scheduled → in_transit → receiving → received. Before in_transit, it can become cancelled.
Stock
- Create: reserves the quantity in the source warehouse.
in_transit: the item leaves the warehouse, with thefulfillment_transfermovement (lowersreservedandonHand).received: shows up as an observation of the fulfillment location, not as your balance.
A failed submit leaves the shipment in draft, with statusReasons. A PATCH resends it.
Webhooks
fulfillment_inbound_shipment.created and fulfillment_inbound_shipment.updated (with previousStatus). See Receiving webhooks.