FileMaker trifft E-Rechnung

Validierung und Auswertung per API nach EN 16931

Herunterladen, öffnen, läuft.

Zum Ausprobieren brauchen Sie FileMaker und diese Datei – fertig. Keine Anmeldung, kein Schlüssel, kein Plugin.

validator_verax.zip · 496 KB · enthält validator_verax.fmp12 mit Beispiel-E-Rechnungen

Die Beispielanwendung zeigt, wie sich VERAX-CHECK über eine REST-API direkt in FileMaker integrieren lässt. Unterstützt werden XRechnung, ZUGFeRD/Factur-X und PEPPOL BIS.

Die Anwendung ist sofort lauffähig, enthält Beispieldaten und kann gleichzeitig als Vorlage für die Integration in eine bestehende FileMaker-Lösung verwendet werden.

Kein Plugin Die Kommunikation erfolgt direkt aus FileMaker über die vorhandenen cURL-Funktionen.
Keine eigene Validator-Infrastruktur Die Prüfung läuft auf der VERAX-Engine, nicht in Ihrer Umgebung.
Keine zusätzliche Middleware Die Rechnung geht aus FileMaker an die API, das Ergebnis kommt strukturiert zurück.

Nicht nur „valide oder nicht valide“

VERAX-CHECK prüft E-Rechnungen mit den dafür vorgesehenen Validatoren und gibt das Ergebnis strukturiert an FileMaker zurück. Dabei kann die Anwendung den passenden Validator automatisch auswählen oder gezielt mit KoSIT, Mustang beziehungsweise der PEPPOL-Prüfung arbeiten.

Neben dem eigentlichen Prüfergebnis erhält FileMaker auf Wunsch auch die erkannten Rechnungsdaten, Fehlermeldungen, Hinweise und vollständigen Prüfberichte.

Die mitgelieferten Beispieldateien ermöglichen es, gültige und fehlerhafte XRechnungen sowie ZUGFeRD-Rechnungen sofort selbst auszuprobieren.

VERAX-CHECK in FileMaker: E-Rechnung wählen, Validator und Report-Level einstellen, Prüfbericht als PDF zurück – FileMaker-Anbindung von JoKa-Automation
Prüfung aus FileMaker auslösen Links die E-Rechnung und die Wahl von Validator, Report-Level und Format, in der Mitte Beispieldaten und die Antwort der API, rechts der fertige Prüfbericht.

Fehlermeldungen, mit denen Anwender etwas anfangen können

Eine Meldung wie „BR-CO-26“ oder ein langer XML-Pfad hilft einem normalen Anwender zunächst wenig.

VERAX ergänzt die Originalmeldung des Validators deshalb um verständliche deutsche Erklärungen, den betroffenen Business Term oder die Business Group nach EN 16931 sowie konkrete Hinweise zur möglichen Behebung. Die Hinweise können zusätzlich auf unterschiedliche Nutzerrollen zugeschnitten werden – vom Anwender über den Sachbearbeiter bis zum Entwickler.

Die Informationen stammen zentral aus dem VERAX Lexikon → Dadurch müssen diese Erläuterungen nicht innerhalb jeder einzelnen FileMaker-Lösung gepflegt werden.

Strukturierte Rechnungsdaten direkt für FileMaker

Die Validatoren liefern ihre Ergebnisse überwiegend technisch strukturiert zurück. VERAX bereitet diese Daten so auf, dass sie unmittelbar in FileMaker weiterverarbeitet werden können.

Die JSON-Ausgabe orientiert sich an EN 16931 und gliedert die Rechnungsdaten nach Business Groups (BG) und Business Terms (BT). Zu jedem Feld können neben dem ursprünglichen Wert auch die normierte Bezeichnung und verständliche Code-Bedeutungen bereitgestellt werden. Damit lässt sich das Mapping einmal aufbauen und anschließend für jede Rechnung wiederverwenden.

Das eignet sich beispielsweise für die Datenübernahme, interne Workflows, Prüfentscheidungen oder die Weiterverarbeitung von Eingangsrechnungen. Neben JSON stehen auch XML, Text und PDF als Ausgabeformate zur Verfügung.

JSON-Ausgabe der VERAX REST-API in FileMaker: Urteil, Rechnungsdaten nach EN 16931 und Fehlermeldungen mit Erklärung – JoKa-Automation
Die JSON-Ausgabe in drei Teilen Das Urteil auf einen Blick, die Rechnungsdaten gegliedert nach BG und BT sowie jede Fehlermeldung mit Originaltext, Erklärung, Tipps und Fassungen für verschiedene Leser.

Drei Berichte für drei unterschiedliche Aufgaben

