Número de seguimento no e-mail Enviado: guia completo
Adicione a transportadora, o número de seguimento e um botão de seguimento ao e-mail Enviado, retenha-o até o número ser introduzido e mostre um cartão de seguimento na conta do cliente.
Visão geral
O Número de seguimento no e-mail Enviado adiciona um bloco Acompanhe a sua encomenda ao e-mail Enviado do PrestaShop: a transportadora, o número de seguimento e um botão que abre a página de seguimento da transportadora. O bloco é redigido no idioma da encomenda e inserido durante o envio do e-mail: os seus modelos de e-mail nunca são alterados.
O módulo também pode reter o e-mail Enviado quando uma encomenda é marcada como enviada antes de o número de seguimento ser introduzido, e enviá-lo assim que o número for guardado. Mostra um cartão de seguimento na conta do cliente e disponibiliza uma pré-visualização em direto, um e-mail de teste, uma fila e um registo de atividade.
Funciona no PrestaShop 1.7.8 a 9.x com PHP 7.1 a 8.5, em Classic, Hummingbird e nos respetivos temas filho. O back office e os textos predefinidos estão disponíveis em inglês, francês, espanhol, alemão, italiano, polaco, neerlandês e português.

Instalação e atualização
- Em Módulos > Gestor de Módulos, clique em Carregar um módulo e largue o ficheiro
dftrackingmail-2.0.0.zip. - Clique em Configurar. O módulo já está ativo no e-mail Enviado, com textos predefinidos em todos os idiomas instalados.
Uma mensagem de boas-vindas indica os três pontos a verificar: os links de seguimento das suas transportadoras, as cores do bloco e um e-mail de teste.
Atualização a partir da 1.0: carregue o novo zip por cima do antigo. As suas definições, textos, cores, links das transportadoras e e-mails retidos são mantidos. O cartão da conta do cliente começa desativado, por isso nada muda na sua loja até o ativar.
Definições
Ativação
- Adicionar os dados de seguimento aos e-mails: desativado, todos os e-mails são enviados exatamente como o PrestaShop os gera.
- Mostrar um cartão de seguimento na conta do cliente: na página de detalhes da encomenda e na página de seguimento para visitantes.
E-mails que mostram o número de seguimento
O estado Enviado predefinido envia o e-mail shipped, selecionado por predefinição. Cada estado de encomenda que envia um e-mail é listado com o respetivo modelo, pelo que pode adicionar estados personalizados ou o e-mail in_transit.
Dados e privacidade
Escolha durante quanto tempo o registo de atividade e os e-mails enviados são conservados (90 dias por predefinição). A cópia de um e-mail retido é eliminada assim que este é enviado ou cancelado. Com o módulo oficial de RGPD, os dados do cliente são exportados e eliminados com o resto da conta.

Reter o e-mail até o número de seguimento ser introduzido
Se mudar o estado para Enviado antes de imprimir a etiqueta, o e-mail predefinido é enviado sem qualquer número. Ative Reter o e-mail: o e-mail Enviado aguarda então numa fila e é enviado assim que o número de seguimento for guardado, na página da encomenda ou por um módulo de transportadora.
- Enviar mesmo assim após: o e-mail é enviado sem número (ou com a mensagem de espera) após este prazo, 48 horas por predefinição.
- E-mail Em trânsito: o PrestaShop envia-o quando é introduzido um número de seguimento. Por predefinição, é ignorado quando o e-mail Enviado retido acabou de ser enviado, para que o cliente receba um único e-mail completo em vez de dois.
- Só são retidas as transportadoras com Número de seguimento previsto assinalado no separador Transportadoras. O levantamento na loja e as outras transportadoras sem seguimento nunca são retidos.
Na página da encomenda, um cartão mostra os números que o cliente verá, o estado do e-mail retido e duas ações: Enviar agora sem número de seguimento e Não enviar.

Tarefa cron
A tarefa cron só é necessária com a retenção ativada. Execute-a a cada 15 minutos: envia os e-mails retidos cujo número foi escrito por um módulo de transportadora, ou cujo prazo terminou, e elimina as entradas antigas. Copie o URL no separador Definições (funciona em modo de manutenção) ou use a linha de comandos:
php /path/to/prestashop/modules/dftrackingmail/cli/process-queue.php
Gerar um novo URL invalida o anterior.
E-mail e textos
Posição no e-mail
- Após a referência da encomenda (recomendado): logo a seguir à frase que indica a referência da encomenda.
- Logo após a saudação: visto primeiro.
- Manual: o bloco só aparece onde o seu modelo contém
{df_tracking_block}.
Estilo e cores
Escolha um estilo cartão, barra de destaque ou minimalista e, depois, as cores do fundo, do contorno, do botão e do texto do botão. O contraste do botão é verificado em direto: abaixo de 4.5:1, o texto é difícil de ler e é mostrado um aviso.
Conteúdo e textos
Mostre ou oculte o nome da transportadora e o botão de seguimento, e escolha o que acontece quando a encomenda ainda não tem número de seguimento: ocultar o bloco ou mostrar a mensagem de espera. Os textos são editados por idioma: título, introdução, rótulos da transportadora e do número, texto do botão, mensagem de espera e rótulo do pacote. A introdução aceita {firstname}, {lastname}, {order_name}, {carrier_name} e {tracking_number}; o rótulo do pacote aceita {n} e {total}.
A pré-visualização em direto, à direita, acompanha as suas alterações antes de guardar, no idioma selecionado para os textos, num computador ou num telemóvel.

