como integrar transportadoras ao seu e-commerce: api, gateways de frete e cotação automática

Integrar transportadoras ao e-commerce é o que permite mostrar opções de frete reais no checkout, gerar etiquetas de envio automaticamente, rastrear pedidos sem trabalho manual e despachar grandes volumes sem virar uma operação artesanal. É também uma das áreas onde lojistas iniciantes mais erram — entre escolher a transportadora errada, o gateway errado ou o nível de integração errado, dá para perder muito tempo e dinheiro.

Este artigo explica, em termos práticos, as três formas principais de integrar transportadoras a um e-commerce no Brasil, qual escolher conforme o tamanho da operação e o que avaliar antes de tomar a decisão.

por que integrar é diferente de "contratar"

Contratar uma transportadora significa ter um contrato comercial (tabelas de preço, condições de pagamento, SLA). Integrar significa conectar o sistema da loja ao sistema da transportadora — para que cotação, geração de etiqueta e rastreamento aconteçam sem ninguém precisar acessar o portal da transportadora a cada pedido.

Sem integração, o trabalho operacional cresce linearmente com o volume: a cada pedido novo, alguém precisa cotar o frete (no checkout ou manualmente), entrar no portal da transportadora, gerar a etiqueta, copiar o código de rastreio para o pedido, atualizar o status. Em volume baixo, isso é viável. Em volume médio (centenas de pedidos por dia), é insustentável.

as três formas de integração

1. integração direta com a api da transportadora

Cada transportadora oferece (ou contratualmente disponibiliza) APIs para cotação, geração de etiqueta e rastreamento. Os Correios têm o serviço SIGEP/SRO. A Jadlog tem a API Pickup/Drop. Loggi, Mercado Envios, Total Express, todos têm endpoints próprios.

Vantagens: maior controle, geralmente melhores tarifas (negociadas direto), sem intermediário. Desvantagens: cada transportadora tem o próprio formato de API, autenticação, padrão de erro. Integrar três transportadoras pode virar três projetos de tecnologia. Para lojas sem time técnico próprio, isso é um problema.

2. gateway de frete (intermediário)

Gateways de frete são empresas que se posicionam entre o e-commerce e várias transportadoras. Você integra uma vez (com o gateway) e ganha acesso simultâneo a dezenas de transportadoras, com formato de API unificado. Os principais no Brasil são: Melhor Envio, Frenet, Kangu, Intelipost, ShipFast, Pacto.

Vantagens: integração única, contratos consolidados (você emite nota e paga em um único lugar), tabelas competitivas (o gateway negocia em volume). Desvantagens: pequeno markup do gateway sobre o frete (geralmente 2-5%), dependência de um terceiro, possíveis limitações em casos específicos.

3. plataforma de e-commerce com módulo nativo

Plataformas como Nuvemshop, Shopify, VTEX, Tray, WooCommerce já oferecem módulos nativos para integração com transportadoras populares — geralmente via gateway próprio ou parceria. A integração é "clica e configura", sem código.

Vantagens: simplicidade, sem custo de desenvolvimento, atualizações automáticas. Desvantagens: limitado às transportadoras suportadas pela plataforma, menor flexibilidade em regras de negócio personalizadas.

comparativo dos principais gateways de frete

melhor envio

Provavelmente o gateway mais conhecido por lojas pequenas e médias no Brasil. Integração com Correios, Jadlog, Loggi, Latam Cargo, Azul Cargo, JeT, Buslog e outros. Modelo de assinatura mensal opcional (gera benefícios em frete) ou pay-as-you-go com tabelas próprias. Boa para quem está começando.

frenet

Foco em integração com várias plataformas de e-commerce e ERPs. Tabela ampla de transportadoras integradas. Modelo comercial baseado em mensalidade + tarifa por pedido cotado. Forte em médio porte.

kangu

Modelo crowdshipping: rede de pontos de coleta espalhados pelo Brasil onde o lojista posta o pedido e a logística é feita por motoristas parceiros. Costuma ser mais barato em rotas que cobre bem.

intelipost

Voltado para grande operação. Tem produtos de cotação, gestão de envios, rastreamento e analytics em um só lugar. Pricing customizado.

como funciona a cotação automática no checkout

A cotação automática é a funcionalidade que mostra opções de frete e prazo no momento em que o cliente digita o CEP de entrega. Tecnicamente, o que acontece é o seguinte:

• O checkout envia para o gateway/transportadora os dados do envio: CEP de origem, CEP de destino, peso, dimensões, valor declarado.
• O gateway/transportadora calcula opções disponíveis (PAC, SEDEX, Mini Envios, Jadlog Package, etc.) com preço e prazo estimado.
• O resultado volta para o checkout em poucos milissegundos e é exibido para o cliente escolher.

