eInvoice Viewer — Technical Details – Handbuch

1 · Überblick

eInvoice Viewer — Technical Details ist ein WordPress-Plugin und ein kostenpflichtiger Zusatz zum freien Plugin eInvoice Viewer for PEPPOL & EN16931. Der Zusatz macht aus den Feldnummern, die der Viewer an einer E-Rechnung zeigt, ein technisches Nachschlagewerk. Außerdem bringt er drei Übersichten mit, die Sie per Kurzbefehl auf jede Seite setzen: eine für die Felder, eine für die Prüfregeln und eine für die Codelisten der EN 16931.

Der Zusatz richtet sich an alle, die nicht nur lesen wollen, was in einer Rechnung steht, sondern auch wissen müssen, wie ein Feld technisch gebaut ist: Entwicklerinnen und Entwickler, Integratoren, Prüferinnen und Prüfer.

Was der Zusatz kann:

• Er ergänzt jeden Kurzhinweis (Tooltip) zu einem Feld (BT) oder einer Gruppe (BG) um Kardinalität, semantischen Datentyp, XSD-Ebene, Referenztabelle, Geschäftsregeln sowie den CII- und den UBL-Pfad.
• Er markiert in der Rechnungsansicht Codes rot, die nicht in ihrer Referenzliste stehen, und nennt die Liste.
• Er öffnet per Klick auf eine Feldnummer die Referenzliste des Feldes oder die Feldübersicht in einem eigenen Fenster.
• Er zeigt mit [svtd_field_browser] die 311 Felder der EN 16931 in einer durchsuchbaren Liste.
• Er zeigt mit [svtd_rule_browser] rund 9 270 Prüfregeln aus 17 Regelwerken, durchsuchbar und filterbar.
• Er zeigt mit [svtd_reference_browser] 17 Referenztabellen (Codelisten), durchsuchbar nach Code und Bezeichnung.

Was der Zusatz nicht kann:

• Er prüft keine Rechnung auf Gültigkeit. Die Markierung eines Codes sagt nur, dass der Code nicht in der Liste steht. Ein Code aus der Liste kann trotzdem gegen die EN 16931 verstoßen; das prüft ein Validator.
• Er zeigt die Felder und Regelwerke von ZUGFeRD / Factur-X EXTENDED nur zusammen mit dem Zusatz Extended Profiles.
• Die meisten Referenztabellen gibt es nur mit englischen Bezeichnungen. Deutsche Bezeichnungen liegen für UNTDID 1001 und UNTDID 4461 vor.
• Er liest selbst keine Rechnung. Die Anzeige der Rechnung ist Aufgabe des Viewers.

Voraussetzungen:

2 · Installieren

Der Zusatz ist ein Kaufprodukt. Sie erhalten ihn als ZIP-Datei über den Shop auf invoicePress.de. Auf wordpress.org gibt es ihn nicht.

Weg 1: ZIP hochladen

1. Laden Sie die ZIP-Datei aus Ihrem Kundenbereich im Shop auf invoicePress.de.
2. Öffnen Sie in WordPress Plugins → Plugin hinzufügen und wählen Sie Plugin hochladen.
3. Wählen Sie die ZIP-Datei aus und klicken Sie auf Jetzt installieren.
4. Aktivieren Sie eInvoice Viewer — Technical Details.
5. Öffnen Sie eine Seite mit dem Viewer, laden Sie eine Rechnung und fahren Sie mit der Maus über eine Feldnummer. Sie sehen die zusätzlichen Zeilen.

Weg 2: Ordner ablegen

1. Entpacken Sie die ZIP-Datei auf Ihrem Rechner.
2. Laden Sie den Ordner des Plugins nach /wp-content/plugins/ auf Ihrem Server.
3. Aktivieren Sie eInvoice Viewer — Technical Details unter Plugins.

Aktualisieren

Eine neue Fassung erhalten Sie als ZIP-Datei über den Shop. Sie laden sie wie in Weg 1 hoch und lassen WordPress die vorhandene Fassung ersetzen, oder Sie ersetzen den Ordner auf dem Server. Die Einstellungen bleiben dabei erhalten, weil sie in der Datenbank stehen. Ist im Shop eine neuere Fassung erschienen, steht unter dem Plugin in der Liste Plugins eine gelbe Zeile mit der neuen Fassung. Die Zeile sagt nur, dass es eine neuere Fassung gibt; herunterladen müssen Sie sie selbst aus Ihrem Kundenkonto im Shop.

Entfernen

