Catálogo

Estoque

Estado absoluto, não incremento — por que isso torna a chamada segura de repetir.

Todas as páginas▾

Comece aqui

Catálogo

Vendas

Inteligência artificial

Servidor MCP

Parceiros

Referência

PUT/v1/products/{id}/stockDefine a quantidade absoluta de um depósito.

curl -X PUT https://api.zankhapi.com.br/v1/products/PRODUTO_ID/stock \
  -H "Authorization: Bearer zk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "quantity": 12, "locationName": "default" }'

A rota define o estado, não soma nem subtrai. Isso é o que a torna segura de repetir: um timeout de rede no meio da sua sincronização não vira estoque dobrado, porque a segunda chamada chega ao mesmo número que a primeira pretendia.

Depósitos

locationName escolhe o depósito. Os depósitos são cadastrados no painel (nome + endereço); omitir o campo usa o padrão da loja. O estoque vendável de um produto é a soma dos depósitos — então enviar 0 para um depósito não zera o produto se outro ainda tiver peça.