Status-Lebenszyklus
Der Dokumentenstatus zeigt die aktuelle Phase des Dokuments. Jede Phase hat drei mögliche Zustände: processing, completed oder failed. Siehe Dokumentenmodell und Transaktionen.
Statusgruppen
| Phase | Statuscodes |
|---|---|
| Create | create.processing, create.completed, create.failed |
| Upload | upload.processing, upload.completed, upload.failed |
| Import | import.processing, import.completed, import.failed |
| Receive | receive.processing, receive.completed, receive.failed |
| Send | send.processing, send.completed, send.failed |
| Delete | delete.processing, delete.completed, delete.failed |
Wann welcher Status gesetzt wird
- Create — Wenn das Dokument aus einem Modell oder Formular erstellt wird (Formular „Erstellen“ in der Weboberfläche oder Modell-Upload per API).
- Upload — Beim Hochladen von XML (oder einer Datei); das Dokument wird verarbeitet und wechselt zu upload.completed oder upload.failed.
- Import — Wenn das Dokument importiert wird (z. B. aus einer Integration).
- Receive — Wenn ein Dokument über Peppol (oder E-Mail, falls unterstützt) empfangen wird; der Empfangsprozess läuft und der Status wird receive.completed oder receive.failed.
- Send — Wenn Sie eine Sendung auslösen (Peppol oder E-Mail); der Sendeprozess läuft und der Status wird send.completed oder send.failed.
- Delete — Beim Löschen des Dokuments; der Status durchläuft delete.processing und wechselt zu delete.completed oder delete.failed.
Statusverlauf
Der Statusverlauf ist eine geordnete Liste von Einträgen. Jeder Eintrag enthält in der Regel:
- code — Statuscode (z. B. send.failed).
- details — Zusätzliche Informationen (z. B. Fehlermeldung).
- created_at — Wann der Status gesetzt wurde.
Der Statusverlauf dient der Fehlersuche (z. B. warum eine Sendung fehlgeschlagen ist). In der API können die Dokumentdetails den Statusverlauf enthalten; der Transaktions-Endpoint kann ebenfalls status_log liefern. Siehe Dokumentenmodell und API-Referenz.