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

# Support und Eskalation

> Erstellen Sie vor der Eskalation eines Integrationsproblems über den etablierten JobHandy-Supportkanal einen vollständigen und sicheren Diagnosedatensatz.

Verwenden Sie den für Ihre Organisation etablierten JobHandy-Kunden- oder Integrationssupportkanal. Der Public-API-Vertrag definiert keine allgemeingültige Support-E-Mail-Adresse; deshalb wird auf dieser Seite keine erfunden.

## Vor der Eskalation

1. Reproduzieren Sie das Problem, sofern sicher möglich, mit einer neuen `X-Request-ID`.
2. Prüfen Sie die Hinweise unter [Troubleshooting](/de/operations/troubleshooting).
3. Bestätigen Sie OpenAPI-Version und Endpoint-Pfad.
4. Lesen Sie die Ressource nach einem Write-Timeout oder `409` erneut.
5. Entfernen Sie Secrets und unnötige personenbezogene Daten aus den Diagnosedaten.

## Erforderlicher Diagnosedatensatz

| Information     | Beispiel                                            |
| --------------- | --------------------------------------------------- |
| UTC-Zeitstempel | `2026-08-27T14:30:12.418Z`                          |
| HTTP-Methode    | `POST`                                              |
| Pfadtemplate    | `/orders/{id}/decision`                             |
| HTTP-Status     | `409`                                               |
| API-Fehlercode  | `ORDER_ALREADY_DECIDED`                             |
| Request-ID      | `018f3d9a-7dfb-7a23-b4b4-9f7e4b19d4b4`              |
| Tenant-Kontext  | Tenant-ID, wenn relevant und zulässig               |
| Dry Run         | `true` oder `false`                                 |
| Versuche        | Anzahl und Request-IDs                              |
| Client-Version  | Integrationsrelease und übernommene OpenAPI-Version |
| Reproduktion    | Bereinigte Schritte und erwartetes Verhalten        |

## Nicht senden

* API-Keys
* Screenshots aus dem Secret Manager
* vollständige Payroll-Dateien, sofern sie nicht ausdrücklich über einen freigegebenen sicheren Kanal angefordert wurden
* sachfremde Vorfallsanhänge
* vollständige Mitarbeiter-Payloads, wenn IDs und Feldnamen ausreichen
* uneingeschränkte Produktionslogs

## Eskalationsvorlage

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
Betreff: JobHandy API - <Operation> - <Fehlercode>

UTC-Zeit:
Umgebung: Öffentliche Produktions-API
Client-Release:
OpenAPI-Version:
Methode und Pfad:
HTTP-Status:
Fehlercode:
Request-ID:
Tenant-Kontext:
Dry Run:
Erwartetes Ergebnis:
Tatsächliches Ergebnis:
Reproduktionsschritte:
Bereits ausgeführte Retries oder Reconciliation:
Bereinigte Nachweise beigefügt:
```

<Warning>
  Erzeugen Sie bei einem mehrdeutigen Write-Ergebnis keine zweite Mutation, nur um eine eindeutigere Fehlermeldung zu erhalten. Lesen Sie die Ressource erneut und geben Sie sowohl die Request-ID des Schreibvorgangs als auch die der Reconciliation an.
</Warning>