# 16.7 Erro ao conectar uma transportadora

> A aba da transportadora ou o cartão do gateway acusa erro ao salvar: os avisos que o app mostra e as causas por tipo, do espaço a mais ao contrato sem API habilitada.

Fonte: https://www.cotafrete.app/manual/solucao-de-problemas/erro-ao-conectar/
Planos: Widget, Basic, Business
No app: Transportadoras
Atualizado em 25/10/2026

---

Ao salvar uma transportadora ou um gateway, o Cota Frete testa as credenciais com uma consulta à transportadora. Se ela recusa o login, o app desliga a origem e mostra um aviso. Os avisos que você pode ver são estes:

| Aviso | O que quer dizer |
|---|---|
| **Erro ao validar credenciais.** "Verifique as informações e tente novamente." | A transportadora ou o gateway recusou o login. A origem fica desligada |
| **Credenciais incompletas.** "Preencha todas as credenciais obrigatórias para ativar a transportadora." | Faltou um campo obrigatório (usuário e senha ou token, na Total Express, na Jadlog e na Gollog) |
| **Não confirmamos a cobertura da Lalamove em (cidade)** | As credenciais da Lalamove estão certas, mas a cidade de coleta não está na lista publicada da Lalamove |
| **(transportadora) está sem retornar cotações** | Depois de conectada, a transportadora parou de cotar. O texto diz se ela recusou as credenciais ou se é instabilidade |

O teste só reprova o que é recusa de login. Uma demora, uma queda da transportadora ou uma rota que o contrato não cobre não desligam uma origem que funciona. Na Loggi, o app não testa a conexão ao salvar: a confirmação é a cotação aparecer no simulador.

O aviso diz que a transportadora recusou, mas não diz por quê. O motivo quase sempre se encaixa em um destes tipos.

## 1. A credencial foi colada com espaço ou pela metade

É a causa mais comum. Ao copiar de um e-mail ou de um painel, vem um espaço no início ou no fim, ou a chave fica cortada.

**Como resolver.** Cole de novo, inteira, e confira as pontas. Nas abas com várias credenciais, confira todas. A J&T Express, por exemplo, pede quatro: **Customer Code**, **Senha**, **API Account** e **Private Key**.

Por segurança, o app não mostra de volta as credenciais salvas. O campo vem vazio, só com uma máscara e os quatro últimos caracteres como dica (`••••••••1b5a`): deixe em branco para manter a credencial atual, ou digite uma nova para trocar.

## 2. A credencial é de teste, não de produção

Várias transportadoras entregam dois jogos de credenciais: um de homologação (testes) e um de produção. Credencial de teste não cota preço real, ou não cota.

- **Lalamove**: com as chaves de sandbox, a aba avisa "Chaves de sandbox: as cotações vêm do ambiente de testes da Lalamove.". As chaves de produção só aparecem no portal da Lalamove depois que você adiciona saldo à carteira.
- **Total Express**: a equipe técnica pode enviar um ambiente de homologação e um de produção. Use o de produção.

**Como resolver.** Peça ou gere as credenciais de produção e cadastre de novo.

## 3. O contrato existe, mas a API não foi liberada

Ter contrato com a transportadora não basta: o acesso à API de cotação precisa ser habilitado. Na Total Express, o **Usuário WS** e a **Senha WS** são pedidos à equipe técnica depois que o contrato é aprovado. Na Jadlog, o **Token de API** é o código de acesso às APIs de cálculo de frete, não a senha do portal, e um número de contrato inválido também reprova o teste.

**Como resolver.** Peça ao comercial ou ao suporte técnico da transportadora as credenciais de integração por API. Veja [Credenciamento na Total Express](https://www.cotafrete.app/manual/transportadoras/credenciamento-total-express/) e [Credenciamento nos Correios](https://www.cotafrete.app/manual/transportadoras/credenciamento-correios/).

## 4. A credencial foi trocada do outro lado

Se alguém gerou um token novo no painel da transportadora ou do gateway, o antigo para de funcionar e a origem deixa de cotar, sem nenhuma mudança no app. No Melhor Envio, a autorização pode expirar ou ser revogada por lá.

**Como resolver.** Cadastre o token novo e salve. No Melhor Envio, clique em **Reconectar com Melhor Envio** e autorize de novo. Veja [Segurança e troca de credenciais](https://www.cotafrete.app/manual/transportadoras/credenciais/).

## 5. Um dado do cadastro não confere com o contrato

Alguns campos, além da chave, precisam ser iguais aos do contrato:

- **Usuário/CNPJ** da Jadlog e **CNPJ** da Gollog: o mesmo do contrato.
- **Contrato Jadlog** e **Conta Jadlog**: preencha só se a Jadlog disponibilizou o contrato e só se você for correntista. Em dúvida, deixe em branco.
- **R3 Express**: um código de cliente ou contrato desconhecido reprova o teste. Uma rota que o contrato não cobre, não.
- **SmartEnvios**: o token pode estar certo e ainda assim nada cotar, se o **CEP do remetente** do cartão for diferente do CEP cadastrado na conta SmartEnvios. A resposta, nesse caso, é "Este serviço não atende esta origem".
- **Lalamove**: o aviso de cobertura não é erro. A Lalamove publica as cidades por região metropolitana, e uma coleta em cidade vizinha ainda pode ser cotada. Se as cotações não aparecem no simulador, a região não é atendida.
- **Loggi**: confira o **Código de Integração** e o endereço completo de coleta.

## Ainda não conecta

Teste as mesmas credenciais fora do app, se a transportadora oferece um portal de cotação. Se lá também falham, o caminho é o suporte da transportadora. Se lá funcionam e no app não, fale com o atendimento do Cota Frete e informe a transportadora, o horário da tentativa e o texto do aviso, sem enviar a credencial. Veja [Atendimento em cada plano](https://www.cotafrete.app/manual/plano-e-conta/atendimento/).