price-lists
Bulk upsert items
Validates a batch of price list items and publishes one Kafka event per item. The endpoint is agnostic — clients integrate over HTTP and the OMS translates each item into a PRICE_LIST_ITEM_UPSERTED event on oms.{accountCode}.price-list-items.ingestion.
post/api/v1/price-lists/{id}/items
Path parameters
idstring uuid required
Example:01920000-0000-7000-8000-000000000000
Price list identifier (UUID).
Request body
Example request
{
"items": [
{
"sku": "SHAMPOO_X",
"salePrice": 1290,
"costPrice": 800,
"listPrice": 1500,
"startDate": "2026-05-15T00:00:00.000Z",
"metadata": {
"source": "boletim_2026_05"
}
}
]
}Response
Batch accepted and published to Kafka.
Example response
{
"accepted": 1000,
"correlation_id": "8f2a3b1c-7d6e-4f5a-9b8c-1d2e3f4a5b6c"
}