Melhor Envio no ERP: visão geral, cotar frete na venda e o frete na loja virtual

O Melhor Envio é um aplicativo à parte dentro do ERP. Com ele você cota frete com várias transportadoras, cadastra o envio, paga a etiqueta com o saldo da sua conta no Melhor Envio e acompanha o rastreio sem sair do sistema. Esta fonte é o mapa da área: o que o aplicativo é, o que ele faz DENTRO da venda e o que acontece na loja virtual. Cada assunto com fonte própria está apontado no fim.

O MENU DO APLICATIVO
O aplicativo fica em Meus aplicativos › Melhor Envio e tem menu próprio: Início, Envios, Configurações (com Integrações e Usuários) e Sistema ERP, que devolve você ao ERP.

O QUE PRECISA ESTAR PRONTO ANTES
A lista é fechada, e é mais ou menos nessa ordem que as coisas travam:
Conta própria no Melhor Envio. O ERP não abre a conta por você.
O Melhor Envio liberado no plano daquela loja.
A conta autorizada no ERP, por empresa e por loja.
Pelo menos uma transportadora do Melhor Envio vinculada a uma transportadora do ERP. Sem nenhum vínculo o sistema nem deixa cadastrar envio.
Saldo na conta do Melhor Envio, porque a etiqueta é comprada no momento em que o envio é pago. A recarga pode ser feita pelo próprio ERP, por Pix.
Peso e dimensões dos produtos. Você pode digitá-los na hora da cotação, mas tê-los no cadastro evita retrabalho.

COTAR O FRETE DENTRO DA VENDA
No cadastro da venda, no bloco Transporte, ao lado do campo Valor do frete existe um botão de calculadora. É ele que abre a cotação.

Esse botão só aparece quando quatro coisas são verdade ao mesmo tempo. A lista é fechada:
o usuário tem a permissão de adicionar envio, que é a mesma que libera cotar;
a LOJA em que você está logado tem CEP preenchido, e é esse o CEP de origem;
a venda tem cliente OU um endereço com CEP de destino;
a venda tem pelo menos um item do tipo produto. Venda só de serviço não cota frete.

É essa lista que responde o "sumiu o botão de cotar frete".

MONTE O PACOTE ANTES DE VER O PREÇO
Vindo da venda, a cotação abre já na etapa "Monte o pacote para cotação". O sistema busca peso, largura, altura e comprimento no cadastro de cada produto e preenche os campos; você confere e corrige ali mesmo, sem voltar ao produto.

Só dá para seguir com os quatro campos preenchidos e maiores que zero em todos os produtos. Produto que não vai no pacote pode ser removido da cotação, e pelo menos um precisa ficar.

Os produtos viram UM ÚNICO pacote: peso, altura, largura e comprimento de cada item são multiplicados pela quantidade e somados entre si. É soma, não empilhamento. Por isso vale conferir o resultado quando a venda tem muitos itens.

O que você digitar fica guardado enquanto a venda está aberta: reabrir a cotação traz os mesmos valores.

A UNIDADE É METRO, E ESSE É O ERRO MAIS COMUM
Em Itens › Produtos, aba Detalhes, bloco "Pesos e dimensões", os campos são Peso (kg), Largura (m), Altura (m) e Comprimento (m).

As medidas são pedidas em METROS. Quem digita centímetros manda um pacote gigante para a plataforma, e o frete sai absurdo ou a transportadora recusa. O sistema converte metros para centímetros ao consultar o Melhor Envio; ele não adivinha a unidade que você usou.

A TELA DA COTAÇÃO
A lista traz só os serviços vinculados na tela de transportadoras do aplicativo. Serviço não vinculado nunca entra no cálculo. Cada linha mostra a transportadora, o serviço, o prazo e o valor; você marca uma e confirma.

Linha marcada em vermelho, com uma mensagem no lugar do preço, é recusa da própria transportadora para aquele pacote e aquele CEP, quase sempre por peso ou medida fora do limite dela. Essa linha não pode ser selecionada.

No lugar da lista podem aparecer estas mensagens: "CEP de origem não informado.", "CEP de destino não informado ou entidade sem endereço cadastrado.", "Produtos não informados.", "CEP de origem não encontrado, verifique o endereço da sua loja." e "CEP de destino não encontrado."

CONFIRMAR A COTAÇÃO JÁ COMPROMETE A VENDA
Ao confirmar, o sistema preenche sozinho o Valor do frete e a Transportadora da venda e, além disso, marca a venda para gerar o envio.

