Ajuste de estoque

Dúvida: como ajustar o saldo quando a NF e a transferência não se aplicam?

Ambiente: Estoque → Operações → Movimentação → Ajustes (/apps/stock/adjustments). Origem no razão: ADJUSTMENT. Usa-se para requisição, devolução ao armazém e correção de saldo sem NF.

Pré-requisitos: produto e armazém; permissão adjustments. Ajuste negativo exige quantidade e motivo. Ajuste gerado por inventário não deve ser recriado na mão para a mesma contagem (InventoryCount.adjustmentId).

Caminho na tela

1. Novo Ajuste.
2. Cabeçalho:

Campo	Valores	Nota
Motivo	DAMAGE Avaria · LOSS Perda · FOUND Encontrado · COUNT_DIFF Diferença de contagem · CORRECTION Correção · OTHER Outro	obrigatório
Local	armazém	obrigatório
Responsável	funcionário
Observações	texto
Itens	produto, quantidade, tipo Entrada (POSITIVE) ou Saída (NEGATIVE)	ao menos uma linha

3. Salvar → DRAFT. Saldo inalterado.
4. Aprovar na linha (POST /stock-adjustment/approve/:id) → APPROVED e gera FAPOB na mesma transação (rollback se falhar no meio).
5. Cancelar só em rascunho.

Abas: Todos, Rascunho, Aprovados, Cancelados.

O que a aprovação grava

• POSITIVE: movimento E, aumenta saldo, cria/alimenta FIFO conforme o custo informado no serviço.
• NEGATIVE: movimento S, validateSufficientStock (padrão: não deixa negativo). Consome FIFO. Sempre com motivo.
• user_id / user_name de quem aprovou.

Doação rastreável não é ajuste: tela /apps/stock/donations, origem DONATION.

Regras

• Valor acima do limite da filial pode exigir company_admin (configuração da filial).
• Contagem aprovada já cria ajuste: não lance outro COUNT_DIFF manual para o mesmo inventário.
• Estorno: POST /stock/reverse/:movementId — inverte o tipo, aponta reversal_of_id, não reescreve a linha antiga. Só se o saldo atual permitir.

API

GET /stock-adjustment/:filialId · GET .../detail/:id · POST :filialId · PATCH :id · DELETE :id (rascunho) · POST approve/:id · POST cancel/:id

Erros comuns

Sintoma	Causa
Aprovou e estoque não mudou	olhou outro armazém / outra filial
Recusou saída	reserva ativa ou lote RECALLED/quarentena comendo o disponível
Duplicou correção de inventário	ajuste manual + aprovação da contagem

Saiba mais

Inventário · Custo FIFO