Zum Hauptinhalt springen

conformance_unavailable

HTTP 503 · code: "conformance_unavailable" · type: https://docs.formfeed.dev/errors/conformance-unavailable

Der Dienst, der aus einem gerenderten PDF eine E-Rechnung macht und sie validiert und der eine mit pdf.ua gerenderte Datei validiert, ist gerade ausgelastet oder nicht erreichbar. Wo ein zweiter Versuch helfen konnte, hat Formfeed ihn bereits unternommen. Ein Rendering, das eine E-Rechnung verlangt hat, kommt nie stattdessen als gewöhnliches PDF zurück, und eines, das PDF/UA-1 verlangt hat, nie ungeprüft: Sie erhalten die validierte Datei oder dieses Problem. Die Antwort trägt Retry-After (5 Sekunden). Es wurde nichts berechnet.

Beispiel​

{
  "type": "https://docs.formfeed.dev/errors/conformance-unavailable",
  "title": "Conformance service unavailable",
  "status": 503,
  "detail": "The conformance service is not reachable; retry shortly",
  "code": "conformance_unavailable",
  "render_id": "rnd_7da09ab6cd9946b798c187c2a9350852",
  "request_id": "req_4b7c1e9a2f3d4c5b8a6e7f9012"
}

Häufige Ursachen​

  • Viele gleichzeitige E-Rechnungen oder PDF/UA-Dateien in Ihrer Region. Jede Datei wird einzeln umgewandelt oder validiert, daher stauen sich Spitzen (The conformance service is busy; retry shortly).
  • Der Dienst startet nach einem Update neu (The conformance service is not reachable; retry shortly).
  • Eine Region, in der E-Rechnungen oder die PDF/UA-Prüfung nicht verfügbar sind (E-invoices are not available in this region, PDF/UA validation is not available in this region).

Eine Umwandlung oder Validierung, die länger als ihre 20 Sekunden dauert, antwortet stattdessen mit render_timeout.

So beheben Sie es​

  • Wiederholen Sie die Anfrage nach der Anzahl Sekunden im Header Retry-After, mit demselben Idempotency-Key.
  • Senden Sie große Mengen an Dokumenten als asynchrone Renderings oder als Batch: Die Warteschlange wiederholt diesen Fehler selbst, 5 und dann 10 Sekunden später. Scheitern alle drei Versuche, endet das Rendering als worker_exhausted, mit der Meldung dieses Codes in detail.
  • Wenn der Fehler weiter auftritt, senden Sie die request_id an support@formfeed.dev.

Wiederholen?​

Ja, nach Retry-After Sekunden, mit demselben Idempotency-Key; Antworten 503 werden nicht unter dem Schlüssel gespeichert. Die SDKs erledigen das für Sie.