assignIdentityByIdentifier

Konzeptarbeit. Noch nicht implementiert

Zweck

Verschiebt die Zuordnung einer Identität zu einer Person (MPI-Eintrag) auf eine andere Person. Suchkriterium für die Identität ist ein Identifier.

Voraussetzung

Verwendete Parameter-Werte müssen im E-PIX bekannt sein.

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/$assignIdentityByIdentifier

Der Funktionsaufruf liefert eine OperationOutcome-Ressource zurück.

Invocations

URL: [base]/$assignIdentityByIdentifier

This operation changes content

Parameters (In)

NameCardinalityTypeDocumentation
domain1..1string

Angabe der Matching-Domäne

identityIdentifier1..1Identifier

Identifier der zu verschiebenden Identität (Patient-Ressource).

mpiIdentifier1..1Identifier

Identifikator des MPI-Eintrags (MPI-ID)

comment0..1string

Anmerkung zum Änderungsvorgang

Return Values (Out)

NameCardinalityTypeDocumentation
return1..1OperationOutcome

Rückinformation zum Merge-Vorgang.

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 Attribute.
Beispiel

Beispielhafter Request-Body:

<Parameters xmlns="http://hl7.org/fhir">
    <id value="Parameters-AssignIdentityByIdentifier-request-example-1" />
    <parameter>
        <name value="comment" />
        <valueString value="Korrektur nach manueller Begutachtung." />
    </parameter>
    <parameter>
        <name value="identityIdentifier" />
        <valueIdentifier>
            <system value="https://ths-greifswald.de/fhir/epix/identifier/identity" />
            <value value="10010000006546" />
        </valueIdentifier>
    </parameter>
    <parameter>
        <name value="mpiIdentifier" />
        <valueIdentifier>
            <system value="https://ths-greifswald.de/fhir/epix/identifier/MPI" />
            <value value="1001000000066" />
        </valueIdentifier>
    </parameter>
</Parameters>

Beispielhafte Response:

<OperationOutcome xmlns="http://hl7.org/fhir">
    <id value="OperationOutcome-AssignIdentityByIdentifier-response-example-1" />
    <issue>
        <severity value="information" />
        <code value="informational" />
        <diagnostics value="identity moved." />
    </issue>
</OperationOutcome>