Segurança e troca de credenciais
Para cotar em nome da loja, o app precisa das credenciais do contrato: senhas, tokens, chaves de API. Elas dão acesso à conta da loja na transportadora ou no gateway. Por isso o Cota Frete as trata como dado sensível.
Como as credenciais ficam guardadas#
Os campos de credencial são de dois tipos:
- Identificadores, como usuário, CNPJ, Customer Code, API Key ou o código de cliente da R3. Aparecem normalmente no campo, como você digitou.
- Segredos, como senha, token, Código API, Private Key e API Secret. Depois de salvos, não voltam a aparecer na tela. O campo fica vazio e mostra, em cinza, só os últimos caracteres do valor salvo (
••••••••1b5a). Isso basta para reconhecer qual credencial está guardada sem expor o valor.
Isso vale para todas as abas da tela Transportadoras e para os cartões da tela Gateways de frete.
Um campo de segredo vazio não apaga o que está salvo. Você pode mudar serviços, o interruptor Ativo ou qualquer outro campo e salvar: o app mantém a senha ou o token anterior.
Quando a credencial muda#
Tokens e senhas mudam: a transportadora renova a chave, alguém troca a senha no portal, o contrato é refeito. Quando isso acontece, a credencial salva no app deixa de valer e a transportadora para de cotar.
- Abra a aba da transportadora em Transportadoras.
- Digite ou cole a credencial nova no campo.
- Clique em Salvar na barra da Shopify. O app valida a credencial nova na transportadora.
Se a validação falhar, a aba mostra o aviso Erro ao validar credenciais e o selo Credenciais inválidas. Confira espaços a mais ao colar e se a credencial é de produção, não de teste (sandbox ou homologação).
Sinais de credencial vencida#
- A transportadora aparece com Sem cotações na coluna da esquerda, e a aba dela mostra o aviso “A transportadora recusou as credenciais desta loja”. O aviso de instabilidade separa os dois casos: credencial recusada pede ação sua; instabilidade da transportadora se resolve sozinha.
- O selo da aba mostra Credenciais inválidas.
- O Simular frete não devolve nenhum serviço daquela transportadora.
Se você ligou os avisos de instabilidade, a credencial recusada também chega por e-mail.
Se só alguns CEPs ficaram sem cotação, a causa provavelmente é outra, como cobertura ou bloqueio. Veja Erro ao conectar uma transportadora e Uma transportadora não cota para um CEP.
Boas práticas#
- Centralize quem tem as credenciais. Como o app não mostra o segredo de volta, guarde as credenciais num lugar seguro da loja. É quem guarda os acessos que vai trocar a credencial no app quando ela mudar.
- Desligue em vez de apagar. Para tirar uma transportadora da loja por um tempo, desligue o interruptor Ativo. As credenciais continuam salvas para quando voltar.