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

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

supplier_5.png

  • 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

  1. Configuração inicial

    Arquiteto cadastra obra e fornecedores com:

    • Valor total da comissão RT
    • Datas estimadas de pagamento (ajustáveis via calendário)
  2. 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
  3. 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]
  1. Gestão de exceções
  • Pagamentos parciais são automaticamente reconciliados
  • Atrasos disparam reações em cascata:
    1. Notificação ao fornecedor
    2. Alerta interno após 48h
    3. Reagendamento inteligente

O Impacto Mensurável

Simulação Financeira Conservadora

MétricaValor
Obras/mês4
Valor médio/obraR$ 200.000
Comissão RT (10%)R$ 20.000/obra
Perda histórica (20%)R$ 4.000/obra
RecuperaçãoR$ 2.000/obra
Ganho mensalR$ 8.000
Ganho anualR$ 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

  1. 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)
  2. 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