Publicar preços
POST /v1/batch/Pricing
[
{
"skuExternalReference": "114970",
"externalReference": "PRECO-114970-VAREJO",
"commercialPolicyId": "9c1f5a3e-7b2d-4c8e-9f01-2a3b4c5d6e7f",
"listPrice": { "value": 10.49 },
"basePrice": { "value": 8.99 }
},
{
"skuExternalReference": "114970-CS",
"externalReference": "PRECO-114970CS-VAREJO",
"commercialPolicyId": "9c1f5a3e-7b2d-4c8e-9f01-2a3b4c5d6e7f",
"basePrice": { "value": 96.9 }
}
]| Campo | Obrigatório | Observação |
|---|---|---|
skuExternalReference | sim | o SKU precisa já existir no catálogo |
externalReference | sim | identificador do registro de preço no seu ERP |
commercialPolicyId | sim | GUID da política comercial |
listPrice / basePrice / fixedPrice | ao menos um | cada um com value e janela opcional |
A resposta traz o operationId; o resultado real chega nos eventos
SKUPricing_Created / SKUPricing_Updated — ou nos respectivos *_Failed.
Remover preço
curl -X DELETE $GROCERS_API/v1/batch/Pricing \
-H "Authorization: Basic $BASIC" \
-H "x-contractAccountId: $TENANT" \
-H "Content-Type: application/json" \
-d '[{"skuExternalReference":"114970","commercialPolicyId":"9c1f5a3e-7b2d-4c8e-9f01-2a3b4c5d6e7f"}]'Note que a remoção identifica o registro por SKU + política, não pelo
externalReference do preço.
Remover o preço torna o item não vendável imediatamente, mesmo com estoque. Para suspender vendas mantendo o preço configurado, prefira zerar o estoque.
Estratégia de atualização
Diária
Carga completa de preços uma vez ao dia, de madrugada. Simples e suficiente para operações com preço estável. Lote de 500 a 1.000 itens por requisição.