Thank you for your interest in contributing to XRechnung-for-Delphi.
Bug reports, test cases, documentation improvements and pull requests are welcome. Please read the following guidelines before submitting code.
By submitting a pull request or other contribution, you agree to the contribution licensing terms described below.
XRechnung-for-Delphi is a Pascal library for reading, writing and processing electronic invoices, including:
- XRechnung
- ZUGFeRD / Factur-X
- Peppol BIS Billing
- UBL and CII invoice documents
- embedded invoice data in PDF files
The library supports Delphi and Free Pascal where documented in the README.
Please:
- Keep changes focused on a single issue or feature where possible.
- Avoid unrelated formatting or whitespace changes.
- Follow the style of the surrounding source code.
- Add or update tests for functional changes.
- Make sure existing tests still pass.
- Clearly describe what was changed and why.
Changes affecting generated invoice XML should, where applicable, be tested against the official or commonly used validation tools for the respective invoice format.
Please avoid introducing compiler- or platform-specific code into shared units unless necessary.
Where differences between Delphi and Free Pascal are required, use conditional compilation and keep the common implementation shared wherever practical.
Changes that intentionally break the public API should be discussed before implementation.
Pascal source files containing non-ASCII characters should use UTF-8 encoding that can be read reliably by supported Delphi and Free Pascal versions.
Please do not convert existing files to another encoding as part of unrelated changes.
Existing German or English comments do not need to be translated merely for consistency.
New public APIs should contain enough documentation to make their intended use and any relevant invoice-standard restrictions understandable.
Where practical, references to EN 16931 business terms or groups such as BT-... and BG-... are encouraged.
XRechnung-for-Delphi is dual-licensed.
Users may use the project under either:
- the GNU General Public License version 3 or later (GPL-3.0-or-later); or
- the Landrix Software Commercial License.
The commercial license allows the library to be used as part of proprietary applications without the copyleft requirements of the GPL.
To preserve this dual-licensing model, contributions must be available for use under both licensing options.
By intentionally submitting a contribution for inclusion in XRechnung-for-Delphi, you agree to the following terms:
You retain the copyright in your contribution.
You grant Landrix Software GmbH & Co. KG a perpetual, worldwide, non-exclusive, irrevocable, royalty-free license to:
- use,
- reproduce,
- modify,
- prepare derivative works of,
- publicly display,
- publicly perform,
- distribute,
- sublicense, and
- otherwise incorporate
your contribution, in source or binary form, as part of XRechnung-for-Delphi and related versions of the project.
This license includes the explicit right to distribute and sublicense your contribution:
- under the GNU General Public License version 3 or any later version;
- under the Landrix Software Commercial License; and
- as part of commercial or proprietary distributions of XRechnung-for-Delphi offered by Landrix Software.
This grant does not transfer ownership of your copyright to Landrix Software.
Where you own or control patent claims that would necessarily be infringed by your contribution alone or by its combination with the project as submitted, you grant Landrix Software and recipients of the contribution a perpetual, worldwide, non-exclusive, royalty-free patent license to make, use, offer for sale, sell, import and otherwise use the contribution as part of the project.
This patent grant applies only to patent claims that you have the right to license.
By submitting a contribution, you represent that:
- you created the contribution yourself or otherwise have the legal right to submit it under these terms;
- the contribution does not knowingly include code or other material that you are not authorized to provide;
- you have the authority to grant the rights described above.
If your contribution was created as part of your employment or on behalf of a company or other organization, you are responsible for ensuring that you are authorized to submit it under these terms.
Please do not submit code copied from another project unless its license is compatible with this project and its origin and license are clearly identified.
If a contribution contains or is derived from third-party code, please state this clearly in the pull request and provide:
- the original project or source;
- the copyright holder, where known;
- the applicable license;
- a link to the original source where possible.
Do not submit GPL-only third-party code if Landrix Software would not also have the right to include that code in the commercially licensed version of the project.
Permissively licensed code, such as code under the MIT, BSD or Apache License 2.0, may be acceptable, but applicable attribution and redistribution requirements must be preserved.
Code created with automated development tools or generative AI may be submitted, but the contributor remains responsible for the contribution.
In particular, you must ensure that:
- you have the right to submit the resulting code;
- no incompatible third-party code has been reproduced;
- the contribution has been reviewed and tested;
- the contribution complies with the licensing terms above.
Automated generation does not remove the contributor's responsibility for correctness, security or licensing.
Submission of a pull request does not guarantee that it will be merged.
Landrix Software may request changes, additional tests or documentation before accepting a contribution.
Once a contribution has been accepted into the project, the rights granted under the Licensing of contributions section are irrevocable.
If you are unsure whether a contribution can be submitted under these terms, please open an issue before submitting the code or contact:
Landrix Software GmbH & Co. KG info@landrix.de