Referencia del formato CSV para la generación de facturas en lote

Inicio rápido

Cada fila del CSV representa una factura. La primera fila debe ser una fila de encabezado con nombres de columna. Los nombres de columna no distinguen entre mayúsculas y minúsculas y admiten varios alias comunes.

CSV mínimo (3 facturas):

client_name,invoice_no,issue_date,item_description,item_quantity,item_price
Acme Corp,FAC-001,2026-04-01,Diseño web,1,2500
TechStart,FAC-002,2026-04-01,Consultoría,8,150
Blue Sky Ltd,FAC-003,2026-04-15,Retención mensual,1,1800

Campos obligatorios

Campo	Nombres de columna aceptados
Nombre del cliente	client_name, client, to_name, company, customer
Número de factura	invoice_no, invoice_number, inv_no, number
Fecha de emisión	issue_date, date, invoice_date
Descripción del artículo	item_description, description, item_desc, service, item1_desc
Cantidad	item_quantity, quantity, qty, hours, item1_qty
Precio unitario	item_price, unit_price, rate, price, amount, item1_price

Campos opcionales

Campo	Nombres de columna aceptados	Por defecto
Fecha de vencimiento	due_date, payment_due	—
Moneda	currency	EUR
Impuesto %	item_tax, tax, vat, item1_tax	0
Email del cliente	email, client_email, to_email	—
Dirección del cliente	address, client_address, to_address	—
NIF/VAT	vat_number, client_vat, tax_id	—
Notas	notes, note, memo	—
Condiciones de pago	payment_terms, terms	—
Descuento %	discount	0

Facturas con múltiples artículos

Usa sufijos numerados item1_, item2_, etc. (hasta 10 artículos):

client_name,invoice_no,issue_date,item1_desc,item1_qty,item1_price,item2_desc,item2_qty,item2_price
Acme Corp,FAC-001,2026-04-01,Fase de diseño,1,1500,Fase de desarrollo,20,100

Formato JSON alternativo

[
  {
    "client_name": "Acme Corp",
    "invoice_no": "FAC-001",
    "issue_date": "2026-04-01",
    "item1_desc": "Diseño web",
    "item1_qty": 1,
    "item1_price": 2500,
    "currency": "EUR"
  }
]

Formato de fecha

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

Descarga de plantillas de muestra

Descarga el archivo CSV de muestra directamente.

Notas sobre el mapeo de columnas

• Los nombres de columna no distinguen entre mayúsculas y minúsculas
• Las columnas no reconocidas se ignoran silenciosamente
• Usa el Mapeador de columnas (paso 2) para asignación manual
• Para la guía completa: Cómo generar múltiples facturas desde un CSV