Melhor Envio: conectar a conta, autorização por loja e reconectar

Conectar o Melhor Envio ao ERP é uma autorização: você entra na sua conta do Melhor Envio e autoriza o sistema a usar essa conta. Você não digita token, chave nem senha em lugar nenhum do ERP. Não existe campo para isso, e o suporte nunca vai pedir uma credencial sua.

ONDE SE CONECTA
Dentro do aplicativo Melhor Envio, pelo card Integrações da tela inicial. A tela que abre se chama Configurações. Enquanto a loja não tem autorização, ela mostra a apresentação da integração e o botão Adicionar integração, que leva você ao Melhor Envio para entrar e autorizar. Ao voltar, o sistema troca o código de autorização pelo acesso e grava o vínculo. A partir daí a mesma tela passa a mostrar Saldo, Informações da integração e Transportadoras vinculadas.

Se o botão Adicionar integração não levar a lugar nenhum, isso é configuração do sistema, não é nada que você tenha feito. Fale com o suporte.

A AUTORIZAÇÃO VALE POR LOJA
O vínculo é gravado por empresa e loja. Cada loja precisa da sua autorização. Autorizar na loja A não conecta a loja B. Com mais de uma loja, troque de loja e repita o processo.

E tem um detalhe que causa muito chamado: a autorização é gravada na loja em que você está logado no momento em que volta do Melhor Envio. Se você trocar de loja no meio do caminho, ela cai na loja errada. Comece e termine na mesma loja.

Em Informações da integração aparece Última atualização. Apesar do nome, essa é a data em que a integração foi cadastrada naquela loja, e ela não muda quando você reconecta. Quem conectou e quem desconectou fica registrado no log do sistema.

O ACESSO SE RENOVA SOZINHO, ATÉ O DIA EM QUE NÃO RENOVA
O acesso tem validade. Quando ele vence, o sistema renova sozinho antes de falar com o Melhor Envio, sem você fazer nada. Quando essa renovação falha, ou quando o acesso é revogado do lado do Melhor Envio, as chamadas passam a voltar como Falha na comunicação com o Melhor Envio.

Isso não se resolve com o tempo nem tentando de novo: cada nova tentativa refaz a renovação e falha do mesmo jeito. Enquanto ninguém reautorizar, continua parado.

A saída é sempre a mesma: autorizar de novo. Nunca é colar token.

COMO REAUTORIZAR
Não existe botão de reautorizar. Enquanto o vínculo estiver ativo, mesmo quebrado, a tela só oferece Desconectar. Então o caminho é: Desconectar, e a tela volta a mostrar Adicionar integração; clique nele e autorize de novo no Melhor Envio.

Isso reativa o mesmo vínculo, e as transportadoras que você já tinha vinculado continuam lá.

O QUE DESCONECTAR FAZ E O QUE NÃO FAZ
A confirmação pergunta se você quer excluir a integração, mas o que acontece é só desativar o vínculo do lado do ERP. Não mexe na sua conta do Melhor Envio, não cancela etiqueta já comprada, não devolve saldo e não apaga os envios já cadastrados.

Enquanto estiver desconectado: as telas de Envios não abrem e devolvem você para as configurações com Esta loja não está integrada ao Melhor Envio; a cotação dentro da venda responde Integração não encontrada; e na loja virtual o Melhor Envio simplesmente não devolve nenhuma opção de frete para o comprador, sem mensagem de erro.

TRÊS CAUSAS COM A MESMA CARA DE NÃO ABRE
Sem o recurso no plano: a tela nem carrega. A mensagem é que o seu plano atual não permite usar a integração com o Melhor Envio, e o sistema leva você para Meu plano. Isso é plano, não é autorização.

Sem permissão: você é devolvido para o Início do Melhor Envio com Você não tem permissão para acessar esta área. Se a tela abriu mas a ação foi barrada, a mensagem é Você não possui permissão para alterar as configurações de integração. Quem cuida da conexão precisa da permissão de gerenciar integrações do aplicativo.

Sem autorização: Esta loja não está integrada ao Melhor Envio. Aqui o plano está certo e a permissão está certa, é a loja que não tem vínculo.

Existe ainda uma quarta situação, parecida mas diferente: Você precisa vincular ao menos uma transportadora ao Melhor Envio, ao cadastrar ou editar um envio. Isso não é falta de autorização, é a etapa seguinte a ela. Pelo mesmo motivo a cotação volta vazia: o sistema só pergunta preço dos serviços que você vinculou.

OS DADOS DO REMETENTE SAEM DO CADASTRO DA LOJA
CEP, CNPJ ou CPF conforme o tipo de pessoa, inscrição estadual, telefone ou celular, e-mail e endereço do remetente vêm do cadastro da loja no ERP, não do Melhor Envio. Corrigir esses dados é no cadastro da loja. Reautorizar não conserta endereço errado.

AMBIENTE DE TESTE
Cada autorização guarda se ela aponta para o ambiente de teste do Melhor Envio ou para o ambiente real, e isso é definido pela configuração do sistema no momento em que você autoriza, não é uma opção da tela. Em ambiente de teste, cotação e etiqueta são de teste e não valem para envio real. Se o frete que aparece está estranho, essa é uma das coisas que o suporte pode conferir.

O QUE COSTUMA DAR ERRADO
Integrei e não funciona: quase sempre a autorização foi feita em outra loja. Confira em qual loja você está logado.

Parou do nada: a renovação do acesso falhou, ou o acesso foi revogado no Melhor Envio. Desconecte e autorize de novo.

Autorizei e caiu na loja errada: trocou de loja durante o processo. Desconecte na loja errada e refaça na loja certa.

Autorizou e continua pedindo transportadora: autorização e vínculo de transportadora são etapas diferentes.

Sumiu a opção Envio no menu da venda: essa opção só aparece quando o recurso Melhor Envio está no plano da loja.

Deu Access token não foi gerado, tente novamente: o retorno do Melhor Envio veio sem acesso. Comece a autorização de novo pelo botão, em vez de atualizar a página do retorno.