Aufzeichnungszustände und -modi

⚠️ Sie sehen die Dokumentation für API-Version 2025-08-12. Die neueste Version ist 2026-05-04. Wesentliche Änderungen umfassen aktualisierte Terminologie (Asset → Organization, Entity → Taxpayer/Location).

Dieser Abschnitt beschreibt die möglichen state- und mode-Stufen sowie die Übergänge, die mit dem Lebenszyklus einer Record-Ressource verbunden sind. Das Diagramm veranschaulicht die Übergänge von Zuständen und Modi und zeigt auf, ob sie über API-Aufrufe oder automatisch durch interne Systemprozesse ausgelöst werden.

Zustände

• Accepted: Der Record wurde empfangen und erfolgreich validiert und ist zur Verarbeitung bereit.
• 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 verarbeitet.
• Failed: Der Record konnte aufgrund eines externen Übertragungsfehlers nicht verarbeitet werden. Details sind in den Log-Meldungen verfügbar.

Modi

• Processing: Der Record wird gerade verarbeitet.
• Finished: Der Record wurde verarbeitet, entweder erfolgreich oder nicht erfolgreich.

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.

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.