API logística: conecte ERP ao transporte sem trocar sistema
Guia prático para gerentes de logística integrarem ERP e WMS ao transporte interestadual via API, do pedido à entrega, sem migração de sistema.
CEO & Founder da Kargu
Quantas vezes por semana alguém do seu time lança manualmente um CT-e no ERP depois que o transportador manda o XML por e-mail? Se a resposta for "todo dia", você não está sozinho. O que vejo com frequência em operações de carga fracionada interestadual é exatamente isso: o sistema de gestão na empresa, o transportador no mundo dele, e no meio uma ponte de planilha, WhatsApp e retrabalho. O pedido sai do WMS, alguém acessa o portal da transportadora, cotação manual, coleta agendada por telefone, rastreamento via tela separada, e a nota fiscal chega dias depois por e-mail. Cada etapa dessas custa tempo, custa erro e custa dinheiro.
A pergunta que chega com frequência é: como integrar ERP e WMS ao transporte interestadual via API sem precisar trocar de sistema? A resposta direta é esta: uma API REST bem documentada permite que seu ERP (SAP, TOTVS, Sankhya ou qualquer outro) ou WMS dispare cotações, reserve capacidade, emita documentos fiscais e receba eventos de rastreamento em tempo real, tudo sem sair do seu ambiente. Você não muda de sistema. Você conecta o que já tem ao transporte, como se fosse mais um módulo. O resto deste post detalha como esse fluxo funciona na prática e o que você precisa checar antes de começar.
Por que a integração manual trava a operação fracionada
O frete fracionado interestadual tem uma característica que amplifica qualquer ineficiência: volume pulverizado e rotas longas. Uma distribuidora que atende 200 clientes em 15 estados diferentes pode ter 40, 50 expedições diárias indo para praças distintas, cada uma com peso, cubagem e destino diferente. Fazer isso na mão não é só lento. É a receita para erro de faturamento, atraso na coleta e SLA descumprido.
O que acontece quando o processo é manual é que o gargalo não está no transporte em si. Está na comunicação entre o pedido e o embarque. O caminhão ou o ônibus interestadual sai no horário. O problema é que a carga às vezes não está pronta para embarcar porque a cotação demorou, a coleta não foi agendada a tempo ou o CT-e ficou pendente de conferência. Isso atrasa a saída, e em uma malha com horário fixo, perder a janela significa D+1 virando D+2 ou D+3 sem aviso para o cliente.
Uma operação que conhecemos no interior de Minas, distribuidora de insumos industriais com envios regulares para o Nordeste, tinha exatamente esse problema: a expedição estava ok, mas o time administrativo levava horas para fechar a documentação e acionar o transportador. Quando integraram o WMS via API, o tempo entre pedido confirmado e carga disponível para coleta caiu de forma expressiva. Não porque o transporte ficou mais rápido, mas porque a interface humana saiu do caminho crítico.
O que uma integração via API cobre na prática
Entendido o problema, a pergunta seguinte é natural: o que exatamente a API faz? Não é magia. É uma sequência de chamadas que cobrem cada etapa do fluxo logístico:
Cotação e booking em tempo real
O ERP envia origem, destino, peso e cubagem. A API retorna prazo (D+1 a D+4 dependendo da rota), custo e janela de coleta disponível. Tudo em milissegundos, dentro do próprio sistema do embarcador. Sem portal externo, sem planilha de tabela de frete desatualizada. Se o pedido for aprovado, o booking já reserva capacidade na malha, seja no bagageiro do ônibus interestadual ou no caminhão de last mile conforme o trecho.
Emissão de documento fiscal e CT-e
Esse é o ponto que mais trava operações na mão. A integração pode automatizar a geração do CT-e a partir dos dados da NF-e, sem que o time de expedição precise tocar nisso. O XML volta para o ERP automaticamente, alimenta a conta a pagar de frete e fecha o ciclo fiscal sem digitação.
Rastreamento e eventos de entrega
A API envia webhooks a cada evento: carga coletada, embarcada, em trânsito, saída para entrega, entregue, tentativa sem sucesso. Seu ERP ou WMS recebe o evento e atualiza o status do pedido automaticamente. O cliente pode ser notificado via e-mail ou app sem que ninguém precise acessar um portal separado de rastreamento em tempo real.
Faturamento consolidado
Em vez de dezenas de CTes e boletos por transportadora, a integração permite receber uma única nota fiscal mensal consolidada. Para o financeiro, isso simplifica conciliação. Para o time de logística, elimina o trabalho de cruzar documentos.
O que checar antes de começar a integração
A integração via API não é um projeto de TI de seis meses. Mas também não é ligar um cabo USB. Existem pontos que definem se vai ser rápido ou demorado:
Seu ERP tem capacidade de consumir REST API?
A maioria dos ERPs corporativos modernos (SAP B1, TOTVS Protheus, Sankhya, Oracle NetSuite) já tem módulos ou conectores nativos para REST. O que varia é quanto o time de TI conhece essa camada. Antes de qualquer conversa com o transportador, vale mapear internamente: quem cuida das integrações, qual o ambiente (cloud ou on-premise) e se há sandbox disponível para testes.
Os dados de expedição estão limpos no WMS?
API não resolve dados ruins. Se o cadastro de clientes tem CEPs errados, endereços incompletos ou peso/cubagem sem padrão, a cotação vai retornar erro ou, pior, retornar um prazo inviável. Uma limpeza de master data antes da integração poupa semanas de troubleshooting depois.
Quais eventos de rastreamento você realmente precisa?
Nem toda operação precisa de todos os webhooks disponíveis. Uma distribuidora B2B que entrega para revendas pode precisar só de "entregue" e "tentativa sem sucesso". Um e-commerce que entrega para o consumidor final vai querer todos os eventos intermediários para comunicação proativa. Defina isso antes, porque impacta o desenvolvimento do lado do ERP.
Uma lista rápida para o checklist inicial:
- Versão do ERP e disponibilidade de integração REST
- Qualidade do cadastro de clientes e produtos no WMS
- Fluxo atual de emissão de CT-e (manual, semi-automático, já integrado?)
- Quem aprova a integração: TI, financeiro e logística precisam estar alinhados
- SLA interno de resposta para testes de homologação
Como o transit time muda com a integração funcionando
Aqui é onde o impacto operacional fica mais concreto. Em rotas médias e longas, a malha multimodal com ônibus interestaduais opera com horário fixo de saída. Isso significa que há uma janela diária para embarque: se a carga está disponível e documentada até determinado horário, ela vai naquele ônibus e chega em D+1 ou D+2. Se não está, espera o dia seguinte.
Com integração manual, perder a janela é comum. Com API, o booking acontece no momento em que o pedido é confirmado no ERP. A coleta é agendada automaticamente, o CT-e está pronto antes de o motorista chegar, e a carga entra na malha no horário. O transit time D+1 a D+4 que a malha promete deixa de ser uma promessa teórica e vira uma realidade operacional. E isso muda o SLA que você consegue oferecer ao seu cliente.
Para e-commerces que estão expandindo para o interior, onde o aéreo não chega e o rodoviário tradicional leva 8 a 10 dias, essa previsibilidade é o que viabiliza a expansão. Você consegue prometer prazo competitivo para cidades que a concorrência ignora, porque a malha cobre mais de 5.500 municípios com esse nível de previsibilidade. Mas só se a operação estiver integrada, porque no volume de pedidos de um e-commerce em crescimento, gestão manual não escala.
Se quiser entender como essa malha funciona na prática, a integração via API com ERP e WMS está disponível para diagnóstico.
O que fazer na prática agora
Com tudo isso em mente, a ação mais inteligente agora é mapear o fluxo atual do pedido até a entrega e marcar cada etapa onde existe intervenção humana que poderia ser automatizada. Não precisa ser um projeto formal. Pode ser uma conversa de 30 minutos com quem opera a expedição todos os dias. Essa pessoa sabe exatamente onde está o atrito.
Depois disso, a conversa com o transportador ou a logtech precisa incluir três perguntas objetivas: a API é REST com documentação pública? Tem sandbox para testes? Qual o SLA de suporte durante a homologação? Se as respostas forem sim, sim e razoável, o projeto de integração é viável em semanas, não meses.
O que não faz sentido em 2026 é manter uma operação interestadual fracionada rodando no modelo de portal + planilha + e-mail. O custo invisível desse modelo (retrabalho, janelas perdidas, SLA descumprido, erros fiscais) é real, só não aparece como linha no P&L. Aparece na churn de clientes, no estresse do time e na dificuldade de crescer sem contratar mais gente para fazer o mesmo processo manual em volume maior.
A integração via API não é um projeto de tecnologia. É uma decisão operacional. Fale com a Kargu e veja como conectar sua operação à malha multimodal sem mudar o sistema que você já usa.
Perguntas frequentes
Quanto tempo leva para integrar o ERP ao transporte via API?
Depende da complexidade do ERP e da qualidade dos dados de expedição. Operações com ERP moderno e dados limpos costumam completar a homologação em algumas semanas. O principal fator de atraso é interno: disponibilidade do time de TI e qualidade do cadastro de clientes e produtos.
A integração via API funciona com TOTVS e SAP?
Sim. Tanto o TOTVS Protheus quanto o SAP Business One têm suporte nativo para consumo de REST API. O trabalho de integração envolve configurar o conector, mapear os campos de expedição e testar os webhooks de rastreamento. Nenhuma das plataformas exige troca ou migração.
É possível integrar sem ter um WMS dedicado?
Sim. Operações que controlam expedição diretamente no ERP, sem WMS separado, conseguem integrar da mesma forma. O fluxo parte do pedido no ERP, e a API recebe os dados de origem, destino, peso e cubagem diretamente dali. O WMS adiciona automação de picking e endereçamento, mas não é pré-requisito para a integração de transporte funcionar.