P2P completo (Procure-to-Pay)

Visão de alto nível

ENGENHEIRO        COMPRADOR         APROVADOR        ALMOXARIFE       FINANCEIRO
   │                 │                  │                │                 │
   │ Requisição      │                  │                │                 │
   ├────────────────►│ Cotação (RFQ)    │                │                 │
   │                 ├─Link público─►   │                │                 │
   │                 │  (fornecedor)    │                │                 │
   │                 │ ◄─Proposta────  │                │                 │
   │                 │ ◄─IA extrai───  │                │                 │
   │                 │ Mapa comparativo │                │                 │
   │                 ├─Decidir─────────►│                │                 │
   │                 │                  │ Aprovar        │                 │
   │                 │                  │ → PO criada    │                 │
   │                 │                  │   automatic.   │                 │
   │                 │                  │                │ Recebimento     │
   │                 │                  │                │ 3-way match     │
   │                 │                  │                │ ↓ Estoque       │
   │                 │                  │                ├────────────────►│
   │                 │                  │                │                 │ CAP gerado
   │                 │                  │                │                 │ ↓ Pagamento
   │                 │                  │                │                 │ + extrato OFX
   │                 │                  │                │                 │ → conciliação

Etapas detalhadas

1. Requisição (engenheiro de obra)

→ Doc: Requisição de Compra

• Onde: Suprimentos → Requisições → Nova requisição
• Vincula à tarefa do cronograma e nó da árvore orçamentária
• Adiciona itens (insumos / composições / texto livre com qtd e unidade)
• Submete → vai por aprovação

2. Aprovação da RC (gerente)

→ Doc: Aprovações

• Onde: Painel → Aprovações
• Default: até R$ 10k gerente; até R$ 50k gerente + diretor
• Após aprovado, callback marca RC como aprovada automaticamente

3. Cotação (comprador)

→ Doc: Cotação com IA

• Comprador abre RFQ a partir da RC aprovada
• Convida 3+ fornecedores → cada um recebe link único
• Distribui via WhatsApp + Email com 1 clique
• Fornecedor (sem login) responde em /rfq/[token]: PDF, foto, áudio, Excel ou texto
• Comprador clica "Extrair IA" em cada resposta
• Mapa comparativo se monta: PNL, score, outliers, recomendação IA
• Comprador clica "Decidir vencedor" → justificativa obrigatória → cria approval

4. Aprovação da decisão (diretor)

• Painel → Aprovações
• Quando aprovado: callback cria PO automaticamente com itens dos vencedores
• Cotação vira decidida; RC vira pedido_emitido

5. PO emitido

→ Doc: PO

• Sistema envia PDF + email ao fornecedor
• Aceite formal: fornecedor responde "OK"
• Fornecedor entrega quando estiver pronto

6. Recebimento (almoxarife)

→ Doc: Recebimento

• Caminhão chega na obra
• Almoxarife abre PO → "Receber"
• Step 1: sobe XML da NF (auto-preenche)
• Step 2: confere itens (qtd, preço, fotos de divergência)
• Step 3: preview 3-way match → confirma

Sem divergência

• Status auto_aprovado
• Trigger SQL atualiza PO (entregue_parcial / entregue)
• Entrada automática no estoque (se PO tem almoxarifado_destino_id)
• Trigger atualiza valor_realizado na árvore orçamentária

Com divergência

• Status pendente
• Cria approval recebimento_divergente (alçada gerente; diretor se > 5%)
• Quando aprovado: callback dispara entrada estoque + libera pagamento

7. Geração de CAP (financeiro)

→ Doc: CAP e Retenções

• No histórico de recebimentos → "Gerar CAP"
• Idempotente — não duplica se já gerou
• Suporta parcelamento (30/60/90)
• Verifica CNDs do fornecedor → alerta se vencidas

8. Pagamento (financeiro)

→ Doc: Financeiro

• CAP entra no lote de pagamento do dia
• Se acima da alçada, vai por approval pagamento
• Após aprovado, executa via PIX/TED/boleto
• Se PIX: instantâneo; se TED: D+1; se boleto: liquidação na compensação

9. Conciliação (financeiro)

→ Doc: Conciliação

• Financeiro importa OFX/CSV do banco diariamente
• Sistema sugere matches (CAP com valor ≈ e data ≈)
• 1 clique para casar
• Trigger SQL marca CAP como paga + reconciliation_status

10. Score do fornecedor (automático)

→ Doc: Fornecedores

• Trigger recalcula prazo, qualidade, atendimento, conformidade
• Score consolidado entra na próxima cotação
• Loop fechado: comprou → recebeu → pagou → score atualizado → influencia próxima decisão

Tempos típicos

SLAs configuráveis

Settings → Compras → SLAs:

• SLA aprovação (default 24h úteis) — escala se passar
• Prazo padrão de cotação (default 5 dias)
• Mínimo de fornecedores

Auditoria

Todo evento crítico fica em log imutável (approval_audit_log, recebimento_3way_log, estoque_movimentos). Não há "delete"; apenas estornos / compensações.