Dieser Artikel beschreibt im Detail, wie der Ventoo Document Reader eine erkannte Zahlungsreferenz bewertet und wie er mit Fehlern, Zeitüberschreitungen und mehrdeutigen Ergebnissen umgeht.
Referenztypen im Detail
|
Referenztyp |
Beschreibung |
Gilt als vollständiger Treffer? |
|---|---|---|
|
|
Schweizer QR-Referenz, 27-stellig numerisch, mit Mod10r-Prüfziffer. |
Ja, sofern beide Prüfstufen bestanden werden. |
|
|
Creditor Reference nach ISO 11649, alphanumerisch. |
Nein – besteht die 27-stellige numerische Prüfung nicht. |
|
|
Kein strukturierter Referenzwert vorhanden. |
Nein – leere Referenz besteht die 27-stellige Prüfung nicht. |
Zweistufige Prüfung im Detail
-
Prüfziffer (Azure Function): Die Azure Function berechnet die Mod10r-Prüfziffer der erkannten Referenz und liefert das Ergebnis als Flag
validzurück. -
Strukturprüfung (Business Central): Der Ventoo Document Reader prüft zusätzlich, dass die Referenz aus exakt 27 numerischen Ziffern besteht.
Nur wenn beide Stufen positiv sind, liefert TryExtractFromAttachment true zurück und die Daten gelten als vollständiger Treffer.
Wichtig: Diese Kombination bedeutet in der Praxis, dass ausschliesslich QRR-Referenzen zu einem true-Rückgabewert führen können. Wird eine SCOR-Referenz oder eine referenzlose (NON) QR-Rechnung erkannt, werden Kreditor-, Debitor- und Betragsdaten zwar von der Azure Function dekodiert, die Prozedur meldet aber dennoch false zurück. Aufrufende Erweiterungen, die auch mit SCOR- oder NON-Belegen arbeiten möchten, können dies aktuell nicht direkt über den Rückgabewert von TryExtractFromAttachment unterscheiden.
Fehlerarten im Überblick
|
Situation |
Verhalten |
Ist das ein Fehler? |
|---|---|---|
|
App nicht aktiviert |
Sofortige Rückgabe |
Nein |
|
Function URL nicht hinterlegt |
Sofortige Rückgabe |
Nein |
|
PDF ohne erkennbaren QR-Code |
Azure Function liefert |
Nein |
|
Referenz besteht 27-stellige Prüfung nicht ( |
Rückgabe |
Nein |
|
Azure Function nicht erreichbar oder Zeitüberschreitung |
Fehlermeldung "The QR-bill reading service could not be reached or returned an error." wird ausgelöst. |
Ja |
|
Azure Function antwortet mit Statuscode ausserhalb 2xx |
Dieselbe Fehlermeldung wie oben. |
Ja |
Hinweis: Der Ventoo Document Reader unterscheidet bewusst zwischen "kein Treffer" (kein Fehler, sehr häufiger Normalfall) und "Dienst nicht erreichbar" (echter Fehler). Nur Letzteres löst eine Fehlermeldung aus, die von der aufrufenden Erweiterung z.B. über TryFunction-Semantik abgefangen werden kann.
Zeitüberschreitung
Antwortet die Azure Function nicht innerhalb der in den Verbindungseinstellungen hinterlegten Timeout (ms)-Zeit, wird die Anfrage abgebrochen und als Fehler behandelt. Es erfolgt kein automatischer Wiederholungsversuch durch den Ventoo Document Reader selbst.