Pedido de Compra (PO)
Documento contratual gerado automaticamente após aprovação da cotação
Quando o PO é criado
Em 3 caminhos possíveis:
1. Automático após aprovação da cotação (caminho principal)
Quando a cotacao_decisao é aprovada pelo diretor, o engine de aprovação dispara um callback que:
- Cria 1 PO por fornecedor vencedor
- Cada PO recebe os itens atribuídos àquele fornecedor (suporta vencedor misto)
- Status inicial:
emitido - Atualiza requisição para
pedido_emitido
2. Direto sem RC (contrato-mestre)
Para fornecedores recorrentes com contrato-mestre vigente (ex: concreto usinado, aço), o comprador pode emitir PO direto sem passar por RC/cotação. Vai pela alçada de pedido_compra (gerente para valores > R$ 1k).
3. Manual via UI
Suprimentos → tab Pedidos → "Novo pedido" — para casos especiais.
Conteúdo do PO
| Seção | Conteúdo |
|---|---|
| Cabeçalho | Empreendimento, fornecedor, comprador, data emissão, condição pagamento, local entrega |
| Itens | Insumo, qtd, preço unitário, valor total, BDI (se serviço), nó orçamentário |
| Tributos previstos | Retenções calculadas pelo tipo de operação (referência) |
| Frete | CIF (fornecedor) ou FOB (comprador), valor |
| Cláusulas | Texto livre |
| Anexos | Proposta vencedora, mapa comparativo aprovado, RC original |
Campos críticos
almoxarifado_destino_id
Se preenchido, dispara entrada automática no estoque quando o recebimento for aprovado.
Pode ser configurado:
- Manualmente no PO
- Default por empreendimento (se você opera com almoxarifado central)
Confirmação do fornecedor
Após emissão, sistema envia PO em PDF para o fornecedor. Aceite formal: fornecedor responde "OK" via portal ou email anexado ao PO. Sem aceite, status fica aguardando_confirmacao.
Estados
emitido → aguardando_confirmacao → confirmado → em_producao → em_transito
→ entregue_parcial → entregue → faturado → pago → encerrado
↓
em_disputa (3-way fail)
↓
resolvido / canceladoAlteração de PO
Aumento de quantidade > 10% OU prazo > 15 dias requer aditivo de PC com nova aprovação de alçada. Toda alteração versiona o PO (v1, v2, v3) com diff visível.
Cancelamento
Cancelamento exige aceite do fornecedor (multa contratual se aplicável).
Reserva orçamentária
Emissão do PC converte o compromisso parcial da RC em compromisso total no nó orçamentário. Se valor do PC > valor estimado da RC, o excesso passa pela política de alteracao_orcamento antes da emissão.
Próximo passo
Após PO emitido, fornecedor entrega → almoxarife recebe:
Permissões
| Permissão | Escopo | Default |
|---|---|---|
compras_pedido:read | project | Todos exceto comercial |
compras_pedido:write | project | gerente |
compras_pedido:delete | project | diretor |