eInvoice Validation Explorer for Mustang

Kaufprodukt · WordPress-Plugin und App · Version 1.7.0 · Erklärt die Prüfberichte des Mustang-Validators

Den Mustang-Prüfbericht verstehen: jede Meldung mit Feld, Wert und Stelle in der Rechnung

Der eInvoice Validation Explorer for Mustang macht aus dem Prüfbericht des Mustang-Validators eine Erklärung, die Sie verstehen. Sie legen den Bericht und die geprüfte E-Rechnung ab, also die Rechnung als strukturierte XML-Datei. Dann sagt Ihnen der Explorer zu jedem Befund, welches Feld der Rechnung gemeint ist, welcher Wert dort steht und wo die Stelle in der Rechnung liegt.

Der Explorer prüft nicht selbst, sondern erklärt, was der Validator festgestellt hat. Im Plugin geschieht das auf Ihrer eigenen Website, in der App direkt in Ihrem Browser, und keine Datei geht an einen fremden Dienst. Zusammen mit dem kostenlosen eInvoice Viewer steht jeder Befund sogar direkt unter seinem Feld in der lesbaren Rechnung.

App und Plugin

Der Validation Explorer for Mustang als App und als WordPress-Plugin

Den Explorer gibt es als App: ein Ordner, den Sie entpacken und per Doppelklick öffnen, auf Ihrem Rechner, im Intranet oder in SharePoint. Die App braucht keinen Server und keine Prüf-Engine, denn sie liest einen Bericht, der schon vorliegt. Der Bericht und die Rechnung verlassen Ihren Rechner nicht. Sie legen den Bericht von Mustang und die geprüfte Rechnung zusammen ab.

Das WordPress-Plugin ist derselbe Explorer mit den Zusatzfunktionen einer Website: Sie begrenzen die Aufrufe je Besucher und Tag, legen fest, ab welcher Rolle er erscheint, und zeigen die Befunde direkt an den Feldern des eInvoice Viewers. Das Plugin setzt das kostenlose Viewer-Plugin voraus. App und Plugin sind Kaufprodukte und tragen dieselbe Versionsnummer.

Der Validator meldet einen Fehler, aber nicht, was Sie tun sollen

Sie haben eine E-Rechnung mit dem Validator des Mustangproject prüfen lassen und halten einen Prüfbericht in der Hand. Darin stehen Regelkennungen und lange Pfade durch eine XML-Datei. Welches Feld der Rechnung gemeint ist, müssen Sie sich selbst zusammensuchen.

Hinzu kommt: Ein Mustang-Bericht enthält die Rechnung nicht, er nennt nur die Fundstellen. Wer wissen will, welcher Wert beanstandet wird, öffnet die Rechnung in einem Editor und arbeitet sich durch Hunderte Zeilen. Dabei wollen Sie am Ende nur dem Lieferanten, dem Kunden oder der Kollegin in einem Satz sagen können, was an der Rechnung zu ändern ist.

Bericht und Rechnung ablegen, Erklärung lesen

Der Explorer bringt die beiden Dateien wieder zusammen. Er ordnet jeden Befund dem passenden Feld der EN 16931 zu, der europäischen Norm, die festlegt, welche Angaben eine E-Rechnung enthält. Er zeigt den Wert, der tatsächlich in der Rechnung steht, und markiert die Stelle in einer Ansicht der Rechnung, der Belegansicht.

Der Bericht des Explorers zu einem Mustang-Prüfbericht: Ergebnis, Prüfschritte und Befunde mit Feld und Wert.

  • 1 · Prüfbericht ablegen

    Sie legen die XML-Datei ab, die der Mustang-Validator geschrieben hat.

  • 2 · Rechnung ablegen

    Dazu kommt die geprüfte Rechnung als XML-Datei, in einer der beiden XML-Formen der EN 16931: CII oder UBL.

  • 3 · Erklärung lesen

    Der Explorer verbindet beide Dateien. Sie lesen zu jedem Befund Klartext, Feld und Wert und springen mit einem Klick an die Stelle in der Rechnung.

Aus zwei Dateien wird eine Erklärung: Sie legen Bericht und Rechnung ab, der Explorer verbindet beide, und Sie lesen zu jedem Befund Feld, Wert und Stelle.

Note Note

1. Viewer und Plugin installieren

Das Plugin setzt den kostenlosen eInvoice Viewer for PEPPOL & EN16931 voraus. Sie installieren zuerst den Viewer, laden dann die ZIP-Datei aus dem Shop in WordPress hoch und aktivieren das Plugin. Die Regel- und Feldkataloge liegen bei, einstellen müssen Sie für den Start nichts.

Tools Tools

2. Shortcode einsetzen

Sie fügen [spxm_validation_report] in eine Seite ein. Ein Shortcode ist ein kurzer Platzhalter in eckigen Klammern, an dessen Stelle WordPress das Werkzeug anzeigt.

