Skip to content

A modern object-oriented PHP library to read and create valid UBL and Peppol BIS files

License

Notifications You must be signed in to change notification settings

num-num/ubl-invoice

Repository files navigation

UBL-Invoice

A modern object-oriented PHP library to create valid UBL and Peppol BIS 3.0 files. Please feel free to contribute if you are missing features or tags.

Latest Version on Packagist Total Downloads

Num•Num UBL Invoice

Installation and usage

This package requires PHP 7.4 or higher and is fully compatible with PHP 8. Installation can be done through composer.

1.0 - writing UBL files

$ composer require num-num/ubl-invoice

2.0 - reading and writing UBL files

💡 We are working on a 2.0 release of this package that will also be able to read ubl files!

If you are interested in trying this out, please check out the 2.0 branch or use the 2.0 version of the package in your project. Please beware that this is still in development and we may still introduce breaking changes.

$ composer require num-num/ubl-invoice:^2.0.0-beta

Contributing

This library is not 100% UBL/Peppol feature-complete, in the sense that it doesn't (yet) support all UBL XML tags & functionality. "Yet" being the keyword, since this definitely is the long-term goal. All common UBL tags that are required for most invoices are present in the library. This includes tags for discounts, cash discounts, special vat rates, etc...

If you are missing functionality, please feel free to add it :-) Adding additional tags & attributes is fairly straight-forward. Check out CONTRIBUTING.md for more information.

Examples & documentation

This repository does not have a documentation website at this moment. For now, please check out some code examples by checking the unit tests in the tests folder.

Changelog

A changelog is available since version v1.9.0. If you are upgrading a minor version (1.x) or major version, please check the changelog to see if you need to implement any breaking changes...

About

A modern object-oriented PHP library to read and create valid UBL and Peppol BIS files

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 27

Languages