PrestaShop Contabilidade & Faturação

Personalizar a Fatura PDF do PrestaShop 8 e 9 sem Editar Templates TPL

A sua fatura PDF à sua maneira, definida no back-office.

Alterar a fatura do PrestaShop significa hoje abrir invoice.tpl, header.tpl e os respetivos subficheiros, copiá-los para o tema, corrigir às cegas o HTML do TCPDF e recomeçar a cada atualização. Para acrescentar a menção de isenção de IVA apenas aos clientes europeus com número de IVA, é ainda preciso programar uma condição. Este módulo substitui tudo isso por um editor no back-office: logótipo, cores, colunas das linhas de produtos, campos personalizados, menções legais por país, data de vencimento, dados bancários com código QR SEPA. A pré-visualização abre uma fatura real da loja com as definições do ecrã, mesmo antes de guardar. Os ficheiros .tpl ficam intactos e a fatura nativa volta com um interruptor.

At a glance
  • Logótipo, cores, tipo de letra e cabeçalho sem abrir um único ficheiro .tpl
  • 12 colunas das linhas de produtos para marcar, ordenar e dimensionar, títulos por idioma
  • Campos personalizados e menções legais conforme o país, o número de IVA e o imposto
  • Vencimento, valor em dívida, dados bancários e código QR SEPA com o valor em dívida
  • Pré-visualização em direto numa fatura real, mesmo antes de guardar, e guias de remessa a condizer
PrestaShop 8 e 9 Sem override nem TPL Código QR SEPA 8 idiomas
  • Reembolso em 30 dias
  • 12 meses de atualizações
  • Suporte em 24h
www.datafirefly.com/pt/
Personalizar a Fatura PDF do PrestaShop 8 e 9 sem Editar Templates TPL
v1.0.0 · atualizado 2026-09-23
O que faz

A versão curta.

01

Nenhum ficheiro de template alterado

O módulo liga-se ao hook displayPDFInvoice, que o PrestaShop chama antes de gerar cada fatura, e substitui a renderização do cabeçalho, do corpo e do rodapé pela sua. invoice.tpl, header.tpl e footer.tpl ficam intactos e não é instalado nenhum override. Se uma definição causar problemas, sai a fatura nativa e o erro fica registado nos logs.

02

Pré-visualização numa fatura real

Escolha uma fatura recente da loja e clique em Pré-visualizar: o PDF abre com as definições do ecrã, mesmo por guardar. O botão Comparar abre a mesma fatura no esquema original do PrestaShop.

03

Linhas de produtos legíveis

Imagem, referência, nome, EAN-13, referência do fornecedor, preço unitário sem ou com IVA, desconto, taxa de IVA, quantidade, total sem ou com IVA: marque as colunas e defina a ordem, a largura e o alinhamento. As combinações passam para uma segunda linha, as personalizações do cliente aparecem sob o nome e os títulos das colunas repetem-se em cada página.

04

Menções conforme o país do cliente

Cada menção legal ou campo personalizado limita-se a um destino (país da loja, UE, UE exceto o país da loja, fora da UE, lista de países), a um tipo de cliente (com ou sem número de IVA, empresa ou particular) e a uma fatura com ou sem imposto. A menção de transmissão intracomunitária só é impressa onde se aplica.

05

Vencimento, valor em dívida e código QR SEPA

Um prazo de pagamento em dias imprime a data de vencimento. Uma fatura paga em parte mostra o valor já pago e o valor em dívida, uma fatura liquidada pode ter um carimbo Paga. O bloco bancário mostra IBAN e BIC verificados, com um código QR EPC que a app do banco do cliente lê para preencher a transferência.

06

Guias de remessa a condizer

Um interruptor aplica o mesmo logótipo, as mesmas cores, moradas e linhas de produtos às guias de remessa, sem qualquer preço. Cada campo personalizado define-se para faturas, guias de remessa ou ambas.

A versão longa

Tudo o que quer saber antes de instalar.

Uma análise detalhada de como o Personalizar a Fatura PDF do PrestaShop 8 e 9 sem Editar Templates TPL funciona, porque o construímos assim e o raciocínio por trás das funcionalidades acima.

§ 01

Porque é tão difícil alterar a fatura do PrestaShop

A fatura PDF do PrestaShop é montada a partir de cerca de dez ficheiros Smarty (cabeçalho, moradas, linhas de produtos, IVA, pagamentos, rodapé) e depois convertida pelo TCPDF, que só entende parte do HTML e do CSS. Cada alteração faz-se nesses ficheiros, verifica-se gerando uma fatura e tem de ser reposta a cada atualização do tema ou do PrestaShop. Uma menção que depende do país do cliente obriga a escrever a condição em Smarty. Muitas lojas ficam por isso com a fatura original, com um logótipo mal dimensionado e colunas inúteis.

§ 02

Um editor em vez de ficheiros .tpl

O módulo acrescenta a página Encomendas > Editor de faturas. Cada zona da fatura tem a sua secção: cabeçalho e logótipo, moradas e resumo, linhas de produtos, totais, pagamento e vencimento, campos personalizados, menções legais, rodapé, textos. Um esquema da página A4 realça a zona em edição. Tudo é gerado no formato que o TCPDF entende, sem colunas a transbordar nem tabelas partidas.

§ 03

As menções certas para cada cliente

Uma fatura para uma empresa alemã com número de IVA tem de indicar a transmissão intracomunitária isenta e o número de IVA do cliente. Uma fatura para a Suíça tem de mencionar a exportação para fora da UE. Cada regra tem as suas condições e só é impressa nas faturas em causa. As três regras de exemplo são fornecidas inativas: peça ao seu contabilista que valide o texto antes de as ativar.

§ 04

Receber mais depressa por transferência

Para os clientes que pagam por transferência, a fatura indica a data de vencimento, os dados bancários e uma referência a indicar. O código QR SEPA contém o IBAN, o BIC, o valor ainda em dívida e essa referência: o cliente lê-o com a app do banco e a transferência fica preenchida, sem erros de digitação. Numa fatura paga em parte, só é pedido o valor restante.

§ 05

Testar sem riscos

A pré-visualização gera o PDF de uma fatura real da loja com as definições do ecrã, sem as guardar. O botão Comparar abre a mesma fatura no esquema do PrestaShop. O interruptor principal devolve o controlo à fatura nativa sem apagar nada, e a exportação JSON permite preparar as definições numa loja de testes antes de as importar em produção.