Validar XRechnung: Validador KoSIT, errores de Schematron y qué significan

El Validador KoSIT es el software de referencia con el que puede verificar si una XRechnung cumple efectivamente con la norma antes de llegar al destinatario o ser rechazada por una entidad pública de contratación. Combina una verificación contra el esquema XML con reglas de Schematron de la especificación de XRechnung e informa tanto errores estructurales como violaciones de contenido contra la lógica de facturación. Quien genera XRechnungen de su propia facturación o de un flujo de automatización debe planificar esta verificación antes del envío, no solo cuando una factura regresa. Estado: agosto de 2026.

¿Qué verifica realmente el Validador KoSIT?

El Validador KoSIT ejecuta según su propia documentación varios pasos: Reconoce el formato XML presente, valida el archivo contra esquemas XML y reglas de Schematron, genera un informe individual de ello y calcula un estado de aceptación. El Validador no proporciona las reglas de verificación reales en sí, sino una configuración separada, el llamado archivo de escenario. Para XRechnung, esto lo realiza la Configuración del Validador XRechnung, que agrupa las reglas de Schematron de EN16931 y la extensión CIUS alemana XRechnung, así como los esquemas XML apropiados para facturas UBL y UN/CEFACT. Sin esta configuración, el Validador no verifica nada, fue construido deliberadamente como una herramienta genérica.

¿Cómo inicia una verificación desde la línea de comandos?

Llama al Validador como programa Java y le pasa la configuración del escenario y el archivo a verificar. En la práctica, esto significa:

• Llamada: java -jar validator-Version-standalone.jar -s Szenario-Konfigurationsdatei -r Repository-Pfad Dateiname, opcionalmente con parámetros adicionales.
• Ayuda: El parámetro --help muestra todas las opciones disponibles directamente en la terminal.
• Alternativas: El Validador también se puede incrustar como una biblioteca Java en su propio software u operar en modo daemon con interfaz HTTP, a través del parámetro -D.

Para un flujo de automatización, el modo daemon es especialmente interesante porque la verificación se puede conectar a una canalización mediante una llamada HTTP, en lugar de iniciar un nuevo proceso cada vez.

¿Qué diferencia los errores de esquema de los errores de Schematron?

Un error de esquema significa que el archivo XML no se ajusta a la estructura prescrita, por ejemplo, falta un campo obligatorio completamente o un elemento está en el lugar equivocado. Generalmente son errores técnicos graves que deben corregirse antes de cualquier verificación de contenido. Un error de Schematron, por el contrario, significa que el archivo es estructuralmente válido, pero viola una regla de negocio de la especificación de XRechnung, por ejemplo, un cálculo de suma que no cuadra, o un tipo impositivo que no coincide con la categoría seleccionada. Ambos tipos de errores aparecen en el mismo informe XML y se incluyen conjuntamente en el estado de aceptación final que emite el Validador al final.

¿Cómo se puede automatizar la verificación antes del envío?

La verificación más confiable es la que se ejecuta automáticamente antes de que una factura siquiera salga de la casa. En un flujo de trabajo n8n, esto se puede implementar de modo que el XML de XRechnung generado se envíe mediante una solicitud HTTP a una instancia de Validador en ejecución en modo daemon y el informe devuelto se evalúe antes de que siquiera comience el paso de envío. Si la verificación falla, el flujo de trabajo se detiene e informa el error al departamento de contabilidad, en lugar de enviar una factura no válida. Exactamente estos pasos de verificación y aprobación previos son parte de las automatizaciones que configuramos en NordFlux para clientes con su propia facturación.

Preguntas frecuentes sobre validar XRechnung

¿Es suficiente la verificación con el Validador KoSIT como único control antes del envío?

Para la conformidad técnica y de negocio según EN16931 y CIUS de XRechnung, sí, porque exactamente para eso se construyó el Validador. Sin embargo, no verifica si los datos comerciales contenidos, como información bancaria o descripción del servicio, son correctos en contenido, esa sigue siendo su responsabilidad.

¿Necesito una configuración diferente para cada tipo de factura?

Sí, la configuración del escenario está vinculada al formato respectivo. Para XRechnung, usa la Configuración del Validador XRechnung, para otras manifestaciones de EN16931 como ZUGFeRD hay correspondientemente otros archivos de configuración con sus propias reglas de Schematron.

¿Puedo usar el Validador sin conocimientos de Java?

Los conocimientos básicos de la línea de comandos son suficientes para la llamada simple contra archivos individuales, no necesita un entorno de desarrollo Java para eso. Para la integración en un flujo de trabajo automatizado, por ejemplo a través del modo daemon, es útil comprender técnicamente las llamadas HTTP.

¿Qué sucede si cambian las reglas de Schematron?

Las reglas de Schematron de XRechnung siguen un control de versiones semántico: las versiones principales introducen cambios de reglas incompatibles, las versiones menores amplían el contenido válido como nuevas listas de códigos, y las versiones de parche corrigen errores hacia atrás compatibles. Vale la pena mantener un seguimiento de la versión de configuración utilizada y volver a probar los flujos de trabajo de validación existentes cuando hay cambios de versión principal.