# Faturas Proforma em PDF para WooCommerce: documentação

> 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…

- Página: <https://www.datafirefly.com/pt/documentation/df-proforma-woo/>
- Idioma: pt
- Atualizado em: 2026-09-02
- Outros idiomas: [fr](https://www.datafirefly.com/documentation/df-proforma-woo/index.md), [en](https://www.datafirefly.com/en/documentation/df-proforma-woo/index.md), [es](https://www.datafirefly.com/es/documentation/df-proforma-woo/index.md), [de](https://www.datafirefly.com/de/documentation/df-proforma-woo/index.md), [it](https://www.datafirefly.com/it/documentation/df-proforma-woo/index.md), [pl](https://www.datafirefly.com/pl/documentation/df-proforma-woo/index.md), [nl](https://www.datafirefly.com/nl/documentation/df-proforma-woo/index.md)
- Índice: <https://www.datafirefly.com/pt/documentation/llms.txt>

## 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

1. Na administração do WordPress, vá a **Plugins → Adicionar → Carregar plugin**.
2. Selecione o arquivo ZIP do plugin e clique em **Instalar agora**.
3. 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.