# 5.5 SmartEnvios

> Como conectar a SmartEnvios pelo Token Embarcador e por que o CEP de origem precisa ser o mesmo cadastrado na conta SmartEnvios.

Fonte: https://www.cotafrete.app/manual/gateways-de-frete/smartenvios/
Planos: Widget, Basic, Business · no checkout, requer o Carrier Calculated Shipping (CCS) da Shopify
No app: Gateways de frete → SmartEnvios
Atualizado em 25/10/2026

---

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

## 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](https://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](https://www.cotafrete.app/manual/images/manual/gateways-smartenvios.webp)

1. No app, abra **Gateways de frete → SmartEnvios**.
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 gateway | CEP que a SmartEnvios recebe |
|---|---|
| Desligada | O **CEP de origem dos envios** da aba Geral |
| Ligada | O **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](https://www.cotafrete.app/manual/inicio/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 frete → SmartEnvios**, substitua pelo token novo e salve.

## Relacionados

- [A tela Gateways de frete](https://www.cotafrete.app/manual/gateways-de-frete/tela-gateways/)
- [Origem da cotação](https://www.cotafrete.app/manual/como-funciona/origem-da-cotacao/)
- [O gateway não devolve serviços](https://www.cotafrete.app/manual/solucao-de-problemas/gateway-sem-servicos/)