API no transporte: do pedido à entrega sem trocar de sistema
Integrar ERP e WMS ao transporte via API não é projeto de TI, é decisão de operação. Compartilho o que aprendi operando essa integração na prática e por que a…
CEO & Founder da Kargu
Resposta direta
Integrar ERP e WMS ao transporte via API significa que o pedido aprovado no seu sistema dispara automaticamente a coleta, o tracking e a nota fiscal, sem nenhuma digitação manual no meio. Para um e-commerce em expansão interestadual, isso elimina o gargalo humano entre a venda e o despacho, reduz erros de endereço e entrega rastreabilidade em tempo real sem migrar de plataforma.
Na semana passada, um COO de um e-commerce de materiais de construção me ligou às 22h. Não era urgência de entrega. Era urgência de dados: ele não sabia onde estavam 34 pedidos despachados três dias antes para o interior do Nordeste. O sistema de gestão dele dizia "em rota". O transportador dizia "em transferência". O cliente final dizia "não chegou".
Essa conversa resume o problema que vejo repetido em praticamente todo e-commerce que começa a crescer para fora do eixo Sul-Sudeste. A operação escala, a malha se estica para cidades que ficam a 800, 1.200 km do CD, e o que não escala junto é a visibilidade. O prazo vira uma aposta, não um compromisso.
Minha tese é simples: a integração logística via API não é uma feature de TI que você agenda para "quando der". É a base que separa uma operação que escala de uma que sangra operador toda vez que abre uma planilha de pendências.
Por que a maioria dos e-commerces atrasa essa decisão
A resposta mais honesta que já ouvi de um fundador foi: "A gente achou que dava para ir de planilha até R$ X de faturamento mensal." E dava, até não dar mais. O ponto de inflexão normalmente chega quando a operação cruza dois estados simultaneamente com transportadoras diferentes, SLAs diferentes e nenhuma fonte única de verdade sobre o status dos pedidos.
O que o mercado não percebe é que o custo invisível desse modelo não está no frete. Está no headcount que você contrata para fazer o que a API faria de graça. Já acompanhei operações onde a equipe de "acompanhamento de entrega" tinha mais gente do que a equipe de separação. Isso é sintoma, não solução.
Alguém poderia argumentar que a integração é cara e demorada. Mas esse argumento era mais verdadeiro em 2018 do que em 2026. Hoje, operadoras com arquitetura REST bem documentada conseguem ter um e-commerce conectado em questão de dias, não meses, desde que o lado do embarcador tenha um desenvolvedor dedicado por uma semana.
O erro de sequência que eu vejo o tempo todo
A maioria dos COOs que conheço tenta primeiro resolver o problema de custo de frete, depois o de prazo, e só depois pensa em integração. A ordem certa é inversa. Sem visibilidade integrada, você não consegue nem medir se a troca de transportadora reduziu custo de verdade, porque os dados vivem em planilhas de cada fornecedor.
Integrar primeiro cria a base de dados que vai informar todas as decisões subsequentes: qual rota performa, qual transportador atrasa mais, qual prazo prometido é cumprido. Sem API, você está gerenciando logística no escuro.
O que "integração" realmente significa na prática
Não estou falando de um painel de rastreamento bonito. Estou falando de quatro fluxos conectados:
- Criação de frete automática: pedido aprovado no ERP dispara a cotação e reserva de capacidade na transportadora, sem clique humano
- Emissão de documento fiscal embarcada: o CT-e ou conhecimento de frete gerado e vinculado ao pedido sem sair do sistema
- Status em tempo real no WMS: cada evento de transporte (coleta, transferência, entrega, tentativa frustrada) atualiza o status do pedido no seu sistema de gestão
- Conciliação de fatura automática: o que foi cobrado bate com o que foi contratado, sem conferência manual no fim do mês
Esses quatro fluxos eliminam as quatro fontes de ruído que travam a operação de qualquer e-commerce com mais de 300 pedidos interestaduais por dia.
O que a infraestrutura multimodal muda nessa equação
Com esse cenário em mente, a próxima questão é inevitável: qual é o valor de integrar via API com uma transportadora que não tem horário fixo de saída?
Na minha visão, nenhum. E aqui está a provocação que gosto de fazer: a API resolve o problema de visibilidade, mas não resolve o problema de previsibilidade. São camadas diferentes.
Quando você conecta seu ERP a uma malha que usa a capacidade ociosa dos bagageiros de ônibus interestaduais, a dinâmica muda. O ônibus sai às 23h todos os dias. Isso não é promessa de SLA, é calendário. A integração via API se torna mais poderosa porque ela tem algo concreto para rastrear: um veículo com horário de partida e chegada definidos, não uma estimativa de "até 10 dias úteis".
Acompanhei uma distribuidora de peças industriais no interior de Minas que migrou parte da sua malha interestadual para esse modelo. Antes, o time de atendimento abria chamado com a transportadora em média 18 horas depois do despacho para saber onde estava a carga. Depois da integração, o status chegava automaticamente ao ERP a cada evento, e o prazo deixou de ser uma conversa e passou a ser um dado.
Rastreamento real vs. rastreamento de fachada
Tenho um incômodo sério com o que o mercado chama de "rastreamento em tempo real". A maioria dos portais de transportadoras atualiza o status uma vez por dia, em batch. Isso não é tempo real, é relatório diário com nome bonito.
Rastreamento genuíno é evento-driven: cada transferência de custódia gera um webhook para o seu sistema. Quando o ônibus chega no terminal intermediário às 4h da manhã, seu WMS já sabe. Isso muda a capacidade de comunicação proativa com o cliente final, que é o que de fato reduz o volume de chamados de "onde está meu pedido".
Se você está avaliando um parceiro de transporte em 2026, peça para ver a documentação da API. Se ela não tem webhooks de evento, ela tem rastreamento de fachada.
O argumento ESG que ninguém usa do jeito certo
Muita gente fala de ESG em logística como se fosse uma linha de relatório anual. Na prática, a integração via API com uma malha que usa infraestrutura já em operação, sem colocar veículo novo na estrada, tem um argumento ESG que é também um argumento financeiro.
Explico com uma analogia: é como colocar passageiros em assentos vazios de um voo que já iria decolar de qualquer forma. A emissão marginal de carbono por tonelada transportada é dramaticamente menor do que despachar um caminhão adicional pela mesma rota. E você não paga pelo veículo ocioso, paga apenas pelo espaço que usa.
O que poucos percebem é que essa lógica aparece na conta de frete. Capacidade ociosa precificada de forma eficiente gera custo menor para o embarcador. O argumento ambiental e o financeiro apontam para o mesmo lugar.
Para e-commerces que já reportam ou pretendem reportar emissões de escopo 3, a integração com uma malha multimodal que usa ônibus interestaduais é o caminho mais direto para reduzir a pegada de carbono do frete sem sacrificar prazo.
O que muda no relatório de sustentabilidade
Dois dados que você só consegue extrair com integração via API:
- Emissão por pedido entregue: calculada automaticamente a partir da rota e modal utilizado
- Comparativo de cenário: quanto seria emitido se o mesmo pedido tivesse ido por aéreo ou por caminhão dedicado
Sem a integração, esse cálculo é manual e impreciso. Com ela, vira uma coluna no dashboard que o time de ESG usa sem depender de logística.
O que o mercado ainda não viu
Tudo que descrevi até aqui está nos manuais de boas práticas de supply chain. O que a experiência de quem opera isso no dia a dia revela é diferente.
O risco real não é técnico. É organizacional. A integração via API cria visibilidade que antes não existia, e visibilidade expõe ineficiências que estavam escondidas nas planilhas. Vi um caso onde a integração revelou que uma transportadora específica atrasava sistematicamente em uma faixa de CEP no interior do Nordeste. O gestor sabia "mais ou menos", mas sem dado automatizado, nunca tinha prioridade para agir. Com o dado na tela, a troca aconteceu em duas semanas.
O percepção que quero deixar: a API não resolve problemas, ela os torna visíveis rápido o suficiente para você agir antes que o cliente vá embora. Isso é diferente.
Outro ponto que o mercado subestima: a integração é âncora de retenção. Uma vez que seu ERP está falando com a plataforma do transportador, a fricção para trocar é real. Isso é bom quando o parceiro performa, e é ruim quando você está preso em um contrato com quem não entrega. Escolha o parceiro antes de integrar, não depois.
Por onde começar, se eu estivesse sentado na sua frente
Se você fatura acima de 200 pedidos interestaduais por dia e ainda gerencia status por e-mail ou planilha, a prioridade é clara: mapeie os quatro fluxos que listei acima e identifique qual deles gera mais atrito hoje. Na maioria dos casos é a criação manual de frete ou a conciliação de fatura no fim do mês.
Comece pelo fluxo que dói mais. Não tente integrar tudo de uma vez. Uma integração parcial que funciona gera confiança interna para avançar para a próxima. A maioria dos projetos que vejo travar não é por dificuldade técnica, é por escopo grande demais que ninguém aprova.
A timeline realista para um e-commerce com desenvolvedor interno disponível: dois a três dias para testar o ambiente de sandbox, uma semana para validar em produção com volume reduzido, duas semanas para rollout completo. Se o parceiro não tem documentação de API que permita isso, ele não está pronto para o seu volume.
Como ponto de partida, a página de integração via API da Kargu documenta os endpoints e os fluxos com exemplos reais de payload. Vale usar como referência mesmo que você esteja avaliando outras opções.
A logística interestadual brasileira é grande e fragmentada. O e-commerce que chegar primeiro ao interior com prazo confiável e operação automatizada vai construir uma vantagem que é muito mais difícil de copiar do que um desconto de frete. API é o instrumento. Previsibilidade é o produto.
Perguntas frequentes
Preciso trocar de ERP para integrar com o transporte via API?
Não. A integração via API é feita por camada, sem substituir o sistema de gestão existente. O ERP continua sendo o sistema de registro; a API cria um canal de comunicação entre ele e a plataforma de transporte. A maioria dos ERPs do mercado já tem suporte a webhooks e chamadas REST.
Quanto tempo leva para conectar WMS e transportadora via API?
Depende da maturidade da documentação do transportador e da disponibilidade técnica do embarcador. Com API bem documentada e um desenvolvedor dedicado, o ambiente de testes pode estar operacional em dois a três dias. O rollout completo em produção leva entre uma e três semanas.
Como a integração via API afeta o custo do frete interestadual?
A integração em si não reduz o custo do frete diretamente, mas cria a base de dados para identificar ineficiências de rota, atrasos sistêmicos por transportador e divergências de cobrança. Operações que usam esses dados para tomar decisão de malha costumam identificar oportunidades de redução de custo que não seriam visíveis sem a automação.