# 4.13 Segurança e troca de credenciais

> Como o Cota Frete guarda senhas, tokens e chaves das transportadoras e dos gateways, como reconhecer uma credencial salva e como trocá-la quando ela muda.

Fonte: https://www.cotafrete.app/manual/transportadoras/credenciais/
Planos: Widget, Basic, Business
No app: Transportadoras
Atualizado em 25/10/2026

---

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](https://www.cotafrete.app/manual/gateways-de-frete/).

> **Salvar outra coisa sem mexer no segredo:** 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.

1. Abra a aba da transportadora em **Transportadoras**.
2. Digite ou cole a credencial nova no campo.
3. 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](https://www.cotafrete.app/manual/inicio/simular-frete/) não devolve nenhum serviço daquela transportadora.

Se você ligou os [avisos de instabilidade](https://www.cotafrete.app/manual/transportadoras/aba-geral/#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](https://www.cotafrete.app/manual/solucao-de-problemas/erro-ao-conectar/) e [Uma transportadora não cota para um CEP](https://www.cotafrete.app/manual/solucao-de-problemas/transportadora-nao-cota-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.