> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pachtify360.de/llms.txt
> Use this file to discover all available pages before exploring further.

# Abrechnung und Fehlerbehandlung

> Vorprüfung, unklare Ergebnisse und schreibende Endpunkte sicher behandeln.

## Lesen und schreiben unterscheiden

Vorschau und Entwurfs-PDF dienen der Kontrolle. Der Buchungsendpunkt
verändert dagegen Archiv, Buchungsschnappschüsse und Kontodaten.
Eine Nachberechnung oder Termin-Synchronisierung kann ebenfalls schreiben,
auch wenn sie keine neue Rechnung erzeugt.

## Vorprüfung

Die Buchung prüft alle ausgewählten Konten vor dem ersten fachlichen
Schreibzugriff. Abgewiesene Konten werden nicht still übersprungen.

| Grund | Bedeutung |
| - | - |
| `KONTO_FEHLT` | Angeforderte Konto-ID existiert nicht. |
| `KONTO_NICHT_AKTIV` | Konto ist nicht aktiv. |
| `KEIN_SOLLTERMIN` | Es konnte kein buchbarer Solltermin bestimmt werden. |
| `TERMIN_UEBERFAELLIG` | Berechneter Solltermin liegt vor dem angeforderten Termin. |
| `TERMIN_ABWEICHEND` | Angeforderter und berechneter Termin passen nicht zusammen. |

Die Fehlerdetails enthalten je betroffenem Konto Identifikation,
`solltermin`, `angeforderterTermin` und `grund`.
Eine fachliche Vorprüfungsablehnung kann als `422` zurückgegeben werden.
Weitere Prüfungen, beispielsweise zu bereits gebuchten Terminen, kommen hinzu.

## Allgemeine Fehlerbehandlung

| Status / Situation | Behandlung |
| - | - |
| `400` | Eingaben und Format prüfen. |
| `401` | Anmeldung beziehungsweise Sitzung prüfen. |
| `403` | Rolle und Einzelberechtigung prüfen. |
| `404` | ID, Termin und vorhandene Daten prüfen. |
| `409` oder Konfliktmeldung | Laufenden oder bereits verarbeiteten Vorgang prüfen. |
| `422` | Fachliche Fehlerliste vollständig auswerten. |
| `5xx` / Timeout | Ergebnis nicht automatisch als „nichts passiert“ behandeln. |

Nicht jeder Endpunkt verwendet sämtliche Statuscodes identisch.
Maßgeblich sind seine Implementierung und die tatsächlich gelieferte Antwort.

## Keine blinden Wiederholungen

Die Buchungsverarbeitung verwendet Kontosperren und Fehlerkompensation,
aber keine einzige große Transaktion für den gesamten Lauf.
Bei unklarem Ergebnis zuerst den gespeicherten Lauf prüfen.

Für sevDesk gilt dasselbe Prinzip: `uncertain` bedeutet Abgleichbedarf,
nicht „gefahrlos nochmals anlegen“. Die Dokumentation behauptet keine
allgemeine Exactly-once-Garantie für beliebige Wiederholungen.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.