ZUGFeRD, XRechnung, Factur-X, UBL — auf Ihrem Server, in Ihrem Code
Das E-Rechnungs-SDK von Aloaha Limited erstellt und liest ZUGFeRD-, XRechnung- und Factur-X-Rechnungen in CII-Syntax aus VB6, VBA, VB.NET, C# und Web Services. Es liest auch UBL- / PEPPOL-Rechnungen und konvertiert sie nach ZUGFeRD — dieselbe Bibliothek dient also als UBL-nach-CII-Brücke. Rechnungsdaten verlassen Ihren Prozess nicht. Bereit für die deutsche B2B-E-Rechnungspflicht 2025.
Deutschland hat strukturierte B2B-Rechnungen verpflichtend gemacht. Die meisten ERPs sind nicht bereit.
Das Wachstumschancengesetz hat einen gestaffelten Übergang zur verpflichtenden elektronischen Rechnungsstellung zwischen Unternehmen eingeführt. Die Daten sind öffentlich und die Fristen sind kurz:
01.01.2027 — Unternehmen mit Jahresumsatz über 800.000 EUR müssen strukturierte elektronische Rechnungen für alle B2B-Transaktionen in Deutschland ausstellen.
01.01.2028 — die Ausstellungspflicht erstreckt sich auf jedes deutsche Unternehmen unabhängig vom Umsatz.
Die Vorgabe ist nicht auf Deutschland beschränkt. Frankreich führt die verpflichtende B2B-E-Rechnung über Factur-X / Chorus Pro zwischen 2026 und 2027 ein. Italien ist seit 2019 verpflichtend (SDI). Polen (KSeF), Spanien, Belgien und die Niederlande sind auf parallelen Pfaden. Die zugrundeliegende EU-Richtlinie 2014/55/EU und das EN 16931 Semantikmodell geben allen eine gemeinsame Datenform.
Ein überraschend grosser Anteil von ERP-, Buchhaltungs- und Rechnungssoftware erzeugt immer noch flache PDFs, die nicht maschinenlesbar sind. Das Nachrüsten eines strukturierten Rechnungsgenerators vor dem jeweiligen Marktstartdatum ist mittlerweile das häufigste E-Rechnungs-Projekt in der gesamten EU.
Operationen über den gesamten Rechnungs-Lifecycle (CII-nativ, UBL-fähig)
Erstellen
Bauen Sie eine ZUGFeRD- oder XRechnung-XML-Nutzlast aus Ihren existierenden Rechnungsdaten. Füllen Sie alle EN 16931 Pflicht- und Optionalfelder: Parteien, Positionen, Steueraufschlüsselung, Zahlungsbedingungen, Boni und Kosten, Referenzen, Anhänge.
Einbetten
Nehmen Sie eine existierende PDF/A- oder PDF/A-3-Rechnung und hängen Sie die strukturierte XML an. Visuelles Layout wird bitgenau erhalten; die maschinenlesbare Nutzlast liegt als eingebettete Datei daneben gemäss PDF/A-3-Spezifikation.
Konvertieren
Direkte XML-nach-PDF/A-3-Konvertierung: übergeben Sie dem SDK eine ZUGFeRD- oder XRechnung-XML und eine Word-Vorlage, erhalten Sie eine einzige PDF/A-3-Datei zurück, die sowohl menschenlesbar als auch maschinen-extrahierbar ist. CSV-Import für Tabellenkalkulations-Workflows.
Extrahieren
Holen Sie die eingebettete XML aus jeder empfangenen ZUGFeRD- oder Factur-X-PDF. Lesen Sie strukturierte Felder ohne OCR: Beträge, Steuerschlüssel, Fälligkeitsdaten, Leitweg-ID, Zahlungsreferenzen.
Lesen
Parsen Sie eine ZUGFeRD-, XRechnung- oder Factur-X-Rechnung (CII-Syntax) in typisierte Objekte, über die Ihr Buchhaltungscode iterieren kann. Derselbe Loader akzeptiert auch UBL 2.1 / PEPPOL BIS Billing 3 Dokumente in dasselbe interne Modell — das SDK ist damit gleichzeitig ein UBL-nach-CII-Konverter: PEPPOL beim Eingang lesen, ZUGFeRD beim Ausgang ausgeben.
Signieren
XAdES auf der XML-Nutzlast, PAdES auf der umgebenden PDF, RFC 3161 Zeitstempel über den Schwester-Dienst Aloaha Timestamping. Detached oder enveloped Signaturen.
UBL → CII konvertieren
Empfangen Sie eine PEPPOL- oder UBL-XInvoice von einem EU-Partner, laden Sie sie in das SDK, geben Sie sie als ZUGFeRD oder XRechnung wieder aus — gleicher Aufruf, gleiches In-Memory-Modell. Nützlich für deutsche Empfänger, deren ERP CII erwartet, deren EU-Lieferanten aber UBL senden.
Ein SDK, vier Ausgabe-Familien
| Standard | Was es ist | Wo es zählt |
|---|---|---|
| ZUGFeRD 2.x | Hybrides PDF/A-3 + UN/CEFACT CII XML. Profilfamilie: MINIMUM, BASIC WL, BASIC, EN 16931, EXTENDED, XRECHNUNG. | SDK liest + schreibt. Deutsches B2B und B2G; die Standard-Ausgabe des SDK. |
| XRechnung (CII) | Deutsches B2G-Bundesprofil in UN/CEFACT CII-Syntax. Leitweg-ID Routing-Identifikator verpflichtend. | SDK liest + schreibt. Verpflichtend für Rechnungen an Bundes- und die meisten Landesbehörden in Deutschland. |
| Factur-X | Französisches Nationalprofil, technisch Mitglied der ZUGFeRD-2.x-Familie mit französischer Semantik. Hybrides PDF/A-3 + CII XML. | SDK liest + schreibt. Französisches B2B zwischen 2026 und 2027; Chorus Pro für B2G. |
| UBL 2.1 / XRechnung (UBL) | OASIS XML-Grammatik, verwendet von PEPPOL BIS Billing 3 und der UBL-Variante von XRechnung. | SDK liest nur. Wird in dasselbe interne Rechnungsmodell geladen und dann als CII (ZUGFeRD / XRechnung) wieder ausgegeben. Das SDK agiert als UBL-nach-CII-Konverter für eingehende PEPPOL-Rechnungen. |
| EN 16931 | Das europäische Semantikmodell, mit dem alle vier oben konform sind. Definiert, was eine konforme Rechnung enthält, nicht wie sie serialisiert wird. | Der rechtliche Anker. EU-Richtlinie 2014/55/EU schreibt EN 16931 Konformität für B2G-Rechnungen in allen Mitgliedstaaten vor. |
| PEPPOL BIS Billing 3 | PEPPOLs UBL Business Interoperability Specification für Rechnungen. | SDK liest nur. Eingehende PEPPOL-Dokumente werden auf dem Weg zu CII konvertiert. Der PEPPOL-Transport selbst (Access Point mit AS4) ist eine separate Infrastruktur. |
Das SDK ist CII-nativ: seine Ausgabe ist immer ZUGFeRD / XRechnung / Factur-X (UN/CEFACT Cross Industry Invoice). Eingehende UBL-Dokumente durchlaufen dasselbe interne Modell und kommen als CII wieder heraus. Bauen Sie die Rechnung einmal; die Wahl des CII-Profils ist ein einziger Parameter.
Rechnungsdaten gehören zu den sensibelsten Finanzdaten, die Sie halten
Eine Rechnung trägt den rechtlichen Namen jedes Kunden, die Positionen, die Einzelpreise, Zahlungsbedingungen, Steuer-IDs, Bankverbindungen, Zahlungsreferenzen und gelegentlich Diagnosen, Aktenzeichen oder andere bereichsspezifische Kennungen in den Freitextnotizen. Für die meisten europäischen Unternehmen liegen diese Daten am Schnittpunkt von GDPR, der deutschen GoBD, branchenspezifischen Pflichten (Gesundheitswesen, Rechtsbereich, öffentliches Beschaffungswesen) und der eigenen geschäftlichen Vertraulichkeit des Unternehmens.
Eine cloud-gehostete Rechnungs-SaaS ist eine einzige konzentrierte Kopie all dieser Daten in der Hand eines Dritten. Das Aloaha SDK ist das Gegenteil: es läuft als Bibliothek innerhalb Ihres eigenen Prozesses, auf Ihrem eigenen Server, hinter Ihrer eigenen Firewall. Die einzigen Daten, die eine Netzwerkgrenze überqueren, sind diejenigen, die Ihre Anwendung ohnehin gesendet hätte. Es gibt keine Telemetrie, keinen Rückruf, keinen Lizenz-Ping nach der Installation.
Datenstandort
Rechnungsinhalt bleibt auf dem Host, der Ihre Buchhaltungs- oder ERP-Anwendung betreibt. Kein Transit zu einer Hersteller-Cloud. Kein bedingter Zugriff auf Hersteller-IP-Bereiche. Kein Hersteller-Ausfall stoppt Ihre Rechnungsstellung.
Compliance-Position
Eine Bibliothek innerhalb Ihrer Anwendung ist eine kleinere GDPR- / NIS2- / GoBD-Angriffsfläche als eine SaaS-Abhängigkeit. Einfachere Subunternehmer-Prüfung; der „Subunternehmer“ ist Ihr eigener Server.
Betriebliche Unabhängigkeit
Das SDK hat keinen Lizenzserver-Rückruf und keine Nutzungs-Telemetrie. Ein luftgekapseltes Netzwerk hinter einer nationalen Firewall kann es genauso betreiben wie ein im öffentlichen Internet.
Einbindbar in alles von einem VBA-Makro bis zu einem Web-Services-Backend
COM (VB6, VBA, Classic ASP)
Registrieren Sie die COM-Bibliothek, instanziieren Sie das ZUGFeRD-Objekt, füllen Sie die Struktur, rufen Sie SaveXML oder MergeXMLIntoPDF auf. Funktioniert von jedem COM-fähigen Host einschliesslich Office-Makros. Early-Binding und Late-Binding beide unterstützt.
VB6 VBA VB5 Classic ASP.NET (C#, VB.NET, PowerShell)
Referenzieren Sie die Assembly, instanziieren Sie die Rechnung, konfigurieren Sie Felder, rendern Sie die Ausgabe. Funktioniert von jeder CLR-Sprache einschliesslich F#, IronPython, PowerShell-Skripten. Sowohl Early-Binding (typsicher) als auch Late-Binding (Reflection) Eintrittspunkte veröffentlicht.
C# VB.NET .NET Framework .NET 6+Kommandozeile
CLI-Tools kapseln dieselben Operationen für Shell-Pipelines und geplante Jobs. Nützlich für Batch-Import aus CSV, Batch-Konvertierung von Legacy-PDFs und CI/CD-Validierung von Fixture-Daten.
PowerShell cmd.exe bashWeb Services
HTTP-Eintrittspunkte (xmluploader, pdfuploader, zugferd, MergeXMLIntoPDF, CreateDOCXFromXML, ExportZUGFeRDXML2Disk) stellen das SDK jeder Sprache ohne COM- oder CLR-Reichweite zur Verfügung: PHP, Python, Node, Java, Go, Rust.
PHP Python Node JavaGUI-Tool
Eigenständige portable Windows-GUI, die Rechnungen ohne Code erstellt, einbettet, extrahiert und liest. Nützlich für Buchhaltungspersonal, das Ausnahmefälle, Prüfungen und einmalige Rechnungen ausserhalb des ERP bearbeitet.
Portable Windows ohne InstallationPDF Viewer
Kostenloser Aloaha ZUGFeRD PDF Viewer liest eingebettete XML aus jeder ZUGFeRD- / Factur-X-PDF und zeigt die strukturierten Felder neben der visuellen Darstellung. Nützlich für Empfänger, die eingehende Rechnungen prüfen.
kostenlos WindowsEin Hersteller für souveräne Identität, Kommunikation, Signatur und Rechnung
Aloaha Limited baut den Rest des Stacks auf dieser Seite: den CodeB Credential Provider V2 für gehärteten Windows-Logon, den CodeB OIDC + Passkeys Identity Provider, den Live-EU-Digital-Identity-Wallet-Validator, die Voice AI, den souveränen SBC, den kostenlosen CodeB-Signaturserver für HBA / qualifizierte elektronische Signaturen und den RFC 3161 Timestamping-Dienst bei timenotary.com. Das E-Rechnungs-SDK lebt neben all diesen in derselben Engineering-Organisation.
Kunden, die CodeB betreiben, wählen typischerweise den SDK-Weg für die Rechnung, weil Beschaffung, Support-Verträge, Audit und die Frage „ist der Hersteller in fünf Jahren noch da?“ alle dieselbe Antwort ergeben. Es gibt keine Integrationsgeschichte zwischen dem Comms-Stack und dem SDK; sie sind einfach derselbe Hersteller. Aber das reicht oft, um eine mehrquartalige Ausschreibung abzukürzen.
FAQ
Wie ist die Lizenzierung?
Pro Entwickler zur Evaluation, perpetual Lizenz für Produktion, OEM-Lizenzierung für ISVs, die das SDK in ihr Produkt einbetten. Die Preisseite auf zugferdpro.com listet aktuelle Tarife; eine Evaluationslizenz wird per E-Mail ausgestellt.
Validiert es gegen KoSIT / Mustang?
Die Ausgabe erfüllt das EN 16931 Semantikmodell und die deutsche Leitweg-ID- sowie BG/BT-Anforderungen. Drittvalidatoren sind sich in der Regelauslegung gelegentlich uneins; das Aloaha-Team veröffentlicht Positionen, wenn das relevant wird. Siehe den zugferdpro.com Blog für die neueste Lage.
Kann ich meinen vorhandenen PDF-Generator behalten?
Ja. Die häufigste Deployment-Form ist Ihre bestehende Anwendung, die die visuelle PDF wie bisher erzeugt, und das SDK, das in einem zweiten Schritt die strukturierte XML als Anhang hinzufügt. Layout unberührt, Maschinenlesbarkeit ergänzt.
Was ist mit Word-Vorlagen?
Das SDK enthält einen DOCX-nach-PDF/A-Konverter und eine direkte „XML + Word-Vorlage → ZUGFeRD PDF“-Pipeline. Nützlich, wenn das Rechnungslayout in vom Marketing kontrollierten Word-Dokumenten liegt statt im Code.
Wie werden XAdES-Signaturen verifiziert?
Standard-XAdES, überprüfbar von jedem konformen Verifier einschliesslich der EU-eIDAS-kompatiblen Toolchain. PAdES-Signaturen auf der umgebenden PDF sind überprüfbar von Adobe Reader und jedem PAdES-fähigen Verifier.
Unterstützt es UBL / PEPPOL?
Eingehend ja: das SDK liest UBL 2.1 / PEPPOL BIS Billing 3 Rechnungen in sein internes Modell. Ausgehend gibt das SDK immer CII aus (ZUGFeRD / XRechnung / Factur-X). Für ein deutsches Unternehmen, das PEPPOL von einem EU-Partner empfängt und ZUGFeRD für sein ERP benötigt, ist das SDK die Brücke. Der PEPPOL Access Point (AS4-Transport) selbst ist eine separate Infrastruktur.
Wer kauft dieses SDK tatsächlich
In der Praxis wird das SDK von zwei deutlich unterscheidbaren Gruppen gekauft. Beide gewinnen dasselbe: ZUGFeRD-Konformität, an eine bestehende Anwendung angebaut, ohne sie neu zu schreiben.
A · Bestehenden historisch gewachsenen Rechnungs-Workflow nachrüsten
Ein Unternehmen betreibt bereits einen Rechnungs- oder Order-to-Cash-Workflow, der älter ist als die deutsche E-Rechnungspflicht 2025. Vielleicht eine vor zehn Jahren gebaute MS-Access-Datenbank, eine Microsoft Dynamics / Navision-Installation mit eigenen Formularen, klassische VB5- oder VB6-Desktop-Tools, eine Delphi-Anwendung, ein Office VBA-Makro oder ein moderner .NET-Dienst. Welche Sprache auch immer der Host hat — die COM- + .NET- + CLI-Oberfläche erlaubt es, das SDK aus dieser bestehenden Anwendung heraus aufzurufen. Das typische Muster: die Anwendung erzeugt Rechnungen wie bisher, und das SDK fügt in einem zweiten Schritt die strukturierte ZUGFeRD-XML-Nutzlast in die erzeugte PDF ein. Visuelles Layout bleibt bitgenau erhalten. Keine Neuentwicklung.
B · Softwarehersteller / ISV erweitert sein eigenes Produkt um ZUGFeRD
Ein ISV veröffentlicht sein eigenes kommerzielles Rechnungs-, Abrechnungs-, Buchhaltungs- oder ERP-Produkt und muss nun ZUGFeRD- / XRechnung-Ausgabe an seinen Kundenstamm liefern. Statt einen CII-Serialisierer selbst zu bauen, bettet der ISV das Aloaha SDK ein und verteilt es unter einer OEM-Lizenz mit. Der ISV liefert ZUGFeRD-Ausgabe an seine Kunden unter eigener Marke, mit einer konsolidierten Lizenz, die sowohl das Host-Produkt als auch das eingebettete SDK abdeckt. OEM-Bedingungen decken Weiterverteilungsrechte, Branding, Support-Eskalation und Update-Berechtigungen ab.
Beide Segmente kontaktieren zugferdpro.com Preise oder schreiben an info@aloaha.com für eine Evaluationslizenz. OEM-Bedingungen sind nach Bereitstellungsvolumen gestaffelt.
SDK herunterladen
Laden Sie die Testversion herunter, sehen Sie die Preise, oder lesen Sie den VB.NET- / VB6-Beispielcode auf der Produktseite. Derselbe Hersteller, der den Comms-Stack auf dieser Website baut.
zugferdpro.com ↗ Downloads ↗ Preise ↗