Fakturate API problem types

Errors use RFC 9457 application/problem+json. The type field dereferences to one of these pages.

typestatustitle
unauthorized401Unauthorized
rate-limit-exceeded429Too Many Requests
unsupported-media-type415Unsupported Media Type
invalid-idempotency-key400Invalid Idempotency Key
invalid-body400Invalid Request Body
payload-too-large413Payload Too Large
malformed-json400Malformed JSON
invalid-invoice422Invalid Invoice
invalid-method400Invalid Method
invalid-route400Invalid Route
internal-error500Internal Server Error

Field-level codes

An invalid-invoice problem carries an errors[] array of { path, code, message } objects using these codes.

codemeaning
requiredA required property was missing or empty.
invalid_typeA value had the wrong JSON type.
invalid_formatA string did not match the expected format (e.g. email, tax ID, date).
invalid_dateA date was not a real calendar date in YYYY-MM-DD form.
invalid_rangeA date or value fell outside an allowed relationship (e.g. due date before issue date).
out_of_rangeA number fell outside its allowed minimum/maximum.
too_longA string exceeded its maximum length.
unknown_propertyThe object contained a property that is not part of the contract.
unsupported_valueA value was not one of the supported enum values.
min_itemsAn array had too few items.
max_itemsAn array had too many items.
incompatible_valueA value is not allowed for the chosen VAT treatment.
incompatible_propertyA property is not allowed for the chosen VAT treatment.
required_for_treatmentA property is required for the chosen VAT treatment.
required_for_profileA property is required for the chosen profile (e.g. XRechnung).
invalid_countryA country code was inconsistent with the VAT treatment.
invalid_vat_idA VAT identifier did not match the published structure for its country (EN 16931 subset).
invalid_ibanAn IBAN failed the ISO 13616 check-digit test.
non_eu_vat_treatmentAn intra-EU VAT treatment (reverse charge or intra-Community supply) was used with a non-EU party.
amount_too_largeA line amount exceeded exact integer-cent arithmetic.
total_too_largeThe invoice total exceeded exact integer-cent arithmetic.
semantic_validationThe invoice violated a profile or VAT-treatment requirement during generation.

See the full API documentation.