2025.2.0 - ci-build

IGTTPFHIRGatewaygICS - Local Development build (v2025.2.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

OperationDefinition: AddConsentOptOut

Official URL: https://ths-greifswald.de/fhir/OperationDefinition/gics/addConsentOptOut Version: 2025.2.0
Active as of 2025-06-12 Computable Name: AddConsentOptOut

Erstellt die Einwilligungsinformationen in einem Opt-Out-Kontext für einen (ggf. neuen) Patienten, um auf dieser Basis eine neue Einwilligung im gICS zu erzeugen. Liefert Bundle vom Typ "collection". Das Bundle enthält die errechnete FHIR Consent-Resource.

Teil des FHIR Gateway für gICS. Weitere Infos unter https://ths-greifswald.de/gics

Legt eine neue Einwilligung im gICS für ein spezifisches Forschungsvorhaben (Domain) mit Opt-Out-Kontext auf Basis der übermittelten Informationen gemäß den Profil-Vorgaben der HL7 Deutschland Arbeitsgruppe "Einwilligungsmanagement" an:

Zurückgegeben wird der auf dieser Basis errechnete strukturierte Consent im Bundle gemäß der gICS-spezifischen Profilvorgaben.

Voraussetzung

  • Spezifizierte Einwilligungsdomäne muss angelegt sein
  • In der Patient-Resource verwendete Angaben des Identifier.system müssen in Form von SignerIdTypes, wie z.B. 'Pseudonym','CaseId','StudyPsn' in der entsprechenden Domäne im gICS konfiguriert sein
  • eventuell vorhandene IDs (UUIDs) werden während der Verarbeitung durch gICS-eigene UUIDs ersetzt.

Language: de-DE

URL: [base]/$addConsentOptOut

Parameters

UseNameScopeCardinalityTypeBindingDocumentation
INpatient1..1Patient

Patient-Ressource, entsprechend dem Profil http://fhir.de/ConsentManagement/StructureDefinition/Patient. Für Identifier in dieser Ressource muss der Namensraum (identifier.system) mit der Zeichenfolge 'https://ths-greifswald.de/fhir/gics/identifiers/' beginnen. Angehängt hieran wird der Bezeichner eines im System konfigurierten SignerIDTypes. Abweichungen hiervon führen zu einem Fehler, indiziert durch HTTP Status 422.

INdomain1..1string

Angabe der Einwilligungsdomaene

INquestionnaire1..1canonical

Canonical URL des Questionnaire (entsprechend dem Profil http://fhir.de/ConsentManagement/StructureDefinition/QuestionnaireComposed), das im Rahmen eines Opt-Out-Kontexts implizit gilt.

OUTreturn1..1Bundle

Bundle vom Typ collection, das die errechneten Consent-Ressourcen enthält.

Liefert alle Consente einer Person einer spezifischen Einwilligungsdomaene, die sich aus den übermittelten Informationen ergeben. Die Rückgabe erfolgt als Bundle vom Typ "collection".

Rückgabe

Im Erfolgsfall wird der HTTP Statuscode 200 zurückgegeben.

Im Fehlerfall wird einer der folgenden HTTP Statuscodes in Verbindung mit einer OperationOutcome-Ressource zurückgegeben:

  • 400: Fehlende oder fehlerhafte Parameter.
  • 401: Fehlende Authentifizierung oder Autorisierung.
  • 404: Parameter mit unbekanntem Inhalt.
  • 422: Fehlende oder falsche Patienten-Attribute.

Beispiel