Skip to content
GitHub

Error types

Every error of the conversion API is an RFC 9457 problem. The type is one of these URIs. They are the command line's exit codes 2 to 7, so a script and a service client see the same categories. Requests over a size or count limit answer 413 with the first type.

  • Unsafe or malformed input unsafe-or-malformed

    Not XML, a DOCTYPE, an unreadable archive or PDF, or a size or count limit exceeded (413).

    HTTP status 400 or 413. Command line exit code 2. Type URI: https://alexcatdad.github.io/eu-einvoice-canonical/problems/#unsafe-or-malformed

  • Unsupported format unsupported

    Well-formed, but not an invoice format this converter reads (including well-formed non-invoice XML).

    HTTP status 422. Command line exit code 3. Type URI: https://alexcatdad.github.io/eu-einvoice-canonical/problems/#unsupported

  • Validation failed validation-failed

    The invoices converted, but the requested validation reported failures. The result is in the problem.

    HTTP status 422. Command line exit code 4. Type URI: https://alexcatdad.github.io/eu-einvoice-canonical/problems/#validation-failed

  • Partially converted partial

    Some documents in the file converted and some did not. The result is in the problem.

    HTTP status 422. Command line exit code 5. Type URI: https://alexcatdad.github.io/eu-einvoice-canonical/problems/#partial

  • Validator unavailable validator-unavailable

    Validation, or the trusted-list snapshot for euTrust, was requested and cannot run on this server.

    HTTP status 503. Command line exit code 6. Type URI: https://alexcatdad.github.io/eu-einvoice-canonical/problems/#validator-unavailable

  • Internal error internal

    A bug in the converter. Report it with the file hash from the response.

    HTTP status 500. Command line exit code 7. Type URI: https://alexcatdad.github.io/eu-einvoice-canonical/problems/#internal