Validador de facturas UBL/Peppol

Comprueba la forma antes de que la red lo haga por ti

La forma cara de descubrir que un archivo de factura está roto es enviarlo: viaja hasta tu cliente o un punto de acceso, se rechaza horas o días después, y el reloj del pago vuelve a empezar. La forma barata es pasar antes treinta segundos aquí. Este validador responde a las preguntas directas y útiles: ¿es el archivo siquiera un XML bien formado?, ¿es realmente una factura UBL?, y ¿están presentes los campos que necesita cualquier factura legible —número, fechas, ambas partes, líneas y totales? Los archivos se comprueban en la memoria del servidor y se descartan de inmediato, que es la forma adecuada de tratar un documento que lleva nombres, importes y datos bancarios. Se gana su lugar sobre todo en dos situaciones: una pequeña empresa que genera sus primeras facturas UBL a partir de una plantilla o un módulo ERP poco conocido, y un desarrollador que prueba un flujo de exportación y quiere una opinión externa rápida sobre la salida antes de dirigirla a la red real.

Qué es una comprobación estructural — y qué es Schematron

Aquí la honestidad importa. La validación oficial de Peppol BIS Billing 3.0 es un conjunto de reglas Schematron: cientos de reglas de negocio que comprueban cosas como si los códigos de categoría de IVA son consistentes y si los totales de impuestos cuadran con la suma de las líneas. Esta herramienta no ejecuta esas reglas. Interpreta los dos resultados en consecuencia: un fallo aquí es definitivo —un archivo que no se analiza, o al que le faltan campos obligatorios, fallará en todas partes, así que arréglalo antes de enviarlo. Un aprobado aquí significa que la forma es utilizable, no que se cumplan todas las reglas de negocio; la red todavía puede rechazarlo por una infracción a nivel de regla. Primero lo estructural, Schematron después, es el orden natural de comprobación. El límite es deliberado, no pereza: los conjuntos de reglas oficiales tienen versión y se mantienen de forma centralizada, y ejecutarlos correctamente es tarea de la propia infraestructura de Peppol —imitar eso mal te serviría peor que nombrar el límite con claridad.

Los fallos que realmente vemos

La mayoría de los archivos rechazados encajan en un puñado de patrones. El archivo es una nota de crédito en lugar de una factura —un tipo de documento UBL distinto que este validador todavía no cubre. Es un PDF Factur-X en lugar de XML puro —la factura está incrustada dentro de un PDF y hay que extraerla antes con la herramienta Factur-X de este sitio. Se truncó o se recodificó en algún punto de un envío por correo, así que el XML ya no se analiza. O una exportación de un ERP dejó vacíos campos obligatorios de parte o de total porque un registro de datos maestros estaba incompleto. El validador nombra qué falta, lo que normalmente apunta directamente a cuál de estos casos ocurrió. Merece la pena conocer una variante más sutil: un archivo que se abre bien en un editor de texto puede seguir sin poder analizarse porque una pasarela de correo o un paso de copiar y pegar cambió su codificación de caracteres —invisible a la vista, fatal para el XML. Vuelve a exportarlo desde el sistema de origen en lugar de repararlo a mano.

El mismo analizador que el generador de PDF — y cuándo llamar a tu proveedor

Este validador comparte su analizador, línea por línea, con la herramienta Factura UBL/Peppol a PDF de aquí. Eso te da un pequeño flujo de trabajo fiable: valida el archivo, y luego genera el PDF y lee la factura como lo haría una persona —un IBAN incorrecto o un total absurdo suele ser más fácil de detectar en una página que en XML. Y conviene saber dónde está el límite: si un archivo se aprueba aquí, se genera con sentido, y aun así lo rechaza la red Peppol, el problema está en el nivel de las reglas de negocio o de la transmisión. Esa conversación le corresponde a tu punto de acceso o a tu proveedor de software, que puede ver el informe de validación oficial —lleva contigo su mensaje de error, porque nombra la regla exacta que se activó.

Qué comprueba realmente esta herramienta

Esto confirma que el archivo es XML bien formado, que tiene una raíz Invoice de UBL, y que contiene los campos que necesita una factura legible: número de factura, fechas, datos del proveedor y del cliente, líneas de factura y totales. Es una comprobación estructural básica, no la validación oficial Schematron de Peppol BIS Billing 3.0 — no detectará todas las infracciones de reglas de negocio (por ejemplo, totales de impuestos que no cuadran), solo si la estructura es utilizable en absoluto.