E-Invoice Transmission

E-Invoice Transmission for Sylius 2

Transmission of Factur-X invoices generated by tmonier/sylius-facturx-plugin: a replaceable port towards a platform, a log of the sends with their statuses, and an idempotent listener.

This is the first slice of the plugin (version 0.x). It ships the port, the log, the listener and a null adapter. It does not connect to any real platform: the adapters are yours to write.

Key Features

• Port/Adapter architecture — Implement TransmissionAdapterInterface to connect to any e-invoicing platform
• Idempotent listener — Listens to tmonier_facturx.invoice_generated events, never sends the same invoice twice
• Transmission log — One line per invoice with status (transmitted, error, not_transmitted), message, and timestamps
• Error isolation — A failing adapter never breaks invoice generation; exceptions are caught and logged
• Status validation — Unknown statuses from adapters are refused and reported
• Null adapter — Default adapter that logs without sending, for safe installation

Compatibility

• Sylius 2.2+ and 2.3+
• PHP 8.2+
• Symfony 6.4 / 7.4 / 8.0+
• Requires tmonier/sylius-facturx-plugin ^1.0

Installation

composer require tmonier/sylius-einvoice-transmission-plugin

Full documentation and source code: github.com/thibmonier/sylius-einvoice-transmission-plugin