Transportadoras e links de seguimento
O botão de seguimento usa o URL de seguimento definido em Envio > Transportadoras. Preencha o campo de uma transportadora para o substituir apenas nos e-mails. Coloque {tracking_number} (ou @, a sintaxe do PrestaShop) no lugar do número; {postcode} e {country_iso} são preenchidos a partir da morada de entrega para as transportadoras que precisam deles.
- Aparece uma sugestão quando o nome da transportadora é reconhecido; Outras transportadoras lista 21 links de seguimento (Colissimo, Chronopost, Mondial Relay, DPD, GLS, UPS, FedEx, DHL, PostNL, bpost, Correos, SEUR, CTT, Poste Italiane, BRT, InPost, Poczta Polska, Royal Mail, USPS, 17TRACK).
- Testar abre o link com um número de exemplo.
- Número de seguimento previsto: desmarque as transportadoras que nunca têm número. O seu e-mail nunca é retido e não são contadas como sem link.
Teste cada link uma vez com um número real: as transportadoras por vezes mudam o endereço da sua página de seguimento.

Pré-visualização e teste
O separador Pré-visualização e teste mostra o e-mail completo, gerado a partir dos modelos da sua loja: com dados de exemplo fictícios (um pacote, dois pacotes ou ainda sem número) ou com uma encomenda recente. Escolha o idioma e o e-mail e alterne entre a versão HTML, a versão texto e a vista em telemóvel.
Enviar um e-mail de teste envia o e-mail selecionado para o endereço que introduzir, com [Teste] no assunto. O cliente não recebe nada. O teste utiliza as definições guardadas.

O que os seus clientes recebem
O bloco mostra a transportadora, o número de seguimento numa fonte legível e o botão de seguimento. Quando uma encomenda tem vários pacotes, cada um é numerado com o seu próprio botão. A versão texto do e-mail contém as mesmas informações.


Conta do cliente
Com a opção ativada, a página de detalhes da encomenda e a página de seguimento para visitantes mostram um cartão de seguimento com a transportadora, o número, um botão Copiar e o botão de seguimento. O cartão usa os textos do bloco e adapta-se a Classic, Hummingbird e aos respetivos temas filho.


Fila e atividade
O separador Fila e atividade lista os e-mails retidos, com filtros por estado (retido, enviado, falhado, cancelado). Enviar agora e Não enviar atuam sobre um e-mail; Processar a fila agora executa de imediato a tarefa cron. Um e-mail falhado é reenviado automaticamente três vezes e o motivo é mostrado.
O registo de atividade regista cada e-mail: seguimento adicionado, enviado sem número, retido, e-mail retido enviado, e-mail Em trânsito ignorado, e-mail de teste.

Posição manual e variáveis
Com a posição manual, adicione estas variáveis ao seu modelo de e-mail (Design > Tema de e-mail, a pasta mails do seu tema ou um módulo de edição de e-mails):
{df_tracking_block}: o bloco completo, versão HTML.{df_tracking_block_txt}: o bloco completo, versão texto.{df_tracking_number}: o número ou os números de seguimento, separados por vírgulas.{df_tracking_url}: o link de seguimento do primeiro pacote.{df_carrier_name}: o nome ou os nomes da transportadora.

Resolução de problemas
O cliente recebeu o e-mail sem número de seguimento
A encomenda passou a Enviado antes de o número ser introduzido. Ative a retenção no separador Definições. A tabela Atividade mostra cada e-mail com ou sem número.
O botão de seguimento não aparece
A transportadora não tem um link de seguimento utilizável. Abra o separador Transportadoras, use uma sugestão ou cole o link da transportadora e clique em Testar.
Os e-mails retidos não são enviados
O número foi escrito por um módulo de transportadora, ou o prazo terminou, mas a tarefa cron não é executada. O separador Visão geral mostra um aviso quando esta não é executada há mais de 2 horas. Configure-a com o URL ou a linha de comandos, ou clique em Processar a fila agora.
O e-mail está no idioma errado
O e-mail usa o idioma da encomenda. Se o PrestaShop não tiver modelo neste idioma, envia o idioma predefinido: a pré-visualização indica-lhe que versão é usada.