Atualização de estoque

Permissão: inventory.stock.update

Atualizar estoque pelo código

curl -X PUT 'https://audacia.com.br/api/v1/inventory/stock/products/by-code/EXEMPLO-001' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  --data '{"warehouse_code":"PRINCIPAL","quantity":12}'

O código do depósito é apenas ilustrativo; ele precisa existir e estar ativo na empresa da integração. Também é possível usar warehouse_id em vez de warehouse_code, nunca ambos.

quantity é obrigatório e deve ser numérico, maior ou igual a zero. Para itens controlados por localização ou lote existem campos adicionais, conforme configuração da empresa.

Atualizar em lote

PUT /api/v1/inventory/stock/bulk

{
  "warehouse_code": "PRINCIPAL",
  "items": [
    { "code": "EXEMPLO-001", "quantity": 12 },
    { "code": "EXEMPLO-002", "quantity": 3 }
  ]
}

O máximo de itens por lote é configurável na instalação. Antes de enviar saldos de vários produtos, valide os códigos, o depósito e o tipo de controle de estoque.