Manual de integração: plataforma WordPress (WooCommerce)

Melhor Envio
Melhor Envio
  • Atualizado

Com o plugin do Melhor Envio para WooCommerce, você centraliza toda a gestão de fretes da sua loja diretamente no painel do WordPress.

A integração conecta sua plataforma de e-commerce ao Melhor Envio para automatizar cotações em tempo real no checkout, emissão e pagamento de etiquetas em lote e rastreamento de envios, tudo sem precisar sair do seu painel para operar

Antes de realizar a integração entre a sua loja e a nossa plataforma, certifique se de possuir:

  • Um cadastro ativo na plataforma do Melhor Envio.

  • O plugin WooCommerce instalado no seu WordPress.

Após atender a estes  critérios, a integração é realizada em 3 etapas simples:

  1. Instalar o plugin "Melhor Envio" no WordPress.

  2. Conectar sua conta via assistente guiado (Wizard).

  3. Configurar os métodos de frete e dimensões dos produtos.

Veja abaixo o passo a passo de cada uma dessas etapas: 


🔷Instalando o plugin "Melhor Envio"

A instalação e a atualização para o novo plugin do Melhor Envio (v3.0) ocorrem de forma simples no painel do WordPress, variando conforme a situação da sua loja: 

Para novos usuários:

  1. Acesse o seu painel administrativo do WordPress.

  2. Na aba lateral esquerda da tela, clique em Plugins > Adicionar Novo.

  3. No campo de busca, pesquise por "Melhor Envio".

    woocommerce.png

  4. Clique em Instalar Agora e, em seguida, em Ativar para ser direcionado automaticamente ao assistente de Onboarding.

Para quem já é usuário da versão anterior :

  1. Acesse o seu painel administrativo do WordPress.

  2. Identifique o banner informativo no topo da tela ou na lista de plugins avisando sobre a nova versão.

  3. Clique no botão "Migrar para a nova versão". Você será direcionado imediatamente ao assistente de Onboarding, com a preservação automática de suas zonas de frete e configurações.

Aviso de Migração e Versão Legada (V1): Caso sua loja já utilize a versão anterior do plugin, ambas funcionarão em paralelo por até 6 meses. O painel exibirá avisos in-app informando a data limite de suporte à versão legada para que você planeje a sua migração com total segurança.


🔷Conectando sua conta e gerando o token de acesso (Wizard)

A conexão com a sua conta do Melhor Envio é realizada via assistente guiado (Wizard) com renovação automática no próprio painel, sem a necessidade de copiar e colar tokens manualmente:

  1. Na barra lateral esquerda do seu WordPress, clique em Melhor Envio.

  2. Entre com o usuário administrador do seu site (o mesmo login do painel WordPress) e, na sequência, o WooCommerce lista as permissões solicitadas pelo Melhor Envio. Clique em Aprovar.

  3. Você será redirecionado para a tela de login do Melhor Envio. Se você já usava o plugin antigo, basta informar o e-mail e a senha da sua conta e clicar em Acessar. Se ainda não tem conta, use a opção Cadastre-se agora e complete o fluxo de cadastro.

  4. O seu Token de Integração será vinculado automaticamente ao plugin no WordPress.

  5. Ajuste as configurações gerais do plugin:

    • Endereço do Remetente: selecione qual endereço cadastrado no Melhor Envio será utilizado como origem dos envios.

    • Agências de preferência: escolha as agências padrão para postagens da Jadlog e Azul Cargo.

    • Serviços adicionais: defina se deseja contratar serviços adicionais padrão como Mão Própria (MP), Aviso de Recebimento (AR) ou Seguro de Carga para as suas cotações.

 

⚠️ IMPORTANTE: Regras de segurança e liberação de IPs

Mudamos a forma como o plugin se comunica com a sua loja: agora, o Melhor Envio faz requisições diretas para o seu site.

Caso enfrente algum erro no processo de integração ou no cálculo de frete, consulte o artigo Bloqueio do Firewall na CloudFlare para realizar a liberação do seu servidor.


