Módulo de Compras e Pedidos
Visão Geral
O Módulo de Compras será um módulo novo e completo do Sistema Rabi. Hoje o sistema não possui um fluxo formal de compras — a clínica controla reposição de produtos manualmente. Com este módulo, todo o ciclo de compra passa a ser registrado e controlado dentro do Rabi: desde a previsão automática do que precisa ser comprado, passando pelo pedido ao fornecedor, cotação de preços, aprovação por níveis de alçada, até o recebimento da mercadoria com atualização automática do estoque e do financeiro.
O objetivo é dar à clínica controle total sobre o que compra, de quem compra, por quanto e quando, evitando falta de produtos essenciais e compras feitas sem critério.
Previsão Automática de Necessidade de Compra
O sistema terá uma engine de previsão que analisa automaticamente três fontes de dados para indicar o que precisa ser reposto:
- Mapa de estoque atual — quanto há disponível de cada produto hoje.
- Consumo histórico — a média de saída de cada produto ao longo do tempo (ritmo de consumo da clínica).
- Lead time do fornecedor — quantos dias o fornecedor leva para entregar após o pedido.
Com base nesses dados, a engine gera uma lista de produtos a repor, contendo, para cada item:
- Quantidade sugerida de compra (calculada para não faltar nem sobrar).
- Data limite para fazer o pedido, considerando o lead time, de modo que a mercadoria chegue antes do estoque acabar.
O orçamentista pode usar essa lista como ponto de partida para gerar pedidos de compra automaticamente.
Pedidos de Compra
O pedido de compra pode ser criado de duas formas:
- Manualmente — o usuário monta o pedido do zero, escolhendo produtos e quantidades.
- A partir da previsão — o sistema gera o pedido já preenchido com os itens e quantidades sugeridos pela engine de previsão.
Um pedido de compra pode conter múltiplos itens e, para cada um, o sistema sugere o fornecedor preferencial com base no histórico de compras.
Status do Pedido
O pedido percorre o seguinte fluxo de status:
| Status | Significado |
|---|---|
| Rascunho | Pedido em criação, ainda não enviado para cotação ou aprovação. |
| Cotação | Em processo de cotação junto aos fornecedores. |
| Aprovado | Pedido aprovado conforme a alçada hierárquica. |
| Enviado | Pedido enviado ao fornecedor vencedor. |
| Recebido | Mercadoria recebida e conferida; estoque e financeiro atualizados. |
Cotações de Fornecedores
Antes de fechar um pedido, o sistema permite solicitar cotação de múltiplos fornecedores para cada item. Os retornos são exibidos em uma comparação lado a lado, considerando:
- Preço por item.
- Prazo de entrega.
- Condição de pagamento.
A escolha do fornecedor vencedor pode ser feita de duas formas:
- Automática — o sistema seleciona o melhor fornecedor segundo o critério configurado.
- Manual — o usuário escolhe o vencedor mesmo que não seja o de menor preço (ex: prefere prazo melhor ou fornecedor de confiança).
Aprovação Hierárquica (4 Níveis de Alçada)
Os pedidos passam por aprovação conforme o valor envolvido, em quatro níveis de alçada:
| Faixa | Aprovador responsável |
|---|---|
| Pequenos | Orçamentista |
| Médios | Coordenador |
| Grandes | Gerente |
| Críticos | Diretor |
Os limites de cada faixa serão configuráveis em Parâmetros → Compras → Alçadas, permitindo que cada clínica defina seus próprios valores de corte conforme o seu porte e política interna.
Recebimento
O recebimento será vinculado à importação da NF-e do fornecedor (issue #391). Ao receber a mercadoria:
- O sistema confere o que foi recebido versus o que foi pedido, apontando divergências.
- Atualiza o estoque com as quantidades efetivamente recebidas.
- Gera os lançamentos em contas a pagar no módulo Financeiro.
- Atualiza o status do pedido para "Recebido".
Veja os detalhes da leitura do XML da nota em Integrações — Notas Fiscais (NF-e e NFS-e).
Rota
O módulo ficará sob o caminho /portal/compras/* (estrutura final das sub-rotas a definir durante o desenvolvimento).
Roadmap
O módulo é um épico de 55 pontos, planejado para as Sprints 25–32. O épico #393 será quebrado nas seguintes sub-issues de entrega:
- Previsão — engine de previsão automática de necessidade de compra.
- Pedido — criação e gestão de pedidos de compra com múltiplos itens.
- Cotação — solicitação e comparação de cotações de fornecedores.
- Aprovação — fluxo de aprovação hierárquica em 4 níveis de alçada.
- Recebimento — recebimento vinculado à NF-e, com atualização de estoque e financeiro.
Fluxo detalhado (jul/2026) 🟠 planejado
- Origem — itens faltantes: a partir do estoque mínimo/reposição, o sistema sugere e gera o pedido (itens e quantidade sugerida), com curva ABC.
- Cotação: comparação de vários fornecedores (preço/prazo/condição) antes de aprovar.
- Aprovação por alçada: pedido vai para aprovação de nível 2 ou 3 conforme o valor; sem aprovação, não avança.
- Recebimento: dá entrada no Estoque por produto, lote e validade, e gera contas a pagar no Financeiro.
- Trava de recebimento: só permite receber o que está no pedido; receber diferente (item/quantidade/preço) exige autorização de nível 2.
- Conferência de 3 vias: Pedido × Recebimento × Nota Fiscal — divergência bloqueia e exige autorização.
- Documentos: boleto e nota fiscal carregados no sistema (sem exclusão); boleto vira conta a pagar automaticamente.
- Importar XML de NF-e do fornecedor: entrada no estoque com casamento ao pedido.
Status do pedido: rascunho → aprovação → aprovado → enviado → recebido parcial → recebido total → concluído/cancelado. Recebimento parcial com conferência. Auditoria de todo o ciclo.