Atualizado em: 02 de setembro de 2025

Documentação: RP

Rastreio de Pedidos para WooCommerce (WooTatitas) — Guia de Integração para Desenvolvedores

Guia rápido para programadores que desejam usar este plugin como base em seus projetos.

Aviso importante

Este plugin pode mudar funcionalidades sem aviso prévio para acompanhar atualizações do WooCommerce.

Toda customização é de responsabilidade do desenvolvedor. Não edite os arquivos originais do plugin. Faça suas alterações em código externo:

um plugin próprio (preferencialmente must‑use),
um plugin adicional do seu projeto, ou
o functions.php de um tema filho.
Utilize hooks (actions/filters) documentados. Alterações diretas no plugin serão sobrescritas em atualizações.

1) Capacidades funcionais

Consulta pública por shortcode: [rastreio_de_pedidos] — formulário pede ID do pedido e 4 últimos dígitos do celular (faturamento).
Cadastro de múltiplos rastreios por pedido: suporte a várias transportadoras e vários códigos no mesmo pedido.
Exibição para o cliente: status básico do pedido + tabela “Transportadora → Código(s)”.
Sem API obrigatória: os códigos são inseridos no pedido (manual ou programaticamente).
Notas do pedido: ao salvar rastreios no admin, o plugin registra/atualiza nota consolidando os códigos (evita duplicatas).
Proteções: nonce no formulário e rate-limit padrão (20 tentativas/10 min por IP).

2) Escopo de produto

Tipos de produto: simples, variável, virtual/baixável — indiferente. O rastreio é por pedido, não por item.
Pedidos com múltiplos envios: cadastre quantas linhas “transportadora + código” forem necessárias.
Cupons/frete: não há interferência — a consulta apenas lê metadados do pedido.

3) Painel e governança de UI

Metabox no pedido (admin): campos para adicionar/remover transportadoras e seus códigos; salva num único meta.
Configurações → Transportadoras:
Ativar/desativar quais transportadoras aparecem na edição do pedido.
Ação de “recuperar rastreamento”: tenta montar o meta lendo notas recentes do pedido quando o meta estiver vazio.
Logs & sistema: opção para habilitar logs internos e ver checagens básicas de ambiente.

4) Comportamento no front (consulta)

Validação: ID do pedido + conferência dos 4 últimos dígitos do telefone de faturamento.
Resultado: exibe rastreios cadastrados e informações essenciais do pedido.
Erros e limites: mensagens claras para ID/dígitos inválidos e bloqueio temporário quando o rate-limit aciona.

5) Sinais e pontos de integração

Shortcode: [rastreio_de_pedidos] (pode ser chamado direto via do_shortcode em templates/headless).
Armazenamento: metadado único do pedido com a lista de rastreios (array serializado). Chave: _rastreio_info.
Cada entrada contém, no mínimo: slug (id da transportadora), nome (rótulo exibido) e codigo (rastreio).
Governança por nota: ao salvar rastreios, é criada/atualizada uma nota do pedido para auditoria.
Extensibilidade: é simples adicionar um passo automático após mudança de status para preencher _rastreio_info (ex.: integração interna).

6) Logs & debug

Logs opcionais: quando habilitados, ficam em pasta própria dentro do plugin e protegidos por regras do servidor (sem acesso público).
Eventos típicos: submissões do formulário, salvamento de rastreios, ações de “recuperar rastreamento”.

7) Boas práticas de extensão

Idempotência: ao inserir rastreios, evite duplicar entradas (compare slug + codigo).
Sanitização & escape: trate sempre nomes/códigos antes de salvar e ao exibir.
Um único meta: mantenha a fonte de verdade em _rastreio_info para simplificar manutenção e integrações.
Hookar, não substituir: prefira actions/filters do WP/WooCommerce ao sobrescrever templates.
Relatórios/ERP: se integrar, leve _rastreio_info como estrutura própria (não “espalhe” em múltiplos metas/campos).

Como instalar

Veja nosso guia de como instalar nosso plugin:

Compre nosso plugin

Gostou do que viu? Compre o nosso plugin:

Direto ao ponto

Sem enrolação

Comercializamos plugins na esperança de que seja útil, porém, é importante observar que ele é fornecido SEM NENHUMA GARANTIA inclusive sem a garantia implícita de ADEQUAÇÃO A UM DETERMINADO FIM.

Estamos sempre prontos para aprimorar nosso plugin e personalizá-lo de acordo com suas necessidades específicas. Não hesite em nos contatar a qualquer momento, estamos aqui para ajudá-lo.