billPress – E-Invoice Viewer – Laden Sie E-Rechnungen (ZUGFeRD, Factur-X, XRechnung) auf Ihrer WordPress-Site hoch und visualisieren Sie sie
Lassen Sie Ihre Besucher eine elektronische Rechnung auf Ihrer Seite ablegen und sie sofort als klare, strukturierte Ansicht sehen – ohne externen Service und ohne Speicherung der Datei. Ein eigenständiges WordPress-Plugin, das die Kernfunktion des ZUGFeRD Quba-Viewers direkt in einem einfachen Shortcode reproduziert.
Egal, ob Sie eine E-Rechnungs-Demo, einen Validierungshelfer oder einen kundenorientierten Viewer anbieten, dieses Plugin liest ZUGFeRD / Factur-X PDFs und CII / UBL / XRechnung XML-Dateien und rendern jedes Rechnungsfeld – optional mit dem Matching EN 16931 Geschäftsbegriffsnummern (BT-…). Das Ergebnis wird inline über AJAX in einem Shadow-DOM angezeigt, sodass es in jedem Vorlage identisch aussieht.
Warum Sie es lieben werden
- Liest alle gängigen E-Rechnungsformate. ZUGFeRD / Factur-X (PDF), CII (UN/CEFACT) XML und UBL / XRechnung XML – das eingebettete XML wird automatisch aus PDFs extrahiert.
- ️ Drag & Drop-Uploader. Vanilla-JavaScript, kein Framework, kein Neuladen der Seite – die strukturierte Ansicht erscheint inline.
- Vollständige Feldabdeckung. Rechnungskopf, Parteien, Bestell- und Lieferdaten, Zahlung, Einzelposten, Mehrwertsteueraufschlüsselung, Summen, Notizen und Anhänge – leere Felder werden als Platzhalter angezeigt, genau wie der Quba-Viewer.
- EN 16931 Geschäftsbedingungen. Die BT-Nummern live, per Einstellung oder über das Shortcode-Attribut ein- oder ausblenden bt=“1“ / bt=“0“.
- Themenunabhängig. In einem Shadow-DOM mit vollständiger Stil-Zurücksetzung gerendert, sodass keine Design-Stile durchsickern – überall identisches Aussehen.
- Keine Lagerung. Die Datei wird nur aus dem temporären Upload gelesen und nie gespeichert.
- ️ Sicher durch Design. XXE-Schutz, Upload-Validierung (Erweiterung + MIME + Größe), Nonce-basierter CSRF-Schutz mit einer Live-Nonce und ein tägliches Ratenlimit pro Besucher.
- Übersetzbar. Textdomäne sp-rechnungsbetrachter; Inklusive deutscher Übersetzung.
Hauptmerkmale
Unterstützte Rechnungsformate
ZUGFeRD / Factur-X (PDF) — Das eingebettete XML wird automatisch extrahiert und gelesen.
CII (UN/CEFACT) XML – direkt lesen. UBL / XRechnung (XML) — intern in CII konvertiert und dann gelesen.
Modernes, Quba-inspiriertes Layout
Ein Single-Scroll-Layout mit farbigen Abschnittsregisterkarten (ausgefüllt = Daten vorhanden, hell = leerer Abschnitt): eine Hero-Kopfzeile mit dem hervorgehobenen fälligen Betrag, gefolgt von Rechnungsdaten, Käufer, Verkäufer, Bestell-/Vertragsdaten, Lieferinformationen, Zahlung, Einzelposten, Mehrwertsteueraufschlüsselung, Gesamtbeträgen, Notizen und Anhängen. Alle Felder werden immer genauso angezeigt – auch leere – genau wie im Original-Viewer.
EN 16931 Geschäftsbegriffe (BT-Nummern)
Jedes Feld kann mit seiner EN 16931-Geschäftsbegriffsnummer gekennzeichnet werden. Besucher schalten die Zahlen live über einen Schalter im Viewer um, und Sie legen die Standardeinstellung pro Einbettung über das Shortcode-Attribut fest
bt=“1“ / bt=“0“ oder global in den Einstellungen. Die Feldkartierung wurde anhand der offiziellen EN 16931-Spezifikation überprüft.
Vorlage-Unabhängigkeit über Shadow DOM
Der Viewer wird in einem Shadow-DOM mit einer vollständigen Darstellung gerendert :Gastgeber Stil zurücksetzen und px Einheiten durchgängig, sodass keine vererbbaren Designstile (Schriftart, Größe, Farbe, Zeilenhöhe) die Grenze überschreiten. Das Ergebnis sieht in jedem WordPress-Vorlage identisch aus.
Sicherheit und Datenschutz
XXE-Schutz (DOCTYPE-Ablehnung, kein externer Entitätslader, kein Netzwerkzugriff beim Parsen), Upload-Validierung (Erweiterung + Finfo-MIME-Prüfung + Größenbeschränkung), Nonce-basierter CSRF-Schutz mit einer Live-Nonce gegen Seiten-Caching und eine tägliche Upload-Ratenbegrenzung pro Besucher. Die Datei wird nur im Speicher verarbeitet und niemals gespeichert; Jeder Rechnungswert wird bei der Ausgabe maskiert.
Erweiterbare Template-Engine
Die Datenextraktion ist vom HTML-Rendering getrennt, sodass zusätzliche Layouts als Vorlagenunterklasse hinzugefügt werden können, ohne die Extraktionslogik zu berühren.
Warum nicht pixelgenau nach Quba? Der Quba-Viewer transformiert mit der KoSIT XRechnung XSLT 3.0 über Saxon-JS; PHP unterstützt nur XSLT 1.0. Stattdessen wird ein eigenes, von Quba inspiriertes PHP-Template verwendet – funktional gleichwertig, aber nicht das identische KoSIT-Markup.
Wie es funktioniert
- Fügen Sie die hinzu [einvoice_viewer] Shortcode zu einer beliebigen Seite oder einem Beitrag.
- Der Besucher legt eine Rechnung (PDF oder XML) in den Viewer ein.
- Die Datei wird validiert, geschwindigkeitsbegrenzt und auf dem Server gelesen. Die Rechnung wird in HTML gerendert und über AJAX zurückgegeben.
- Die strukturierte Ansicht wird inline eingefügt – die Datei wird nie gespeichert.
Einstellungen
- Tägliche Uploads pro Besucher — Limit pro Kalendertag (0 = unbegrenzt).
- Maximale Dateigröße – begrenzt durch das WordPress-Upload-Limit.
- Trust-Proxy-Header — Verwenden Sie X-Forwarded-For für die Client-IP (nur hinter einem vertrauenswürdigen Reverse-Proxy).
- BT-Nummern standardmäßig anzeigen — Besucher können weiterhin umschalten.
- Layoutvorlage — die aktive Ansicht (weitere können hinzugefügt werden).
Was ist enthalten
- Das Plugin (Shortcode, Uploader, Renderer, Einstellungen und die gebündelten Horstoeko-Bibliotheken).
- Englische und deutsche Übersetzungen (Textdomäne sp-rechnungsbetrachter).
- Vollständige Dokumentation in Englisch und Deutsch (README + Funktionsübersicht).
Anforderungen & Kompatibilität
- WordPress 5,8+ (getestet bis 6,9)
- PHP 7,4+
- Das gebündelte Verkäufer/ Verzeichnis (Horstoeko-Bibliotheken) im Plugin-Ordner
Änderungsprotokoll
2.0.1
- Geschäftsbegriffskorrekturen, überprüft anhand der offiziellen EN 16931-Spezifikation (BT-115, BT-28/BT-33, BT-56/BT-41, BT-10, BT-47/BT-30 und die hinzugefügten Schemafelder BT-47-1 / BT-30-1).
- Aktualisierte und neu kompilierte Übersetzungen.
- Das Plugin wurde in „invoicePress – e-Invoice Viewer“ umbenannt; die Textdomäne auf umgestellt
sp-rechnungsbetrachter und gehärtete Eingabeverarbeitung für die WordPress-Codierungsstandards.
2.0.0
- Neues rechteckiges Layout im Quba-Stil mit farbigen Abschnittsregistern und einer eigenen Kartengruppe pro Werbebuchung.
- Einführung der Template-Engine (vom HTML-Rendering getrenntes Datenmodell).
- Viele weitere Felder (BT-127 bis BT-160, Zahlungskarten, Lieferdetails und mehr).
- Farben abgestimmt auf das billPress-Logo.
Bewertung: 0
Verkäufe bisher: 0
Be the first to leave a review.
