v9

latestOpenAPI 3.0.0raw.githubusercontent.com2026-07-071292691.1 MB

inventory

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"
}