> ## 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.

# Replenishment status changed

> Cubbo sends this event to your replenishment webhook URL when a replenishment transitions to
`PROCESSING` (merchandise received and being counted), `IN_PUTAWAY` (units being stored),
`COMPLETED` (receipt closed) or `CANCELED`. Other statuses (`RECEIVED` at dock arrival, the
pre-arrival statuses) do not produce this event.

- `products` carries, per product, the expected quantity and the quantity received so far;
  `supplier_invoices` carries the supplier invoice numbers captured at reception. Both are omitted
  when `status` is `CANCELED`.
- `sell_ahead` is `true` for presale replenishments whose stock could be sold before arrival.
- `sequence` is the timestamp of the transition in epoch milliseconds; retries keep it.
- `X-Cubbo-Idempotency-Key` is deterministic (`replenishment:<id>:<status>:<integration>`).




## OpenAPI

````yaml /openapi.yaml webhook replenishmentStatus
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.