# Integração de cotação de frete com transportadoras: como fazer

> Como integrar a cotação de frete com transportadoras: várias cotações no pedido, escolha por custo e prazo, etiqueta, rastreio e auditoria da fatura.

Fonte: https://pervian.tech/blog/integracao-com-transportadoras-e-frete · Pervian Tech · publicado em 2026-10-01

O vendedor está ao telefone com um cliente de outro estado, e o cliente quer saber quanto fica o frete. O vendedor abre o site de uma transportadora, depois o de outra, preenche CEP, peso e medidas nas duas, anota os valores num papel e volta à ligação. Enquanto isso, o cliente já pediu cotação ao concorrente, que respondeu na hora.

No outro lado do galpão, a expedição repete o trabalho: escolhe a transportadora "de costume", digita o endereço no portal dela, imprime a etiqueta, cola na caixa e manda o código de rastreio por mensagem. No fim do mês, a fatura da transportadora chega com valores que ninguém consegue comparar com o que foi cotado.

Integrar as transportadoras ao sistema de pedidos resolve as duas pontas. A cotação sai no momento do pedido, a escolha segue regras, a etiqueta é gerada sem redigitação, o rastreio volta sozinho e a fatura é conferida contra o que foi combinado. Este texto mostra como montar esse fluxo, peça por peça.

## A resposta curta: o que uma integração de frete precisa fazer

Uma integração de cotação de frete com transportadoras bem feita cobre seis etapas, e cada uma depende da anterior:

1. **Cotar**: a partir de CEP de origem, CEP de destino, peso, dimensões e valor da mercadoria, consultar várias transportadoras ao mesmo tempo e receber preço e prazo de cada uma.
2. **Escolher**: aplicar regras da empresa (menor custo, menor prazo, transportadora preferida por região) e indicar a opção vencedora, sem depender de quem está no turno.
3. **Contratar**: registrar o envio na transportadora escolhida, com os dados da nota fiscal.
4. **Etiquetar e coletar**: gerar etiqueta, solicitar a coleta e organizar os volumes do dia.
5. **Rastrear**: receber cada mudança de status e avisar o cliente.
6. **Auditar**: conferir o valor cobrado na fatura contra o valor cotado.

O ganho real aparece quando as seis conversam entre si e com o pedido.

## Cotação manual: onde a empresa perde venda e margem

A cotação manual custa em três lugares, e nenhum aparece numa linha específica do balanço.

- **Venda perdida pela demora.** No B2B, o cliente que espera retorno de frete continua pesquisando. No e-commerce, o carrinho sem frete calculado na hora tende a ser abandonado.
- **Margem perdida pela escolha.** Quem cota à mão cota em duas ou três transportadoras, não em todas, e tende a repetir a de sempre. A opção mais barata para aquele CEP e aquele peso fica de fora.
- **Erro de cubagem.** Em geral, as transportadoras cobram pelo maior valor entre o peso real e o peso cubado, calculado pelas dimensões da embalagem com um fator definido por cada uma. Quando o cadastro do produto não tem medidas corretas, a cotação sai baixa e a fatura sai alta.

## Integração direta x plataformas de frete

Existem dois caminhos para ligar o sistema às transportadoras, e muitas empresas acabam usando os dois.