Sie deaktivieren und löschen das Plugin unter Plugins. Ob dabei auch die Einstellungen des Zusatzes verschwinden, bestimmen Sie vorher mit dem Kästchen Beim Löschen im Abschnitt des Zusatzes auf der Seite eInvoice Viewer → Viewer. Ab Werk ist es leer, und die Einstellungen bleiben stehen, damit nach einem Neuinstallieren alles wie vorher ist. Ist es angehakt, entfernt das Löschen auch die Wahl bei „Geschäftsregeln im Tooltip“. Das Kästchen selbst verschwindet in jedem Fall. Die Wahl des Design-Kits bleibt in jedem Fall stehen, weil sie allen eInvoice-Werkzeugen der Website gehört.

3 · Erste Schritte

1. Aktivieren Sie den Viewer und den Zusatz.
2. Öffnen Sie eine Seite, auf der der Viewer steht, und laden Sie eine E-Rechnung.
3. Fahren Sie mit der Maus über eine Feldnummer, etwa BT-1. Der Kurzhinweis zeigt jetzt die technischen Zeilen.

1. Legen Sie eine neue Seite an und setzen Sie den Kurzbefehl [svtd_field_browser] hinein.
2. Veröffentlichen Sie die Seite und öffnen Sie sie. Sie sehen die Feldübersicht mit Suchfeld und Filter.
3. Klicken Sie auf eine Zeile. Die vollständige technische Ansicht des Feldes klappt auf.

4 · Arbeiten mit Technical Details

Erweiterte Kurzhinweise an BT und BG

Sie fahren in der Rechnungsansicht des Viewers mit der Maus über eine Feldnummer. Unter der Bezeichnung und der Beschreibung, die der Viewer ohnehin zeigt, stehen nun weitere Zeilen:

• Kardinalität nach EN 16931. Weicht der Wert für CII oder Factur-X ab, steht er daneben.
• Semantischer Datentyp des Feldes.
• XSD-Ebene.
• Referenztabelle, wenn das Feld einen Code aus einer Liste trägt.
• Geschäftsregeln, die für das Feld gelten, als Regelkennungen. Es erscheinen die ersten zehn oder alle, je nach Einstellung.
• CII-Pfad und UBL-Pfad, also die Stelle des Feldes in den beiden XML-Schreibweisen.

Die Zeilen erscheinen in der Sprache der Seite. Sie müssen nichts einrichten; der Zusatz hängt sich von selbst an den Viewer.

Codes außerhalb ihrer Referenzliste

Steht in einem codierten Feld ein Code, der in der zugehörigen Referenzliste nicht vorkommt, markiert der Viewer das Feld rot und nennt die Liste, etwa: „Dieser Code steht nicht in der Referenzliste UNTDID 1001." Geprüft werden unter anderem Dokumentart, Währung, Länder, Steuerkategorien, Befreiungsgründe, Zahlungsart, Mengeneinheiten, Gründe für Zu- und Abschläge und die Schemata der Kennungen.

Die Markierung braucht den eInvoice Viewer ab Fassung 2.34.0.

Klick auf eine Feldnummer

Sie klicken in der Rechnungsansicht auf eine Feldnummer. Hat das Feld eine Referenzliste, öffnet sich diese Liste in einem eigenen Fenster. Hat das Feld keine Referenzliste, öffnet sich die Feldübersicht auf genau diesem Feld. Das Fenster können Sie neben der Rechnung offen lassen. Auch der Klick braucht den eInvoice Viewer ab Fassung 2.34.0.

Die Feldübersicht

Der Kurzbefehl [svtd_field_browser] zeigt die 311 Felder der EN 16931 nach BT und BG in einer Liste. Sie suchen über das Suchfeld „BT/BG-Code oder Name suchen …" und grenzen mit dem Filter „Feldtyp" auf „nur BT" oder „nur BG" ein. Ein Klick auf eine Zeile öffnet die vollständige technische Ansicht des Feldes. Die Einzelheiten einer Zeile werden erst beim Öffnen geladen.

Feldbeschreibungen folgen der Sprache der Seite. Liegt ein Text nur auf Englisch vor, sagt die Übersicht das.

Die Regelübersicht

Der Kurzbefehl [svtd_rule_browser] zeigt rund 9 270 Schematron-Prüfregeln aus 17 Regelwerken: den Kern der EN 16931, XRechnung, Peppol BIS Billing, Factur-X und die unterstützten nationalen CIUS. Sie wählen das Regelwerk oder laden mit „Alle Regelwerke laden" alle zugleich, suchen im Feld „Regel-ID, Feld oder Text suchen …" und filtern nach Feld, nach Herkunft, nach Jurisdiktion und nach Schweregrad („Schwerwiegend", „Fehler", „Warnung", „Hinweis"). Die Liste zeigt je Regel einen kurzen Auszug; die Einzelheiten laden beim Öffnen der Zeile. Jede Regel nennt ihre amtliche Herkunft. Die Regeln stammen aus dem Projekt phive-rules, das die amtlichen Prüfartefakte von CEN/TC 434 ( EN 16931 ), KoSIT ( XRechnung ), OpenPeppol, FNFE-MPE ( Frankreich ), FeRD ( Factur-X ) und den jeweiligen nationalen CIUS-Stellen bündelt.

