TaxLayer
Técnica2026-10-206 min de lecturapor TaxLayer Team

Factura electrónica desde CSV: estructura de la plantilla de importación y qué cubre

Con la importación CSV genera facturas electrónicas directamente a partir de la exportación estructurada de su ERP, sin el rodeo de un PDF. Este camino es determinista: los datos ya proceden limpios de su sistema, no hace falta reconocimiento y TaxLayer construye el archivo ZUGFeRD o XRechnung 1:1 a partir de sus valores. Además, cada archivo se comprueba automáticamente contra el conjunto de reglas oficial de KoSIT/Mustang (EN 16931).

> En resumen: una línea por posición, campos de cabecera en cada línea, un archivo por factura. La plantilla la descarga en la aplicación, en «Convertir PDF», en el apartado «Importar desde exportación de ERP (CSV)».

Estructura del archivo

El CSV está construido según el patrón de una línea por posición de factura. Los campos a nivel de factura (número, fecha, vendedor, comprador, pago) figuran en cada línea y se leen de la primera línea. El separador es el punto y coma. Se reconocen los números decimales alemanes (1.234,56).

Resumen de campos

ColumnaSignificadoObligatorio
invoiceNumberNúmero de facturasí
issueDateFecha de factura (AAAA-MM-DD)sí
deliveryDateFecha de entrega/prestaciónopcional
currencyCodeMoneda (por defecto EUR)opcional
buyerReferenceLeitweg-ID / referencia del comprador (B2G)opcional
orderReferenceNúmero de pedido/encargo (BT-13)opcional
sellerNameNombre del vendedorsí
sellerVatIdUSt-IdNr. del vendedor (NIF-IVA)sí*
sellerTaxNumberNúmero fiscal del vendedorsí*
sellerStreet / sellerZip / sellerCity / sellerCountryDirección del vendedoropcional
sellerEmailCorreo electrónico del vendedoropcional
buyerNameNombre del compradorsí
buyerVatIdUSt-IdNr. del comprador (NIF-IVA)opcional**
buyerStreet / buyerZip / buyerCity / buyerCountryDirección del compradoropcional
iban / bicDatos bancariosopcional
paymentTermsCondiciones de pago (texto libre, BT-20)opcional
dueDateFecha de vencimientoopcional
skontoDays / skontoPercentDías y porcentaje de Skontoopcional
deliveryNoteIdNúmero de albaránopcional
discountAmount / discountVatRate / discountVatCategoryDescuento aplicado a toda la facturaopcional
descriptionDescripción de la posiciónsí
quantityCantidadsí
unitUnidad (p. ej. hora, kg, unidad)opcional
unitPricePrecio unitario netosí
vatRateTipo impositivo en porcentajesí
vatCategoryCategoría de impuesto (S, AE, K, G, E, O, Z)opcional

\* Se requiere al menos un identificador del vendedor (USt-IdNr. o número fiscal).

\*\* En reverse charge (categoría AE), la USt-IdNr. del comprador es obligatoria.

Por qué un CSV cubre aproximadamente el 95 por ciento

EN 16931 define unos 160 campos de datos, la mayoría opcionales. Una factura B2B alemana real solo necesita unos 20 a 30 de ellos, y justo esos son los que refleja la plantilla. Los demás valores (desglose de impuestos, todas las sumas) los calcula TaxLayer automáticamente a partir de las posiciones.

Un CSV es una tabla plana: una sola dirección de repetición, a saber, las líneas. Las utilizamos para las posiciones. Los valores individuales se pueden complementar libremente como columnas adicionales. Lo que un CSV plano no puede reflejar limpiamente son las estructuras anidadas y repetidas varias veces: varios descuentos aplicados a toda la factura, descuentos por posición o muchas referencias. Estas estructuras son un árbol, y para ello el formato adecuado es XML.

Skonto y descuento

El Skonto se indica mediante skontoDays y skontoPercent. De ahí resulta automáticamente la grafía de DATEV en las condiciones de pago, de modo que el Skonto es legible por máquina. Cómo está construido exactamente este patrón y por qué el texto libre por sí solo activa la regla BR-DE-18 lo explica Indicar el Skonto en XRechnung y ZUGFeRD. Un descuento aplicado a toda la factura se indica mediante discountAmount; se gestiona como una posición propia con importe negativo y reduce la base imponible.

¿Y después?

Tras la subida, los datos pasan al paso de revisión habitual. Allí controla importes, tipos impositivos y unidades y genera después la factura electrónica validada. La importación CSV es además el camino más sencillo para convertir muchas facturas a la vez, porque se procesa conjuntamente un archivo por factura. Las 2 primeras conversiones al mes son gratuitas: pruébelo ahora.

Preguntas frecuentes

¿Cómo está estructurado el CSV?

Una línea por posición de factura. Los campos de cabecera de la factura (número, fecha, vendedor, comprador, pago) figuran en cada línea y se toman de la primera línea. Un archivo corresponde a una factura.

¿Qué campos son obligatorios?

invoiceNumber, issueDate, sellerName, un identificador del vendedor (sellerVatId o sellerTaxNumber), buyerName y, por cada posición, description, quantity, unitPrice y vatRate. Todo lo demás es opcional.

¿Cubre el CSV todos los campos de EN 16931?

Aproximadamente el 95 por ciento de los casos prácticos. EN 16931 tiene unos 160 campos de datos, la mayoría opcionales. Un CSV plano refleja todos los valores individuales (cabecera, partes, pago, Skonto, un descuento, fecha de entrega). No se pueden reflejar estructuras anidadas y repetidas varias veces, como varios descuentos aplicados a toda la factura o descuentos por posición. Para eso sirve XML.

¿Cómo indico el Skonto?

Mediante las columnas skontoDays y skontoPercent. TaxLayer genera con ellas automáticamente la grafía de DATEV legible por máquina (#SKONTO#TAGE=14#PROZENT=2.00#) en las condiciones de pago (BT-20), de modo que DATEV reconoce el Skonto.

¿Cómo indico un descuento?

Mediante discountAmount (importe neto), opcionalmente discountVatRate y discountVatCategory. El descuento se refleja como una posición propia con importe negativo y reduce la base imponible del tipo impositivo indicado. Para facturas con un solo tipo impositivo es exacto; con tipos mixtos, es mejor indicar el descuento como posición propia por cada tipo.

¿Puedo importar varias facturas en un archivo?

Actualmente, una factura por archivo. Para muchas facturas suba varios archivos o consúltenos sobre una conexión automatizada.

Convierta sus facturas PDF ahora

Pruebe TaxLayer gratis – 2 conversiones al mes, sin tarjeta de crédito.

Comenzar