Skip to content

Ironfang Finance API problem type

unknown_ruleset

Unknown ruleset. HTTP 422.

What it means

The requested ruleset names no release that can be validated against: the id is unknown, names an internal candidate, or no current release exists for that profile and document type. The document was not validated.

What to do

List the rulesets with GET /v1/einvoices/rulesets and use an id from that list, or let the API choose the current release.

What the response carries

type
https://ironfang.uk/problems/unknown_ruleset, this page.
status
Always 422 for this code.
code
unknown_ruleset. 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
Absent. This code is not a statement about any document.

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.