# 5.2 Melhor Envio

> Como conectar a conta do Melhor Envio ao Cota Frete por autorização em um clique, ligar os serviços e reconectar quando a autorização cair.

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

---

O **Melhor Envio** é um gateway de frete: uma conta reúne várias transportadoras, sem contrato direto com cada uma. Se a loja já opera pelo Melhor Envio, o Cota Frete conecta essa conta e passa a cotar com as transportadoras disponíveis nela.

O Melhor Envio é o único gateway em que a conexão não usa token. Ela é feita por **autorização**: você entra na sua conta do Melhor Envio e permite que o Cota Frete calcule fretes com os preços dela. Nada para copiar nem colar.

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/).

## Por que autorização em vez de token

Com o token, a loja copia uma chave do painel do gateway e cola no app. Com a autorização, quem confirma o acesso é o próprio Melhor Envio, na tela de login dele. A senha da sua conta nunca passa pelo Cota Frete. O acesso pedido é só o de calcular frete, e você pode revogá-lo pelo painel do Melhor Envio quando quiser.

A contrapartida: a autorização pode cair. Isso acontece quando ela é revogada no Melhor Envio ou quando a conta fica muito tempo sem uso. Nesse caso, é preciso conectar de novo (veja abaixo). Enquanto a conta está em uso, o app renova a autorização sozinho.

## Conectar

![Cartão do Melhor Envio na tela Gateways de frete](https://www.cotafrete.app/manual/images/manual/gateways-melhor-envio.webp)

1. No app, abra **Gateways de frete → Melhor Envio**.
2. Na seção **Integração**, clique em **Conectar com Melhor Envio**. Você vai para o site do Melhor Envio.
3. Entre com a conta da loja, se ainda não estiver conectado, e confirme a autorização do Cota Frete.
4. De volta ao app, a seção **Integração** mostra "Sua conta Melhor Envio está conectada." e a lista de serviços da sua conta.
5. Ligue os serviços que quer oferecer e a chave **Ativo** no topo do cartão.
6. Clique em **Salvar** na barra da Shopify.

Se a aba Geral estiver com **Permitir customização por gateway** ligada, o cartão também pede o **CEP do remetente** do Melhor Envio. Sem a customização, vale o CEP de origem da aba Geral.

## Os serviços

Ao conectar, o Cota Frete lê da sua conta quais serviços estão disponíveis no Melhor Envio e lista exatamente esses em **Serviços do contrato**. Eles começam desligados. Ligue os que devem aparecer na loja. Sem nenhum ligado, o Melhor Envio não cota.

Os preços são os da sua conta, com os acréscimos que você tiver configurado no próprio Melhor Envio. Se quiser somar margem do lado do Cota Frete, use uma regra de [Acréscimo](https://www.cotafrete.app/manual/regras-de-frete/acrescimo/).

## 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 ao Melhor Envio o valor de cada item como valor segurado, e a tarifa passa a incluir o seguro. Desligada, o valor vai zerado.

## Testar

Rode o [Simular frete](https://www.cotafrete.app/manual/inicio/simular-frete/) na tela Início com um produto e um CEP. Depois confira na loja: abra um produto, digite o CEP e compare com o que a sua conta no Melhor Envio cota para o mesmo destino. Os valores vêm da sua conta, então devem bater.

As mesmas cotações aparecem no carrinho e na gaveta. No checkout, aparecem 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.

## Se a conexão cair

Quando a autorização é revogada ou expira, o cartão passa a mostrar **Credenciais inválidas**, e as cotações do Melhor Envio deixam de aparecer na loja. As outras transportadoras e gateways seguem cotando normalmente.

Para resolver, volte a **Gateways de frete → Melhor Envio** e clique em **Conectar com Melhor Envio** de novo. O fluxo é o mesmo da primeira vez. Com a conta conectada, o mesmo botão se chama **Reconectar com Melhor Envio**: serve para refazer a autorização, por exemplo depois de trocar a conta da loja no Melhor Envio. Os serviços que você já tinha ligado continuam ligados, desde que ainda existam na sua conta.

## Relacionados

- [A tela Gateways de frete](https://www.cotafrete.app/manual/gateways-de-frete/tela-gateways/)
- [O gateway não devolve serviços](https://www.cotafrete.app/manual/solucao-de-problemas/gateway-sem-servicos/)
- [Widget na página do produto](https://www.cotafrete.app/manual/widgets-da-loja/pagina-do-produto/)