Adjust Adjust

3. Zwei Dateien ablegen

Die Seite hat zwei beschriftete Felder, oben für den Bericht und unten für die Rechnung. Die Reihenfolge ist frei. Solange eine Datei fehlt, sagt Ihnen die Seite, welche.

Was den Validation Explorer for Mustang besonders macht

Zwei Dateien, eine Erklärung

Ein Mustang-Bericht nennt nur Pfade. Der Explorer heftet die Rechnung an den Bericht und zeigt so zu jedem Befund den Wert, der wirklich in der Rechnung steht. Im Plugin wird erst gesendet, wenn beide Dateien da sind; bis dahin heißt es zum Beispiel „Der Prüfbericht ist da. Es fehlt noch die Rechnung.“

Was Sie davon haben: Sie müssen die Rechnung nicht mehr in einem Editor durchsuchen, und ein unvollständiger Versuch kostet keinen Upload aus dem Tageskontingent.

Das betroffene Feld und sein tatsächlicher Wert

Jeder Befund wird seinem Fachbegriff der EN 16931 zugeordnet, mit der BT- oder BG-Nummer. Business Terms (BT) und Business Groups (BG) sind die nummerierten Felder und Feldgruppen der Norm. Betrifft ein Befund eine Anlage der Rechnung, nennt der Explorer ihren Namen, etwa „Anlage: Aufmass.pdf“.

Was Sie davon haben: Sie sehen sofort, welche Angabe der Lieferant ändern muss, und können ihm den falschen Wert nennen.

Ein Befund mit Regel, Erklärung, betroffenem Feld und dem Wert aus der Rechnung.

Was ein roher Mustang-Bericht zeigt und was der Validation Explorer hinzufügt
Roher Mustang-BerichtMit dem Validation Explorer
Regelkennung und Meldung des Validators✓✓
Erklärung in Klartext–✓
Betroffenes Feld mit BT- oder BG-Nummer–✓
Wert, der in der Rechnung steht–✓
Sprung zur Stelle in der Rechnung–✓
Befund direkt unter seinem Feld in der lesbaren Rechnung–✓

Umlaute richtig lesen, auch wenn der Bericht sie falsch kodiert

Mustang gibt in seinem Bericht die Kodierung UTF-8 an, schreibt deutsche Meldungstexte aber teilweise in Windows-1252. Der Explorer erkennt das an der Datei selbst, liest die Umlaute richtig und weist am Anfang des Berichts auf die Reparatur hin.

Was Sie davon haben: Sie lesen deutsche Meldungen ohne Zeichensalat und wissen trotzdem, dass der Bericht repariert wurde.

Keine Meldung geht verloren

Manche Meldungen zeigen auf keine Stelle in der Rechnung, zum Beispiel weil sie das Schema betreffen. Sie stehen im Kasten „Nicht zugeordnet“ am Ende, jede mit Regelkennung, Begründung und dem Pfad aus dem Bericht. Warnungen erscheinen als Warnungen und werden nicht als Fehler gezählt.

Was Sie davon haben: Sie sehen den vollständigen Bericht und können sich darauf verlassen, dass die Seite dasselbe sagt wie Ihr Validator, nur verständlicher.

Suchen, filtern und in drei Sprachen lesen

Ein Suchfeld durchsucht die Belegansicht nach Feldname, Wert oder BT-Nummer. Der Schalter „BT-Nummern“ blendet die Nummern ein und aus, der Schalter „nur Befunde“ zeigt nur die Zeilen mit Fehlern und Warnungen. Die Oberfläche gibt es auf Deutsch, Englisch und Französisch; deutsche Regeltexte gibt es für XRechnung.

Was Sie davon haben: Auch in einer Rechnung mit Hunderten Zeilen finden Sie mit wenigen Tastenanschlägen die Angabe, die Sie suchen.

Im eInvoice Viewer: prüfen und den Befund am Feld sehen

Der kostenlose eInvoice Viewer for PEPPOL & EN16931 ist das zentrale Werkzeug für Ihre E-Rechnungen. Er zeigt jede Rechnung lesbar an. Ist auf Ihrer Website der kostenlose eInvoice Validator for Mustang installiert, steht in seiner Werkzeugleiste der Knopf „Mit Mustang prüfen“, und der Bericht öffnet sich in einem eigenen Reiter „Mustang Validator“.

Mit dem Validation Explorer for Mustang stehen die Erklärungen genau in diesem Reiter. Ein Klick auf „Position“ an einer Meldung öffnet den Reiter „RECHNUNG“ am betroffenen Feld, und dort steht jeder Befund als ganze Karte direkt unter seinem Feld. Ein Schalter unter den Meldungen zeigt stattdessen das XML-Listing. Auch auf der eigenen Seite des Explorers zeigt die Ansicht „Beleg“ die abgelegte Rechnung mit jedem Befund an seinem Feld, sobald der Viewer aktiv ist.

