Error Reference
Error Code Structure
Section titled “Error Code Structure”TaprNext uses a systematic error code format: ERR-[CATEGORY]-[CODE]
Examples include ERR-CON-401 for connection/HTTP 401 errors and ERR-WF-ROUTE for workflow routing issues.
Error Categories
Section titled “Error Categories”| Prefix | Category | Purpose |
|---|---|---|
| ERR-CON | Connection | ERP and API connectivity |
| ERR-WF | Workflow | Approval routing issues |
| ERR-AI | AI Extraction | Document processing |
| ERR-VAL | Validation | Data validation errors |
| ERR-ERP | ERP Posting | Posting to ERP system |
| ERR-SYS | System | Internal system errors |
Connection Errors (ERR-CON)
Section titled “Connection Errors (ERR-CON)”ERR-CON-401: Authentication failed — Invalid API key, expired token, or incorrect credentials. Resolve by verifying credentials, regenerating API keys in your ERP, and testing the connection.
ERR-CON-403: Access forbidden — User lacks permissions in the ERP system. Verify the ERP user has invoice posting permissions and check API scopes.
ERR-CON-TIMEOUT — Network issues or ERP server unavailability. Confirm the ERP system is accessible and check firewall settings.
ERR-CON-SSL — Certificate validation failure. Verify SSL certificates are valid and not expired.
Workflow Errors (ERR-WF)
Section titled “Workflow Errors (ERR-WF)”ERR-WF-ROUTE: No matching rule — Invoice doesn’t match configured approval rules; defaults to standard approver. Review and adjust approval rule conditions.
ERR-WF-APPROVER: Approver not found — Assigned approver is inactive or nonexistent. Verify the approver exists and set a backup approver.
ERR-WF-PERM: Permission denied — User’s role lacks required permissions for the action.
AI Extraction Errors (ERR-AI)
Section titled “AI Extraction Errors (ERR-AI)”ERR-AI-PARSE: Parse failed — Document format unrecognized or quality insufficient. Check document clarity and ensure it’s a valid invoice.
ERR-AI-MODEL: Model unavailable — AI provider service issue. Wait and retry, or switch to a configured backup provider.
ERR-AI-VENDOR: Vendor not matched — Vendor missing from system or name mismatch. Manually select the vendor or create a new entry.
Validation Errors (ERR-VAL)
Section titled “Validation Errors (ERR-VAL)”ERR-VAL-REQ: Required field missing — Mandatory field is empty. Enter the required value.
ERR-VAL-DUP: Duplicate invoice — Same invoice number from the same vendor already exists. Mark as duplicate or correct the invoice number.
ERR-VAL-TOTAL: Total mismatch — Line item sum doesn’t equal grand total. Review amounts, tax calculation, and charges.
ERP Posting Errors (ERR-ERP)
Section titled “ERP Posting Errors (ERR-ERP)”ERR-ERP-MAP: Mapping failed — Missing field mapping configuration. Configure required ERP field mappings in settings.
ERR-ERP-POST: Posting failed — ERP validation rejected the invoice. Verify vendor exists, check GL account mappings, and review tax codes.
Getting Help
Section titled “Getting Help”When contacting support, provide the error code, full message, screenshots, invoice number, and reproduction steps. Additional guidance is available in related FAQs for connection, workflow, and extraction issues.