Audit-Bericht Das vollständige Prüfprotokoll mit geprüfter Datei, SHA-256-Hash, erkanntem Profil, Prüfzeitpunkt, Prüfumgebung, Validator und Version sowie den einzelnen Prüfschritten. Auch die Originalberichte der eingesetzten Validatoren können Bestandteil des Berichts sein.
Kurzbericht Eine kompakte Seite mit dem Ergebnis „valide oder nicht valide“, verwendetem Prüfer, Version und Zeitpunkt. Fehler werden mit Meldung und Fundstelle aufgeführt – gedacht für die schnelle Entscheidung im laufenden Prozess.
Rechnungsdaten-Analyse Die Inhalte der E-Rechnung werden nach EN 16931 gegliedert dargestellt – Verkäufer, Käufer, Zahlung, Lieferung, Summen, Positionen und weitere Bereiche. Business Terms und Codes werden dabei verständlich bezeichnet.
Drei PDF-Berichte von VERAX-CHECK in FileMaker: Audit-Bericht, Kurzbericht und Rechnungsdaten-Analyse – JoKa-Automation
Audit-Bericht, Kurzbericht und Analyse nebeneinander Damit kann FileMaker nicht nur ein Prüfergebnis speichern, sondern bei Bedarf auch einen nachvollziehbaren Prüfbericht zusammen mit der Rechnung archivieren.

Schnell in die eigene FileMaker-Lösung integriert

Die technische Anbindung ist bewusst klein gehalten. Im Kern besteht die Integration aus einem FileMaker-Script und vier Feldern für Übergabe und Rückgabe. Der übrige Aufwand betrifft im Wesentlichen nur die Darstellung und Weiterverarbeitung im eigenen FileMaker-Interface.

Die Rechnung wird aus FileMaker an die VERAX REST-API übertragen. Das Ergebnis kommt strukturiert zurück und kann anschließend direkt im eigenen Workflow verarbeitet werden.

Die mitgelieferte Anwendung ist deshalb nicht nur eine Demo, sondern gleichzeitig ein nachvollziehbares Beispiel dafür, wie die Integration aufgebaut werden kann.

Kein Plugin, kein zusätzliches Modul und keine eigene Validator-Infrastruktur notwendig.

Mehr als die reine Normprüfung

Zusätzliche VERAX-Prüfregeln → Unter anderem für IBAN, Leitweg-ID, Summen und USt-IdNr. inklusive VIES-Abfrage.
Prüfung der PDF-Hülle ZUGFeRD-PDF auf PDF/A-3, XMP-Metadaten und eingebettete XML.
Dreistufiges Ergebnis Valide, bedingt valide oder nicht valide.
Verständliche Rückmeldung Auch bei abgewiesenen oder technisch problematischen Dateien.
PDF/A-3-Reparatur Mit anschließender erneuter Prüfung.
Konvertierung nach CII Von UBL, XRechnung und PEPPOL.
ZUGFeRD erstellen Eine ZUGFeRD-PDF/A-3 aus PDF und XML.
E-Rechnungs-Viewer Zur lesbaren Darstellung der Rechnungsdaten.
Stapelverarbeitung Mehrere Rechnungen in automatisierten FileMaker-Abläufen.

Entwickeln und Testen

Die reguläre freie Nutzung ist auf 10 Prüfungen pro Tag begrenzt.

Für die Entwicklung und Erprobung einer FileMaker-Anbindung kann darüber hinaus ein kostenloser Entwicklerzugang angefordert werden. Damit lässt sich die Integration in Ruhe entwickeln und mit eigenen Testfällen erproben.

Fair-Play-Angebot für FileMaker-Entwickler

Die FileMaker-Anbindung ist ein eigenständiges Angebot. Die regulären Preise auf der VERAX-CHECK-Website gelten hierfür nicht.

Entwickeln und testen Die freie Nutzung ermöglicht bis zu 10 Prüfungen pro Tag. FileMaker-Entwickler können für Entwicklung und Erprobung zusätzlich einen kostenlosen Entwicklerzugang anfordern.
Produktiver Einsatz im eigenen Unternehmen Wer VERAX in der eigenen FileMaker-Lösung für ein- oder ausgehende Rechnungen nutzt, erhält einen festen Nutzungstarif, passend zum Einsatz.
Lösungen für Kunden Wird VERAX Bestandteil einer kommerziellen FileMaker-Lösung, eines eigenen Produkts oder einer Dienstleistung für Kunden, vereinbare ich die Konditionen individuell nach Einsatzart und Prüfvolumen.

Entwicklerzugang, Fragen oder kommerzielle Nutzung:
service@joka-automation.de →

Für die FileMaker-Community