A primeira ativação do plugin gira em torno de três coisas: token da API do Melhor Envio, endereço do remetente e a decisão entre Sandbox (testes) e produção. Tudo fica em WooCommerce → Configurações → Integrações → Melhor Envio.
1. Gere o token no Melhor Envio
- Entre no painel do Melhor Envio em melhorenvio.com.br.
- Vá em Conta → Tokens (ou Configurações → Aplicações, dependendo da versão da plataforma).
- Crie uma nova aplicação. Marque os escopos de shipping e cart (necessários pra cotação, compra e geração de etiqueta).
- Copie o token gerado.
O token costuma expirar depois de algumas semanas, e o tempo de vida varia por conta. Se as cotações pararem de aparecer ou as etiquetas começarem a falhar, o primeiro lugar a checar é se o token ainda é válido. Gere um novo no painel do Melhor Envio e cole aqui.
2. Cole o token no plugin
Em WooCommerce → Configurações → Integrações → Melhor Envio, preencha:
- Token — cole o token gerado.
- Sandbox — deixe desmarcado se a loja já vai operar em produção. Marque apenas pra testar com a sandbox do Melhor Envio (etiquetas geradas no sandbox não são reais).
Salve. Se o token estiver válido, a próxima vez que você abrir uma zona de envio em WooCommerce → Configurações → Entrega já vai listar os métodos disponíveis na sua conta do Melhor Envio.
3. Preencha o endereço do remetente
Mais abaixo na mesma página, Endereço do remetente tem os campos:
- Nome completo (ou razão social).
- CPF/CNPJ.
- E-mail e Telefone.
- Endereço, Número, Complemento, Bairro, Cidade, CEP.
Esses dados vão direto pra etiqueta e pro pré-cadastro do envio no Melhor Envio. Se algum campo estiver errado ou em branco, a geração de etiqueta vai falhar.
O endereço do remetente é o que aparece na etiqueta. Manter exatamente o mesmo da NF evita problemas de auditoria e devolução.
4. Ative o log nos primeiros dias
Marque a opção Log e salve. Os logs ficam em WooCommerce → Status → Logs, com prefixo wc-melhor-envio-. Eles mostram cada cotação, cada etiqueta e cada chamada da API — essencial pra entender qualquer comportamento estranho na primeira semana.
Quando estiver tudo rodando, você pode desligar pra reduzir o volume de arquivos.
5. Entenda o Sandbox
O Sandbox usa um ambiente paralelo do Melhor Envio. As etiquetas geradas no sandbox não despacham nada: servem só pra você verificar o fluxo (cotação → carrinho → checkout → etiqueta → rastreio) sem pagar de verdade.
Importante:
- O token usado em sandbox precisa ser de uma conta sandbox no Melhor Envio (não vale o token de produção).
- Tudo é descartado periodicamente do lado do Melhor Envio. Não use sandbox como histórico.
- Quando passar pra produção, desmarque a opção e troque o token.
Pronto
Com token, sandbox decidido, endereço do remetente preenchido e log ativo, o plugin já consegue cotar fretes. O próximo passo é decidir quais métodos vão ficar disponíveis pros seus clientes — veja configurar métodos de entrega.