Requisições, cotações, coletas de preço e pedidos de compra. Somente consulta: não aprova, não cria nem altera pedido. Cadeia: ORDEM DE MANUTENÇÃO > REQUISIÇÃO (a demanda) > COTAÇÃO (agrupa itens para pesquisar preço) > COLETA DE PREÇO (a resposta de um fornecedor para um item) > PEDIDO (a compra fechada). Um item pode ir da requisição direto ao pedido, sem cotação. Atraso: nunca compare datas. SITUACAO_ENTREGA do pedido já vem pronta ("Recebido", "Atrasado", "Pendente") e DIAS_ATRASO já vem calculado. "Pedidos atrasados": situacao_entrega ["Atrasado"]; "o que falta chegar": ["Atrasado", "Pendente"]. Aprovação é outra coisa e não entra na conta de atraso. Departamento: é o campo "Departamento" das telas de pedido e de requisição. "Pedidos do departamento X": visão pedidos, filtro departamento. Nos pedidos a coluna é DEPARTAMENTO; nas requisições o mesmo dado sai na coluna GRUPO_MANUTENCAO. Quantidades: QUANTIDADE_PENDENTE (requisição) e QUANTIDADE_RESTANTE (pedido) já vêm prontas — nunca subtraia colunas. QUANTIDADE_NOTA_FISCAL é a mesma coisa que a recebida: não some as duas. Item de requisição do tipo "Saída de estoque" não gera compra, sai direto do estoque. Não conte esses itens quando a pergunta for sobre compra, cotação ou pedido. Nome de fornecedor ou produto: filtre por trecho; se vierem nomes diferentes, pergunte qual e siga pelo identificador (id_fornecedor, id_pedido, id_cotacao, id_requisicao). Volume: para a fazenda inteira use "agrupar_por" em vez de listar requisição ou pedido um a um. "Quantas coletas teve o pedido" se responde com QTDE_COLETAS_PRECO da visão pedidos.

Visões disponíveis (parâmetro "visao"):

• pedidos: Uma linha por pedido de compra: fornecedor, departamento, valores, aprovação, recebimento e atraso já resolvidos. Período pela data do pedido. Filtros: situacao_entrega (lista de valores exatos), status (lista de valores exatos), status_aprovacao (lista de valores exatos), departamento, fornecedor, id_fornecedor (valor exato), setor, centro_custo, safra, codigo_pedido, id_pedido (valor exato), codigo_cotacao, id_cotacao (valor exato), aceita período. Agrupa por: departamento, fornecedor, situacao_entrega, status, setor, centro_custo, safra.

• itens_pedido: Uma linha por item de pedido: quantidade pedida, recebida e restante, valor e se a compra foi feita pelo menor preço coletado (COMPROU_MENOR_PRECO). Não aceita período — filtre pelo pedido. Filtros: id_pedido (valor exato), codigo_pedido, status (lista de valores exatos), fornecedor, produto, id_cotacao (valor exato), comprou_menor_preco. Agrupa por: fornecedor, produto, status.

• requisicoes: Uma linha por item de requisição: quem pediu, para qual ordem de manutenção e equipamento, e o que ainda falta atender (QUANTIDADE_PENDENTE). "O que a ordem X ainda espera": id_ordem_manutencao e pendente true. Período pela data da requisição. Filtros: status (lista de valores exatos), situacao_item (lista de valores exatos), tipo_item (lista de valores exatos), prioridade (valor exato), pendente, departamento, produto, equipamento, solicitante, centro_custo, codigo_requisicao, id_requisicao (valor exato), id_ordem_manutencao (valor exato), aceita período. Agrupa por: departamento, status, situacao_item, tipo_item, equipamento, produto, solicitante, centro_custo.

• cotacoes: Uma linha por item de cotação, com o resumo das coletas: quantas houve, quantas foram respondidas, menor, maior e médio preço e o fornecedor mais barato. Período pela data da cotação. Filtros: status (lista de valores exatos), produto, codigo_cotacao, id_cotacao (valor exato), aceita período.

• coletas: Uma linha por coleta de preço (item da cotação x fornecedor): preço, desconto, prazo, se respondeu, em quantos dias e se foi a escolhida. Cresce rápido: para ver os preços de uma cotação, filtre id_cotacao; para comparar fornecedores, use agrupar_por fornecedor. Período pela data de envio ao fornecedor. Filtros: status (lista de valores exatos), fornecedor, id_fornecedor (valor exato), produto, codigo_cotacao, id_cotacao (valor exato), respondida, escolhida, aceita período. Agrupa por: fornecedor, produto, status.

• trilha: Rastreabilidade de UM documento: cada caminho do item, da ordem de manutenção e da requisição até a cotação e o pedido, com o valor rateado. Exige id_pedido, id_cotacao, id_requisicao ou id_ordem_manutencao: sem o documento, liste antes pedidos, cotações ou requisições e pergunte qual. Filtros: id_pedido (valor exato), id_cotacao (valor exato), id_requisicao (valor exato), id_ordem_manutencao (valor exato).

Quando "visao" não é informada, usa "pedidos". Filtro de texto casa por trecho, sem diferenciar maiúsculas nem acento ("aplicacao" acha "Aplicação") — exceto os marcados "(valor exato)", que exigem o valor inteiro, como código, placa e número. A resposta traz "total_disponivel": quantas linhas o filtro encontra ao todo. Chame uma vez só, já com o limite que a resposta vai usar — nunca repita a consulta mudando só o limite; se só o número interessa e o total pode ser grande, um limite baixo basta. Para totais e contagens use "agrupar_por"; a listagem é limitada e serve para ver itens. Com "agrupar_por", a resposta vem somada pelo banco: uma linha por grupo, com QTDE_LINHAS, as somas e os maiores e menores valores (MAIOR_*, MENOR_*). Use isso em vez de somar linhas por conta própria.