// estudo de caso
Plataforma B2B
Plataforma de pedidos para clientes de uma indústria de embalagens, ligando o catálogo digital ao ERP. O objetivo: o cliente faz o pedido sozinho, e ele chega no sistema sem ninguém redigitar.
O problema
Pedido B2B costuma chegar por onde der: WhatsApp, e-mail, telefone, PDF. Alguém do time interno lê, interpreta e digita no ERP. Esse passo humano é onde mora o erro — item trocado, quantidade errada, pedido que ficou esquecido numa conversa.
E não é um problema de preguiça: é de interface. Enquanto o caminho mais fácil pro cliente for mandar mensagem, ele vai mandar mensagem. A plataforma só funciona se for mais conveniente que o WhatsApp.
O que foi construído
- Catálogo digital — o cliente vê o que existe, com a informação que importa pra ele
- Pedido self-service — montado pelo próprio cliente, sem intermediário
- Integração com o Tiny ERP — o pedido nasce já dentro do sistema que a operação usa
Empacotado em Docker, como o resto do ecossistema, para que subir versão não dependa de configuração manual de servidor.
A parte difícil: integrar com sistema que você não controla
Integrar com uma API de terceiro é diferente de escrever o próprio backend. Você herda decisões que não tomou: o formato dos dados, os limites de requisição, o vocabulário do domínio, e o comportamento em caso de erro — que raramente está documentado tão bem quanto o caminho feliz.
Duas coisas que aprendi a tratar como obrigatórias:
- Nunca confiar que a chamada deu certo porque retornou 200. Verificar o efeito, não só a resposta.
- Falhar alto. Integração que falha em silêncio é pior que integração que não existe — porque todo mundo acha que está funcionando.
Essa segunda lição, aliás, eu reaprendi construindo este próprio site: o formulário de contato desta página exibia "mensagem enviada com sucesso" sem enviar nada. Seis semanas. O mesmo erro, em escala menor.