youniwemi/digital-invoice

Digital Invoice is an easy wrapper around easybill/zugferd-php, josemmo/einvoicing and atgp/factur-x that will allow you generate Factur-x and UBL (Peppol, Cius...) invoices in a very easy way.

v0.2.4 2025-04-23 23:56 UTC

Requires

• atgp/factur-x: ^1.0
• easybill/zugferd-php: dev-master
• jms/metadata: 2.8.0
• jms/serializer: 3.28.0
• josemmo/einvoicing: ^0.3.0
• milo/schematron: dev-master

Requires (Dev)

• phpunit/phpunit: ^8 || ^9

MIT

• Rahal Aboulfeth

• invoice
• ZUGFeRD
• ubl
• e-invoicing
• digital invoice
• factur-x
• peppol
• Cius

README

Digital Invoice offers an effortless and unified interface for generating E-Invoices across various formats. It serves as a simplified wrapper around key libraries such as easybill/zugferd-php, josemmo/einvoicing, and atgp/factur-x. Our objective is to streamline the process of E-Invoice generation by bringing together the capabilities of these established libraries into one easy-to-use package.

We extend our sincere appreciation to the developers of these libraries for their foundational contributions to the field.

Supported Formats

Digital Invoice supports a range of formats, catering to diverse invoicing needs:

• Factur-X PDF Invoice:

  • Profiles: MINIMUM, BASIC_WL, BASIC, EN16931, EXTENDED

• ZUGFeRD PDF Invoice:

  • Profiles: CONFORT, BASIC, EXTENDED

• XRechnung XML Invoice:

  • A widely-used German XML format

• UBL XML Invoices:

  • Profiles: Peppol, Nlcius, CiusRo, CiusIt, CiusEsFace, CiusAtNat, CiusAtGov

Getting Started

To integrate Digital Invoice into your PHP project:

1. Add Digital Invoice to your project. For installation details, refer to the accompanying documentation.
2. Explore our test cases for examples and usage guidelines.

Digital Invoice enables you to generate E-Invoices in the following formats with ease:

• Factur-X PDF Invoice:

  • Profiles: MINIMUM, BASIC_WL, BASIC, EN16931, EXTENDED

• ZUGFeRD PDF Invoice:

  • Profiles: CONFORT, BASIC, EXTENDED

• XRechnung XML Invoice:

  • A standard German XML format

• UBL XML Invoices:

  • Profiles: Peppol, Nlcius, CiusRo, CiusIt, CiusEsFace, CiusAtNat, CiusAtGov

Development Status and Collaboration

Active Development: Please note that Digital Invoice is currently under active development. As such, the API and functionalities may undergo changes. We encourage users to use this package with caution and to stay updated with the latest versions for the most stable experience.

Collaboration and Support: We welcome collaboration and are eager to support specific use cases that enhance the utility of Digital Invoice. If you have unique invoicing needs or suggestions for improvements, we would be delighted to hear from you and work together to expand the capabilities of this package. Your contributions and feedback are invaluable in shaping a more versatile and robust tool.

Contributors

@yassiNebeL : Adding support to UBL Format using josemmo/einvoicing

Credits and Acknowledgements

We are grateful to the following projects and teams for their contributions:

• ZUGFeRD PHP SDK (Factur-X, XRechnung) - For enabling the generation of Factur-X, XRechnung and Zugferd.
• European Invoicing (eInvoicing) - For enabling the generation of UBL invoices.
• PHP Factur-X Library - Providing foundational tools for Factur-X invoicing.
• Tiime Software Team - For their work on structured data types in E-Invoicing.