Die Referenzübersicht

Der Kurzbefehl [svtd_reference_browser] zeigt 17 Referenztabellen, darunter UNTDID 1001, UNCL 5305, VATEX, ISO 4217, ISO 3166-1, UN/ECE Rec. 20 und 21, ICD, EAS und MIME. Es wird jeweils eine Tabelle gezeigt. Sie wählen die Tabelle aus; ihr Name und die Zahl ihrer Einträge stehen als Überschrift darüber. Die Tabelle durchsuchen Sie nach Code und Bezeichnung.

Die Namen der Tabellen und alle Bedienelemente erscheinen in der Sprache der Seite. Die Bezeichnungen von UNTDID 1001 und UNTDID 4461 liegen auch auf Deutsch vor. Die übrigen Tabellen gibt es nur auf Englisch, und die Übersicht sagt das über der Tabelle.

Feld- und Regelübersicht aus dem Viewer heraus

Die Knöpfe „Feldbrowser" und „Regelbrowser" in der Werkzeugleiste des Viewers öffnen die jeweilige Übersicht in einem eigenen Fenster. Das Fenster ist bereits auf die aktuelle Rechnung gefiltert.

Auf einer Seite ausschalten

Im Kurzbefehl des Viewers schalten Sie auf einer einzelnen Seite ab, was dieser Zusatz zeigt, zum Beispiel [spev_einvoice_viewer button_svtd_tooltips="no"]. Ohne Angabe bleibt alles an.

Ein Schalter nimmt etwas nur von dieser Seite. Wer den Zusatz überhaupt benutzen darf, legt „Verfügbar ab Rolle“ in den Einstellungen des Viewers fest.

5 · Einstellungen

Seite „eInvoice Viewer → Viewer", Abschnitt „eInvoice Viewer — Technical Details"

Der Zusatz hat keine eigene Einstellungsseite. Er ergänzt die Seite des Viewers um einen Abschnitt mit zwei Einstellungen. Ohne aktiven Viewer gibt es diesen Abschnitt nicht.

Verfügbar ab Rolle

Auf derselben Seite eInvoice Viewer → Viewer wählen Sie unter „Erweiterungen verfügbar ab Rolle“, ab welcher Rolle dieser Zusatz im Viewer erscheint. Für Besucher unterhalb dieser Rolle lädt der Viewer den Zusatz nicht: Die Kurzhinweise zeigen keine technischen Zeilen, Codes werden nicht markiert, ein Klick auf die Feldnummer öffnet nichts, und die Knöpfe „Feldbrowser“ und „Regelbrowser“ fehlen. Ein von Hand aufgerufenes Fenster einer Übersicht antwortet dann mit „Diese Erweiterung steht für Ihr Konto nicht zur Verfügung.“ Die drei Übersichten, die Sie per Kurzbefehl auf eine Seite setzen, sind von dieser Wahl nicht betroffen; sie bleiben für jeden Besucher sichtbar. Die Wahl gibt es ab dem Viewer 2.35.0.

Design-Kit

Die drei Übersichten folgen dem Design-Kit, das für alle eInvoice-Werkzeuge der Website gewählt ist. Die Wahl gilt nicht nur für diesen Zusatz.

Kurzbefehle

Die drei Kurzbefehle werten keine Attribute aus. Sie setzen sie so ein, wie sie hier stehen:

[svtd_field_browser]

[svtd_rule_browser]

[svtd_reference_browser]

Sie können mehrere Kurzbefehle auf dieselbe Seite setzen, auch zusammen mit dem Viewer.

6 · Besondere Fälle

Sie wollen ein Nachschlagewerk zur EN 16931 auf Ihrer Website anbieten. Legen Sie drei Seiten an und setzen Sie je einen der drei Kurzbefehle hinein. Die Übersichten lesen nur die Daten, die der Zusatz mitbringt, und arbeiten auch für Besucher, die nicht angemeldet sind.

Sie wollen in den Kurzhinweisen jede Regel sehen, die ein Feld betrifft. Öffnen Sie eInvoice Viewer → Viewer, wählen Sie bei „Geschäftsregeln im Tooltip" den Wert „alle" und speichern Sie. Rechnen Sie bei Feldern mit vielen Regeln mit langen Kurzhinweisen.

