ZUGFeRD in Python erstellen: Schnelle REST-API statt komplexer XML-Bibliotheken

Python-Entwickler verbringen oft Tage damit, Factur-X XML-Schemata mit lxml, ReportLab oder pdfminer zusammenzubauen. Mit unserem PyPI-Paket zugferd-client oder einfachem httpx erstellst du valide ZUGFeRD PDF/A-3 Rechnungen in wenigen Zeilen.

Eigene Rechnung hier hineinziehen

oder Datei vom Computer auswählen (.pdf oder .xml bis 10 MB)

🔒 100 % flüchtige RAM-Prüfung auf deutschen Servern (Frankfurt) – keine Speicherung.

Code-Vergleich: Falsches vs. Korrektes CII-XML

✗ Häufiger Fehler / Falsches XML Nicht konform

<!-- FEHLER: Manuell zusammengebautes XML in Python mit ungültiger Zeichenkodierung / Steuerzeichen -->
<?xml version="1.0" encoding="ISO-8859-1"?>
<rsm:CrossIndustryInvoice>
  <!-- ISO-8859-1 ist nach EN 16931 unzulässig! Zwingend UTF-8 vorgeschrieben -->
</rsm:CrossIndustryInvoice>

✓ Valide nach EN 16931 / KoSIT Normkonform

<!-- KORREKT: Sauberes UTF-8 XML mit deklarierter EN 16931 Guideline -->
<?xml version="1.0" encoding="UTF-8"?>
<rsm:CrossIndustryInvoice xmlns:rsm="urn:un:unece:uncefact:data:standard:CrossIndustryInvoice:100">
  <!-- Validiertes UTF-8 CII XML ohne fehlerhafte Escapes -->
</rsm:CrossIndustryInvoice>

Technische Ursache & Lösung

In Python existieren zwar Open-Source-Bibliotheken für ZUGFeRD, diese sind jedoch häufig veraltet, unterstützen die neuen KoSIT-Regeln der XRechnung 3.0 nicht oder erfordern fehleranfälliges PDF-Munging mit unvollständigen PDF/A-3 Konformitäts-Flags.

Mit unserer Cloud-API und dem offiziellen PyPI-Paket `zugferd-client` erstellst du Rechnungen mit sauberem Python-Code: ```python import httpx

payload = { "invoice_number": "RE-2026-PY01", "issue_date": "2026-10-24", "seller": {"name": "Python Devs GbR", ...}, "buyer": {"name": "Kunde GmbH", ...}, "line_items": [{"description": "Backend API", "quantity": 1, "unit_price": 500, "tax_rate_percent": 19}] }

resp = httpx.post( "https://e-rechnung-cloud.de/v1/invoice/generate", headers={"X-API-Key": "zg_test_ouroboros_001"}, json=payload ) with open("rechnung.pdf", "wb") as f: f.write(resp.content) ``` Das Backend kümmert sich um PDF/A-3 Konvertierung, Schriften-Embedding (UTF-8), XML-Generierung und Schematron-Validierung.

⚡ Die schlüsselfertige Abkürzung für Entwickler & No-Code

Keine Lust auf XML-Schematron-Fehler und Rundungsdifferenzen?

Unsere E-Rechnung Cloud API übernimmt alle mathematischen Berechnungen, Steuerregeln, XSD-Schemata und die PDF/A-3 Konvertierung vollautomatisch im Hintergrund.

📦 n8n Workflow (.json) ⚡ Make.com Blueprint 🛒 WooCommerce Plugin (.zip) API-Key ab 10 € Prepaid holen →

Häufig gestellte Fragen (FAQ)

Gibt es ein fertiges Python-SDK auf PyPI?

Ja! Das offizielle Paket 'zugferd-client' steht auf PyPI zur Verfügung (pip install zugferd-client) und bietet vollständige Typisierung und MCP-Server-Support.

Kann ich die API auch asynchron mit httpx oder aiohttp nutzen?

Ja, der REST-Endpunkt ist auf maximale Parallelität ausgelegt und lässt sich problemlos mit asyncio, httpx.AsyncClient oder Celery-Tasks integrieren.

Wie teste ich die Python-Anbindung lokal?

Du kannst sofort den öffentlichen Test-Key zg_test_ouroboros_001 nutzen, um Generierung und Validierung ohne Registrierung zu testen.

Passende Themen & Normen

Alle 12 Themen ansehen →

C# / .NET 8