Fehlerreferenz
Struktur der Fehlercodes
Abschnitt betitelt „Struktur der Fehlercodes“TaprNext verwendet ein systematisches Fehlercode-Format: ERR-[CATEGORY]-[CODE]
Beispiele sind ERR-CON-401 für Verbindungs-/HTTP-401-Fehler und ERR-WF-ROUTE für Workflow-Routing-Probleme.
Fehlerkategorien
Abschnitt betitelt „Fehlerkategorien“| Prefix | Kategorie | Zweck |
|---|---|---|
| ERR-CON | Connection | ERP- und API-Konnektivität |
| ERR-WF | Workflow | Probleme beim Freigabe-Routing |
| ERR-AI | AI Extraction | Dokumentenverarbeitung |
| ERR-VAL | Validation | Datenvalidierungsfehler |
| ERR-ERP | ERP Posting | Buchung ins ERP-System |
| ERR-SYS | System | Interne Systemfehler |
Verbindungsfehler (ERR-CON)
Abschnitt betitelt „Verbindungsfehler (ERR-CON)“ERR-CON-401: Authentication failed — Ungültiger API-Schlüssel, abgelaufenes Token oder falsche Anmeldedaten. Lösung: Anmeldedaten prüfen, API-Schlüssel im ERP neu erzeugen und die Verbindung testen.
ERR-CON-403: Access forbidden — Dem Benutzer fehlen Berechtigungen im ERP-System. Prüfen Sie, ob der ERP-Benutzer Rechnungen buchen darf, und kontrollieren Sie die API-Scopes.
ERR-CON-TIMEOUT — Netzwerkprobleme oder ERP-Server nicht erreichbar. Stellen Sie sicher, dass das ERP-System erreichbar ist, und prüfen Sie die Firewall-Einstellungen.
ERR-CON-SSL — Zertifikatsvalidierung fehlgeschlagen. Prüfen Sie, ob die SSL-Zertifikate gültig und nicht abgelaufen sind.
Workflow-Fehler (ERR-WF)
Abschnitt betitelt „Workflow-Fehler (ERR-WF)“ERR-WF-ROUTE: No matching rule — Die Rechnung entspricht keiner konfigurierten Freigaberegel; es wird der Standard-Freigeber verwendet. Freigaberegeln prüfen und Bedingungen anpassen.
ERR-WF-APPROVER: Approver not found — Der zugewiesene Freigeber ist inaktiv oder existiert nicht. Prüfen Sie, ob der Freigeber vorhanden ist, und hinterlegen Sie einen Stellvertreter.
ERR-WF-PERM: Permission denied — Die Rolle des Benutzers verfügt nicht über die erforderlichen Berechtigungen für die Aktion.
KI-Extraktionsfehler (ERR-AI)
Abschnitt betitelt „KI-Extraktionsfehler (ERR-AI)“ERR-AI-PARSE: Parse failed — Dokumentformat nicht erkannt oder Qualität unzureichend. Prüfen Sie die Lesbarkeit des Dokuments und stellen Sie sicher, dass es sich um eine gültige Rechnung handelt.
ERR-AI-MODEL: Model unavailable — Problem beim KI-Provider-Dienst. Warten und erneut versuchen oder auf einen konfigurierten Backup-Provider wechseln.
ERR-AI-VENDOR: Vendor not matched — Lieferant fehlt im System oder Namensabweichung. Lieferanten manuell auswählen oder neu anlegen.
Validierungsfehler (ERR-VAL)
Abschnitt betitelt „Validierungsfehler (ERR-VAL)“ERR-VAL-REQ: Required field missing — Pflichtfeld ist leer. Erforderlichen Wert eingeben.
ERR-VAL-DUP: Duplicate invoice — Dieselbe Rechnungsnummer desselben Lieferanten existiert bereits. Als Duplikat markieren oder Rechnungsnummer korrigieren.
ERR-VAL-TOTAL: Total mismatch — Summe der Positionen entspricht nicht dem Gesamttotal. Beträge, Steuerberechnung und Zuschläge prüfen.
ERP-Buchungsfehler (ERR-ERP)
Abschnitt betitelt „ERP-Buchungsfehler (ERR-ERP)“ERR-ERP-MAP: Mapping failed — Fehlende Feldzuordnung. Erforderliche ERP-Feldzuordnungen in den Einstellungen konfigurieren.
ERR-ERP-POST: Posting failed — ERP-Validierung hat die Rechnung abgelehnt. Prüfen Sie, ob der Lieferant existiert, die Sachkontenzuordnungen und die Steuercodes.
Hilfe erhalten
Abschnitt betitelt „Hilfe erhalten“Geben Sie bei der Kontaktaufnahme mit dem Support den Fehlercode, die vollständige Meldung, Screenshots, die Rechnungsnummer und die Schritte zur Reproduktion an. Weitere Hinweise finden Sie in den FAQs zu Verbindung, Workflow und Extraktion.