WP Manifestindependent plugin directory
manifest / ecommerce / wc-rastreio-frenet-plugin

WC Rastreio Frenet

Plugin para WooCommerce que automatiza a gestão de rastreio via Frenet. Adiciona campos de rastreio nos pedidos, detecta automaticamente a transportadora (Correios/Loggi) e envia e-mails de acompanhamento aos clientes. Compatível com HPOS.

by Frederico de Castro · github.com/fredpiuma/wc-rastreio-frenet-plugin · website

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/fredpiuma/wc-rastreio-frenet-plugin/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/fredpiuma/wc-rastreio-frenet-plugin ↗

Plugin para WooCommerce que adiciona campo de código de rastreio nos pedidos e envia automaticamente um e-mail ao cliente com o link de acompanhamento via Frenet.

Funcionalidades

  • Metabox "Rastreio Frenet" na tela de edição do pedido no painel administrativo
  • Botão de rastreio integrado às páginas de pedidos no front-end (Minha Conta e Shortcode de Rastreamento)
  • Detecção automática da transportadora pelo padrão do código de rastreio:
    • Correios — formato AA000000000AA (ex: AB123456789BR) → https://rastreio.frenet.com.br/COR/
    • Loggi — 8 caracteres alfanuméricos (ex: NSWC7NR6) → https://rastreio.frenet.com.br/LOG/
    • J&T Standard — 15 dígitos numéricos (ex: 888030733163445) → https://rastreio.frenet.com.br/JTE/
  • E-mail automático ao cliente quando o código é adicionado ou atualizado
  • Formatação automática do código (maiúsculas, remoção de espaços)
  • Página de configurações em WooCommerce → Rastreio Frenet com o modo de rastreio: link externo da Frenet ou embutido no próprio site
  • Shortcode [rastreio_frenet_cpf] — página de rastreio por CPF
  • Compatível com HPOS (High-Performance Order Storage) do WooCommerce

Requisitos

  • WordPress 5.6 ou superior
  • PHP 7.4 ou superior
  • WooCommerce ativo

Instalação

  1. Copie a pasta wc-rastreio-frenet para o diretório wp-content/plugins/ do seu WordPress
  2. Ative o plugin em Plugins → Plugins instalados

Como usar

  1. Acesse um pedido em WooCommerce → Pedidos
  2. No painel lateral, localize a metabox Rastreio Frenet
  3. Insira o código de rastreio e salve o pedido
  4. O cliente receberá automaticamente um e-mail com o código e o link de rastreamento

O e-mail só é disparado quando o código é inserido pela primeira vez ou alterado.

Rastreio por CPF (shortcode)

Insira o shortcode [rastreio_frenet_cpf] em qualquer página. O cliente informa o CPF e o plugin busca os pedidos em seu nome dos últimos 60 dias, do mais recente para o mais antigo, consultando o link de rastreio da Frenet de cada um.

O loop para no primeiro pedido já entregue — ou seja, se o pedido mais recente já foi entregue, apenas ele é exibido; se ainda não, os pedidos seguintes também são mostrados até encontrar um entregue.

De cada consulta são exibidos apenas os blocos .tracking-result-header e .tracking-result-timeline da página da Frenet. O resultado é armazenado em cache (transient) por 30 minutos.

Pedidos que ainda não têm código de rastreio exibem uma mensagem com o status do pedido em vez do card de rastreio — por exemplo, "Seu pedido #1234 está aguardando pagamento." ou "Seu pedido #1234 teve o pagamento confirmado e está em separação para envio." — e a busca continua pelos pedidos seguintes.

Configuração

Em WooCommerce → Rastreio Frenet:

  • Modo de rastreio — quando desmarcado, o botão de rastreio abre o link externo da Frenet; quando marcado, o andamento da entrega é exibido embutido no site

Configuração do E-mail

O template do e-mail pode ser configurado em WooCommerce → Configurações → E-mails → Código de Rastreio Frenet, onde é possível personalizar assunto, título e formato (HTML, texto simples ou multipart).

Autor

Frederico de Castro https://www.fredericodecastro.com.br/links

Licença

GPL-2.0-or-later