Ingest inventory snapshot batch

Validates a batch of absolute inventory positions and publishes them to Kafka for asynchronous processing. Each item overwrites the position (onHand, blocked, safetyStock) for its sku/strategyCode. Returns 202 with a correlation id shared by every published event of the batch.

post/api/v1/inventory

Request body

Example request

{
  "items": [
    {
      "blocked": 5,
      "onHand": 150,
      "safetyStock": 10,
      "sku": "SKU-001",
      "strategyCode": "loja-barra"
    }
  ]
}

Response

Batch accepted and published to Kafka.

acceptednumber required

Number of items accepted and published to Kafka (always equals items.length on 202).

correlation_idstring required

Batch correlation id (UUID) shared by every published event.

update_type'SNAPSHOT' required

Update mode of the accepted batch.

Example response

{
  "accepted": 150,
  "correlation_id": "8f2a3b1c-7d6e-4f5a-9b8c-1d2e3f4a5b6c",
  "update_type": "SNAPSHOT"
}

Changes

Changed in 1 of the 9 revisions of this API.31

Jul 7, 2026a3b4750a505f31See the full diff
- ▲
  added the new required request property items
  new-required-request-property
- ▲
  removed InventorySnapshotIngest InventoryDeltaIngest from the request body oneOf list
  request-body-one-of-removed
- ▲
  the request's body type/format changed from / to object/
  request-body-type-changed
- ○
  removed the DELTA enum value from the update_type response property for the response status 202
  response-property-enum-value-removed
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history