# Fulfilment Inbound

An inbound is a booked delivery of stock into the warehouse, and the only way stock arrives. See [Inbound](/docs/fulfilment/inbound).

 - [POST /api/fulfilment/inbound/book](https://developer-docs.quiqup.com/openapi/fulfilment-inbound/post:fulfilment_public_api.bookinbound.md): Books a delivery of stock into the Quiqup warehouse that serves your account. The warehouse is set from your account: there is no warehouse to choose. Only `items` is needed to create an inbound, and
 - [GET /api/fulfilment/inbound/{id}](https://developer-docs.quiqup.com/openapi/fulfilment-inbound/get:fulfilment_public_api.getinbound.md): Returns one inbound by its id, with its items and documents.
 - [GET /api/fulfilment/inbound/{id}/state-history](https://developer-docs.quiqup.com/openapi/fulfilment-inbound/get:fulfilment_public_api.getinboundstatehistory.md): Returns every status change of an inbound: the old and new status, when it happened, who or what made the change, why, where it came from (`webhook`, `pull` or `manual`) and, for a change reported by
 - [GET /api/fulfilment/inbounds](https://developer-docs.quiqup.com/openapi/fulfilment-inbound/get:fulfilment_public_api.getinbounds.md): Lists your inbounds, one page at a time, 100 to a page unless you send `limit`. Filter by `state`, `type`, `ids` or `asn_id`, or by the start of the delivery window with `slot_from` and `slot_to`.
 - [PATCH /api/fulfilment/inbounds/{id}](https://developer-docs.quiqup.com/openapi/fulfilment-inbound/patch:fulfilment_public_api.updateinbound.md): Adds or changes the courier details (`plate_number`, `courier_name`, `courier_contact`) and attaches documents, on an inbound that is `PENDING`, `BOOKED` or `IN_PROGRESS`. Fields you omit are kept. A
 - [POST /api/fulfilment/inbounds/{id}/cancel](https://developer-docs.quiqup.com/openapi/fulfilment-inbound/post:fulfilment_public_api.cancelinbound.md): Cancels an inbound that is `PENDING`, `BOOKED` or `IN_PROGRESS`. The inbound is kept with status `CANCELLED`, and Quiqup cleans up the warehouse booking. You can only cancel your own inbounds. A `PEND
 - [GET /api/fulfilment/inbounds/{id}/items](https://developer-docs.quiqup.com/openapi/fulfilment-inbound/get:fulfilment_public_api.getinbounditems.md): Returns the line items of an inbound with what the warehouse counted: the expected `quantity`, `received_qty`, `usable_quantity`, `unusable_quantity` and `quarantine_quantity`, plus the batch number,
 - [POST /api/fulfilment/inbounds/{id}/schedule](https://developer-docs.quiqup.com/openapi/fulfilment-inbound/post:fulfilment_public_api.scheduleinbound.md): Gives a `PENDING` inbound its delivery window. The inbound moves to `BOOKED` and the warehouse booking is made. `slot_start_at` must be in the future and `slot_end_at` after it. Only a `PENDING` inbou
 - [GET /api/fulfilment/slots/available](https://developer-docs.quiqup.com/openapi/fulfilment-inbound/get:fulfilment_public_api.getavailableslots.md): Returns the delivery windows in which the warehouse serving your account can take an inbound, between `start_time` and `end_time`. Both are required. The warehouse is set from your account, so a `ware