Nach unserer Kenntnis ist der Validation Explorer das einzige Werkzeug, das die Meldungen eines fertigen Prüfberichts am betroffenen Feld der lesbaren Rechnung zeigt. Eine Recherche vom 13. Oktober 2026 über rund 35 Werkzeuge hat kein anderes gefunden.

Was Sie davon haben: Lesen, prüfen und verstehen geschieht auf einer Seite, und Sie sehen einen Fehler dort, wo er in der Rechnung steht.

Für wen der Explorer gedacht ist

  • Die Buchhaltung

    Eine Eingangsrechnung fällt durch die Prüfung. Die Buchhalterin legt Bericht und Rechnung ab, liest, welches Feld betroffen ist, und schreibt dem Lieferanten eine Rückfrage, die er auch versteht.

  • Der Dienstleister

    Eine Kanzlei oder Agentur prüft Rechnungen für ihre Kunden mit Mustang. Statt den rohen Bericht weiterzureichen, verweist sie auf eine Seite ihrer Website, auf der sich der Kunde den Bericht selbst erklären lässt.

  • Die Entwicklerin

    Ihre Software schreibt E-Rechnungen, und Mustang meldet Fehler. Zu jedem Befund sieht sie das Feld der Norm und den Wert, den ihre Software geschrieben hat, und springt mit einem Klick an die Stelle.

  • Der Betreiber eines Mustang-Validators

    Mustang läuft bei ihm auf einem eigenen Server und schreibt Berichte als Dateien. Der Explorer ist genau für solche Berichte da, die an anderer Stelle entstanden sind.

Der Shortcode

[spxm_validation_report]

Mit dem Attribut bt legen Sie für eine einzelne Seite fest, ob die BT-Nummern beim Öffnen sichtbar sind, zum Beispiel [spxm_validation_report bt="0"] für die Buchhaltung.

Die Einstellungen

Die Einstellungen stehen im eigenen Menüpunkt eInvoice Validation Explorer → Mustang im Adminbereich von WordPress. Findet das Plugin seine Regeldaten nicht, warnt dort ein gelber Hinweis.

Die Einstellungsseite des Validation Explorer for Mustang.

Die Einstellungen des Plugins und ihre Voreinstellungen
EinstellungVoreinstellungWozu sie dient
Tägliche Uploads je Rolle10 je RolleEine Zeile für Gäste und eine für jede Rolle: leer heißt unbegrenzt, 0 heißt kein Zugang. Administratoren sind nie begrenzt.
Maximale Dateigröße (MB)8Gilt für Bericht und Rechnung einzeln. Die Upload-Grenze Ihres Servers gilt zusätzlich.
Proxy-Header vertrauenausFür Websites hinter einem Reverse Proxy, dem Sie vertrauen.
BT-Nummern standardmäßig anzeigenanBesucher können die Nummern im Bericht selbst umschalten.
Design-KitKit HBestimmt die Gestaltung und gilt für alle eInvoice-Werkzeuge der Website.

Für Entwickler

Die REST-Adresse POST /wp-json/einvoice/v1/explain-mustang nimmt die Dateifelder report und invoice entgegen und liefert die fertige Ansicht zurück. Die Einzelheiten beschreibt das Handbuch.

Bericht und Rechnung bleiben bei Ihnen

  • Im Plugin nur auf Ihrer eigenen Website

    Bericht und Rechnung gehen an Ihre WordPress-Installation, sobald beide Felder gefüllt sind, und nur dorthin. Das Plugin stellt keine Anfrage an einen anderen Server und lädt keine Schriften von außen.

  • Nichts wird aufbewahrt

    Die Dateien werden aus dem vorübergehenden Upload im Arbeitsspeicher gelesen. Sie landen nicht im Upload-Verzeichnis und in keinem Protokoll.

  • In der App bleibt alles im Browser

    In der Voreinstellung löst die App keinen einzigen Abruf aus. Bericht und Rechnung werden im Browser gelesen und nirgendwohin gesendet.

  • Die Tagesgrenze ohne gespeicherte IP-Adresse

    Angemeldete Benutzer zählt das Plugin nach ihrem Konto, Gäste nach einem Hashwert ihrer IP-Adresse. Der Zähler verfällt nach einem Tag.

Bitte beachten Sie: Bericht und Rechnung enthalten in der Regel Namen, Anschriften, Bankverbindungen und Beträge. Wenn Sie das Plugin öffentlich anbieten, liegen diese Daten während der Anfrage im Arbeitsspeicher Ihres Servers. Erwähnen Sie das in Ihrer Datenschutzerklärung.