Esse fluxo aparenta simples, mas tem várias decisões de negócio embutidas: quais transportadoras mostrar, em qual ordem, com ou sem markup adicional, com ou sem regras especiais ("frete grátis acima de R$ 200", "X grátis para São Paulo capital"). Quanto mais flexível o gateway, mais fácil configurar essas regras.

geração automática de etiqueta e despacho

Após o pagamento aprovado, a integração permite gerar a etiqueta de envio automaticamente. O fluxo típico em uma operação integrada:

• O ERP ou sistema de gestão recebe o pedido pago.
• Decide qual transportadora usar (geralmente conforme escolha do cliente no checkout, mas pode haver regras adicionais).
• Solicita ao gateway/API a etiqueta de envio.
• Recebe o PDF da etiqueta + o código de rastreio.
• Imprime a etiqueta para o pessoal do packing colar no pacote.
• Atualiza o pedido com o código de rastreio (que automaticamente dispara a notificação para o cliente — via e-mail, WhatsApp ou ambos).

rastreamento integrado

Geração de etiqueta é o despacho. Rastreamento é o que acontece depois. Um e-commerce moderno consulta os status do pedido junto à transportadora periodicamente (geralmente a cada 1-4 horas) e atualiza o cliente proativamente quando algo muda.

Aqui é onde plataformas dedicadas a rastreio (como o já enviou) entram. Em vez do cliente abrir o link do site dos Correios para conferir, ele recebe uma mensagem no WhatsApp dizendo "seu pedido saiu para entrega, chega hoje entre 14h e 18h" e tem acesso a uma página com a marca da loja.

como decidir o caminho de integração

Resumo prático conforme o tamanho da loja:

• Até 100 pedidos/mês: módulo nativo da plataforma de e-commerce, sem integração customizada. O ganho marginal de uma integração customizada não compensa.
• 100 a 1.000 pedidos/mês: gateway de frete (Melhor Envio, Frenet, Kangu) com integração nativa na plataforma. Custo-benefício ótimo, processo enxuto.
• 1.000 a 10.000 pedidos/mês: gateway com customização ou integração mista (gateway para algumas + API direta para transportadora principal). Faz sentido investir em desenvolvimento próprio.
• Acima de 10.000 pedidos/mês: integração direta com APIs principais + gateway para excepcionais. Tabelas comerciais negociadas direto, time técnico próprio gerenciando.

Em qualquer cenário, complementar a integração de despacho com uma plataforma de rastreio integrado faz mais diferença na percepção do cliente do que escolher esta ou aquela transportadora. O envio é da transportadora, mas a comunicação do envio é sua — e é nessa comunicação que o cliente decide se volta a comprar.

erros comuns na integração de transportadoras

1. confiar 100% na cotação automática sem auditar

APIs de transportadora retornam preços que nem sempre refletem o contrato comercial real (especialmente em tabelas negociadas). Vale auditar mensalmente: o cliente pagou X no checkout, a loja pagou Y na fatura — a diferença consistente indica problema.

2. não configurar fallback quando a api falha

APIs de transportadora caem. Quando isso acontece e o checkout depende dela para mostrar opções, o cliente desiste. Sempre configurar uma tabela fixa de fallback (regras simples por região e peso) que entra no ar quando a cotação falha.

3. ignorar peso e dimensão

Cotação errada por dimensão errada é um dos maiores buracos da operação. Cadastrar peso e dimensão real de cada SKU evita prejuízo no momento do despacho (quando a transportadora cobra pelo peso cubado real).

4. não testar edge cases

CEP inexistente, peso acima do limite, valor declarado alto, destino internacional, frete grátis condicional — testar cada cenário antes de subir para produção evita problemas que aparecem só em escala.

exemplo prático: integração de uma loja média

Para tornar concreto, vamos a um cenário típico de loja com 800 pedidos/mês, ticket médio R$ 180, vendendo para todo o Brasil:

• Plataforma: Nuvemshop com tema padrão.
• Gateway escolhido: Melhor Envio (assinatura mensal padrão), pelo custo-benefício e integração nativa.
• Transportadoras ativas: Correios PAC + Mini Envios (todo o Brasil), Jadlog Package (capitais Sul/Sudeste), Loggi (entregas locais em SP).
• Cotação no checkout: o cliente vê 3-4 opções, ordenadas por preço. Frete grátis configurado a partir de R$ 220 para SP capital, de R$ 280 para o restante do país.
• Geração de etiqueta: ao marcar pedido como pago no Nuvemshop, integração com Melhor Envio gera a etiqueta automaticamente no PDF.
• Despacho: o time de packing imprime as etiquetas em lote três vezes ao dia.
• Rastreamento: integração com já enviou complementar — cliente recebe notificação de cada mudança de status pelo WhatsApp e tem página com a marca da loja.

Esse setup, padrão para uma loja desse porte, custa entre R$ 150 e R$ 350 por mês em ferramentas, e elimina praticamente todo o trabalho manual de cotação, despacho e rastreio. O ganho de tempo do time é significativo — espaço para focar no que cresce o negócio.