E-Invoice: XRechnung 3.0, ZUGFeRD & Factur-X

Facturación electrónica estructurada para Dolibarr — 100 % local

Este módulo añade a Dolibarr una facturación electrónica totalmente estructurada. Cubre tanto los requisitos del sector público alemán (B2G) como los del comercio entre empresas (B2B) en un único paquete autónomo que se ejecuta íntegramente en su propio servidor. Ningún dato sale de su sistema y no se requiere ninguna suscripción a un servicio de conversión de terceros.

Formatos de exportación

• XRechnung 3.0 (UBL 2.1) — Documentos Invoice y CreditNote, el formato exigido para las facturas dirigidas a las autoridades federales alemanas.
• ZUGFeRD / Factur-X (UN/CEFACT CII) — XML estructurado incrustado en el PDF de la factura como un auténtico archivo híbrido PDF/A-3, mediante la biblioteca incluida atgp/factur-x. Los destinatarios reciben un PDF legible por personas y un XML legible por máquinas en un único adjunto.

Generación automática al validar la factura

Cuando valida (aprueba) una factura en Dolibarr, el módulo genera automáticamente el XML y lo adjunta al documento. El disparador emplea un diseño Soft-Fail: si la generación falla, Dolibarr continúa con normalidad y registra el error en lugar de bloquear el flujo de aprobación.

Importación de facturas de proveedores

Cargue un archivo XML UBL 2.1 o CII y el módulo creará un borrador de factura de proveedor en Dolibarr. El proveedor se identifica por su número de IVA o su razón social; si no se encuentra ninguna coincidencia, se crea automáticamente un nuevo registro de proveedor. Las líneas se transfieren sin necesidad de reintroducirlas manualmente.

Comprobación de plausibilidad EN16931 integrada

Antes de generar o importar, el módulo ejecuta una validación nativa en PHP que cubre las reglas de campos obligatorios de EN16931 (serie BR-*) y las reglas de coherencia aritmética (serie BR-CO-*). El resultado es una lista clara de errores y advertencias que se muestra directamente en la interfaz de Dolibarr.

Alcance de la validación: Se trata de un comprobador de plausibilidad de reglas esenciales implementado en PHP nativo. No es la suite oficial de validación KoSIT Schematron/Saxon XSLT 2.0 y no cuenta con certificación oficial. Para los envíos que requieran una pre-validación certificada por KoSIT, procese el XML a través del validador oficial KoSIT por separado.

Leitweg-ID para facturas del sector público (B2G)

Al instalar el módulo se crea automáticamente un campo personalizado dedicado (BT-10, Leitweg-ID) en la ficha del cliente. Rellénelo una sola vez por cada cliente del sector público y se incluirá automáticamente en cada XRechnung saliente — sin introducción manual por factura.

Configuración

• Selección de perfil (XRechnung 3.0 UBL / ZUGFeRD EN16931 / Factur-X EN16931)
• Generación automática al validar la factura: activado/desactivado
• Incrustación PDF/A-3: activado/desactivado
• Comprobación de plausibilidad EN16931: activado/desactivado
• Verificación opcional del esquema XSD de Factur-X
• Botón de generación de prueba directamente en la página de configuración
• Carga de importación XML para facturas de proveedores
• Interfaz disponible en alemán e inglés

Detalles técnicos

• Licencia: GPLv3 — código abierto, sin clave de licencia en tiempo de ejecución
• Dolibarr 18.0 – 23.0 (probado en 23.0.3)
• PHP 7.4 – 8.2
• Sin llamadas a API externas, sin dependencia de la nube
• Biblioteca incluida: atgp/factur-x v3.3 para la incrustación PDF/A-3