Expense scanner error codes
Every public API error code emitted by Expense scanner, with its HTTP status, its type and a page per code.
Error codes emitted by Expense scanner. Each code links to its own page with the cause and the action to take.
| Code | Type | HTTP | Description |
|---|---|---|---|
duplicate_override_reason_required | invalid_request_error | 422 | A valid reason to proceed despite the duplicate is missing. |
duplicate_resolution_required | invalid_request_error | 422 | A possible duplicate requires review. |
invalid_inbound_signature | authentication_error | 401 | The inbound email signature could not be authenticated. |
invalid_purchase_scan_transition | invalid_request_error | 422 | The current scan status does not allow this transition. |
module_upgrade_required | authorization_error | 403 | The current plan does not include the requested OCR capability. |
ocr_company_daily_quota_exceeded | rate_limit_error | 429 | The company has exhausted its daily OCR quota. |
ocr_company_quota_exceeded | rate_limit_error | 429 | The company has exhausted its monthly OCR quota. |
purchase_scan_already_converted | conflict_error | 409 | The scan is already linked to an expense. |
purchase_scan_not_found | not_found_error | 404 | The scan does not exist or does not belong to the active company. |
purchase_scan_retry_not_allowed | invalid_request_error | 422 | The scan cannot be retried in its current status. |
purchase_scan_review_incomplete | invalid_request_error | 422 | Required data is missing or the reviewed amounts do not reconcile. |
purchase_scan_source_unavailable | invalid_request_error | 422 | The scan original was purged or is no longer available in secure storage. |
scan_batch_too_large | invalid_request_error | 413 | The batch exceeds the permitted total size. |
scan_decompression_limit_exceeded | invalid_request_error | 413 | The file exceeds the safe decompression limit. |
scan_file_too_large | invalid_request_error | 413 | A file exceeds the 20 MiB limit. |
scan_page_limit_exceeded | invalid_request_error | 413 | The document exceeds the configured page limit. |
scan_pixel_limit_exceeded | invalid_request_error | 413 | The document resolution exceeds the safe processing limit. |
scan_storage_unavailable | service_unavailable_error | 503 | Secure storage for the original is unavailable. |
scanner_admin_required | authorization_error | 403 | The action requires scanner administration permissions. |
stale_scan_version | conflict_error | 409 | The scan has changed since it was last read. |
unsafe_scan_file | invalid_request_error | 422 | The original failed security inspection. |
unsupported_purchase_currency | invalid_request_error | 422 | The document currency is not supported for conversion. |
unsupported_purchase_document_type | invalid_request_error | 422 | The original is a delivery note, order, quote, proforma or another document that does not substantiate a fiscal expense. |
unsupported_scan_format | invalid_request_error | 422 | The actual file format is unsupported. |
validation_failed | invalid_request_error | 422 | The scan data does not meet the stated constraints. |
Related
Error codes by category
Find an error by the category that emits it.
Full reference table
All codes, HTTP statuses, types and descriptions in one reference.
Error model
Interpret the error envelope and handle errors by code.