# Fulfilment Inbound

## Book Inbound Delivery

 - [POST /api/fulfilment/inbound/book](https://developer-docs.quiqup.com/openapi/fulfilment-inbound/post:fulfilment_public_api.bookinbound.md): ## Book an Inbound Delivery

### 📌 Description

This endpoint allows you to book an inbound delivery to a warehouse. The system handles the complete lifecycle of inbound deliveries from booking to goods receipt.

### 🔹 Use Cases

- Scheduling warehouse deliveries for inventory restocking - Booking collection slots for pickup from suppliers - Managing inbound logistics with proper documentation - Tracking delivery status through the fulfillment system

### 📋 Required Information

- Booking ID: Unique identifier for the delivery booking (optional - auto-generated if not provided) - Warehouse Code: Target warehouse for the delivery - Time Slot: Start and end times for the delivery window - Attendees: List of people who will be present for the delivery - Items: List of products being delivered with quantities

### 📄 Optional Information

- Pickup Details: If collection is required from a supplier - Documents: Supporting files like invoices or manifests - Custom Labels: Human-readable slot identifiers

## Get Inbound Delivery

 - [GET /api/fulfilment/inbound/{id}](https://developer-docs.quiqup.com/openapi/fulfilment-inbound/get:fulfilment_public_api.getinbound.md): ## Get Single Inbound Delivery

### 📌 Description

This endpoint retrieves a specific inbound delivery by its ID. You can view detailed delivery information and track individual delivery progress.

### 🔹 Use Cases

- Viewing specific delivery details for detailed tracking - Checking delivery status for operational planning - Accessing delivery documents and supporting files - Monitoring individual delivery progress

## Get Inbound State History

 - [GET /api/fulfilment/inbound/{id}/state-history](https://developer-docs.quiqup.com/openapi/fulfilment-inbound/get:fulfilment_public_api.getinboundstatehistory.md): ## Get Inbound State History

### 📌 Description

This endpoint retrieves the state change history for a specific inbound delivery. The history tracks all status transitions from booking to completion.

### 🔹 Use Cases

  - Tracking delivery progress through different stages
  - Auditing status changes for compliance and reporting
  - Debugging issues by reviewing the state transition timeline
  - Understanding delivery lifecycle events

## List Inbound Deliveries

 - [GET /api/fulfilment/inbounds](https://developer-docs.quiqup.com/openapi/fulfilment-inbound/get:fulfilment_public_api.getinbounds.md): ## List All Inbound Deliveries

### 📌 Description

This endpoint retrieves all inbound deliveries for the authenticated user. You can view delivery history and track multiple deliveries across different time slots.

### 🔹 Use Cases

- Viewing delivery history for inventory management - Tracking multiple deliveries across different time slots - Monitoring delivery status for planning purposes - Auditing inbound logistics for reporting

## Get Available Slots

 - [GET /api/fulfilment/slots/available](https://developer-docs.quiqup.com/openapi/fulfilment-inbound/get:fulfilment_public_api.getavailableslots.md): ## Get Available Time Slots

### 📌 Description

This endpoint retrieves available time slots for inbound deliveries at a specific warehouse. You can specify a time range to get all available slots within that period.

### 🔹 Use Cases

- Checking available delivery slots before booking an inbound - Planning delivery schedules for inventory restocking - Finding suitable time windows for warehouse deliveries - Optimizing delivery planning based on availability