Server error codes
Every public API error code emitted by Server, with its HTTP status, its type and a page per code.
Error codes emitted by Server. Each code links to its own page with the cause and the action to take.
| Code | Type | HTTP | Description |
|---|---|---|---|
dependency_unavailable | service_unavailable_error | 503 | An external service the operation relies on did not answer in time. |
face_transmission_failed | api_error | 502 | The FACe platform — the public administration entry point — was unreachable or answered with a fault. The failure is upstream, not in your request. |
facturae_signing_failed | api_error | 500 | The XAdES signature of the Facturae file could not be produced, usually because the signing certificate is unusable at that moment. |
internal_error | api_error | 500 | Something broke on our side while processing the request. The condition is not caused by your payload. |
maintenance | service_unavailable_error | 503 | The platform is in a maintenance window and writes are held back on purpose. |
pdf_generation_failed | service_unavailable_error | 503 | The rendering service could not produce the PDF. The document and its data are intact — what failed is the file. |
register_sealing_failed | api_error | 500 | The cryptographic sealing of the record did not complete, so the closure was left unsigned rather than sealed with a broken signature. |
send_failed | api_error | 500 | The document was not delivered by email: the mail provider rejected the message or was unreachable. |
service_unavailable | service_unavailable_error | 503 | The service, or a dependency it needs, is temporarily unable to answer. |
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.