Code

Meldung

Ursache und Abhilfe

400

„grant_type muss …“, „code und code_verifier sind Pflicht.“, „code_challenge_method muss "S256" sein.“

Unvollständige Token- oder Authorize-Anfrage; Parameter laut Anmeldung prüfen.

400

„refresh_token-Grant ist deaktiviert.“

In der config.ini ist [FHIR]REFRESHENABLED=0 gesetzt.

400

„Client … darf TypeID … nicht schreiben“

ItemType fehlt in Erlaubte ItemTypen (inbound). In der Client-Liste hinzufügen und sofort erneut senden.

400

„TypeID … ist ein berechnetes Feld (kind=calc)“

Den Wert berechnet der Server (z. B. BMI). Schreiben Sie die Quell-Items (Größe, Gewicht).

400

„subject.reference muss "Patient/<id>" sein“

Erst GET /Patient?identifier=… ausführen und die interne ID verwenden.

400

„Patient/X existiert nicht“

Subject-ID falsch; Patient erneut suchen.

400

„Subject ist nicht in der studienspezifischen Kohorte …“

Ein Client mit Studieneinschränkung schreibt zu einem Patienten außerhalb seiner Studie.

400

„Unit … passt nicht zur erwarteten Einheit …“

Den Wert in der Stamm-Einheit des ItemTypes liefern (property/unit im CodeSystem). Es gibt keine automatische Umrechnung.

400

„_since konnte nicht als Datum gelesen werden …“, „_count muss >= 0 sein.“

Ungültiger Parameter. Ein unlesbares _since wird nie als Vollexport behandelt.

401

„Authorization: Bearer <token> erforderlich.“

Kein oder leerer Authorization-Header. Token holen, Header setzen.

401

„Unbekannter Client.“, „Ungueltige Credentials.“, „client_id und client_secret sind Pflicht.“

Client-ID oder Secret falsch. Notfalls in der Client-Liste ein neues Secret erzeugen.

401

error="invalid_token" im Header WWW-Authenticate

Token abgelaufen oder ungültig signiert. Neuen Token holen.

403

„Client ist deaktiviert.“

Spalte Aktiv steht auf Nein.

403

„Client-Credentials sind abgelaufen.“

Das beim Client hinterlegte Ablaufdatum ist überschritten.

403

„Client ist ohne EMMA-Lizenz nicht zugelassen.“

Eigene Clients brauchen eine aktive EMMA-Lizenz (siehe Freischaltung und Lizenz).

403

„Client ohne Studien-Scope hat keinen Patienten-Lesezugriff.“

Vorkonfigurierter Kanal ohne zugewiesene Studie; betrifft Patient, Media, Binary und $bundle.

403

„ItemType … ist fuer diesen Client nicht zum Export freigegeben.“

type= enthält einen Typ, der nicht in Erlaubte ItemTypen (outbound) steht. Freigeben und neuen Token holen.

403

„Anonymisierte Clients haben keinen Zugriff auf Bild-Bytes …“

Abruf von Binary bei Anonym = Ja. Die Metadaten über Media bleiben abrufbar.

404

„Observation/X wurde nicht gefunden“ (ebenso QuestionnaireResponse)

PUT auf eine nicht existierende Item-ID; es gibt kein Update-as-Create. Bei Bedarf per POST neu anlegen (idempotent).

404

„Media/X …“, „Binary/X …“

Bild existiert nicht, ist archiviert, liegt außerhalb des Studien-Scopes, oder die Bilddatei fehlt im Dateisystem.

404

„Selektion … existiert nicht oder ist archiviert.“

Selektions-ID über CodeSystem/selection prüfen.

405

„Patient-Create per FHIR ist nicht erlaubt …“

POST oder PUT auf Patient. Patienten werden nicht über FHIR angelegt oder geändert; Suche verwenden.

422

Selektion noch nie ausgeführt und leer

Abfrage zuerst im Client ausführen. Eine ausgeführte Selektion ohne Treffer liefert dagegen ein leeres Bundle.

429

(kein Body, Header Retry-After: 60)

Zu viele Fehlanmeldungen von dieser IP-Adresse, siehe Anmelde-Drosselung.

501

„… nicht implementiert“

Nicht unterstützte Interaktion, z. B. DELETE oder Bundle.type=batch.

503

„Ein Datenimport ist noch nicht abgeschlossen …“

Während ein Datenimport aussteht, nimmt der Server keine Daten an; Lesezugriffe funktionieren weiter. Nach Abschluss des Imports erneut senden.