Exit Codes

Automatisierung sollte den Prozess-Exit-Code verwenden, um zu entscheiden, ob ein Lauf erfolgreich war, dauerhaft fehlgeschlagen ist oder wiederholt werden sollte.

Exit code	Bedeutung	Typische Behandlung
0	Erfolg, einschließlich Läufen mit Warnungen.	Fortfahren. Ergebnis-CSV bei Bedarf prüfen.
1	CLI-Fehler: Konfiguration, Authentifizierung, Mapping oder IO-Problem.	Eingabe, Mapping, Token oder Pfade vor erneutem Versuch korrigieren.
2	Validierungsfehler: mindestens eine ungültige Zeile oder Response-Zeilen konnten nicht zugeordnet werden.	Ergebnis-CSV prüfen. Dies ist meist ein abgeschlossenes fachliches Ergebnis, kein Infrastruktur-Retry.
3	Temporärer Fehler: Timeout, Rate Limit, Serverfehler oder TEMP_ERROR.	Später erneut versuchen.
4	Berechtigung oder Quote erschöpft.	Lizenz oder Quote vor erneutem Versuch prüfen.

API-Fehler-Mapping

API-Bedingung	Exit code
Connection timeout oder Verbindungsfehler	3
HTTP 400	1
HTTP 401 oder 403	1
HTTP 402	4
HTTP 409	1
HTTP 429	3
HTTP 500 oder höher	3

Ergebnisbasierte Exit Codes

Nachdem eine Ergebnis-CSV geschrieben wurde:

• Jede ERROR-Zeile gibt Exit Code 2 zurück.
• Jede Unavailable- oder TEMP_ERROR-Zeile gibt Exit Code 3 zurück, wenn keine stärkeren Fehler vorhanden sind.
• Andernfalls gibt der Befehl 0 zurück.

Folder Mode gibt den schlechtesten Exit Code aller Dateien zurück, die in diesem Lauf verarbeitet wurden.