Sie wollen wissen, welche Codes in einem Feld zulässig sind, während Sie eine Rechnung ansehen. Klicken Sie in der Rechnungsansicht auf die Feldnummer. Die Referenzliste des Feldes öffnet sich in einem eigenen Fenster, das Sie neben die Rechnung stellen.

Sie arbeiten mit ZUGFeRD / Factur-X EXTENDED. Aktivieren Sie zusätzlich den Zusatz Extended Profiles. Die Feldübersicht zeigt dann auch die 974 Felder der Erweiterungen, zusammen 1 285 Felder: 963 von ZUGFeRD / Factur-X EXTENDED, 6 der XRechnung Extension und 5 von EXTENDED-CTC-FR. Der Filter „Felder" bietet „Alle Felder ( EN 16931 und Erweiterungen )", „Nur EN 16931", „Nur Factur-X EXTENDED", „Nur XRechnung Extension" und „Nur EXTENDED-CTC-FR". Die Regelübersicht zeigt drei weitere Regelwerke mit rund 3 190 Regeln.

Sie wollen die technischen Einzelheiten nur angemeldeten Mitarbeitern zeigen. Wählen Sie auf der Einstellungsseite des Viewers unter „Erweiterungen verfügbar ab Rolle“ eine Rolle. Besucher unterhalb dieser Rolle sehen den Viewer dann ohne die technischen Einzelheiten; die Übersichten auf eigenen Seiten bleiben öffentlich.

Sie betreiben eine Website in einer anderen Sprache. Die zusätzlichen Zeilen der Kurzhinweise, die Bedienelemente und die Beschreibungen folgen der Sprache der Seite, soweit eine Übersetzung mitgeliefert ist. Wo ein Text nur auf Englisch vorliegt, steht das dabei.

7 · Zusammenspiel mit anderen Paketen

8 · Wenn etwas nicht geht

9 · Datenschutz und Sicherheit

• Eine Anfrage am Tag nach der neuesten Fassung. Wenn ein Benutzer, der Plugins aktualisieren darf, die Liste Plugins öffnet, fragt Ihre Website höchstens einmal am Tag bei https://apps.invoicepress.de/updates/plugins.json nach, welche Fassung die neueste ist. Die Anfrage trägt keine Adresse Ihrer Website; invoicePress.de erfährt nur die IP-Adresse Ihres Servers. Wer das nicht will, schaltet die Anfrage mit dem Filter einvoicepress_shop_update_check ab. Sonst stellt der Zusatz keine ausgehende Anfrage und nutzt keinen fremden Dienst.
• Die Übersichten zeigen nur mitgelieferte Daten. Feld-, Regel- und Referenzübersicht lesen ausschließlich die Referenzdaten, die im Plugin enthalten sind. Der Browser des Besuchers lädt diese Daten von Ihrer eigenen Website.
• Die Kurzhinweise lesen nur, was der Viewer schon hat. Die Erweiterung der Kurzhinweise liest allein Daten, die der freie Viewer aus der Datei des Besuchers bereits gewonnen hat. Der Zusatz speichert keine Rechnungsdaten.
• Gespeichert werden zwei Einstellungen. In der Datenbank stehen nur die Wahl bei „Geschäftsregeln im Tooltip“ und das Kästchen „Beim Löschen“. Dazu merkt sich die Website für einen Tag die Antwort auf die Frage nach der neuesten Fassung.
• Öffentlich lesbar. Die Übersichten und die Fenster, die der Viewer öffnet, sind auch ohne Anmeldung abrufbar, es sei denn, unter „Erweiterungen verfügbar ab Rolle“ ist eine Rolle gewählt; dann antworten die Fenster nur Besuchern ab dieser Rolle. Sie enthalten ausschließlich öffentliche Referenzdaten und ändern nichts auf Ihrer Website.

10 · Für Entwickler

Feld- und Regelübersicht werden als Skriptmodule geladen. Die Lizenz ist GPL-2.0-or-later.

11 · Fassungen

Der vollständige Änderungsverlauf steht auf Englisch in der Datei CHANGELOG.md des Plugins.

12 · Bilderliste

Diese Liste zeigt, welche Bildschirmfotos dieses Handbuch erwartet und welche im Ordner screenshots/ des Pakets gefunden wurden. Ein Bild heißt immer Kennung.Sprache.png, zum Beispiel td-tooltip.de.png. Fehlt die deutsche Fassung, zeigt das Handbuch die englische. Auf den Bildern sind nur Beispieldaten zu sehen.