Ventoo Document Reader
Der Ventoo Document Reader ist eine AppSource-App für Microsoft Business Central. Sie löst ein alltägliches Problem: Wer tippt heute noch von Hand die Zahlungsreferenz, den Betrag oder die Kreditor-IBAN von einer Schweizer QR-Rechnung ab, nur weil das Zahlungsteil als PDF-Anhang an einem Beleg in Business Central hängt?
Mit der App liest Business Central den in einem PDF-Anhang eingebetteten Swiss-QR-Code automatisch aus und stellt die daraus gewonnenen, strukturierten Zahlungsdaten – inklusive geprüfter Zahlungsreferenz – anderen Erweiterungen und Prozessen zur Weiterverarbeitung zur Verfügung. Die eigentliche Bilderkennung und QR-Dekodierung übernimmt eine von Ventoo betriebene Azure Function; in Business Central selbst wird nur die Verbindung dazu eingerichtet.
Was die App kann
QR-Rechnungen automatisch erkennen Ein PDF-Dokumentenanhang (z.B. an einer Einkaufsrechnung) wird an die konfigurierte Azure Function übergeben, die den eingebetteten Swiss-QR-Code dekodiert.
Zahlungsreferenz doppelt prüfen Die erkannte Referenz wird zweifach validiert: einmal über die Mod10r-Prüfziffer der Azure Function, einmal über eine strukturelle 27-stellige Prüfung auf Business-Central-Seite.
Vollständige Zahlungsdaten liefern Kreditor (IBAN, Name, Adresse), Debitor (Name, Adresse), Betrag, Währung sowie unstrukturierte Mitteilung und Rechnungsinformationen werden als ein strukturierter Datensatz zurückgegeben.
Sichere Konfiguration Der Function Key der Azure Function wird ausschliesslich verschlüsselt abgelegt, nie in einer Tabelle oder einem Backup im Klartext.
Baustein für andere Erweiterungen Der Ventoo Document Reader hat keine eigene Erfassungsmaske für Endbenutzer. Er stellt seine Funktion über eine öffentliche Codeunit-Prozedur bereit, die von abhängigen Erweiterungen direkt aufgerufen wird.
Unterstützte Referenztypen
|
Referenztyp |
Bedeutung |
|---|---|
|
QRR |
Schweizer QR-Referenz (27-stellig, mit Mod10r-Prüfziffer). Einzige Referenzart, die von der App aktuell als vollständiger Treffer zurückgegeben wird. |
|
SCOR |
Creditor Reference (ISO 11649). Wird erkannt und mit dekodiert, gilt aber gemäss der 27-stelligen Prüfung nicht als vollständiger Treffer. |
|
NON |
Keine strukturierte Referenz, nur unstrukturierte Mitteilung. Gilt ebenfalls nicht als vollständiger Treffer. |
So funktioniert es
Schritt 1 – Azure Function verbinden Auf der Seite Document Reader Setup werden Function-URL, Function Key und Timeout hinterlegt.
Schritt 2 – PDF-Anhang bereitstellen Ein beliebiger Beleg mit einem PDF-Dokumentenanhang, der eine Schweizer QR-Rechnung enthält.
Schritt 3 – Abruf durch eine abhängige Erweiterung Eine abhängige Erweiterung ruft die öffentliche Prozedur TryExtractFromAttachment auf und erhält bei einer gültigen QRR-Referenz die vollständigen, strukturierten Zahlungsdaten zurück.
Schritt 4 – Weiterverarbeitung Die aufrufende Erweiterung übernimmt Referenz, Betrag und Kreditordaten automatisch in ihren eigenen Beleg- oder Buchungsprozess – ganz ohne manuelle Eingabe.