Quando você salvar a venda, o envio é criado automaticamente no Melhor Envio, com os dados da venda e o pacote que você montou. Ele nasce apenas cadastrado: não está pago, e a etiqueta não sai só por isso.

Se você apagar a transportadora do campo depois de cotar, a venda deixa de gerar o envio.

Uma venda só entra em UM envio. Tentar gerar de novo responde "Pedido já inserido em um envio." Para refazer, exclua o envio antes.

NA LISTAGEM DE VENDAS
Enquanto a venda não tem envio, o menu de ações da linha mostra a opção Envio, que abre o cadastro de envio já com os dados daquela venda.

Depois que o envio existe, a venda passa a mostrar um ícone de caminhão com a legenda "Envio via Melhor Envio", e o menu ganha "Ver no Melhor Envio", que abre o envio.

ENVIO SEM VENDA
Nem todo envio precisa nascer de uma venda. Na tela Envios do aplicativo você cadastra um envio do zero, e o destinatário pode ser um cliente ou um fornecedor.

O MELHOR ENVIO NA LOJA VIRTUAL
Na loja virtual o Melhor Envio é um meio de envio, e a cotação aparece para o comprador no checkout. Para ela aparecer, tudo isto precisa ser verdade ao mesmo tempo. A lista é fechada:
o Melhor Envio liberado no plano daquela loja;
o meio de envio do Melhor Envio ativo na loja;
a integração do Melhor Envio ativa, a mesma autorização usada pelo aplicativo;
a loja com CEP cadastrado;
o produto com peso, altura, largura e comprimento maiores que zero;
o CEP de destino informado pelo comprador.

Aqui está a armadilha. Quando qualquer uma dessas condições falha, o Melhor Envio simplesmente NÃO aparece no checkout. Não há mensagem de erro para o comprador nem para você, e o restante do checkout continua funcionando. Sumir em silêncio é o comportamento normal, então o diagnóstico é percorrer a lista acima, não procurar um aviso.

Ainda no checkout, o sistema só oferece serviços cujo vínculo aponta para uma transportadora do ERP ativa. Serviço vinculado a transportadora inativa, serviço que voltou com erro e serviço que voltou sem preço são descartados de propósito, para não ofertar frete grátis por engano. O nome exibido é o nome gravado no vínculo.

A cotação do checkout ainda fica um tempo em cache, por loja, CEP de destino e pacote. Depois de corrigir uma configuração, a mesma consulta pode continuar respondendo o resultado antigo por um período.

O QUE É DO MELHOR ENVIO, NÃO DO ERP
Preço do frete, prazo, quais transportadoras e serviços existem, regras de postagem, o crédito do saldo e o aceite do cancelamento são da plataforma. O ERP mostra e repassa o que ela devolve.

Cadastro de produto, de transportadora e de cliente, e a venda em si, são do ERP e se respondem pelas fontes do ERP.

ONDE ESTÁ CADA ASSUNTO
Conectar a conta, autorização por loja e reconectar: fonte de conexão do Melhor Envio.
Vincular transportadoras e escolher agência: fonte de transportadoras vinculadas.
Cadastrar o envio, pacotes e volumes e os erros que barram a etiqueta: fonte de cadastro do envio.
Saldo, recarga por Pix e enviar sem saldo: fonte de saldo.
Situações do envio, rastreio, imprimir e cancelar etiqueta: fonte de situações do envio.
Quem pode cotar, gerar, pagar e imprimir: fonte de permissões do Melhor Envio.

O QUE COSTUMA DAR ERRADO
Frete absurdo ou transportadora recusando: medidas digitadas em centímetros num campo que pede metros.
Botão de cotar sumiu: quase sempre CEP da loja em branco, venda sem produto, ou venda sem cliente e sem CEP. Permissão vem depois disso.
Cotação vazia: nenhum serviço vinculado, ou nenhum dos vinculados atende aquele trecho.
Envio não foi criado ao salvar a venda: a cotação não foi confirmada, ou a transportadora foi apagada do campo depois de cotar.
"Pedido já inserido em um envio.": aquela venda já tem envio.
Melhor Envio não aparece no checkout da loja: percorra a lista fechada de condições, porque ele some sem avisar.
Etiqueta não sai: o envio precisa ser pago, e o pagamento consome o saldo da conta no Melhor Envio.