Errors use RFC 9457 application/problem+json. The type field dereferences to one of these pages.
| type | status | title |
|---|---|---|
unauthorized | 401 | Unauthorized |
rate-limit-exceeded | 429 | Too Many Requests |
unsupported-media-type | 415 | Unsupported Media Type |
invalid-idempotency-key | 400 | Invalid Idempotency Key |
invalid-body | 400 | Invalid Request Body |
payload-too-large | 413 | Payload Too Large |
malformed-json | 400 | Malformed JSON |
invalid-invoice | 422 | Invalid Invoice |
invalid-method | 400 | Invalid Method |
invalid-route | 400 | Invalid Route |
internal-error | 500 | Internal Server Error |
An invalid-invoice problem carries an errors[] array of { path, code, message } objects using these codes.
| code | meaning |
|---|---|
required | A required property was missing or empty. |
invalid_type | A value had the wrong JSON type. |
invalid_format | A string did not match the expected format (e.g. email, tax ID, date). |
invalid_date | A date was not a real calendar date in YYYY-MM-DD form. |
invalid_range | A date or value fell outside an allowed relationship (e.g. due date before issue date). |
out_of_range | A number fell outside its allowed minimum/maximum. |
too_long | A string exceeded its maximum length. |
unknown_property | The object contained a property that is not part of the contract. |
unsupported_value | A value was not one of the supported enum values. |
min_items | An array had too few items. |
max_items | An array had too many items. |
incompatible_value | A value is not allowed for the chosen VAT treatment. |
incompatible_property | A property is not allowed for the chosen VAT treatment. |
required_for_treatment | A property is required for the chosen VAT treatment. |
required_for_profile | A property is required for the chosen profile (e.g. XRechnung). |
invalid_country | A country code was inconsistent with the VAT treatment. |
invalid_vat_id | A VAT identifier did not match the published structure for its country (EN 16931 subset). |
invalid_iban | An IBAN failed the ISO 13616 check-digit test. |
non_eu_vat_treatment | An intra-EU VAT treatment (reverse charge or intra-Community supply) was used with a non-EU party. |
amount_too_large | A line amount exceeded exact integer-cent arithmetic. |
total_too_large | The invoice total exceeded exact integer-cent arithmetic. |
semantic_validation | The invoice violated a profile or VAT-treatment requirement during generation. |
See the full API documentation.