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

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 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.

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, 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.

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. 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.

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) é 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 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 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.

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.

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. Se a sua expedição ainda cota frete em abas do navegador, conte como ela funciona hoje.