service_unavailableSchnittstelle
Dienst nicht erreichbar
HTTP 503 der Schnittstelle: Ein nachgelagerter Dienst – Prüfung oder PDF-Erzeugung – antwortet gerade nicht. Wiederhole den Aufruf in ein paar Minuten, und zwar MIT demselben Idempotency-Key: Dann entsteht auch bei mehrfacher Wiederholung nur eine Rechnung.
Wortlaut der Meldung
[service_unavailable] Der Prüfdienst ist gerade nicht erreichbar. Bitte versuche es in ein paar Minuten erneut.
Stand: Juli 2026 · Geprüft und geschrieben von Pascal Wagner
Warum das passiert
- Der Prüf- oder Erzeugungsdienst wird gerade neu gestartet – etwa bei einer Wartung.
- Eine vorübergehende Störung zwischen den internen Diensten; sie heilt in aller Regel von selbst.
So behebst du es
- Wiederhole den Aufruf mit wachsendem Abstand – und mit demselben Idempotency-Key wie beim ersten Versuch.
- Nichts verwerfen: Der Aufruf ist nicht verloren, die Bestellung wartet, bis der Dienst wieder antwortet.
Was die Regel nicht prüft
Eine Dienststörung wird NIE als „Rechnung ungültig“ ausgegeben – 503 heißt „gerade nicht“, nicht „falsch“. Und die Wiederholung ohne Idempotency-Key ist der einzige Weg, aus einer Störung zwei Rechnungen zu machen: Mit Key gibt der zweite Aufruf die erste Antwort zurück, ohne Key legt er eine zweite Nummer an.
Was der Empfänger sieht
Nichts. Entweder ist gar keine Rechnung entstanden, oder sie entsteht vollständig bei der Wiederholung – halbe Rechnungen gibt es nicht.
Tritt oft zusammen auf mit
- rate_limited – Zu viele Aufrufe in kurzer Zeit
- validation_failed – Normprüfung nicht bestanden
Begriffe dazu
- Rechnungsprüfung – Die Kontrolle einer Eingangsrechnung, bevor sie bezahlt und gebucht wird.
Quelle: die Schnittstelle des Rechnungslotsen (/api/v1). Diese Seite beschreibt das dokumentierte Verhalten des Dienstes und ist keine Rechts- oder Steuerberatung. Fehlt etwas oder stimmt etwas nicht? Schreib uns.