Como conectar a SmartEnvios ao Cota Frete
A SmartEnvios é um gateway de frete: uma conta reúne várias transportadoras, sem contrato direto com cada uma. Se a sua loja já opera pela SmartEnvios, o Cota Frete conecta essa conta e passa a cotar, na Shopify, com os serviços habilitados nela.
A conexão usa o Token Embarcador da sua conta SmartEnvios. Disponível a partir do plano Widget. Se ainda não sabe o que é um gateway, comece por O que é um gateway de frete e quando usar .
Antes de começar
A conta SmartEnvios não é aberta em autoatendimento: ela passa por um processo comercial com a própria SmartEnvios. Se você ainda não tem conta, fale com eles primeiro. O Cota Frete não abre conta nem intermedeia essa relação.
1. Encontre o Token Embarcador no painel da SmartEnvios
- Entre na sua conta em portal.smartenvios.com .
- Localize o Token Embarcador da conta.
- Copie o token.
O token é da sua conta, não do Cota Frete. Não compartilhe com terceiros.
2. Cadastre o token no Cota Frete
- No admin da Shopify, abra Cota Frete → Gateways de frete.
- No cartão SmartEnvios, ligue Ativo.
- Cole o Token Embarcador SmartEnvios.
- Informe o CEP do remetente. Leia a seção seguinte antes: esse CEP tem uma regra própria na SmartEnvios.
- Salve.
Se o token estiver correto, o cartão mostra a conexão como ativa e carrega a lista de serviços da sua conta. Se der erro de credenciais, confira se copiou o token inteiro, sem espaços no início ou no fim.
3. O CEP do remetente precisa ser o da conta SmartEnvios
Este é o ponto que mais causa dúvida. A SmartEnvios só cota a partir do CEP de origem cadastrado na conta dela. Se o CEP do remetente informado no cartão for outro, nenhum serviço cota, e a resposta da SmartEnvios é “Este serviço não atende esta origem”.
Use no cartão exatamente o CEP que está cadastrado na sua conta SmartEnvios. Se a sua loja envia de outro lugar, o ajuste é feito com a SmartEnvios, não no app.
Cada gateway no Cota Frete cota a partir do CEP do remetente do próprio cartão, mesmo que as configurações gerais da loja usem outro CEP de origem.
4. Escolha os serviços que quer oferecer
Depois de conectar, o Cota Frete lê da sua conta quais serviços estão habilitados na SmartEnvios e lista exatamente esses. Não é uma lista fixa: numa conta pode aparecer PAC, Sedex, J&T Express, Loggi, Jadlog, Magalog, Gollog ou Movvi; noutra, um conjunto diferente.
Marque os serviços que devem aparecer na loja e salve. Se você habilitar um serviço novo na SmartEnvios, ele aparece no Cota Frete sem precisar abrir atendimento.
Um serviço pode estar na lista e não cotar para uma rota específica. É a SmartEnvios dizendo que aquela transportadora não atende aquele trecho; as outras seguem normais.
5. Os demais campos do cartão
- Exibir cotações no checkout: desligada, a SmartEnvios cota na página do produto e no carrinho, mas não aparece no checkout.
- Peso mínimo e Peso máximo para ativar frete: fora dessa faixa, o gateway não cota.
- Declarar valor da compra: envia o valor do pedido para a SmartEnvios, o que pode incluir seguro na tarifa.
6. Teste com um CEP
Abra uma página de produto da loja e informe um CEP. Os prazos e valores exibidos vêm da sua conta SmartEnvios, e as mesmas cotações aparecem no carrinho e, a partir do plano Basic, no checkout, com o Carrier Calculated Shipping (cotação calculada pela transportadora) ativo na loja.
Se o token for trocado
Gerou um token novo na SmartEnvios? O antigo para de funcionar e as cotações somem da loja. Volte em Cota Frete → Gateways de frete → SmartEnvios, substitua pelo token novo e salve.
Sobre as suas credenciais
O token salvo no Cota Frete não é enviado para o navegador. No painel, o campo mostra só uma máscara do que está salvo (••••••••1b5a); o valor real sai do servidor apenas quando você clica para exibir.
Relacionados
- Gateways de frete no Cota Frete: o que são, quando usar e como conectar
- Como mostrar o frete do gateway na página do produto e no carrinho
- O que é um gateway de frete e quando usar
Última atualização: setembro de 2026