> ## Documentation Index
> Fetch the complete documentation index at: https://developers.cubbo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Order status changed

> Cubbo sends this event to your order webhook URL every time an order's fulfillment status
changes: when the order is created (initial status), when it starts processing, enters picking
or packing, is put on hold or released, is interrupted, canceled, errored, shipped, and on every
return-related status (returning, return_arrived, returned, reentered). It is also sent when a
picking is sent to review (`picking_status: "in_review"`) and on every consumer-to-consumer (C2C)
lifecycle step.

- The body always carries `id`, `status`, `order_number`, `updated_at` and `store_id`.
- `products` (with the picked `unit_codes`) is present only while the order is in `picking` or
  `packing`.
- `channel_name` and `channel_order_id` are included for every Open API integration created
  recently; older integrations may not receive them.
- `channel_integration_id`, `channel_order_id` and `subchannel_name` are added when the
  "include channel details in webhooks" setting is enabled for your store by Cubbo.
- `latest_estimated_time_arrival_range` is added when that extra field is enabled for your
  integration by Cubbo.
- Retries resend the exact same body, so `(id, status, updated_at)` is a safe deduplication key.
  There is no `X-Cubbo-Idempotency-Key` header on this event.




## OpenAPI

````yaml /openapi.yaml webhook orderUpdated
openapi: 3.1.0
info:
  title: Cubbo Clients API
  version: '1.0'
  summary: >-
    Orders, inventory, replenishments, returns, shipping and webhooks for Cubbo
    fulfillment.
  description: >
    The Cubbo Clients API connects your store, ERP or marketplace with Cubbo's
    fulfillment network.

    All endpoints except `POST /auth/token` require a bearer token; see the
    Authentication guide.

    Request and response bodies are JSON. Errors are JSON objects with an
    `error` key.
  contact:
    name: Cubbo integrations
    email: integraciones@cubbo.com
servers:
  - url: https://api.cubbo.com/v1
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Authentication
    description: Exchange client credentials for a bearer token.
  - name: Orders
    description: Create, update, hold, cancel and read sales orders.
  - name: Shipping labels
    description: Read the shipping labels generated for an order.
  - name: Inventory
    description: Products and stock per store.
  - name: Lots
    description: Lot-level inventory for products with expiration or batch tracking.
  - name: Reports
    description: Bulk reports for reconciliation.
  - name: Replenishments
    description: Inbound shipments to the warehouse.
  - name: Returns
    description: Returns and exchanges.
  - name: Stores
    description: Store provisioning and settings.
  - name: Shipping methods
    description: Available shipping methods, coverage and quotes.
  - name: Click and collect
    description: Pickup points and in-store pickup orders.
paths: {}
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Token returned by `POST /auth/token`, sent as `Authorization: Bearer
        <token>`.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.