# Orders

Newly created orders have status set to `blocked`.

After MALL processes the order (validations passed and payment was successful), it's `status` will be set to `open` and `confirmed` to `false` (partner can list these orders using `/orders/unconfirmed` endpoint).

This is the moment where partner should start with expedition process, and it is necessary to confirm these orders by setting `confirmed` to `true` and start updating order status. More information about order statuses [here](https://knowledgebase.mallgroup.com/en/statusy-objednavek/).

### ⚠ ATTENTION
Exceptions to order statuses applies in case you are using MALL Delivery service. Please check the information [here](https://knowledgebase.mallgroup.com/en/mall-doprava-a-stavy-objednavek/).

Our system also provides webhook feature so you can easily track order updates from MALL. Please check more information [here](https://knowledgebase.mallgroup.com/en/webhook-pro-stavy-objednavek/).

When using MALL Delivery you can get parcel labels using `/orders/labels` endpoint bellow.

### ℹ NOTE
To display `test` orders in list endpoints, use query param `test=1`.

### Description of statuses
  * `blocked` - order is blocked and cannot be processed by partner
  * `open` - order is open and ready for shipment by partner
  * `shipping` - order is in shipment process and cannot be cancelled
  * `shipped` - order is shipped to the customer
  * `delivered` - order is delivered to the customer
  * `returned` - final status, order is returned as undelivered and is not invoiced
  * `cancelled` - final status, order is cancelled and is not invoiced
  * `lost` - final status, order consignment was lost during delivery ( only for orders shipped with MDP, status is managed by mall )

### Statuses managed by partner
  * from `open` to `cancelled`, `shipping` or `shipped`
  * from `shipping` to `cancelled` or `shipped`
  * from `shipped` to `delivered` or `returned`

### Order's labels and consignments
  * You can create order labels needed for order delivery by MALL transports. Number of parcel count is required for label creation. It returns base64 representation of PDF labels.
  * Returns consignments data if order labels were created.



## Operations
- [Get orders using filters](https://mall-api-proxy.documentation.omnicado.com/operation/operation-get-orders.md)
- [Get list of unconfirmed orders](https://mall-api-proxy.documentation.omnicado.com/operation/operation-get-orders-unconfirmed.md)
- [Get list of orders by status](https://mall-api-proxy.documentation.omnicado.com/operation/operation-get-orders-parameter.md)
- [Get order detail](https://mall-api-proxy.documentation.omnicado.com/operation/operation-get-orders-parameter.md)
- [Update order](https://mall-api-proxy.documentation.omnicado.com/operation/operation-put-orders-parameter.md)
- [Generate labels for MALL Delivery orders](https://mall-api-proxy.documentation.omnicado.com/operation/operation-post-orders-labels.md)
- [Generates labels for both DIP and MPD orders](https://mall-api-proxy.documentation.omnicado.com/operation/operation-post-orders-labels-bulk.md)
- [Set order item serial numbers](https://mall-api-proxy.documentation.omnicado.com/operation/operation-put-orders-parameter-items-parameter-serial-numbers.md)
- [Set order tracking number](https://mall-api-proxy.documentation.omnicado.com/operation/operation-put-orders-parameter-tracking-number-parameter.md)
- [Set order tracking information](https://mall-api-proxy.documentation.omnicado.com/operation/operation-put-orders-parameter-tracking.md)
- [Create new order labels](https://mall-api-proxy.documentation.omnicado.com/operation/operation-post-orders-parameter-labels.md)
- [Returns order consignments](https://mall-api-proxy.documentation.omnicado.com/operation/operation-get-orders-parameter-consignments.md)
- [Get order statistics](https://mall-api-proxy.documentation.omnicado.com/operation/operation-get-orders-stats.md)

[Powered by Bump.sh](https://bump.sh)