Procesamiento UBL en eConnect

Cómo eConnect procesa las facturas UBL: validación, reparación XML automática y transformación.

Cuando envía una factura a eConnect, el documento pasa por una serie de pasos de procesamiento. El desarrollo exacto de este procesamiento depende del tipo de archivo (XML o PDF) y de la calidad del archivo suministrado. Este artículo explica lo que sucede entre bastidores.

XML versus PDF: dos rutas de procesamiento

eConnect dispone de dos rutas de procesamiento fundamentalmente diferentes:

Procesamiento XML (ruta directa): si envía una factura UBL válida (SI-UBL 2.0, Peppol BIS Billing 3.0 u otro formato XML compatible), se procesa directamente. La plataforma lee los datos estructurados del XML, los valida y enruta el documento al destinatario. Esta es la ruta más rápida y fiable.

Procesamiento PDF (conversión vía IDR): si envía una factura PDF, se procesa mediante el Intelligent Document Recogniser (IDR). El IDR extrae los datos de facturación mediante OCR y reconocimiento de patrones, y produce una factura UBL basada en los datos reconocidos. Este proceso es intrínsecamente menos fiable que el procesamiento XML directo, ya que depende de la calidad del PDF.

Consejo : el suministro UBL siempre es preferible al PDF. Es más rápido, más económico y más fiable. Pregunte a su proveedor o software si la exportación UBL está disponible.

¿Qué ocurre con el suministro XML?

Al enviar un archivo XML, eConnect realiza los siguientes pasos:

1. Reconocimiento del formato

La plataforma reconoce automáticamente qué formato sigue el archivo basándose en el CustomizationID y el esquema XML. Los formatos compatibles incluyen entre otros NLCIUS, BIS Billing V3, XRechnung, CII y Factur-X.

2. Validación

La factura se valida según las reglas del perfil reconocido. Esto incluye:

  • Validación del esquema: ¿el XML cumple con la estructura del esquema UBL 2.1 o CII?
  • Reglas de negocio: ¿son correctos los cálculos? ¿Están rellenos los campos obligatorios? ¿Coinciden los valores de las listas de códigos?
  • Reglas nacionales: ¿se respetan las reglas NL-R-, DK-R- u otras reglas nacionales?

Consejo: ¿Recibe el mensaje de que no se encontraron "reglas de validación"? Esto generalmente significa que el CustomizationID en su XML falta o no se reconoce. Sin un perfil reconocible, el validador no puede aplicar reglas de negocio. Verifique que su factura contiene un CustomizationID válido, como el de NLCIUS o BIS Billing V3.

3. Reparación XML automática

Una característica notable del procesamiento de eConnect es la reparación automática de archivos XML. Mediante transformaciones XSL, se corrigen errores conocidos. La plataforma acepta en principio cualquier UBL; los campos no esenciales faltantes se rellenan con valores por defecto. Esta función de reparación se mejora continuamente sobre la base del feedback de los clientes y está lista para producción.

Ejemplos de reparaciones automáticas:

  • Los campos opcionales faltantes se completan con valores por defecto correctos
  • Los errores de formato conocidos en los campos de identificación se corrigen
  • Los datos de contacto incompletos se completan (si el campo ElectronicMail del proveedor está vacío, eConnect rellena automáticamente [email protected], para que las facturas rechazadas lleguen al remitente)
4. Transformación

Si el destinatario admite un formato diferente al formato fuente, el PSB transforma automáticamente el documento. Una factura NLCIUS puede, por ejemplo, transformarse a XRechnung si el destinatario es una administración pública alemana. Esto es posible porque todos los formatos compatibles se basan en el mismo modelo semántico (EN 16931).

Técnico : al descargar una factura a través de la API, puede especificar el formato de recepción deseado mediante el parámetro targetDocumentTypeId. El PSB transforma entonces el documento a ese formato.

ZUGFeRD y Factur-X: procesamiento híbrido

