Ironfang Finance API problem type

`generation_failed`

Generation failed. HTTP 500.

What it means

The JSON was accepted, but the document generated from it did not pass the selected ruleset, so no XML was released and nothing was charged. The outcome is indeterminate rather than a verdict on the input.

What to do

Review the input values the rules depend on, such as totals, tax categories and identifiers, and try again. If the input is right, contact support with the request_id.

What the response carries

type: https://ironfang.uk/problems/generation_failed, this page.
status: Always 500 for this code.
code: generation_failed. Stable: branch on this, not on the wording of title or detail.
detail: What happened this time, safe to show to a person. It never carries invoice content.
request_id: The same value as the X-Ironfang-Request-ID header. Quote it to support.
retry_after_seconds: Never present for this code.
outcome: Always indeterminate, with usage_charged false: the API could not decide, which is not a verdict on the document, and nothing was charged.

Problems follow RFC 9457 and are served as application/problem+json. A validation finding is never a Problem: an invalid invoice is a successful response that lists its findings. See every problem type, the Finance guide and the OpenAPI contract.