Melhor Envio
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.
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#

- No app, abra Gateways de freteMelhor Envio.
- Na seção Integração, clique em Conectar com Melhor Envio. Você vai para o site do Melhor Envio.
- Entre com a conta da loja, se ainda não estiver conectado, e confirme a autorização do Cota Frete.
- 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.
- Ligue os serviços que quer oferecer e a chave Ativo no topo do cartão.
- 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.
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 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 freteMelhor 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.