A geração de etiqueta acontece em dois lugares: dentro do pedido (metabox) ou em massa pelo painel de etiquetas. Os dois caminhos chamam a mesma rotina — compram o frete no Melhor Envio e devolvem o link de impressão.
Pelo metabox do pedido
Abra qualquer pedido em WooCommerce → Pedidos. Na barra lateral direita aparece o metabox Etiquetas Melhor Envio.
Antes de gerar:
- O pedido precisa estar num dos status configurados em Status para gerar etiquetas (em Configurações → Integrações → Melhor Envio). O padrão é Processando.
- O método de envio do pedido precisa ser do Melhor Envio. Se for outro método (taxa fixa, frete grátis), você pode forçar a etiqueta adicionando um meta
melhorenvio_method_idno item de envio com o ID do serviço (1PAC,2Sedex, etc).
Ao clicar Gerar etiqueta, o plugin:
- Adiciona o pedido ao carrinho do Melhor Envio.
- Faz checkout (compra o frete).
- Gera a etiqueta.
- Mostra o botão Imprimir no metabox.
A geração é assíncrona — pode levar alguns segundos pela API.
Sobrescrever o serviço por pedido
No metabox tem um campo pra escolher um serviço diferente do que o cliente selecionou no checkout. Use quando o cliente paga PAC mas você quer despachar como Sedex (ou vice-versa). O ID escolhido é gravado em _order_me_custom_service_id e tem prioridade sobre o método original.
Anexar nota fiscal
O metabox tem um campo Nº da nota fiscal. Ele é exigido pelo Melhor Envio nas transportadoras privadas (todas menos Correios) — sem NF, a etiqueta volta com erro.
Se você usa Bling ou Webmania pra emissão, o plugin importa a NF automaticamente. Veja importar nota fiscal.
Pra envios sem NF (amostras, brindes), o Melhor Envio aceita marcar como não-comercial. O plugin já envia tudo como não-comercial por padrão, então amostras passam mesmo sem NF.
Apagar dados da etiqueta
O link Excluir dados no metabox apaga todos os meta da etiqueta no pedido (item ID, protocolo, URL de impressão, rastreio). Não cancela a etiqueta no Melhor Envio — pra isso você precisa cancelar lá também, senão pode dar conflito na impressão.
Se você cancela a etiqueta no painel do Melhor Envio, lembre de excluir os dados no plugin. E se exclui no plugin, lembre de cancelar no Melhor Envio. Manter os dois sincronizados evita erro de "etiqueta já gerada" na próxima tentativa.
Pelo painel de etiquetas
Em WooCommerce → Melhor Envio abre o painel de etiquetas: uma tabela com todos os pedidos que têm método Melhor Envio, com colunas pra status da etiqueta, protocolo e ações rápidas. É a maneira mais eficiente quando você processa dezenas de pedidos por dia, porque dispensa abrir um por um.
A partir da v2.0.4 a tabela é paginada e exclui pedidos de reembolso (que não geram etiqueta).
Modo "apenas adicionar ao carrinho"
Se você prefere finalizar o frete direto no painel do Melhor Envio (porque escolhe pacote, embalagem ou seguro caso a caso), ative Apenas adicionar ao carrinho na página de integração. Nesse modo:
- O plugin adiciona o pedido ao carrinho do Melhor Envio mas não compra.
- Você finaliza no Melhor Envio.
- A etiqueta gerada lá é importada de volta pelo cron, junto com o rastreio.
Combine com:
- Adicionar ao carrinho automaticamente — gatilho pra que pedidos em determinado status vão pro carrinho sem clique manual.
- Status para atualizar após adicionar ao carrinho — pra qual status mover o pedido depois do envio pro carrinho.
O status definido em Status para atualizar após adicionar ao carrinho precisa estar incluído em Status para monitorar. Senão o cron nunca olha esses pedidos e o rastreio nunca é importado. Veja status do pedido.
Permissões
Por padrão, qualquer usuário com manage_woocommerce pode gerar etiqueta. Pra restringir (por exemplo, só gerentes), use o filtro wc_melhor_envio_can_request_label. Veja filtros.
Próximos passos
- Rastreamento automático — como o código de rastreio é importado e como o cliente é notificado.
- Status do pedido — mapeamento dos status que o pedido vai assumir ao longo do envio.