Datensatz-Status und -Modi

⚠️Warning

Sie sehen die Dokumentation für API-Version 2026-02-03. Die neueste Version ist 2026-06-01. Die neue API-Version bringt keine Änderungen an der italienischen Integration. Sie fügt jedoch die SIGN PT-Unterstützung hinzu und ermöglicht es Teams, die eine Expansion nach Portugal planen, dieselbe Integration, die bereits für Italien vorhanden ist, wiederzuverwenden.

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.

Status

• 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 (Abgelehnt): Der Datensatz wurde empfangen, hat aber unsere internen Validierungsprüfungen nicht bestanden. Details sind in den Protokollmeldungen verfügbar. Dies ist ein Endstatus.
• Completed: Der Record wurde erfolgreich an die Steuerbehörde übermittelt und von ihr akzeptiert. Dies ist ein Endzustand.
• Failed (Fehlgeschlagen): 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.

💡Tipp: Leitfaden zur Fehlerbehandlung

Der folgende Artikel bietet eine Übersicht der häufigsten Fehler beim Senden von Datensätzen über SIGN IT lite sowie Hinweise zu deren Behebung: SIGN IT - Error Handling Guide

Modi

• Processing (In Verarbeitung): 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.

Statusübergänge

• POST → Accepted: Der Datensatz wird über einen API-Aufruf erstellt und geht vorübergehend in den Status „Accepted” über, wenn er erfolgreich validiert wurde.
• POST → Rejected: Wenn der Datensatz bei der Erstellung die interne Validierung nicht besteht, wechselt er automatisch in den Status „Rejected” und stellt zusätzliche Protokollmeldungen zum Fehler bereit.
• Accepted → Completed: Dieser Übergang erfolgt automatisch, sobald der Datensatz erfolgreich verarbeitet wurde.
• Accepted → Failed: Wenn während der Verarbeitung ein Fehler auftritt, wechselt der Datensatz automatisch in den Status „Failed” und stellt zusätzliche Protokollmeldungen 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 Datensatz verarbeitet wurde, unabhängig davon, ob das Ergebnis erfolgreich oder nicht erfolgreich war, wechselt er automatisch in den Modus „Finished”.

📘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.