bitbetterde

bitbetterde / paperless-ngx-erechnung

Public

Parser plugin for Paperless-ngx to store and read E-Rechnungen (both XRechnung and ZUGFeRD).

e-rechnung paperless-ngx xlst xml xrechnung
19
0
89% credibility
Found May 17, 2026 at 19 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
XSLT
AI Summary

This is a plugin that adds special support for German electronic invoices to Paperless-ngx, a popular document management system. When you receive invoices in XRechnung (XML) or ZUGFeRD/Factur-X (PDF) formats—the official standards for German business-to-business e-invoicing—the plugin automatically recognizes them, extracts all the important information like invoice numbers, dates, seller details, and amounts, and makes everything visible and searchable. For XML invoices, it even creates a professional-looking PDF that matches the official invoice layout. The result is that German e-invoices become as easy to manage, search, and organize as any other document in your system.

How It Works

1
📄 You receive a German e-invoice

A supplier or customer sends you an invoice in the XRechnung or ZUGFeRD format, which is the standard for German business-to-business electronic invoices.

2
📤 You upload the invoice to Paperless-ngx

Just like any other document, you drop the invoice file into your Paperless-ngx system and it begins processing automatically.

3
🔍 Your system recognizes the e-invoice format

Behind the scenes, the plugin identifies that this is a German e-invoice and takes over the processing instead of treating it like a regular document.

4
The system processes your invoice
📝
For XRechnung (XML invoices)

The plugin transforms the raw XML into a beautiful, readable PDF that looks exactly like the official invoice layout.

📎
For ZUGFeRD (PDF invoices)

The plugin extracts the embedded invoice data while keeping your original PDF perfectly intact with all its official certifications.

5
💰 Invoice details appear in the sidebar

You can immediately see the invoice number, dates, seller information, and amounts right in the document sidebar without opening the file.

6
🔎 Everything becomes searchable

All the invoice details are converted into searchable text, so you can find this invoice later by searching for the invoice number, seller name, or any amount.

✅ Your e-invoice is perfectly organized

The invoice is saved as an archive with a clear PDF preview, searchable details, and all metadata ready for your records or accounting software.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 19 to 19 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is paperless-ngx-erechnung?

This is a plugin that brings German e-invoice processing directly into Paperless-ngx. If your business needs to handle the XRechnung or ZUGFeRD/Factur-X formats mandated for B2B invoicing in Germany, this plugin makes them first-class citizens in your document management pipeline. Upload an XML invoice or hybrid PDF, and the plugin extracts the structured data, renders a proper archive PDF, and surfaces invoice fields in the metadata sidebar. Full-text search works automatically across all extracted content. It registers two parsers that outrank Paperless's defaults when matching invoices are detected, so normal PDFs continue using the built-in path unchanged.

Why is it gaining traction?

Germany's E-Rechnung mandate means more developers are staring down the barrel of parsing complex XML-based invoice formats. The official KoSIT stylesheets ship with this plugin, so you get spec-compliant rendering without hunting down dependencies. The plugin handles both flavors of the standard, validates that uploaded files are actually German e-invoices (not random XML or PDFs), and gives clear error messages when something is wrong. No configuration beyond installing a JRE and the package itself.

Who should use this?

Small German businesses running Paperless-ngx who receive invoices in either format. If you're manually copying invoice numbers and amounts into spreadsheets because Paperless can't read the XML, this plugin solves that. Teams with compliance requirements around PDF/A-3 archiving should note that ZUGFeRD files pass through unchanged, preserving the Factur-X signature and conformance. Developers building German-focused document automation will find the clear entry-point documentation and clean separation of detection, extraction, and rendering logic easy to extend.

Verdict

With 19 stars this is early-stage software, and the AI-assisted development disclaimer in the README is worth acknowledging. That said, the documentation is thorough, the architecture correctly gates on content validation before claiming files, and the approach of vendoring official KoSIT stylesheets avoids the maintenance burden of rolling your own transforms. At a credibility score around 0.9%, the low star count is the main concern for production dependency decisions. If you're already running Paperless-ngx beta, this is worth a test deployment on non-critical documents to validate it fits your workflow. The 0.1.0 dev version suggests active development, so monitor the repository for stability signals before committing to production.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.