🔷Configurando as opções de frete

Depois de conectar a sua conta, a configuração do frete na sua loja é realizada diretamente no painel do Melhor Envio, sem a necessidade de cadastrar áreas ou métodos manualmente nas configurações nativas do WooCommerce.

A gestão é centralizada no próprio plugin através dos dois ícones de atalho localizados no canto superior direito do cabeçalho:

  1. Acesse WooCommerce > Melhor Envio na barra lateral do seu WordPress.

  2. Clique no ícone de Engrenagem (⚙️) no canto superior direito para acessar a tela de Configurações Gerais. Nela você ajusta todos os parâmetros operacionais de frete da sua loja:

Nela você ajusta todos os parâmetros operacionais de frete da sua loja: 

  • Informações da Loja e Inscrição Estadual: confira os dados cadastrais pré-preenchidos e informe sua Inscrição Estadual (ou deixe em branco caso seja isento). 

  • Transportadoras Ativas: ative ou desative as transportadoras e modalidades que deseja disponibilizar na sua loja (Azul Cargo Express, Buslog, Correios, J&T Express, Jadlog, LATAM Cargo, Loggi e Total Express). 

  • Seleção de Agências: defina a agência padrão de postagem para transportadoras como Jadlog e Azul Cargo. 

  • Serviços Adicionais e Seguro: configure Aviso de Recebimento (AR), Mão Própria (MP) e o modelo de seguro aplicado automaticamente aos seus envios. 

  • Substituição de Frete: defina a regra para pedidos importados com frete grátis ou taxa fixa, permitindo que o plugin substitua pelo serviço do Melhor Envio priorizando o menor preço ou o menor prazo. 

  • Oferta Inteligente (Expresso e Econômico): se desejar, ative a exibição simplificada no checkout agrupando os fretes nas opções mais rápida (Expresso) e mais barata (Econômico). 

  • Prazo Adicional: adicione dias extras de manuseio ao frete do checkout. 

  • Regras de Frete Personalizadas: configure até 5 regras de desconto ou frete grátis condicional (por valor de carrinho ou cupom). 

  1. Clique em Salvar Alterações no canto inferior direito.

Pronto! Os métodos ativados passarão a ser exibidos automaticamente no carrinho e no checkout do seu cliente.

Posicionamento da Calculadora de Frete (Tela WooCommerce Ⓦ)

(Observação: a configuração da calculadora não fica na engrenagem, mas sim na segunda tela do cabeçalho)

Para configurar a exibição e o posicionamento da calculadora de cotação na página do produto:

  1. No cabeçalho do plugin, clique no ícone do WooCommerce (Ⓦ) ao lado da engrenagem.

  2. Ative a opção Calculadora de frete e selecione onde ela deve aparecer na página do produto (ex: "Antes da descrição do produto").  

  3. Clique em Salvar Alterações.


🔷Configurando os produtos

Esta integração precisa de valores mínimos de peso e dimensões para uma cotação correta.

Os seus produtos deverão pesar pelo menos 100 gramas e medir ao menos 1 cm em cada uma das dimensões.

Caso sejam informados pesos e dimensões inferiores, a cotação não será feita corretamente.

Para garantir que as cotações de frete dos seus envios sejam feitas corretamente garanta que seus produtos contem as dimensões mínimas.

Para isso:

  1. Acesse o seu painel administrativo do WordPress

  2. Na aba lateral esquerda da tela, encontre a opção "Produtos"

  3. Clique em "Todos os produtos"

  4. Escolha um dos seus produtos

  5. No campo "Dados do produto" clique na opção "Entrega"

  6. Verifique se o peso está superior a 100 gramas e se as dimensões são iguais ou superiores a 1 cm. Caso o produto apresente peso e dimensões superiores aos citados anteriormente não haverá necessidade de alteração. Contudo, caso estes campos não estejam preenchidos ou apresentem valores inferiores aos supracitados, faça a alteração de modo a respeitar a regra de peso e medidas mínimas

  7. Se você alterou algum valor, clique em "Atualizar"

  8. Pronto!

 

