Vermittlungscode anfordern

Beschreibung und fachlicher Kontext

Mit dieser Operation lässt sich im 116117 Terminservice ein Vermittlungscode für eines der überweisungsfreien Leistungsmerkmale anfordern, mit dem sich im Anschluss eine Terminsuche ausführen lässt. Der so erstellte Vermittlungscode ist ungebucht, nicht abgelaufen und an das angegebene Leistungsmerkmal gebunden.

Der Zeitpunkt für den Start des gesetzlichen Anspruchs auf eine Terminvermittlung ist noch nicht festgelegt. Dieser wird erst mit der erstmaligen Terminsuche ausgelöst.

FHIR-Operation

Name	KBV_OD_KV_DIGITAL_TS_DRITTE_Vermittlungscode_Request
Type	OperationDefinition
Kind	`operation`
Code	`vermittlungscode_anfordern`
Canonical URL	https://fhir.kbv.de/OperationDefinition/KBV_OD_KV_DIGITAL_TS_DRITTE_Vermittlungscode_Request

Invocations

URL: [base]/$vermittlungscode_anfordern

Parameters (In)

Name	Cardinality	Type	Binding	Documentation
leistungsmerkmale	1..100	Coding	KBV_VS_KV_DIGITAL_TS_DRITTE_Non_Referral_Specialties (required)	Liste der für die Vermittlung benötigten, überweisungsfreien Leistungsmerkmale. Bitte beachten: Aktuell darf hier nur ein Leistungsmerkmal übergeben werden, da die Leistungsmerkmale aus unterschiedlichen Fachgruppen kommen oder (im Falle der PTV11-Leistungsmerkmale) sich gegenseitig ausschließen.

Return Values (Out)

Name	Cardinality	Type	Documentation
vermittlungscode	1..1	canonical(KBV_PR_KV_DIGITAL_TS_DRITTE_Identifier_Vermittlungscode)	Neuer Vermittlungscode mit den gewünschten Leistungsmerkmalen

Ein Vermittlungscode, der mit dieser Operation angefordert wurde, hat immer die Dringlichkeit "dringend" (urgent).

Anmerkungen

Im Fehlerfall wird ein Fehler (OperationOutcome) mit Details zum aufgetretenen Fehler zurückgegeben.

In der folgenden Tabelle finden sich zudem weitere Anmerkungen zu einzelnen Parametern:

Parameter	Art	Anmerkung
`leistungsmerkmale`	`in`	Aktuell gibt es folgende Einschränkung, die nicht in der FHIR-Spezifikation abgebildet ist und daher nur durch die Systeme der Terminschnittstelle für Dritte validiert wird: Es muss exakt ein überweisungsfreies Leistungsmerkmal übergeben werden. Werden keine oder mehrere Leistungsmerkmale übergeben oder handelt es sich um ein überweisungspflichtiges Leistungsmerkmal, kommt ein Fehler (OperationOutcome) zurück.
`vermittlungscode`	`out`	Der Vermittlungscode besteht immer aus exakt 12 alphanumerischen Zeichen.

Beispiele

Beispiele für den Fehlerfall sind auf der Seite Fehler (OperationOutcome) zu finden.

Request Body
Response Body

<Parameters xmlns="http://hl7.org/fhir">
    <parameter>
        <name value="leistungsmerkmale" />
        <valueCoding>
            <system value="https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_BPL_ARZTGRUPPE" />
            <code value="09" />
        </valueCoding>
    </parameter>
    <parameter>
        <name value="leistungsmerkmale" />
        <valueCoding>
            <system value="https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_BAR2_WBO" />
            <code value="030" />
        </valueCoding>
    </parameter>
</Parameters>

<Identifier xmlns="http://hl7.org/fhir" id="bbce5e04-99c1-4bbb-9a78-8ff904ed426f">
    <system value="https://fhir.kbv.de/NamingSystem/KBV_NS_116117_TERMINSERVICE_Vermittlungscode" />
    <value value="XN6PF4UPZ5KX" />
</Identifier>