django-xrechnung

Create validated XRechnung XML and printable PDF invoices in Django.

Bring invoicing into your existing Django project: prepare drafts in admin or Python, review calculated totals, then finalize and download both documents. The app runs the official KoSIT validator locally and renders PDFs with WeasyPrint. XML, PDF, and the validation report are stored together when finalization succeeds.

What it does

• Invoices, credit notes, and corrections: generate XRechnung 3.0.2 documents in UBL 2.1 or CII, including credit notes and corrected invoices linked to their originals.
• Flexible VAT: combine German 7% and 19% VAT, exempt lines, and reverse charge with separate tax breakdowns, exemption reasons, and consistent decimal rounding.
• Printable PDFs: produce German invoice layouts with customizable templates, wrapping descriptions, repeated table headers, and page numbers.
• Factur-X output: generate PDF/A-3b invoices with embedded CII using WeasyPrint, validated by veraPDF and the pinned XML rules before issuance.
• Less repeated data entry: reuse seller, contact, and payment defaults for new drafts without changing existing invoices.
• Controlled issuance: enforce ownership and Django permissions, validate before issuing, and preserve finalized documents against edits through the app.
• Django integration: use the supplied admin, review pages, JSON read endpoints, document downloads, and Python services in your own workflows.
• Incoming invoice review: receive immutable originals through Python, a management command, or admin upload; deduplicate within owned inboxes, retain validation evidence, and retry failures. Validate UBL/CII XRechnung and Factur-X XML, including XML extracted from PDFs with the optional inbound extra. Review parsed parties, lines and totals, reconciliation mismatches, and unsupported fields without changing originals.

Invoice validation and PDF rendering run on your application host. Invoice data is not uploaded to an external validation service.

Project status

Alpha, under active development. The draft-to-document workflow is implemented, including credit notes and corrections. Automated tests exercise real KoSIT acceptance and rejection, PDF output, permissions, calculations, migrations, and installation from a built wheel.

The current outgoing invoice scope covers German sellers and buyers, EUR, standard VAT, exemptions and reverse charge, email electronic addresses, and SEPA transfers to German IBANs. See the supported invoice scenarios for exact limits.

Creating invoices with discounts, charges, attachments, or additional countries, and transmission integrations, are not yet supported. Settlement tracking and cumulative credit limits remain outside the app. PDFs can be separate printable documents or Factur-X EN 16931 hybrids with embedded CII and mandatory runtime PDF/A-3b checks.

Get started

Install from Codeberg with Git available in your environment:

python -m pip install git+https://codeberg.org/fsbraun/django-xrechnung.git

Follow the first-invoice tutorial to install into a Django project and generate your first XML and PDF. The installation guide covers Java and WeasyPrint's system dependencies.

Documentation

The documentation is organized around tutorials, how-to guides, reference, and explanation:

• Configure seller defaults, manage permissions, and customize PDFs.
• Use VAT exemptions and reverse charge.
• Create credit notes and corrected invoices.
• Look up configuration, Python services, and HTTP endpoints.
• Understand finalization and VAT calculations.
• Choose CII or Factur-X PDF output.
• Receive and review documents.

For repository development, see contributing.

See the runnable example, changelog, and compatibility and release policy.

License

BSD 3-Clause. KoSIT, WeasyPrint, and system fonts retain their upstream licenses.