European e-Invoice

Create and import e-invoices with ERPNext.

This app converts between ERPNext and UN/CEFACT Cross-Industry-Invoice (CII) XML in the BASIC, EN 16931, EXTENDED, and XRECHNUNG profiles. All profiles except "XRECHNUNG" can be embedded in a PDF file (ZUGFeRD / Factur-X). UBL invoices and Peppol transport are out of scope.

---

Documentation

User documentation lives under eu_einvoice/docs/. Compendium serves these files in Desk at /app/docs when that app is installed.

You can also read the Markdown files in this repository:

• Overview
• Setup
• Sales Invoice
• Purchase Invoice
• Custom logic

Installation

You can install this app using the bench CLI:

cd $PATH_TO_YOUR_BENCH
bench get-app https://github.com/alyf-de/eu_einvoice --branch $MAJOR_VERSION
bench install-app eu_einvoice

Please use a branch (MAJOR_VERSION) that matches the major version of ERPNext you are using. For example, version-14 or version-15. If you are a developer contributing new features, you'll want to use the develop branch instead.

Contributing

This app uses pre-commit for code formatting and linting. Please install pre-commit and enable it for this repository:

cd apps/eu_einvoice
pre-commit install

Pre-commit is configured to use the following tools for checking and formatting your code:

• ruff
• eslint
• prettier
• pyupgrade

CI

This app can use GitHub Actions for CI. The following workflows are configured:

• CI: Installs this app and runs unit tests on every push to develop branch.
• Linters: Runs Frappe Semgrep Rules and pip-audit on every pull request.

Dependencies

• drafthorse by Raphael Michel, released under the Apache License 2.0

  Used to create and parse XML invoices.

• factur-x by Alexis de Lattre, released under a BSD License

  Used to extract XML data from PDF files, and to create PDF files with embedded XML.

• SaxonC by Saxonica

  Used for XSL transformation (validate XML against schematron).

• lxml by Infrae

  Used for general XML parsing.

• SchXslt by David Maus

  Used to convert Schematron files to XSL.

Sponsors

Many thanks to the following companies for sponsoring the initial development of this app:

• aepfel+birnen IT GmbH
• axessio Hausverwaltung GmbH
• Burkhard Baumsteigtechnik GmbH & Co. KG
• DriveCon GmbH
• ibb testing gmbh
• itsdave GmbH
• iXGate UG
• Kautenburger IT GmbH
• MERECS Engineering GmbH
• Royal Software GmbH
• voidsy GmbH
• … and many more

Note

We only list companies that have explicitly agreed to have their name published here. If you want to be listed here too, please send us a short note by email.

License

Copyright (C) 2024 ALYF GmbH

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or(at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.