Erro ao conectar uma transportadora
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 e Credenciamento nos 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.
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.