DesenvolvedoresAPI HTTP
API POST /api/integrations/v1/price-lists/:priceListId/prices
Referência HTTP /api/integrations/v1/price-lists/:priceListId/prices
Endpoint
/api/integrations/v1/price-lists/:priceListId/prices
Implementação: apps/cms/src/app/api/integrations/v1/price-lists/[priceListId]/prices/route.ts
Métodos
- POST
Autenticação
Bearer kmx_live_… com escopo prices:write (ERP) ou conforme rota.
Corpo de exemplo (ERP)
{
"items": [
{
"sku": "ARROZ-5KG",
"priceCents": 2599,
"offerPriceCents": 2199,
"offerStartsAt": "2026-11-10T08:00:00-03:00",
"offerEndsAt": "2026-11-17T23:59:59-03:00"
}
]
}Respostas comuns
| HTTP | Significado |
|---|---|
| 200 | updated, unchanged, unknownSkus |
| 401 | Token ausente ou escopo incorreto |
| 404 | Lista não encontrada na organização |
| 422 | Validação (centavos não inteiros, data ISO inválida, etc.) |
| 429 | Rate limit integrationPrices (120/min) |
Fluxo no produto
Rotas /api/dashboard/* alimentam o painel. Rotas /api/player/* são usadas pelos players. Rotas /api/integrations/* e /api/mcp/* usam tokens kmx_live_….
Erros
Leia as mensagens error no JSON de resposta. Para 429, aguarde Retry-After (segundos).