Supplier Collector: Resolvendo a Crise das Comissões Perdidas na Arquitetura

O Problema Invisível que Drena Receitas
No universo da arquitetura, existe uma perda silenciosa: as comissões RT (Reserva Técnica) não cobradas. Durante anos, arquitetos conviveram com este desafio:
- Variabilidade imprevisível: As comissões dependem do fluxo de pagamento do cliente, que segue padrões caóticos (35%-15%-50% é comum)
- Gestão manual inviável: Um arquiteto com 5 obras ativas e 20 fornecedores precisa monitorar manualmente dezenas de datas e porcentagens
- Consequências financeiras: Vamos estimar que só 20% das comissões se perdem por esquecimento, representando em média R$4k por obra não recuperados
A Engenharia por Trás da Solução
Núcleo Técnico: Três Pilares Interconectados
1. Sistema de Monitoramento Adaptativo
- Webhook Asaas: Captura pagamentos do cliente em tempo real
- Banco de estado: Firebase RT armazena o estado atual de cada obra
- Lógica de faseamento: Determina automaticamente a próxima data de cobrança baseado no cronograma da obra
2. Motor de Notificações Inteligentes
- CronJob diário: Varre o banco de dados às 8AM buscando cobranças do dia
- Evolution API: Envio de mensagens WhatsApp com:
- Detalhes da comissão (% aplicado, valor devido)
- Link de pagamento gerado dinamicamente
- Histórico de interações
- Fallback estratégico: Após 48h sem resposta, notificação interna para o escritório
3. Arquitetura Anti-Frágil
Frontend (Next.js)
↓
API Gateway (Fastify)
↓
Microserviços:
↗ Notificações → Evolution API
↗ Pagamentos → Asaas API
↗ Monitoramento → Firebase Listeners
- Isolamento de falhas: Um módulo pode cair sem afetar os demais
- Fila de retentativas: Mensagens não entregues são reagendadas automaticamente
- Logging estruturado: Todos os eventos são auditáveis no Firebase
Como Transformamos Caos em Controle
Fluxo Operacional Simplificado
-
Configuração inicial
Arquiteto cadastra obra e fornecedores com:
- Valor total da comissão RT
- Datas estimadas de pagamento (ajustáveis via calendário)
-
Monitoramento automático
O sistema:
- Detecta pagamentos do cliente via Asaas API
- Recalcula comissões em tempo real
- Atualiza as datas no calendário visual
-
Ciclo de notificações
graph TD A[CronJob diário] --> B{Existe cobrança hoje?} B -->|Sim| C[Envia WhatsApp] B -->|Não| D[Próxima verificação] C --> E{Confirmado?} E -->|Sim| F[Marca como cobrado] E -->|Não| G[Reagenda em 48h]
- Gestão de exceções
- Pagamentos parciais são automaticamente reconciliados
- Atrasos disparam reações em cascata:
- Notificação ao fornecedor
- Alerta interno após 48h
- Reagendamento inteligente
O Impacto Mensurável
Simulação Financeira Conservadora
Métrica | Valor |
---|---|
Obras/mês | 4 |
Valor médio/obra | R$ 200.000 |
Comissão RT (10%) | R$ 20.000/obra |
Perda histórica (20%) | R$ 4.000/obra |
Recuperação | R$ 2.000/obra |
Ganho mensal | R$ 8.000 |
Ganho anual | R$ 96.000 |
Benefícios Intangíveis
- Redução de 70% no tempo gasto com cobranças
- Relacionamento comercial mais transparente
- Previsibilidade financeira para o escritório
Lições Técnicas Aprendidas
-
A arte da flexibilidade calculada
Abordagem híbrida que combina:
- Automação onde possível (cálculos, notificações)
- Intervenção humana onde necessário (validações estratégicas)
-
Evolução de stack em produção
Migração de Twilio para Evolution API nos ensinou:
- Custo de oportunidade de manter soluções subótimas
- Importância de APIs com suporte a cenários complexos
- Valor de números dedicados para operações comerciais
Para Onde Vamos
O Supplier Collector representa mais que uma ferramenta - é uma nova abordagem para gestão financeira criativa:
Próximas fronteiras técnicas:
- Integração com softwares de gestão de obras (Trello, Asana)
- Painéis preditivos usando histórico de pagamentos
- Versão mobile offline para visitas a obras
Convite à ação:
Se você enfrenta desafios similares com:
- Cobranças baseadas em eventos variáveis
- Sistemas financeiros fragmentados
- Comunicação comercial ineficiente
Vamos conversar:
Desenvolvemos soluções sob medida para problemas complexos de gestão.
"Automatizar não é eliminar o humano, é libertá-lo para o que realmente importa" - Filosofia do projeto