2026.2.0-rc - ci-build

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

OperationDefinition: queryPossibleMatches

Official URL: https://ths-greifswald.de/fhir/OperationDefinition/epix/QueryPossibleMatches Version: 2026.2.0-rc
Draft as of 2026-09-16 Computable Name: QueryPossibleMatches

Gibt possible Matches des E-PIX zurück. Begrenzung auf eine spezifische Domäne und/oder eine spezifische Person (MPI-Eintrag) ist möglich.

Unterstützt ab v2026.2.0

Zweck

Possible Matches des E-PIX abfragen. Filterung auf Domäne und/oder spezifische Person möglich.

URL: [base]/$queryPossibleMatches

Parameters

UseNameScopeCardinalityTypeBindingDocumentation
INdomain0..1string

Angabe der Matching-Domaene

INmpiIdentifier0..1Identifier

Identifikator eines MPI-Entrags (MPI-ID, Person.identifier). Im konkreten Fall muss auch die Domain angegeben werden.

OUTmatch0..1Bundle

Ergebnis-Bundle mit Match-Informationen vom Typ Match Parameters Profile.

Matchende Identitäts-Informationen sowie zugehörige Meta-Informationen ausgeben.

Voraussetzung

Der angegebene Parameter zur Spezifikation der Matching-Domäne muss im E-PIX konfiguriert sein. Wenn der Parameter mpiIdentifier angeben wird, muss ebenfalls zwingend Parameter domain angegeben werden.

Aufruf und Rückgabe

Die bereitgestellte Funktionalität kann per POST-Request aufgerufen werden. Die erforderlichen Angaben werden per POST-BODY in Form von FHIR Parameters übermittelt.

<HOST>:<PORT>/ttp-fhir/fhir/epix/$queryPossibleMatches

Paging mittels _count und _offset sowie Bundle-Navigation-Links werden in der aktuellen Version noch nicht unterstützt.

Der Funktionsaufruf liefert ein SearchSet-Bundle zurück. Das Bundle-Total gibt die Gesamtanzahl der offenen Possible-Matches im E-PIX zurück. Possible Matches werden als Ressourcen vom Typ Match Parameters Profile zurückgegeben.

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