Integrações e APIs 11 min de leitura
Como criar uma API para parceiros e clientes integrarem
Quando abrir uma API para parceiros, como versionar sem quebrar quem já integrou, autenticar, limitar uso e documentar para o outro lado integrar sozinho.
Sistema sob medida para distribuidoras e atacadistas
Distribuidora vive de política comercial: preço por cliente, região e canal, bonificação, verba de fornecedor, prazo e crédito. Quando isso não cabe no ERP, a regra vai para a cabeça do vendedor e a margem some no desconto. Desenvolvemos portais, apps de vendas e módulos de gestão que aplicam a política comercial do mesmo jeito em todos os canais, integrados ao ERP que emite a nota.
Solicitar diagnóstico gratuitoDores que resolvemos
- Vendedor que dá desconto fora da política porque o app não mostra margem nem alçada.
- Preço no pedido que não bate com o faturado, porque cada canal consulta uma tabela diferente.
- Verba e bonificação de fornecedor controladas em planilha, sem conciliação com o que foi vendido.
- Produto vencendo no estoque enquanto o lote mais novo sai primeiro.
- Cliente que só consegue pedir pelo vendedor ou pelo telefone, em horário comercial.
- Bloqueio de crédito descoberto depois do pedido separado, com o caminhão esperando.
- Rota de entrega montada à mão, sem considerar a janela de recebimento de cada cliente.
Módulos pensados para o setor
O escopo final sai do diagnóstico da sua operação.
Motor de política comercial
Preço por cliente, região, canal e volume, descontos com alçada, bonificação e campanhas com vigência, aplicados igual no app, no portal e no televendas.
Força de vendas offline
Catálogo, carteira, histórico do cliente, estoque disponível e sugestão de pedido no celular do vendedor, funcionando sem sinal.
Portal de pedidos B2B
O cliente faz pedido, consulta títulos, baixa boleto e segunda via de nota a qualquer hora, com o mesmo preço que o vendedor veria.
Verbas e acordos com fornecedores
Rebate, verba de sell-out, bonificação e ações de trade registradas por acordo, com apuração a partir das vendas efetivas e cobrança do fornecedor.
Lote, validade e FEFO
Separação guiada pelo vencimento mais próximo, bloqueio de lote e alerta de produto perto do vencimento para ação comercial.
Crédito e liberação de pedidos
Limite, títulos em aberto e consulta a bureau antes da separação, com fila de liberação por alçada.
Roteirização e entrega
Montagem de carga por rota e janela de recebimento, com app de entrega e comprovante digital.
Integrações comuns no setor
- ERPs como TOTVS, Sankhya e SAP Business One
- SEFAZ NF-e
- Bureaus de crédito
- EDI e portais de indústrias fornecedoras
- Roteirizadores
- Bancos, boleto e Pix
- Marketplaces B2B
- WhatsApp Business Platform
Regras e obrigações que o sistema respeita
- A substituição tributária do ICMS varia por estado, NCM e acordo interestadual, e muda o preço final e a margem de cada item. O cálculo fiscal deve ficar no ERP ou no motor tributário, com o sistema comercial consultando o resultado.
- Alimentos, medicamentos, cosméticos, produtos veterinários e defensivos têm exigências próprias de licença, armazenagem e rastreio de lote, definidas por Anvisa, MAPA e órgãos estaduais.
- A reforma tributária do consumo, em transição a partir de 2026, muda a forma de calcular tributos na nota e tende a mexer na formação de preço.
- Consulta de crédito e dados de compradores precisam respeitar a LGPD e as regras do cadastro positivo.
Soluções que se aplicam
Perguntas frequentes
Como impedir que o vendedor dê desconto fora da política?
Mostrando a regra no momento da venda e travando o que passa do limite. O app exibe o preço mínimo, a margem estimada ou uma indicação por cor, conforme o que a empresa quiser revelar ao vendedor, e manda para aprovação o desconto acima da alçada dele. O gerente aprova pelo celular, com histórico. O vendedor mantém autonomia dentro da política, e a exceção deixa rastro.
Dá para apurar verba de fornecedor sem planilha?
Dá, desde que cada acordo seja cadastrado com as suas regras: produtos, período, meta, forma de apuração e contrapartida. O sistema calcula o valor a receber a partir das vendas e compras efetivas, gera o demonstrativo para o fornecedor e acompanha o recebimento, seja em desconto, bonificação ou pagamento. Verba conquistada e nunca cobrada costuma aparecer justamente quando alguém passa a apurar direito.
O cliente pode fazer o pedido pelo WhatsApp em vez do portal?
Pode. Parte dos clientes do atacado prefere mandar a lista pelo WhatsApp, e um fluxo bem desenhado transforma essa conversa em pedido com o mesmo preço e as mesmas regras do portal: consulta do mix, confirmação dos itens, total e condição de pagamento. Pedido ambíguo vai para o televendas revisar. O pedido entra no ERP pelo mesmo caminho dos outros canais, sem redigitação.
Como controlar lote e validade se o nosso ERP não faz isso bem?
O controle pode nascer num módulo de armazém integrado ao ERP. Lote e validade são capturados no recebimento por leitura de código, a separação indica de qual posição tirar cada item e o sistema bloqueia a saída de lote vencido ou bloqueado pela qualidade. O ERP continua com o saldo fiscal, o módulo cuida do saldo por lote e endereço, e os dois são conciliados todos os dias.
Vamos desenhar o sistema da sua empresa?
Cada projeto é desenhado sob medida para o seu processo, e o investimento é definido sob consulta depois de entendermos o contexto. O diagnóstico inicial não tem custo: descreva o cenário e respondemos em até um dia útil.
Falar com a Pervian TechPara se aprofundar
Mais artigos em Integrações e APIs.
- Integrações e APIs 11 min de leitura
Como integrar seu sistema com o ERP sem dor de cabeça
Como integrar sistemas próprios a ERPs como TOTVS, SAP, Omie ou Bling: APIs, filas, fonte da verdade, mapeamento de cadastros e o que definir antes.
- Integrações e APIs 11 min de leitura
Como integrar um sistema legado que não tem API
Arquivos, banco, captura de mudanças e telas: as formas de integrar um sistema antigo sem API, os riscos de cada uma e como criar uma camada segura.