🔷 Gerenciamento de envios, compra em lote e etiquetas

Todo o gerenciamento operacional de envios é realizado na aba Melhor Envio > Pedidos dentro do painel do WordPress:

  • Geração de etiquetas com 1 clique: emita a etiqueta de um pedido individual diretamente na lista de vendas com apenas um clique.

  • Compra automatizada com pausa inteligente: ative a compra automática para novos pedidos pagos. O sistema realiza uma pausa inteligente e avisa o lojista caso o saldo em carteira atinja o limite.

  • Alerta de saldo baixo: receba notificações visuais no painel informando quando o saldo em carteira estiver baixo para a realização de novas compras de etiquetas.

  • Compra de etiquetas em lote (Sacola): selecione até 100 pedidos de uma só vez e adicione à Sacola para cotar, pagar e emitir em lote.

  • Pagamento de etiquetas via PIX e cartão (Vindi): opção de pagamento direto das etiquetas de frete utilizando PIX ou Cartão de Crédito no momento da emissão. 

  • Impressão de etiquetas e romaneio: geração integrada de etiquetas e romaneios de postagem.

  • Declaração de conteúdo preenchida automaticamente e geração de romaneio: preenchimento automático dos dados do pedido do WooCommerce na declaração.

  • Importação de XML para preenchimento da chave NF: importação do arquivo XML da nota fiscal para preenchimento automático da chave de acesso nos envios.

  • Logística reversa pontual (Correios): emissão de etiquetas de logística reversa para trocas e devoluções.


🔷Rastreamento, Pós-Venda, Status Customizados e Dashboard 

O fluxo pós-venda é automatizado na tabela de pedidos e os indicadores de desempenho são centralizados na tela inicial do plugin:

  • Rastreamento automático: assim que a etiqueta é gerada, o código de rastreio é inserido automaticamente nos detalhes do pedido no WooCommerce com link direto para o Melhor Rastreio, atualizando o status para o comprador sem necessidade de cópia manual.

  • Status customizados: personalize e faça o mapeamento de quais status do WooCommerce devem corresponder a cada etapa do envio no plugin.

  • Atendimento em 1 clique: utilize os botões de ação rápida na própria lista de pedidos para solicitar o cancelamento da etiqueta com estorno ou abrir chamados de suporte por atraso, avaria ou extravio.

  • Dashboard de indicadores: acompanhe métricas estratégicas diretamente no painel, como tempo médio de entrega, ranking das transportadoras mais utilizadas e mapa de calor dos envios por região. 


🔷 Financeiro e Gestão de Saldo

As movimentações da carteira, opções de pagamento e relatórios de custos do plugin estão agrupados nos seguintes recursos: 

  • Alerta de saldo baixo: notificações informando quando o saldo em carteira estiver insuficiente para novas compras de etiquetas. 

  • Inserção de saldo na carteira via PIX e cartão (Vindi): adicione créditos à sua utilizando PIX ou Cartão de Crédito. 

  • Saque de saldo na carteira:solicitação de transferência do saldo disponível na plataforma para a sua conta bancária de mesma titularidade. 

  • Extrato de divergências de peso/dimensão: solicitação de transferência do saldo disponível para a sua conta bancária de mesma titularidade. 

  • Exportação contábil de gastos com frete: geração de relatórios de frete para controle contábil e financeiro.


🔷Manual de integração com o WordPress (WooCommerce) em vídeo

Caso prefira, você pode conferir as instruções completas para integrar a sua loja WooCommerce ao Melhor Envio em vídeo a seguir: 

Você encontra este e outros conteúdos no nosso canal do YouTube.
 


🔷Mais informações

Caso você tenha dúvidas sobre outras etapas da nossa integração com o WooCommerce sugerimos a leituras dos artigos 📃Manual WooCommerce: como realizar o pagamento dos meus envios?, 📃Bloqueio do Firewall na CloudFlare e 📃Manual WooCommerce: como imprimir sua etiqueta de envio.