Referência do formato CSV para geração de faturas em lote

Início rápido

Cada linha do CSV representa uma fatura. A primeira linha deve ser uma linha de cabeçalho com nomes de colunas. Os nomes de colunas são insensíveis a maiúsculas/minúsculas e suportam vários aliases comuns.

CSV mínimo (3 faturas):

client_name,invoice_no,issue_date,item_description,item_quantity,item_price
Acme Corp,FT-001,2026-04-01,Web design,1,2500
TechStart,FT-002,2026-04-01,Consultoria,8,150
Blue Sky Ltd,FT-003,2026-04-15,Retenção mensal,1,1800

Campos obrigatórios

Campo	Nomes de coluna aceites
Nome do cliente	client_name, client, to_name, company, customer
Número da fatura	invoice_no, invoice_number, inv_no, number
Data de emissão	issue_date, date, invoice_date
Descrição do item	item_description, description, item_desc, service, item1_desc
Quantidade	item_quantity, quantity, qty, hours, item1_qty
Preço unitário	item_price, unit_price, rate, price, amount, item1_price

Campos opcionais

Campo	Nomes de coluna aceites	Padrão
Data de vencimento	due_date, payment_due	—
Moeda	currency	EUR
Imposto %	item_tax, tax, vat, item1_tax	0
Email do cliente	email, client_email, to_email	—
Morada do cliente	address, client_address, to_address	—
NIF/IVA	vat_number, client_vat, tax_id	—
Notas	notes, note, memo	—
Condições de pagamento	payment_terms, terms	—
Desconto %	discount	0

Faturas com múltiplos itens

Usa sufixos numerados item1_, item2_, etc. (até 10 itens):

client_name,invoice_no,issue_date,item1_desc,item1_qty,item1_price,item2_desc,item2_qty,item2_price
Acme Corp,FT-001,2026-04-01,Fase de design,1,1500,Fase de desenvolvimento,20,100

Formato JSON alternativo

[
  {
    "client_name": "Acme Corp",
    "invoice_no": "FT-001",
    "issue_date": "2026-04-01",
    "item1_desc": "Web design",
    "item1_qty": 1,
    "item1_price": 2500,
    "currency": "EUR"
  }
]

Formato de data

Usa ISO 8601: AAAA-MM-DD (por exemplo, 2026-04-01).

Descarregar modelos de amostra

Descarrega o ficheiro CSV de amostra diretamente.

Notas sobre mapeamento de colunas

• Os nomes de colunas são insensíveis a maiúsculas/minúsculas
• Colunas não reconhecidas são silenciosamente ignoradas
• Usa o Mapeador de colunas (passo 2) para mapeamento manual
• Para o guia completo: Como gerar múltiplas faturas a partir de um CSV