Aufzeichnungszustände und -modi

⚠️Warning

Sie sehen die Dokumentation für API-Version 2024-10-31. Die neueste Version ist 2026-06-01. Wesentliche Änderungen umfassen aktualisierte Terminologie (Asset → Organization, Entity → Taxpayer/Location).

Dieser Abschnitt beschreibt den Lebenszyklus eines Records — die möglichen state- und mode-Werte sowie die Übergänge zwischen ihnen, die alle automatisch vom System ausgelöst werden.

Zustände

• Accepted: Der Record wurde empfangen und hat die Erstvalidierung bestanden, aber noch kein endgültiges Ergebnis wurde gespeichert. Dies ist ein temporärer Zustand.
• Rejected: Der Record wurde empfangen, hat unsere internen Validierungsprüfungen jedoch nicht bestanden. Details sind in den Log-Meldungen verfügbar.
• Completed: Der Record wurde erfolgreich an die Steuerbehörde übermittelt und von ihr akzeptiert. Dies ist ein Endzustand.
• Failed: Während der Verarbeitung ist ein Fehler aufgetreten. Der Record hat entweder die Validierungsprüfungen der Steuerbehörde nicht bestanden, oder ein Fehler hat unser System daran gehindert, das Übermittlungsergebnis zu bestätigen. Details sind in den Log-Nachrichten verfügbar. Dies ist ein Endzustand.

Modi

• Processing: Der Record wird verarbeitet. Der entsprechende Zustand ist Accepted.
• Finished: Der Record wurde verarbeitet, mit entweder einem erfolgreichen oder nicht erfolgreichen Ergebnis. Der entsprechende Zustand ist Rejected, Completed oder Failed.

Zustandsübergänge

• POST → Accepted: Der Record wird über einen API-Aufruf erstellt und wechselt vorübergehend in den Accepted-Zustand, wenn er erfolgreich validiert wurde.
• POST → Rejected: Wenn der Record bei der Erstellung die interne Validierung nicht besteht, wechselt er automatisch in den Rejected-Zustand und stellt zusätzliche Log-Meldungen zum Fehler bereit.
• Accepted → Completed: Dieser Übergang erfolgt automatisch, sobald der Record erfolgreich verarbeitet wurde.
• Accepted → Failed: Wenn während der Verarbeitung ein Fehler auftritt, wechselt der Record automatisch in den Failed-Zustand und stellt zusätzliche Log-Meldungen zur Fehlersuche bereit.

⚠️Wichtig

Der finale Zustand eines TRANSACTION-Records wird direkt in der synchronen POST-Antwort zurückgegeben — kein Polling oder Webhooks erforderlich.

Modusübergänge

• Processing → Finished: Sobald der Record verarbeitet wurde, unabhängig davon, ob das Ergebnis erfolgreich oder nicht erfolgreich war, wechselt er automatisch in den Finished-Modus.

📘Hinweis

Processing ist der Standardmodus jeder INTENTION bei der Erstellung. Sobald die INTENTION in einer TRANSACTION referenziert wird, übernimmt sie den Zustand und den Modus dieser TRANSACTION.

Für TRANSACTION-Records ist Processing normalerweise temporär und sollte sich innerhalb von Sekunden in den Finished-Modus auflösen. Wenn eine TRANSACTION mehr als einige Minuten im Processing-Modus verbleibt, behandeln Sie dies als blockierten Übergang und kontaktieren Sie uns mit der ID des Records, damit wir nachforschen können.