Alle 164 Business Terms, sichtbar
Ein Shortcode macht aus Ihrer WordPress-Seite einen vollständigen E-Rechnungs-Leser. Der Besucher zieht eine ZUGFeRD-/Factur-X-PDF oder eine XRechnung-/UBL-XML in die Seite und sieht sofort das ganze Dokument – strukturiert, lesbar, bis zum letzten Detailfeld. Ohne externen Dienst, ohne API-Schlüssel, und die Datei wird nie gespeichert.
Business Terms
Business Groups
geprüfte Beispielrechnungen
Sprachen
Echte Ausgabe, kein Mockup
So sieht eine eingelesene Rechnung aus: Kopfzeile mit Rechnungsnummer, Datum, Währung und Zahlbetrag, darunter die Felder Zeile für Zeile — jedes mit seiner EN-16931-Kennung daneben.
Ohne Kennungen: die reine Leseansicht für alle, die einfach nur die Rechnung sehen wollen.
Positionen, USt-Aufschlüsselung und Summen — beim Überfahren einer Kennung steht die amtliche Definition aus der Norm.
Was der Viewer liest
Die eingebettete XML wird automatisch aus dem PDF-Objektbaum geholt und gelesen. Ein PDF ohne eingebettete Rechnung wird sauber abgelehnt.
Wird direkt gelesen – der Weg, den XRechnung-CII und ZUGFeRD/Factur-X gemeinsam haben.
XRechnung-UBL und Peppol BIS Billing 3.0, einschließlich Gutschriften – /CreditNote-Dokumente werden wie Rechnungen behandelt und als Gutschrift ausgewiesen.
Das Format wird am Dokument selbst erkannt, nicht an der Dateiendung: eine .xml mit UBL und eine mit CII funktionieren beide, ohne dass der Besucher etwas auswählen muss.
Vollständige EN-16931-Abdeckung
Alle 164 Business Terms und alle 32 Business Groups werden ausgelesen und dargestellt – auch die Blöcke, die die meisten Viewer auslassen. Die Abdeckung ist gegen den Beispielkorpus gemessen, nicht geschätzt.
Ein Feld ohne Wert erscheint als „—“ statt zu verschwinden. Genau darin liegt der Sinn einer Business-Term-Ansicht: zu sehen, welche Terms die Norm vorsieht und welche diese Rechnung ausgelassen hat. Leere Felder auszublenden würde genau diese Information verstecken.
Die BT-/BG-Kennungen selbst lassen sich ein- und ausblenden, live vom Besucher umgeschaltet, ohne Neuladen – der Ausgangszustand kommt je Einbindung aus dem Shortcode (bt=“1″ / bt=“0″) oder global aus den Einstellungen.
Drei Sprachen, aus der Spezifikation
Jede BT-/BG-Kennung trägt beim Überfahren den normativen Term-Namen samt vollständiger Definition – in Deutsch, Englisch oder Französisch, der Sprache der Seite folgend.
Der Wortlaut stammt unverändert aus der Factur-X-Spezifikation, nicht umformuliert: Was dort steht, steht auch bei einer Prüfung. Die Oberfläche selbst ist vollständig in alle drei Sprachen übersetzt.
BT-31 · Umsatzsteuer-Identifikationsnummer des Verkäufers
BT-31 · Seller VAT identifier
BT-31 · Identifiant à la TVA du vendeur
Jedes Feld, dessen Wert aus einer Referenztabelle stammt, wird aufgelöst – Dokumentart, Zahlungsart, Maßeinheit, Steuerkategorie, Land, Kennungsschema und Schema der elektronischen Adresse.
Datum, Zahlen und Beträge folgen der Seite: das Datumsformat aus Einstellungen → Allgemein, die Trennzeichen aus der aktiven Locale.
Darstellung
Sicherheit und Datenschutz
Für Entwickler
Ein Shortcode genügt. Setzen Sie einvoice_viewer in eckigen Klammern auf eine beliebige Seite. Mit dem Attribut bt=“1″ starten die Business-Term-Kennungen sichtbar, mit bt=“0″ verborgen – umschalten kann der Besucher jederzeit selbst.
Das EN-16931-Wissen liegt in einer eigenen Schicht (includes/core/), sauber getrennt vom WordPress-Teil – dadurch bleibt der Plugin-eigene Code klein und prüfbar. Keine PDF-Bibliothek zum Schreiben, keine Template-Engine, kein Framework wird mitgeschleppt.
SPEV_Renderer::model() gibt die ganze Rechnung als verschachteltes Array zurück – für Exporte, eigene REST-Endpunkte oder eine eigene Darstellung; model_json() liefert dasselbe als JSON-String. Die Form des Modells ist als versioniertes JSON-Schema festgehalten, abgeleitet aus dem tatsächlichen Output. Ein eigenes Layout ist eine Klasse; die Ausleselogik bleibt unangetastet.
Wer die Ansicht nicht per Shortcode, sondern aus eigenem Code anfordern will, kann statt der AJAX-Aktion auch die REST-Route POST /wp-json/einvoice/v1/render verwenden. Beide rufen denselben Code auf, keine der beiden ist veraltet.
Ist der KoSIT-Validator aktiv, erscheint nach einem XML-Upload ein Knopf, der dieselbe Datei zusätzlich validieren lässt – ohne zweiten Dateidialog. Ist das Export-Modul aktiv, kommt ein „Export nach Excel“ dazu, nach jedem Upload, PDF wie XML. Ist der Visualizer aktiv, stehen in den Einstellungen vier weitere, druckorientierte Layouts zur Wahl. In allen Fällen bleibt es bei einem Upload und einer Ergebnisansicht.
Geprüft
Business-Term-Abdeckung über den gesamten Korpus: 164 / 164 BT und 32 / 32 BG.
Die XRechnung-Suite ist dabei besonders nützlich, weil sie dieselben Fälle in beiden Syntaxen liefert – damit prüfen sich der CII- und der UBL-Weg gegenseitig.
Ein PDF ohne eingebettete XML wird korrekt abgelehnt, ebenso fehlerhaftes XML und jedes Dokument mit DOCTYPE.
Zuletzt erneut geprüft, nachdem die Lese-Engine gewechselt wurde: dieselben 125 Dateien werden weiterhin gelesen, die absichtlich rechnungsfremde PDF im Korpus weiterhin abgewiesen.
Voraussetzungen: WordPress 5.8+ (getestet bis 7.1), PHP 8.2+.
Die Demo läuft mit demselben Plugin, das Sie auf Ihrer eigenen Seite einsetzen würden. Nichts wird gespeichert.