Pular para o conteúdo
Cota Frete Manual
5.5

SmartEnvios

Planos:WidgetBasicBusinessCheckout requer CCSNo app:Gateways de freteSmartEnvios

A SmartEnvios é um gateway de frete: uma conta reúne várias transportadoras, sem contrato direto com cada uma. Se a loja já opera pela SmartEnvios, o Cota Frete conecta essa conta e passa a cotar com os serviços habilitados nela.

A conexão usa o Token Embarcador SmartEnvios. A SmartEnvios tem uma particularidade que os outros gateways não têm, e que explica a maioria das dúvidas: ela só cota a partir do CEP de origem cadastrado na conta. Esta página explica isso em detalhe.

O que é igual para todos os gateways (aba Geral, serviços, parâmetros de cálculo, avisos) está em A tela Gateways de frete.

Antes de começar#

A conta SmartEnvios não é aberta em autoatendimento: ela passa por um processo comercial com a própria SmartEnvios. Se a loja 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#

  1. Entre na conta da loja no painel da SmartEnvios (portal.smartenvios.com).
  2. Localize o Token Embarcador da conta.
  3. Copie o token.

O token é da conta da loja, não do Cota Frete. Trate como senha.

2. Cadastre o token no Cota Frete#

Cartão da SmartEnvios com o campo Token Embarcador
  1. No app, abra Gateways de freteSmartEnvios.
  2. Cole o token no campo Token Embarcador SmartEnvios.
  3. Ligue a chave Ativo no topo do cartão.
  4. Clique em Salvar na barra da Shopify.

Ao salvar, o app confere o token com a SmartEnvios. Com o token certo, o cartão carrega a lista de serviços da conta. Token recusado deixa o cartão com Credenciais inválidas: confira se ele foi copiado inteiro, sem espaço no início ou no fim.

3. O CEP de origem precisa ser o da conta#

Nos outros gateways, o CEP de origem é só o ponto de partida da cotação: você escolhe e o gateway cota. Na SmartEnvios, a origem já está definida na conta, no processo comercial. O gateway só aceita cotar a partir desse CEP. Com outro CEP, nenhum serviço cota, e a SmartEnvios responde “Este serviço não atende esta origem”.

Qual CEP o app usa depende da aba Geral:

Permitir customização por gatewayCEP que a SmartEnvios recebe
DesligadaO CEP de origem dos envios da aba Geral
LigadaO CEP do remetente do cartão da SmartEnvios. Em branco, o da aba Geral

O cartão lembra disso logo abaixo do token. Se a loja envia tudo do mesmo endereço cadastrado na SmartEnvios, basta o CEP da aba Geral. Se a loja tem outro CEP de origem para as demais transportadoras, ligue a customização e preencha no cartão da SmartEnvios o CEP da conta.

Se a loja passou a enviar de outro endereço, o ajuste é feito com a SmartEnvios, não no app.

4. Ligue os serviços#

O app lê da sua conta quais serviços estão habilitados na SmartEnvios e lista exatamente esses em Serviços do contrato, todos desligados. A lista muda de uma conta para outra: numa pode aparecer PAC, SEDEX, J&T Express, Loggi, Jadlog, Magalog, Gollog ou Movvi; noutra, um conjunto diferente.

Ligue os que devem aparecer na loja e salve. Sem nenhum ligado, a SmartEnvios não cota. Serviço novo habilitado na SmartEnvios aparece na lista, desligado, na próxima vez que o app consultar a sua conta (quando você abre o Cota Frete, no máximo uma vez por dia).

Um serviço pode estar na lista e mesmo assim não cotar para uma rota. É a SmartEnvios dizendo que aquela transportadora não atende aquele trecho. Os outros serviços seguem normais.

Declarar valor da compra#

Com Permitir customização por gateway ligada, o cartão tem a opção Declarar valor da compra. Ligada, o app envia o valor dos itens à SmartEnvios, e a tarifa pode incluir seguro.

5. Teste#

Rode o Simular frete na tela Início com um produto e um CEP. Se nenhum serviço da SmartEnvios aparecer, confira primeiro o CEP de origem.

As mesmas cotações aparecem na página do produto, no carrinho e na gaveta. No checkout, nos planos Basic e Business, com o Carrier Calculated Shipping (CCS, “cotação calculada pela transportadora”) ativo na loja e Exibir cotações no checkout ligada na aba Geral.

Quando o token muda#

Um token novo gerado na SmartEnvios invalida o antigo, e as cotações dela somem da loja. Volte a Gateways de freteSmartEnvios, substitua pelo token novo e salve.

Relacionados#

Atualizado em 25/10/2026 Algo desatualizado nesta página? Avise a equipe