Estoque: atualização de saldo pela API V1

Permissão necessária: inventory.stock.update.

A API dispõe de PUT /api/v1/inventory/stock/products/{product}, PUT /api/v1/inventory/stock/products/by-code/{code} e PUT /api/v1/inventory/stock/bulk.

Atenção: o campo quantity representa o saldo desejado, não uma quantidade a adicionar ou subtrair. O serviço compara o saldo atual com o valor solicitado e registra o ajuste quando necessário.

Exemplo por código

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

PRINCIPAL é um código fictício: substitua por um depósito ativo realmente cadastrado na empresa. É necessário informar exatamente um entre warehouse_id e warehouse_code. Lote e localização são opcionais, mas podem ser necessários conforme o controle do produto.

No endpoint em lote, utilize items com cada produto identificado por product_id ou code. O limite de itens por requisição depende da configuração. Faça testes de sincronização em homologação e evite executar dois processos concorrentes para o mesmo saldo.