Fluxos End-to-End
Fluxo de Empreitada (mão de obra)
Diferente de compra de material — tem contrato formal, medições mensais, retenção 5%, aditivos
Diferenças vs compra de material
| Aspecto | Material | Empreitada |
|---|---|---|
| Documento principal | PO | Contrato |
| Recebimento | Físico (almoxarife) | Medição (engenheiro fiscal) |
| Pagamento | À vista ou parcelas predefinidas | Conforme medição × cronograma |
| Retenções | ICMS-ST (responsabilidade vendedor) | INSS, ISS, IRRF, PIS/COFINS/CSLL + retenção técnica |
| Garantia | NF + nota técnica | Caução / seguro / retenção 5% |
| Encerramento | Última entrega | Recebimento provisório → definitivo |
| Aditivos | Aditivo PC | Aditivo formal (regra dos 25%) |
Etapas
1. Criar contrato
→ Doc: Contratos de Empreitada
Suprimentos → Contratos de empreitada → Novo- FormWizard 8 passos
- Default: retenção técnica 5%
2. Aprovação
- Approval
contrato_empreitada - Default: gerente + diretor (sempre 2 níveis)
-
R$ 100k: + jurídico (3 steps)
3. Assinatura
- Após aprovado, status
aprovado - Você passa manualmente para
assinadoquando tiver assinatura física - Anexa PDF assinado
4. Em execução
- Status
em_execucao - Empreiteiro começa a obra
5. Medição mensal (engenheiro fiscal)
- A cada mês (ou ciclo do contrato), empreiteiro apresenta boletim
- Engenheiro fiscal confere em campo (metragem, vão de janela, m² de revestimento)
- No detalhe do contrato → "Nova medição"
- Tipos:
- medicao — execução normal
- glosa — refazimento (valor negativo + justificativa obrigatória)
- recebimento_provisorio — marco
- recebimento_definitivo — marco
- Sistema calcula automaticamente:
- Retenção técnica (5% padrão) — descontada do valor bruto
- Acumulada de retenções no contrato
6. Aprovação da medição
- Approval
medicao_empreiteiro - Default: gerente; diretor se > R$ 100k
- Quando aprovado: callback marca
status='aprovada'
7. Calcular retenções LC 116
- Botão "Retenções" na medição aprovada
- Selecione código LC 116 (ex: 7.02)
- Sistema calcula INSS 11%, ISS, IRRF 1.5%, PIS/COFINS/CSLL 4.65%
- Salva no
retencoes_calculadas
8. Gerar CAP
- Botão "Gerar CAP" — valor líquido (bruto - retenção técnica - retenções tributárias)
9. Pagamento + conciliação
(igual ao fluxo de material)
10. Aditivos (durante execução)
→ Doc: Contratos de Empreitada — Aditivos
- Detalhe do contrato → "Novo aditivo"
- Tipo (prazo / valor / escopo / misto), descrição, deltas
- Approval
aditivo_contrato - Regra dos 25%: soma de aditivos > 25% sobe alçada para diretor automaticamente
- Após aprovado, gerente clica "Aplicar ao contrato" para materializar
11. Recebimento provisório
- Fim da obra física
- Status do contrato:
em_recebimento_provisorio - Inicia prazo de garantia (default 90 dias)
12. Período de garantia
- Status
em_garantia - Defesa contra vícios construtivos
- Retenção técnica continua bloqueada
13. Recebimento definitivo
- Status
recebimento_definitivo - Empreiteiro pode pedir liberação de retenção
14. Liberar retenção (botão)
- Numa medição aprovada → "Liberar retenção"
- Approval
liberacao_retencao(alçada diretor) - Quando aprovado: callback marca
medicao.retencao_liberada=true - Gera CAP da retenção para pagar
15. Encerramento
- Status
encerrado - Soma das retenções liberadas = total da retenção acumulada
- Histórico fica auditável
Score do fornecedor (empreiteiro)
Cada medição aprovada alimenta as métricas:
- Atendimento: % medições aprovadas sem glosa
- Conformidade: contratos sem aditivos > 25%
Influência: próxima vez que esse empreiteiro for cotado para outra obra, score histórico aparece no mapa comparativo.
Custos invisíveis evitados
Sem OctaBuild:
- Retenções esquecidas → passivo trabalhista
- Aditivos descontrolados → contratos inflam 50%+ sem aprovação
- Glosa não rastreada → empreiteiro recebe por refazimento
Com OctaBuild:
- Retenção 5% e tributárias automáticas
- Approval de aditivo > 25% obrigatório
- Glosa formalizada com justificativa em auditoria