Listar entradas de materiais
Lista as entradas de material (Page=1, PageSize=50; total em `totalRows`). O filtro de datas usa a data da COMPRA, não a da entrada. Para saldo pendente, use GET /v1/entradas-materiais/compras. Somente leitura.
Criar entrada de materiais
Registra a entrada de material de uma compra (`ordemCompra` = ID da compra, `responsavelId`, `data`, `itens`). SOMA a quantidade ao estoque do almoxarifado; quando todos os itens da compra chegam a saldo zero, as solicitações vinculadas passam para 'Aguardando retirada'. Recusa material repetido no lote e quantidade acima do saldo da compra; uma entrada recusada por saldo pode deixar um cabeçalho sem itens, então valide o saldo antes. Exija confirmação humana antes de executar a partir de um agente autônomo.
Listar compras para entrada
Lista as compras com saldo pendente de recebimento (quantidade comprada − já recebida > 0). Consulte antes de criar uma entrada. Somente leitura.
Listar itens da entrada
Lista os itens de uma entrada (material, quantidade, valor unitário). Somente leitura.
Adicionar item à entrada
Adiciona um item (`materialId`, `quantidade` > 0) a uma entrada existente. SOMA ao estoque; limitado ao saldo da compra. Exija confirmação humana antes de executar a partir de um agente autônomo.
Atualizar itens da entrada
Altera vários itens da entrada de uma vez; tudo é validado antes de gravar e o estoque é ajustado pela diferença. Exija confirmação humana antes de executar a partir de um agente autônomo.
Adicionar itens em lote
Adiciona vários itens a uma entrada (mínimo 1; sem material repetido no lote). SOMA ao estoque; limitado ao saldo da compra. Exija confirmação humana antes de executar a partir de um agente autônomo.
Atualizar item da entrada
Altera quantidade e valor de um item da entrada; o estoque é ajustado pela diferença. Recusa reduções que deixariam o estoque negativo. Exija confirmação humana antes de executar a partir de um agente autônomo.
Excluir item da entrada
Remove um item da entrada e DEBITA a quantidade do estoque. Recusa se o saldo ficaria negativo. Irreversível. Exija confirmação humana antes de executar a partir de um agente autônomo.
Excluir entrada de materiais
Exclui a entrada e DEBITA o estoque de todos os itens. Qualquer recusa (inclusive saldo negativo) responde 404 com o motivo em `message`. Não reverte andamentos de solicitação já avançados. Irreversível. Exija confirmação humana antes de executar a partir de um agente autônomo.