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

> Cubbo sends this event to your replenishment webhook URL when a replenishment (inbound receipt)
is created before any merchandise has arrived, i.e. created in status `WITHOUT_SCHEDULING`,
`PENDING`, `REQUESTED` or `IN_TRANSIT`. Receipts that are born already in the warehouse (reverse
logistics, relocations, transfers) do not produce this event; they only produce
`replenishmentStatus` events on later transitions.

- This feed must be enabled for your integration (opt-in, with its own URL). It does not require
  the order webhook feed.
- `products` lists the expected and received quantities per product; `received_quantity` is 0 at
  this point.
- `sequence` is the timestamp of the transition in epoch milliseconds; order events of the same
  replenishment by it.
- `X-Cubbo-Idempotency-Key` is deterministic (`replenishment:<id>:<status>:<integration>`), so a
  retry carries the same key.




## OpenAPI

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