Listar solicitações de materiais
Lista solicitações de material (Page=1 e PageSize=50 por padrão; total em `totalRows` em cada linha). Status: lista CSV (ex.: 1,3), 0 = todos. Período máximo de 12 meses. Somente leitura.
Criar solicitação de materiais
Cria uma solicitação de material em status 1 (Aguardando confirmação), com `itens` (`materialId`, `quantidade`) e, opcionalmente, `anomaliaIds`. `siteId` e `solicitanteId` vão no corpo (não vêm do token) e os itens não são validados a fundo: confira materiais e quantidades antes. Dispara e-mail de aviso por item. Exija confirmação humana antes de executar a partir de um agente autônomo.
Excluir solicitação de materiais
Exclui a solicitação com seus itens e andamentos — só enquanto está em status 1 (Aguardando confirmação). Se ela veio de uma correção, a correção passa para 'Solicitação negada'. Irreversível. Exija confirmação humana antes de executar a partir de um agente autônomo.
Listar itens da solicitação
Lista os itens de uma solicitação: quantidade, estoque atual/mínimo/máximo, status de compra e quantidade entregue. Só aparecem itens cujo material está cadastrado no almoxarifado da solicitação. Somente leitura.
Adicionar item à solicitação
Adiciona um item (`materialId`, `quantidade` > 0) a uma solicitação em status 1. `destinacaoTipo`: 1 = Área, 2 = Equipamento (exige `destinacaoId`). Retorna `itemId` e `compraAutomaticaSugerida`. Dispara e-mail de aviso. Exija confirmação humana antes de executar a partir de um agente autônomo.
Excluir item da solicitação
Remove um item de uma solicitação em status 1 e sem ordem de compra vinculada. Irreversível. Exija confirmação humana antes de executar a partir de um agente autônomo.
Consultar histórico da solicitação
Histórico de andamentos (status) da solicitação, em ordem cronológica, paginado (Page=1, PageSize=50). Somente leitura.
Registrar andamento da solicitação
Registra um novo status (andamento) na solicitação. Status 2 (Aguardando compra) e 9 (Compra realizada) são gerados pela compra: não envie. Transições: 1→10 ou 6; 10→3; 9→3; 3→4 ou 5; 4→4, 5, 7 ou 8; 5→7 ou 8; 7→8; 6, 8 e 11 são finais. Status 4 e 5 exigem `itens` (`materialId`, `quantidadeEntregue`) e DEBITAM o estoque; 3, 4/5 e 6 também movem o status da correção de origem e enviam notificação. Não há estorno. Exija confirmação humana antes de executar a partir de um agente autônomo.
Listar solicitações por ocorrência
Lista as ocorrências que podem ser vinculadas a solicitações de um almoxarifado (almoxarifadoId obrigatório); com solicitacaoId, exclui as já vinculadas. Somente leitura.
Listar ocorrências da solicitação
Lista as ocorrências já vinculadas a uma solicitação. Somente leitura.
Vincular ocorrência à solicitação
Vincula ocorrências (`anomaliaIds`) a uma solicitação. Ids de outra empresa ou já vinculados são ignorados sem erro (confira `data`, a quantidade inserida). O vínculo não move o status de nenhuma correção. Grava dados. Exija confirmação humana antes de executar a partir de um agente autônomo.