# Fulfilment Orders

## Create Order

 - [POST /api/fulfilment/orders](https://developer-docs.quiqup.com/openapi/fulfilment-orders/post:fulfilment_public_api.createfulfilmentorder.md): ## Create a Fulfilment Order

### 📌 Description

This endpoint allows you to create a fulfilment order. The service_kind field determines the picking & packing SLA based on your account's cut-off times and automatically selects the appropriate delivery service with the carrier.

### Available Service Kinds:

- partner_next_day → Next-day delivery (standard service), available in UAE & KSA. 
 - partner_same_day → Same-day delivery, currently only available in the UAE. 
 - partner_4hr → 4-hour deliveries, only available in Dubai. 
 - partner_export → International shipments, carrier allocation is rule-based. 


Additionally, return orders can be created by setting is_return to true.

### 🔹 Use Cases

- Creating a new customer order for fulfilment. 
 - Processing a return order by setting is_return: true. 
 - Handling multi-item orders with various delivery options. 
 - Managing payment-on-delivery orders (payment_mode: paid_on_delivery).

## Get Order

 - [GET /api/fulfilment/orders/{id}](https://developer-docs.quiqup.com/openapi/fulfilment-orders/get:fulfilment_public_api.getfulfilmentorder.md): ## Get a Fulfilment Order by ID

### 📌 Description

This endpoint retrieves the details of an existing fulfilment order using its unique ID.

### 🔹 Use Cases

- Checking the status of a previously created fulfilment order. 
 - Retrieving tracking details to share with customers. 
 - Confirming order information before dispatch or customer communication. 
 - Verifying payment and service type for an order.

## Update Order

 - [PATCH /api/fulfilment/orders/{id}](https://developer-docs.quiqup.com/openapi/fulfilment-orders/patch:fulfilment_public_api.updatefulfilmentorder.md): ## Update a Fulfilment Order

### 📌 Description

This endpoint allows you to update an existing fulfilment order. Depending on the current order status, some fields may not be modifiable.

For example:

- If the order is already out for delivery, the shipping address cannot be changed. 
 - If the order has been picked and packed, modifications to products are no longer possible. 
 - Orders that are cancelled or completed cannot be updated. 


### 🔹 Use Cases

- Updating the shipping address before the order is dispatched. 
 - Modifying payment details before dispatched. 
 - Adjusting product quantities before fulfilment begins. 
 - Cancelling an order if it has not yet been picked and packed.