Cenário de uma indústria que redigita no ERP os pedidos enviados por representantes em planilhas. Como construímos um portal B2B integrado ao ERP.
Cenário ilustrativo. Composto a partir de problemas comuns do setor e da forma como a Devled trabalha. Não descreve um cliente específico, e os indicadores mostram o que medimos, não resultados alcançados.
O fluxo depois do projetoRegras · integrações · revisão humana
01RepresentantePedido no portal ou no app
02ValidaçãoPreço, estoque e crédito
03AprovaçãoExceções comerciais
04ERPPedido integrado
05ClienteStatus, NF-e e boleto
As etapas, os sistemas e as aprovações são definidos com a sua equipe.
Quanto isso custa na sua operação?
Calcule com os seus números e baixe um relatório em PDF para levar à diretoria.
Indústria de médio porte, de alimentos, cosméticos ou materiais elétricos, com 30 a 150 representantes comerciais autônomos e alguns milhares de clientes revendedores em vários estados. O ERP, muitas vezes o TOTVS Protheus ou o Sankhya, concentra preços, impostos, estoque, crédito e faturamento, mas não é acessível aos representantes. Os pedidos chegam por planilha, e-mail ou foto do talão, e uma equipe interna redigita tudo.
Sinais comuns
Pedidos com preço, desconto ou condição de pagamento fora da política, descobertos só na digitação.
O preço final muda por estado por causa de ICMS-ST e IPI, e o representante passa ao cliente um valor que não fecha com a nota.
O representante vende o que não tem em estoque, e o cliente descobre na entrega.
A equipe interna passa o dia digitando pedidos em vez de atender.
O cliente liga para saber se o pedido foi faturado e quando chega.
Um sistema antigo em Delphi ou Access faz parte do processo, e só uma pessoa sabe mantê-lo.
Pequenas e grandes empresas
O projeto ajustado ao porte da empresa.
O cenário acima descreve uma empresa de médio porte. Em empresas menores ou maiores, o problema se repete, e mudam o escopo, os sistemas e as integrações.
Empresas de menor porte
Indústria ou distribuidora com 5 a 20 representantes e política comercial simples. Uma plataforma B2B pronta, integrada ao ERP, pode resolver a primeira versão. O diagnóstico compara essa opção com o portal sob medida antes de qualquer desenvolvimento.
Empresas de maior porte
Indústria com centenas de representantes, várias marcas e tabelas por canal. Entram integração com Protheus ou SAP por API, alçadas de aprovação, app offline, regras fiscais por UF, login corporativo (SSO) e ambientes de homologação.
Como resolvemos
Do problema à rotina em uso.
Cada etapa tem responsável, critério de aceite e validação da sua equipe antes de avançar.
01
Entender a política comercial
Mapeamos tabelas de preço por região, descontos por cliente e por volume, condições de pagamento como boleto em 28, 56 e 84 dias, pedido mínimo, frete CIF ou FOB, alçadas de aprovação e o que o ERP já valida. O portal usa as regras do ERP sempre que possível.
02
Portal e app para quem vende
O representante consulta clientes, estoque e o preço final com impostos, calculado pelo ERP para a UF do cliente, e monta o pedido no celular, mesmo sem sinal. Pedidos fora da política seguem para aprovação do gestor, com o motivo.
03
Integrar com o ERP
Clientes, produtos, preços e estoque são sincronizados a partir do ERP. Pedidos aprovados entram por API, com retorno do número e do status. Nada é redigitado.
04
Autoatendimento para o cliente
O cliente revendedor acompanha pedidos, baixa NF-e e boleto e repete compras anteriores, com o próprio login.
05
Substituir o legado aos poucos
Se houver um sistema antigo no meio do processo, migramos uma função por vez, com os dois funcionando em paralelo até a validação.
Stack típica
O que já existe e o que construímos.
São as opções mais comuns neste cenário. A escolha final depende do ambiente, das licenças e da equipe da sua empresa.
Sistemas que normalmente já existem
ERP (TOTVS Protheus, Sankhya, SAP Business One ou similar)
Planilhas de pedido e de tabela de preço
Sistema legado em Delphi, VB ou Access
E-mail e WhatsApp dos representantes
Aplicação
Next.js e React para o portal
React Native para o app do representante, com modo offline
API em Node.js (NestJS) e TypeScript
PostgreSQL
Integração com o ERP
APIs REST do ERP (Protheus, Sankhya) ou serviços customizados
Sincronização incremental de preços e estoque
Fila de pedidos com reprocessamento
Conciliação diária entre portal e ERP
Consulta de crédito em bureau, como Serasa ou Boa Vista, quando a política exigir
Infraestrutura e qualidade
AWS ou Azure, com ambientes separados
CI/CD com testes automatizados
Perfis de representante, gestor e cliente
Monitoramento e alertas
Cuidados do projeto
O que pode dar errado e como evitamos.
Riscos que tratamos desde o diagnóstico, antes de construir.
O ERP é a fonte da verdade
Preço, impostos, crédito e estoque vêm do ERP. ICMS-ST, IPI e, a partir de 2027, CBS e IBS são calculados lá, e o portal não cria regras paralelas que divergem com o tempo ou com a Reforma Tributária.
Customizações no ERP
Algumas integrações exigem serviços no próprio ERP. Combinamos com o time ou a consultoria do ERP quem desenvolve e quem mantém.
Adoção pelos representantes
Se o portal for mais lento que a planilha, eles voltam para a planilha. Testamos com representantes reais desde as primeiras versões.
Propriedade do código
Código, infraestrutura e documentação ficam em contas da empresa, para que o produto possa ser mantido pela Devled ou por outro time.
Como medimos
Indicadores combinados antes do piloto.
Os números de partida são medidos no diagnóstico. As metas são combinadas com a sua equipe antes de começar.
Pedidos redigitados
Percentual que ainda passa por digitação manual.
Tempo do pedido ao faturamento
Do envio pelo representante à emissão da NF-e.
Pedidos fora da política
Preço, desconto ou condição corrigidos depois do envio.
Adoção
Representantes e clientes ativos no portal por mês.
Ligações sobre status
Contatos com o atendimento para perguntar sobre pedidos.
Plano de entrega
Do diagnóstico à operação.
Semanas 1 e 2
Diagnóstico
Política comercial, fluxo do pedido, interfaces do ERP, legado e escopo da primeira versão.
Semanas 3 a 10
Primeira versão
Pedido do representante com validação e integração com o ERP, para uma regional.
Semanas 11 a 16
Ampliação
Demais regionais, app offline, aprovações e portal do cliente.
Depois
Evolução contínua
Novas funções e substituição gradual do legado, por projeto ou com um time dedicado.
Prazos indicativos para um cenário como este. O plano do seu projeto, com escopo, investimento e prazo, sai do diagnóstico.
Como começamos
Comece por um diagnóstico.
Mapeamos a política comercial, o caminho do pedido e as interfaces do ERP. Você recebe o escopo da primeira versão, a recomendação técnica, o investimento e o prazo.
01
Conversa de 30 minutos
Sem custo. Entendemos o contexto, os sistemas e o resultado esperado, e indicamos o próximo passo.
02
Diagnóstico em 1 semana
Mapeamos o processo, as integrações e as prioridades da primeira entrega.
03
Plano e proposta
Escopo priorizado da primeira entrega, recomendação técnica, riscos, investimento e prazo. O plano é seu, para executar com a Devled ou com o seu time.
Plataformas prontas atendem bem catálogos e pedidos simples. Quando a política comercial tem muitas exceções ou o ERP é muito customizado, um portal sob medida pode sair mais barato de manter. O diagnóstico compara as duas opções.
Quem é dono do sistema no final?
A empresa. Código, documentação e infraestrutura ficam em contas dela desde o início.
Vocês mexem no Protheus?
Quando a integração exige, desenvolvemos ou especificamos os serviços no ERP junto com o time ou a consultoria responsável.
O portal precisa mudar com a Reforma Tributária?
Pouco, se os impostos vierem do ERP. Quando o ERP passar a calcular CBS e IBS, o portal mostra os novos valores sem mudar as próprias regras. Ajustes de tela, como mostrar cada imposto no pedido, entram no plano de evolução.