Todo lo que querrías saber antes de instalar.
Una mirada detallada a cómo funciona DataFirefly Factur-X SW — Factura electrónica Shopware 6: ZUGFeRD y XRechnung 3.0, por qué lo construimos así y la lógica detrás de las características anteriores.
La factura electrónica ya no es opcional
En Alemania, toda empresa debe poder recibir facturas electrónicas B2B desde enero de 2025, y la obligación de emisión se despliega por fases hasta 2028. El B2G ya exige XRechnung con Leitweg-ID. En Francia, el mandato Factur-X impone la recepción desde septiembre de 2026 y la emisión en 2026-2027 según el tamaño de la empresa. Si su tienda Shopware vende B2B o factura a administraciones, la factura electrónica conforme a EN 16931 se convierte en una condición para cobrar.
Lo que el nativo de Shopware no cubre
Shopware ofrece una salida ZUGFeRD básica desde la versión 6.6.10, pero no produce XRechnung 3.0, no gestiona el Leitweg-ID, no existe en las versiones 6.5 y 6.6 anteriores, y sus datos del vendedor se limitan a los ajustes de documento. DfFacturX es una suite de conformidad completa: perfiles múltiples, datos del vendedor ricos por canal de venta, instrucciones de pago SEPA, categorías de IVA automáticas, adjunto por correo y herramientas de regeneración.
XRechnung 3.0 y Leitweg-ID, sin apaños
Facturar a una administración alemana exige un XML XRechnung con una referencia del comprador BT-10 — el Leitweg-ID — que Shopware no sabe almacenar. Al activarse, el plugin instala un campo personalizado dedicado en la ficha de cliente y en el pedido: introduzca el Leitweg-ID una vez en el cliente y se reutilizará en todas sus facturas, con posibilidad de sobrescribirlo pedido a pedido y un valor de respaldo configurable. El XML generado incluye el proceso de negocio Peppol, el contacto del vendedor BG-6 y las direcciones electrónicas exigidas por el validador KOSIT.
Un PDF híbrido, no un documento más
Para los perfiles Factur-X y ZUGFeRD, el XML se incrusta directamente en el PDF de factura generado por Shopware mediante actualización incremental: archivo factur-x.xml adjunto, relación AF de tipo Data, metadatos XMP PDF A-3 con el esquema de extensión Factur-X completo. El medio del documento se reemplaza in situ — el PDF que su cliente descarga desde su cuenta o recibe por correo es la factura electrónica híbrida. Si una estructura PDF exótica impide la incrustación, el plugin degrada limpiamente: el XML sigue disponible como adjunto de correo y por consola, y se registra una advertencia.
Un modelo contable que pasa los validadores
La norma EN 16931 es exigente: importes netos, líneas negativas prohibidas, desglose de IVA por categoría, totales coherentes al céntimo. DfFacturX convierte los pedidos con IVA incluido al modelo neto mediante los impuestos calculados de Shopware, transforma las promociones en descuentos a nivel de documento con su desglose por tipo, declara los gastos de envío como cargos de documento, y utiliza el campo RoundingAmount BT-114 para absorber cualquier desviación de redondeo: el GrandTotal del XML siempre es estrictamente igual al total del pedido en Shopware. Los tipos al 0 por ciento reciben automáticamente la categoría correcta — K intracomunitario, G exportación, Z — con motivo de exención.
Automático, y nunca bloqueante
La generación se activa al crear el documento de factura, sea cual sea el canal: admin, Flow Builder o API. El modo solo B2B restringe la generación a los pedidos profesionales. El XML se adjunta automáticamente a los correos de pedido. Y por diseño, un error de factura electrónica nunca bloquea la creación de la propia factura: el incidente se registra y el comando de consola df:facturx:generate permite regenerar tras la corrección, con cambio de perfil al vuelo y exportación del XML a un archivo.
Valide antes de pasar a producción
La documentación incluye una lista de comprobación completa: pedidos con IVA incluido y netos, promoción, gastos de envío, venta intracomunitaria con número de IVA, exportación fuera de la UE. Exporte el XML con un comando y envíelo al validador KOSIT para XRechnung o al validador Mustang para Factur-X y ZUGFeRD. Pasa a producción sabiendo exactamente lo que recibirán sus clientes y sus herramientas contables.
No hay valoraciones aún.