ZUGFeRD y Factur-X son formatos de factura híbridos: un archivo PDF/A-3 que contiene una factura CII XML integrada. Para estos documentos, la plataforma intenta primero extraer el XML integrado del PDF. Si el XML es válido, se procesa directamente, como una factura XML regular. Solo si el XML integrado resulta no válido, el sistema recurre al procesamiento OCR mediante el IDR.

Una factura ZUGFeRD que pasa los validadores externos pero se procesa mediante OCR indica un problema con el XML integrado en el proceso de validación de eConnect. En ese caso, puede contactar con soporte.

Técnico : la plataforma legacy solo puede almacenar facturas UBL válidas. Cuando una factura ZUGFeRD se procesa mediante el IDR como PDF, la salida del IDR debe primero transformarse a UBL válido (BIS Billing V3 o NLCIUS). Si esa transformación falla porque los datos fuente no contienen suficientes campos para una factura UBL válida, la plataforma no puede almacenar la factura. En el PSB/Control, este problema es menor, ya que las facturas se almacenan en su formato original y solo se transforman en el momento de la entrega.

Fallback: de UBL inválido a PDF

Si envía un archivo XML no válido, el sistema recurre automáticamente al PDF adjunto. Funciona de la siguiente manera:

  1. La plataforma intenta primero procesar el componente XML.
  2. Si el UBL no es válido, se utiliza el PDF adjunto como fallback.
  3. El PDF se procesa a través de la ruta IDR (OCR y reconocimiento de patrones).

Este mecanismo garantiza que la factura siempre se procese, incluso si el XML contiene errores. Sin embargo, es una ruta más costosa y más lenta que el procesamiento XML directo.

Formatos obsoletos

SI-UBL 1.2 (Simplerinvoicing 1.2) fue definitivamente retirado el 1 de enero de 2024. Las facturas en este formato son rechazadas en la red Peppol. eConnect puede a veces transformar los archivos SI antiguos recibidos por correo electrónico a NLCIUS válido, siempre que los datos esenciales estén presentes. Si faltan datos, la validación puede fallar.

Atención : ¿Recibe mensajes de error al enviar facturas? Compruebe si su software todavía genera SI-UBL 1.2. Si es así, solicite a su proveedor una actualización a NLCIUS/SI-UBL 2.0 o BIS Billing V3.

Diferencia entre la plataforma legacy y PSB/Control

El procesamiento difiere ligeramente entre la plataforma legacy y el PSB/Control:

  • Plataforma legacy: una factura siempre se transforma primero a UBL válido (BIS Billing V3 o NLCIUS) antes de ser almacenada. Si esa transformación falla, la factura no puede ser almacenada.
  • PSB/Control: una factura se valida y almacena en la recepción. La transformación solo tiene lugar más tarde cuando es necesario, por ejemplo durante la entrega a un sistema ERP. Esto significa que una factura puede ser almacenada en el PSB, pero que un error de transformación puede ocurrir posteriormente si el formato objetivo no puede ser generado.
Preguntas frecuentes
¿Qué ocurre si mi factura XML no es válida?

Si el archivo XML contiene errores, eConnect intenta primero repararlo automáticamente mediante transformaciones XSL. Los errores conocidos se corrigen y los campos opcionales faltantes se completan. Si eso no funciona, el sistema recurre al PDF adjunto y lo procesa mediante OCR.

¿Por qué se procesa mi factura ZUGFeRD mediante OCR en lugar de XML?

Esto indica que el XML incrustado en el PDF no es válido según el proceso de validación de eConnect. La plataforma intenta primero extraer el XML; solo si no es válido se recurre al OCR. Contacte con soporte si la factura pasa los validadores externos.

¿Es mejor el envío UBL que el PDF?

Sí, siempre. El procesamiento UBL es más rápido, más barato y más fiable que el procesamiento PDF mediante OCR. Con XML, los datos estructurados se leen y validan directamente, mientras que con PDF los datos deben reconocerse mediante reconocimiento de patrones.


¿Desea comprobar si su archivo XML se procesa correctamente? Utilice el validador eConnect gratuito para probar su factura de antemano.

Valide su factura

Artículos relacionados