TaxLayer
Técnica2026-11-138 min de lecturapor TaxLayer Team

Factura electrónica por API: convertir y validar CSV y XML automáticamente a ZUGFeRD, XRechnung y PEPPOL

La obligación de la factura electrónica afecta más duramente a las empresas con muchas facturas. Quien emite cientos o miles de facturas al mes no puede subirlas, comprobarlas y descargarlas una por una. Además, no todos los ERP tienen un módulo de factura electrónica, y un software propio tendría que generar ZUGFeRD, XRechnung y PEPPOL por sí mismo, mantenerlos al día y validarlos contra las reglas oficiales. Una API cierra esa brecha: su software aporta los datos y la interfaz devuelve facturas electrónicas validadas. Esta guía muestra cómo funciona y en qué conviene fijarse al elegir.

> Respuesta breve: una API de factura electrónica recibe los datos de factura de su sistema y devuelve archivos terminados en ZUGFeRD, XRechnung o PEPPOL. Las entradas más fiables son las estructuradas (CSV o XML), porque no se adivina ningún valor. Lo decisivo es que cada archivo se compruebe antes de su emisión contra EN 16931 y las reglas de KoSIT. La API de TaxLayer ofrece para ello cuatro endpoints (estado, convertir CSV, convertir XML, validar) y está incluida en Enterprise.

Por qué una API en lugar de trabajo manual

Una factura electrónica es un conjunto de datos estructurado según EN 16931. Generarlo a mano cuesta solo unos minutos por factura, pero con grandes volúmenes son días al mes. A ello se suman fuentes de error: códigos de unidad incorrectos, datos obligatorios ausentes para XRechnung, diferencias de redondeo en el desglose de impuestos. Una API automatiza todo el recorrido:

  • Su sistema exporta los datos de factura, por ejemplo por la noche como archivo CSV.
  • Un pequeño script envía el archivo a la interfaz.
  • La API genera, por cada factura, un PDF ZUGFeRD, una XRechnung o un archivo PEPPOL.
  • Cada archivo se valida antes de devolverse. Las facturas con errores vuelven con su motivo, en lugar de como archivo no válido.

Así su proceso de facturación sigue como está, y al final se obtiene una factura electrónica válida.

Qué entrada: CSV, XML o PDF

La pregunta más importante al automatizar es en qué forma están los datos.

EntradaOrigen típicoFiabilidad
CSVexportación del ERP, sistema de gestión, hoja de cálculomuy alta, los valores se toman con exactitud
XML (UBL, CII)facturas electrónicas existentes, sistemas modernosmuy alta, lectura basada en reglas
PDFimpresión de facturas de cualquier sistemabuena, pero solo con revisión humana

CSV es el camino más sencillo para sistemas sin módulo de factura electrónica. Casi cualquier ERP puede sacar facturas como tabla. En la plantilla de TaxLayer, cada posición va en una línea y los datos de cabecera (vendedor, comprador, pago) se repiten en cada línea. Un archivo puede contener muchas facturas, agrupadas por número de factura.

XML compensa cuando ya existen facturas electrónicas y solo debe cambiar el formato. Un caso típico es una XRechnung para una administración pública que un cliente quiere además como PDF ZUGFeRD legible, o una factura ZUGFeRD que debe enviarse por la red PEPPOL. UBL (XRechnung, PEPPOL BIS) y CII (ZUGFeRD, Factur-X) se leen con reglas, sin IA.

PDF es la entrada que promete más comodidad y ofrece menos seguridad. La IA moderna lee muy bien los datos de factura de los PDF, pero no sin errores. Una cifra cambiada en el importe o un tipo impositivo mal reconocido acabaría, si no, sin validar en una factura jurídicamente vinculante. Por eso TaxLayer ofrece PDF de forma deliberada solo en la aplicación web, con un paso de revisión antes de la emisión y en lote hasta 50 facturas (Enterprise Plus: 70). Por qué un PDF por sí solo no es una factura electrónica lo explica el artículo Excel y PDF no son una factura electrónica.

Validación: la parte que muchos olvidan

Una factura electrónica solo es una factura electrónica cuando cumple las reglas. Para Alemania son EN 16931 y, para XRechnung, además las reglas de negocio alemanas (BR-DE), por ejemplo el teléfono y la dirección de correo electrónico del vendedor. Estas reglas las comprueba la Koordinierungsstelle für IT-Standards (KoSIT) con un conjunto de reglas oficial que también utilizan los destinatarios públicos de facturas.

