Saltar al contenido
Volver al blog
FormatosPublicado 9 de julio de 20266 min de lectura

Una API para convertir formatos de factura: cualquier formato de entrada, una e-factura conforme de salida

Cada país quiere un formato de factura electrónica distinto, pero tu ERP sigue exportando el mismo CSV. Así lo resuelve una única API de conversión de formatos de factura.

Construiste el export de tu ERP una vez. Genera un CSV, o quizá un archivo UBL, y durante años eso bastó. Luego Francia impuso Factur-X. Alemania quiere XRechnung. Italia tiene FatturaPA y su despacho por SdI. Polonia está desplegando KSeF con su esquema FA(3). España espera Facturae. Noruega funciona con EHF sobre Peppol. Los EAU, Omán y Singapur se están estandarizando en PINT.

Tu ERP no cambió. El mundo a su alrededor sí. Y ahora cada nuevo cliente o país con el que tu negocio entra en contacto trae una exigencia técnica distinta, mientras tu equipo de finanzas sigue atascado exportando exactamente el mismo archivo de siempre.

Por qué se fragmentaron los formatos de factura en primer lugar

Existe una norma europea, EN 16931, que define un modelo semántico común para una factura electrónica. En teoría, todos coinciden en qué significa un « importe neto » o un « identificador de IVA del comprador ». En la práctica, cada país envuelve ese modelo en su propia sintaxis, sus propios campos obligatorios y sus propias reglas de validación.

XRechnung y Factur-X se basan ambos en EN 16931, pero no son archivos intercambiables. FatturaPA es anterior a la norma y usa por completo su propio esquema italiano. KSeF FA(3) es específico de Polonia. Así que « damos soporte a la facturación electrónica » nunca es un solo trabajo. Son una docena de trabajos que parten de los mismos datos de origen y terminan en archivos incompatibles. Esa es la brecha que una API de conversión de formatos de factura está hecha para cerrar: tú sigues exportando lo que ya exportas, y otra cosa se encarga de traducirlo a lo que cada destino exige.

Qué significa realmente « cualquier formato de entrada »

La parte complicada suele ser la entrada, no la salida. Los sistemas contables reales exportan datos heredados e inconsistentes: un CSV plano con 40 columnas, una hoja de Excel que un controller mantiene a mano, EDIFACT de un antiguo montaje EDI, o UBL y CII estructurados de una pila más moderna. Algunos envían un PDF ZUGFeRD o Factur-X con el XML incrustado dentro.

Una API de conversión que valga la pena lee todo eso. MyInvoice acepta como entrada CSV, Excel, EDIFACT, UBL, CII y PDF ZUGFeRD/Factur-X — y cuando un proveedor te envía un PDF híbrido, extrae el XML del archivo y lo normaliza en el mismo modelo limpio. Esa última parte importa más de lo que parece: una factura electrónica que recibes se convierte en una entrada válida, no solo en algo que archivas. Puedes tomar un documento Factur-X o ZUGFeRD entrante y reemitirlo como Peppol BIS o XRechnung sin reconstruir tu pipeline.

Una API, cada salida conforme

Una vez que tus datos están parseados en el modelo común, la salida es una elección, no una reconstrucción. La misma factura de origen puede salir como:

  • Peppol BIS 3.0 para la red Peppol
  • XRechnung para compradores del sector público alemán
  • Factur-X / ZUGFeRD para Francia y Alemania
  • FatturaPA para Italia
  • KSeF FA(3) para Polonia
  • EHF para Noruega
  • PINT para los EAU, Omán y Singapur

Envías los datos una vez y eliges el formato al final. Cuando un nuevo país entra en vigor, cambias un parámetro, no tu ERP.

Conserva tu sistema, resuelve la última milla

La cuestión no es reemplazar tu software. Es dejar de cablear un proyecto de formato puntual cada vez que aterriza un mandato. Tu ERP sigue exportando su CSV. La API se encarga de la última milla, convirtiendo ese export en el archivo exacto que un país o la red Peppol aceptará, y valida el resultado antes de que lo envíes.

Si tu equipo se enfrenta a un nuevo mandato con el mismo archivo de export de siempre, esa es exactamente la brecha que esto cierra. Echa un vistazo a MyInvoice e intenta convertir uno de tus exports reales al formato que de verdad necesitas.

Convierte uno de tus exports en el navegadorLeer la documentación de la API