Problemtyp der Ironfang Finance API

`unknown_ruleset`

Unbekanntes Regelwerk. HTTP 422.

Was er bedeutet

Das angeforderte Regelwerk nennt kein Release, gegen das validiert werden kann: Die ID ist unbekannt, bezeichnet einen internen Kandidaten, oder für dieses Profil und diesen Dokumenttyp gibt es kein aktuelles Release. Das Dokument wurde nicht validiert.

Was zu tun ist

Listen Sie die Regelwerke mit GET /v1/einvoices/rulesets auf und verwenden Sie eine ID aus dieser Liste, oder lassen Sie die API das aktuelle Release wählen.

Was die Antwort enthält

type: https://ironfang.uk/problems/unknown_ruleset, die englische Fassung dieser Seite.
status: Für diesen Code immer 422.
code: unknown_ruleset. Stabil: Verzweigen Sie anhand dieses Werts, nicht anhand des Wortlauts von title oder detail, die die API auf Englisch liefert.
detail: Was diesmal passiert ist, auf Englisch; kann einer Person angezeigt werden. Enthält nie Inhalte der Rechnung.
request_id: Derselbe Wert wie im Header X-Ironfang-Request-ID. Geben Sie ihn beim Support an.
retry_after_seconds: Bei diesem Code nie vorhanden.
outcome: Fehlt. Dieser Code ist keine Aussage über ein Dokument.

Problemantworten folgen RFC 9457 und werden als application/problem+json ausgeliefert. Ein Validierungsbefund ist nie eine Problemantwort: Eine ungültige Rechnung ist eine erfolgreiche Antwort, die ihre Befunde auflistet. Siehe alle Problemtypen, den Finance-Leitfaden und den OpenAPI-Vertrag (auf Englisch).