En una API fíjese en tres puntos:

  • Validación antes de la emisión: cada archivo generado debería pasar por el conjunto completo de reglas, no solo por el esquema XML.
  • Automático significa automático: incluso la mejor validación solo confirma la forma. En TaxLayer todas las comprobaciones son automáticas, no hay control manual; usted sigue siendo responsable del contenido (importes, tipos impositivos, destinatario) como hasta ahora.
  • Fail-closed: si el servicio de validación no está disponible, la API no debe entregar ningún archivo sin validar. La API de TaxLayer responde entonces con 503 y no cobra nada; su script simplemente reenvía la petición.
  • Errores comprensibles: en lugar de «no válido» necesita el código de regla y un mensaje, por ejemplo BR-DE-6 para el teléfono ausente. Puede consultar los códigos en el directorio de códigos de error de XRechnung.

El endpoint de validación también es útil para facturas recibidas: antes de que una factura de proveedor pase a la contabilidad, muestra si cumple las reglas. Para archivos sueltos existe además el validador gratuito en el navegador.

Seguridad y protección de datos

Una API de facturas procesa datos sensibles. Pregunte por:

  • Gestión de claves: las claves de API deberían guardarse solo como hash y poder revocarse en cualquier momento. En TaxLayer ve una clave una sola vez al crearla; una clave revocada queda inválida de inmediato.
  • Sin acceso desde el navegador: las claves van en el servidor. La API de TaxLayer no envía cabeceras CORS, por lo que no son posibles las llamadas desde páginas web.
  • Almacenamiento: los archivos de factura no deberían guardarse. El registro de accesos solo debería contener datos técnicos.
  • Ubicación: procesamiento en la UE, en TaxLayer en Fráncfort.

Cómo es una llamada

Una llamada es una simple petición HTTP: envía el archivo CSV con POST a /v1/convert/csv?format=xrechnung y pone su clave en la cabecera Authorization: Bearer tlk_…. Con curl es una sola línea; en Python o Node.js son unas diez líneas.

La respuesta es JSON: por cada factura el archivo terminado (XML como texto o PDF ZUGFeRD en Base64) y una lista de las facturas que no se pudieron generar, con el motivo. Solo las facturas generadas con éxito cuentan para su cuota. Todos los endpoints, parámetros, códigos de error y ejemplos en Node.js y Python figuran en la documentación de la API.

Lista de comprobación para empezar

  1. Compruebe si su sistema puede exportar facturas como CSV o XML.
  2. Descargue la plantilla CSV de la documentación y asigne sus columnas a ella.
  3. Para XRechnung, añada el Leitweg-ID o la referencia del comprador, el teléfono, el correo electrónico, el código postal y la localidad del vendedor, así como el código postal, la localidad y una dirección de correo electrónico o el NIF-IVA (USt-IdNr.) del comprador.
  4. Cree una clave en la cuenta, en «API (Beta)», y pruebe con la llamada de estado.
  5. Envíe un primer archivo y evalúe el campo errors antes de pasar a la ejecución nocturna.

---

La factura electrónica no tiene por qué ser un proyecto con desarrollo propio. Con la API de TaxLayer, su sistema aporta los datos y usted recibe archivos ZUGFeRD, XRechnung y PEPPOL validados. La API está incluida en Enterprise y Enterprise Plus y por ahora está disponible en versión beta. Consultas a info@taxlayer.de.

Preguntas frecuentes

¿Qué es una API de factura electrónica?

Una interfaz de programación a la que su software envía los datos de factura y que devuelve facturas electrónicas terminadas en el formato deseado, por ejemplo ZUGFeRD, XRechnung o PEPPOL. Se ahorra su propio generador, el mantenimiento de las versiones de formato y la operación de un validador.

¿Qué entrada es la mejor para automatizar?

Los datos estructurados, es decir, CSV o XML. Los valores se toman con exactitud y no hay que adivinar nada. Es cierto que con IA se pueden leer datos de PDF, pero no es infalible y requiere un paso de revisión humana.

¿Cómo me aseguro de que la factura electrónica generada es válida?

Cada archivo debería comprobarse antes de su emisión con las reglas oficiales, es decir, EN 16931 y, para XRechnung, además las reglas alemanas BR-DE. La API de TaxLayer comprueba cada archivo con las reglas de validación de KoSIT y solo entrega los archivos que las han superado.

¿Puedo validar también facturas de proveedores con la API?

Sí. El endpoint de validación acepta XML (UBL o CII) y PDF ZUGFeRD y devuelve el resultado con códigos de regla, por ejemplo BR-CO-15 para un importe total incorrecto. Así se detectan las facturas recibidas defectuosas antes de contabilizarlas.

¿Cuánto cuesta la API de TaxLayer?

Está incluida en las tarifas Enterprise y Enterprise Plus. Las conversiones cuentan para la misma cuota mensual que la aplicación web; las validaciones tienen su propio límite diario.

¿Necesito conocimientos de programación?

Algunos. Una llamada es una simple petición HTTP que se puede lanzar con curl, con un script corto en Python o Node.js o desde muchos sistemas ERP. La documentación incluye ejemplos para copiar.

Convierta sus facturas PDF ahora

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

Comenzar