Skip to main content
POST

Comportamento

Atualiza a quantidade disponível de cada variante identificada por hunter_variante_id. Loja substitui integralmente pelo valor enviado (não é delta).
Chame este endpoint após cada venda no sistema integrado e em batch a cada 10 minutos para deltas acumulados. Ver Fluxo de estoque.

Payload

array
required
Lista de atualizações. Máx 500 por request.
string
required
Identificador da variante no sistema integrado.
integer
required
Nova quantidade disponível. Inteiro, >= 0.
Não envie o campo estoque_reservado — a loja gerencia (é incrementado no checkout, decrementado no cancelamento). Se enviar, response é HTTP 400 VALIDATION.

Erros específicos

Boas práticas

Não faça 500 chamadas individuais em vez de 1 chamada em lote. Consome rate limit sem necessidade e leva ~50x mais tempo.
  • Agregue deltas de estoque num buffer temporal (10 minutos) e envie tudo junto
  • Após cada venda: envie imediato só o SKU vendido (pra não overselling)
  • Estoque 0 é valor válido (produto zerado, pode ficar visível pra cliente escolher entrar em lista de espera)