Faturas Proforma em PDF para WooCommerce: documentação
Instalação, configuração e utilização do plugin de geração de faturas proforma em PDF para WooCommerce.
Apresentação
O plugin Faturas Proforma em PDF para WooCommerce gera faturas proforma profissionais em formato PDF diretamente a partir das suas encomendas WooCommerce. Cada documento retoma automaticamente os produtos com os seus atributos (dimensões, opções, personalizações), a totalidade dos totais do WooCommerce (subtotal, expedição, descontos, IVA) e os dados da sua empresa.
Uma fatura proforma é um documento não contratual entregue antes do pagamento. Não substitui a fatura definitiva.
Instalação
1. Instalar o plugin
- Na administração do WordPress, vá a Plugins → Adicionar → Carregar plugin.
- Selecione o arquivo ZIP do plugin e clique em Instalar agora.
- Ative o plugin.
2. Requisitos
- WordPress 6.0 ou superior
- WooCommerce 7.0 ou superior (compatível com HPOS)
- PHP 8.0 ou superior
Configuração
As definições estão em WooCommerce → Proforma, organizadas em três separadores.
Separador Empresa
Indique as informações que vão aparecer no bloco do emissor do PDF: logótipo (a partir da biblioteca de multimédia), designação social, morada completa, telefone, e-mail, número de IVA intracomunitário e número de identificação da empresa.
Separador Documento
- Prefixo do número: por exemplo
PRO-dá PRO-00001, PRO-00002, etc. O contador incrementa automaticamente e cada número fica associado à sua encomenda. - Validade: número de dias durante os quais a proforma é válida (a data-limite é impressa no documento).
- Símbolo e posição da moeda: 10,00 € ou € 10,00.
- Cor de destaque: cor das faixas, dos títulos e dos cabeçalhos de tabela do PDF.
- Texto de rodapé: menção legal impressa no fundo de cada página.
Separador E-mail
Ative Anexar automaticamente para que a proforma seja anexada aos e-mails de confirmação de encomenda (nova encomenda, encomenda em processamento, encomenda em espera).
Gerar uma proforma
A partir da ficha de encomenda
Aparece uma caixa Fatura Proforma na coluna lateral de cada encomenda. Permite gerar o PDF, descarregá-lo e regerá-lo depois de alterar a encomenda. A ação também está disponível no menu pendente Ações de encomenda.
A partir da lista de encomendas
- Coluna dedicada: um ícone indica se existe uma proforma (azul) ou não (cinzento); um clique descarrega-a ou gera-a.
- Ação em massa: assinale várias encomendas e escolha Gerar proforma(s) para um processamento em massa.
Depois de alterar uma encomenda (adição de produto, desconto), use o botão Regerar para atualizar o PDF: o número da proforma mantém-se igual.
Conteúdo do PDF
- Blocos emissor / destinatário com moradas completas
- Tabela de produtos com referência, designação e atributos dos produtos (dimensões, opções de personalização…)
- Totais completos idênticos aos do WooCommerce: subtotal, expedição, descontos e cupões, IVA, total com IVA
- Modo de pagamento e notas do cliente (opcional)
- Numeração, data de emissão e data de validade
Armazenamento e segurança
Os PDF são guardados em wp-content/uploads/df-proforma/, uma pasta protegida contra listagem. Só os utilizadores com a permissão manage_woocommerce podem gerar ou descarregar os documentos.
Perguntas frequentes
O PDF não é gerado
Verifique que a biblioteca de PDF está instalada (aparece um aviso na administração se estiver em falta) e que a pasta uploads tem permissões de escrita.
Posso alterar o número de uma proforma existente?
O número é fixado na primeira geração e guardado na encomenda para garantir a rastreabilidade. Regerar o documento mantém o mesmo número.
Os descontos e os portes aparecem?
Sim, o documento retoma exatamente as linhas de totais calculadas pelo WooCommerce, incluindo os envios gratuitos e os cupões.