ZUGFeRD / Factur-X extension for SuiteCRM 7.1x AOS Invoices – beta testers wanted

👨‍💻 Development Help
1

Open Source ZUGFeRD / Factur-X extension for SuiteCRM 7 AOS Invoices – beta testers wanted

Hi everyone,

I’ve been working on a ZUGFeRD / Factur-X extension for SuiteCRM 7 and AOS Invoices, and I’ve now published the first public beta on GitHub.

The goal of the project is fairly simple: generate structured electronic invoices without having to replace the existing AOS invoice and PDF workflow.

The extension keeps the existing AOS PDF template as the visible invoice, generates EN 16931 XML from the invoice data, and embeds it as factur-x.xml into a PDF/A-3 document.

Current version: 0.2.0-beta.1

What currently works:

  • ZUGFeRD / Factur-X with EN 16931

  • PDF/A-3 with embedded factur-x.xml

  • existing AOS PDF templates can still be used

  • invoices, cancellation invoices, replacement invoices and credit notes as document types

  • linking cancellation/replacement invoices to the original invoice

  • validation of the original invoice relationship

  • cancellation invoices are treated as negative amounts for revenue reporting

  • central configuration of seller and payment information

  • German and English labels

  • integration via hooks instead of replacing the complete AOS Invoices detailviewdefs.php

The generated documents have been tested with veraPDF and Mustangproject. A test document passed PDF/A-3b validation, and the embedded XML was validated against the EN 16931 schema.

There are still some known limitations. For example, credit notes are not yet treated as negative amounts in the additional revenue fields, existing AOR reports have to be adapted manually, and I haven’t yet been able to test the module across a wide range of SuiteCRM 7 versions, themes and customized AOS installations.

That last point is the main reason I’m posting this here.

I’m looking for beta testers.

If you have a SuiteCRM 7 test installation using AOS Invoices, I’d be very interested to know whether the module installs and works correctly in your environment — especially with custom PDF templates or customized invoice modules.

The project is open source under the GPL and available here:

https://github.com/Pi-R-JB/suitecrm-zugferd

Please don’t use the current beta as an untested drop-in replacement on a production system. Make a backup, use a test instance first, and validate the resulting electronic invoices before using them in a real accounting workflow.

Bug reports, compatibility reports and contributions are very welcome — even a short “works with SuiteCRM x.x and PHP x.x” would be useful.

Thanks,
Pierre

1 Like