Was der Explorer bewusst nicht tut

  • Er prüft nicht selbst. Das Ergebnis stammt vom Validator; der Explorer gibt es wieder und erklärt es.
  • Er braucht die Rechnung. Ohne sie liest er den Bericht zwar vollständig, aber die Belegansicht bleibt leer.
  • Er nimmt nur XML-Dateien an. Ein PDF, auch ein ZUGFeRD-PDF, lässt sich nicht ablegen.
  • Er liest keine Berichte des KoSIT-Validators. Dafür gibt es den eInvoice Validation Explorer for KoSIT.
  • Er berichtigt und speichert nichts. Er schreibt keine Rechnung, und es gibt kein Archiv früherer Berichte.
  • Deutsche Regeltexte gibt es für XRechnung. Ein maschinell übersetzter, noch nicht geprüfter Regeltext trägt einen Hinweis.
  • Er ist kein Produkt des Mustangproject. Das Mustangproject gibt das Prüfprogramm heraus, nicht diesen Explorer.

Passt dazu

Note Note

eInvoice Validator for Mustang

Prüft E-Rechnungen in WordPress mit Ihrem eigenen Mustang-Validator, der auf dem Server Java braucht, und zeigt den Bericht in derselben Klartext-Ansicht. Mehr erfahren
kostenlos

Tools Tools

eInvoice Validation Explorer for KoSIT

Das Schwesterwerkzeug für die Berichte des offiziellen KoSIT-Validators. Dort genügt eine Datei, weil der Bericht die Rechnung mitbringt. Mehr erfahren
Kaufprodukt

Adjust Adjust

eInvoice Viewer – Extended Profiles

Erklärt auch die Regeln von ZUGFeRD / Factur-X EXTENDED und EXTENDED-CTC-FR und zeigt die Werte der Erweiterungsfelder. Mehr erfahren
Kaufprodukt

14

Regelwerke erklärt der mitgelieferte Katalog

8 604

Regeln mit Erklärung, von EN 16931 bis Peppol BIS

311

Felder der EN 16931 kennt der Feldkatalog

0

Anfragen an fremde Dienste

Zum Katalog gehören EN 16931 in CII und UBL, XRechnung, Peppol BIS Billing 3, Factur-X EN16931, die französischen Flux-2-Regeln und die Länderanpassungen für Portugal, Rumänien, Kroatien, Belgien und Italien. Drei weitere Regelwerke mit 3 190 Regeln, Factur-X EXTENDED und EXTENDED-CTC-FR, erklärt der Explorer mit dem Zusatz „Extended Profiles“.

Häufige Fragen

Nein. Er erklärt einen Prüfbericht, den der Mustang-Validator bereits geschrieben hat. Wenn Sie die Prüfung selbst in WordPress ausführen möchten, nehmen Sie das kostenlose Plugin „eInvoice Validator for Mustang“.

Ein Mustang-Bericht enthält die Rechnung nicht, er nennt nur die Fundstellen als Pfade. Erst mit der Rechnung kann der Explorer den Wert zeigen, der an der beanstandeten Stelle steht.

Der Explorer zeigt trotzdem alle Befunde. Darüber steht ein Hinweis, oder die Meldungen erscheinen unter „Nicht zugeordnet“. Prüfen Sie dann, ob es wirklich die Datei ist, die der Validator geprüft hat.

WordPress ab 6.0, PHP ab 7.4 und den kostenlosen eInvoice Viewer for PEPPOL & EN16931, denn WordPress aktiviert den Explorer nur, solange der Viewer aktiv ist. Java braucht der Explorer nicht; das braucht nur der Mustang-Validator, der den Bericht schreibt.

Ja. Plugin und App sind ein Produkt mit derselben Versionsnummer. Die App ist ein Ordner, dessen Startdatei Sie per Doppelklick im Browser öffnen, auf Ihrem Rechner, einem Netzlaufwerk oder Ihrem Webserver. Dort ziehen Sie beide Dateien gemeinsam auf eine Fläche, und die App erkennt am Inhalt, was der Bericht ist.

Nein. Im Plugin werden sie nur während der Anfrage im Arbeitsspeicher Ihres Servers verarbeitet, in der App nur im Browser. An invoicePress oder einen fremden Dienst geht nichts.

Ohne den Zusatz „Extended Profiles“ zeigt ein Befund zu einer Regel der Erweiterung die Kennung und die Meldung des Validators, und ein Hinweis sagt, was der Zusatz ergänzen würde. Mit dem Zusatz werden diese Regeln erklärt, und die Felder der Erweiterung erscheinen.

Machen Sie aus dem nächsten Mustang-Bericht eine Erklärung, die jeder versteht. Erwerben Sie den Validation Explorer for Mustang im Shop von invoicePress.de, setzen Sie den Shortcode auf Ihre Seite oder öffnen Sie die App, und sehen Sie zu jedem Befund Feld, Wert und Stelle.