**Integração direta** é conectar o sistema à API de cada transportadora ou dos Correios, ou trocar arquivos no [padrão EDI](https://pervian.tech/blog/edi-com-clientes-e-fornecedores) que boa parte das transportadoras de carga ainda usa (arquivos como NOTFIS, para enviar as notas, OCOREN, para receber ocorrências, CONEMB e DOCCOB, para conhecimentos e cobrança). Cada transportadora tem sua forma de autenticar, seus campos obrigatórios e suas tabelas.

**Plataforma de frete** (também chamada de hub ou gateway de frete) é um intermediário que já está integrado a várias transportadoras e expõe uma única API. O sistema conversa com a plataforma, e ela conversa com as transportadoras.

| Critério | Integração direta | Plataforma de frete |
|---|---|---|
| Velocidade para começar | Mais lenta, uma transportadora por vez | Mais rápida, várias de uma vez |
| Uso do contrato negociado | Total, com a tabela própria da empresa | Depende de a plataforma aceitar o contrato próprio |
| Transportadoras regionais pequenas | Possível, inclusive via EDI ou planilha de tabela | Só as que a plataforma suporta |
| Dependência de terceiro | Menor | Mais um fornecedor na cadeia |
| Manutenção | Cada mudança de API é sua | A plataforma absorve parte delas |

A pergunta que decide é: **as transportadoras que você usa e os contratos que você negociou cabem na plataforma?** Se cabem, ela costuma ser o caminho mais curto. Se a empresa depende de uma transportadora regional com tabela própria, ou de frota própria em parte das rotas, a integração direta entra pelo menos para esses casos.

Um desenho que funciona bem é ter, dentro do sistema, uma **camada única de frete**: o pedido pede cotação a essa camada, e ela decide se consulta a plataforma, a API direta ou uma tabela interna. Esse tipo de separação é decisão de [arquitetura de software](https://pervian.tech/servicos/arquitetura-de-software), e é ela que evita refazer a integração a cada contrato novo.

## Cotação automática no pedido e no e-commerce

A cotação precisa acontecer onde a venda acontece.

### No sistema de pedidos (B2B e televendas)

O vendedor monta o pedido e o sistema mostra, ao lado do total, as opções de frete com preço e prazo. Para isso, o cadastro do produto precisa ter **peso, altura, largura e comprimento da embalagem de envio**, não do produto nu.

Quando o frete é cobrado do cliente (FOB) ou absorvido pela empresa (CIF), a regra muda o que aparece no pedido. Em vendas CIF, o frete não é cobrado à parte do cliente, mas precisa aparecer para quem calcula a margem.

### Na loja virtual

No e-commerce, a cotação é chamada a cada CEP digitado, e o tempo de resposta importa. Duas proteções evitam que uma transportadora lenta trave o checkout:

- **Tempo limite por transportadora.** Quem não respondeu a tempo fica fora daquela cotação, em vez de segurar todas.
- **Memória de curta duração (cache).** O mesmo CEP, peso e dimensões, cotados minutos antes, podem reaproveitar a resposta, desde que a tabela não tenha mudado nesse intervalo.

Se a loja e o ERP já trocam pedidos, estoque e nota, o frete escolhido no checkout precisa seguir junto com o pedido para o faturamento. Os detalhes dessa ida e volta estão no texto sobre [integração entre ERP e e-commerce sem planilha no meio](https://pervian.tech/blog/integracao-erp-e-commerce).

## Regras de escolha por prazo, custo e região

Cotar em várias transportadoras só ajuda se alguém, ou alguma regra, escolher bem. As regras mais comuns:

- **Menor custo dentro do prazo prometido.** O sistema descarta quem não cumpre o prazo de entrega do pedido e escolhe a mais barata entre as restantes.
- **Preferência por região.** Para determinados estados ou faixas de CEP, uma transportadora tem prioridade, porque entrega melhor ali, mesmo que não seja a mais barata.
- **Restrição por tipo de carga.** Produto frágil, de grande volume ou acima de certo peso só vai por transportadoras habilitadas para isso.
- **[Desempenho recente](https://pervian.tech/blog/indicadores-de-logistica-otif).** Transportadora com muitas ocorrências na região perde prioridade até melhorar.

O cuidado aqui é **deixar a regra visível e editável por quem é da operação**, numa tela de configuração, não escondida no código. E registrar, em cada pedido, quais opções foram cotadas e por que uma venceu. Quando o gestor perguntar por que o pedido foi pela transportadora mais cara, a resposta precisa estar no sistema.

A escolha automática não elimina a exceção. A expedição deve poder trocar a transportadora de um pedido, desde que registre o motivo.

## Etiqueta, coleta e documentos

Com a transportadora escolhida e a nota emitida, o sistema registra o envio e recebe de volta a etiqueta e o código de rastreio.

Pontos que costumam dar trabalho:

- **Dados da nota no envio.** Boa parte das transportadoras exige a chave da NF-e para aceitar a carga. A etiqueta, portanto, só deve ser gerada depois do faturamento, e o fluxo precisa respeitar essa ordem.
- **Volumes.** Pedido com três caixas precisa de três etiquetas, cada uma com seu peso e suas medidas reais, conferidos na expedição.
- **Impressão em lote.** A expedição imprime as etiquetas do dia de uma vez, agrupadas por transportadora, junto com a lista de coleta (romaneio) para o motorista conferir na saída.
- **Envio sem nota fiscal.** Em alguns casos, como remessa de pessoa física ou devolução de cliente não contribuinte, o documento que acompanha a mercadoria é outro. O sistema precisa suportar essas situações; a regra fiscal de cada caso vale validar com o contador.
- **Agendamento de coleta.** Para transportadoras que coletam no endereço da empresa, a solicitação de coleta pode sair automaticamente quando os volumes do dia estiverem prontos.

Do lado da transportadora, o documento fiscal do transporte é o CT-e, emitido por ela. Se a sua empresa é a própria transportadora, ou tem frota que presta serviço a terceiros, o assunto é outro e está no texto sobre [sistema para transportadora: TMS pronto ou sob medida](https://pervian.tech/blog/sistema-para-transportadora-sob-medida).

## Rastreio e aviso automático ao cliente

Rastreio integrado funciona por dois mecanismos:

- **Notificação da transportadora** (webhook): a transportadora avisa o sistema a cada mudança de status. É o mais rápido, mas nem todas oferecem.
- **Consulta periódica**: o sistema pergunta, de tempos em tempos, o status dos envios em aberto. Funciona com qualquer uma, com algum atraso.

Cada transportadora chama os status de um jeito. O sistema precisa traduzi-los para uma lista própria e curta, que o cliente e a equipe entendem: postado, em trânsito, saiu para entrega, entregue, ocorrência. O aviso ao cliente (e-mail, SMS ou [WhatsApp](https://pervian.tech/blog/integracao-whatsapp-api-oficial)) é disparado a partir dessa lista padronizada, não do texto cru da transportadora.

A parte que mais vale a pena automatizar é a **ocorrência**: destinatário ausente, endereço não localizado, avaria, extravio. Ocorrência deve abrir uma pendência com dono e prazo, não ficar esperando o cliente reclamar. Quando a entrega é feita por frota própria, o comprovante com foto e assinatura pode alimentar o mesmo rastreio; o texto sobre [app de entrega com comprovante digital](https://pervian.tech/blog/app-de-entrega-com-comprovante-digital) mostra como.

Rastreio carrega nome, endereço e telefone do cliente. A LGPD vale para essa troca de dados como para qualquer outra: envie à transportadora só o necessário para a entrega e restrinja o acesso aos registros.

## Auditoria de frete: cobrado x combinado

Sem auditoria, a integração resolve a operação e deixa a margem descoberta. A fatura da transportadora (ou o arquivo de cobrança no padrão EDI) chega com dezenas ou centenas de conhecimentos, e o financeiro paga o total.

Com a integração, cada envio já tem no sistema o **valor cotado no momento da escolha**. A auditoria compara esse valor com o cobrado, envio por envio, e separa as divergências por motivo:

| Divergência | Causa provável | O que fazer |
|---|---|---|
| Peso cobrado maior que o enviado | Cubagem diferente ou medida errada no cadastro | Corrigir cadastro ou contestar com a medição |
| Taxa extra não prevista | Taxa de difícil acesso, reentrega, agendamento | Conferir contrato e ocorrência que justifica |
| Tabela diferente da contratada | Reajuste não comunicado ou erro de tabela | Contestar com a tabela vigente |
| Cobrança de envio cancelado | Coleta cancelada que foi faturada | Contestar com o registro de cancelamento |
| Cobrança duplicada | Mesmo conhecimento em duas faturas | Contestar |

Divergência dentro de uma tolerância definida pela empresa passa direto. Fora dela, vira pendência para o financeiro contestar antes de pagar.

## Checklist para começar a integração de frete

1. **Liste as transportadoras e os contratos atuais**, com a forma de integração que cada uma oferece (API, EDI, só portal).
2. **Revise o cadastro de produtos**: peso e medidas da embalagem de envio, item por item. Sem isso, nenhuma cotação acerta.
3. **Defina a regra de montagem de volumes** para pedidos com vários itens.
4. **Escreva as regras de escolha** (custo, prazo, região, tipo de carga) e quem pode alterá-las.
5. **Decida entre plataforma, integração direta ou as duas**, testando com os seus envios difíceis, não com o exemplo da demonstração.
6. **Desenhe a ordem do fluxo**: pedido, nota, contratação do frete, etiqueta, coleta.
7. **Padronize os status de rastreio** e os avisos ao cliente.
8. **Ligue a auditoria desde o primeiro dia**, mesmo que só para medir, antes de contestar.
9. **Rode em paralelo** com o processo atual por um período, conferindo cotação e fatura.

Erros que aparecem com frequência: integrar a cotação e deixar a etiqueta no portal (a redigitação continua), confiar em medidas de cadastro nunca conferidas, e tratar falha de API da transportadora como erro fatal. Se uma transportadora estiver fora do ar, o pedido segue com as que responderam. Falhas e reprocessamento seguem os mesmos princípios de qualquer integração; quando a transportadora não tem API nenhuma, vale entender as opções em [RPA ou integração via API](https://pervian.tech/blog/rpa-ou-integracao-via-api).

## Perguntas frequentes

### O que é peso cubado no frete?

Peso cubado é o peso calculado a partir das dimensões da embalagem, com um fator definido por cada transportadora. Em geral, a transportadora cobra pelo maior valor entre o peso real e o peso cubado, por isso o cadastro de produtos precisa ter altura, largura e comprimento corretos da embalagem de envio.

### Preciso de uma plataforma de frete para cotar em várias transportadoras?

Não necessariamente. Uma plataforma de frete acelera o começo porque já está integrada a várias transportadoras, mas só atende as que suporta e nem sempre aceita o contrato negociado pela empresa. Transportadoras regionais com tabela própria costumam exigir integração direta por API ou EDI, e muitas empresas usam os dois caminhos.

### Dá para integrar uma transportadora que não tem API?

Sim. Muitas transportadoras de carga trocam dados por arquivos no padrão EDI, como NOTFIS, OCOREN, CONEMB e DOCCOB, e algumas trabalham com tabela de frete em planilha que o sistema consegue importar. Quando a transportadora só oferece portal, a automação de tela entra como último recurso, com manutenção mais frágil.

### Quanto tempo leva para integrar a cotação de frete ao sistema?

Depende do número de transportadoras, da forma de integração de cada uma e do estado do cadastro de produtos. A integração de frete costuma avançar por fases, começando por uma transportadora e depois somando regras de escolha, rastreio e auditoria, então o cronograma só pode ser estimado com segurança depois de um diagnóstico.

## Como a Pervian Tech trabalha integração logística

Na Pervian Tech, começamos pelo diagnóstico inicial gratuito: quais transportadoras a empresa usa, como cada uma se integra, como o pedido anda hoje do comercial à expedição e onde o frete cotado e o frete pago se separam. A partir daí, desenhamos a integração sob medida, aproveitando plataformas de frete quando elas atendem e construindo a camada própria onde o contrato ou a operação exigem, como parte do nosso trabalho de [integração de sistemas](https://pervian.tech/solucoes/integracao-de-sistemas).

O projeto segue fases (diagnóstico, primeira transportadora integrada, regras de escolha, rastreio e auditoria), e o cronograma é definido depois do diagnóstico, porque depende do número de transportadoras e do estado do cadastro. O investimento é sob consulta. Outros textos sobre o tema estão em [integrações](https://pervian.tech/blog/categoria/integracoes). Se a sua expedição ainda cota frete em abas do navegador, [conte como ela funciona hoje](https://pervian.tech/#contato).