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.

Folgende Arztgruppen sind überweisungsfrei (siehe CodeSystem KBV_CS_SFHIR_BPL_ARZTGRUPPE):

Hausärzte
Kinder- und Jugendärzte

Folgende Fachgruppen nach Weiterbildungsordnung (WBO) sind ebenfalls überweisungsfrei (siehe CodeSystem KBV_CS_SFHIR_BAR2_WBO):

FÄ/FA Augenheilkunde
FÄ/FA Frauenheilkunde und Geburtshilfe

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_Specialties (required)

Liste der für die Vermittlung benötigten, überweisungsfreien Leistungsmerkmale

Überweisungfreie Leistungsmerkmale aus dem CodeSystem KBV_CS_SFHIR_BPL_ARZTGRUPPE:

01 (Hausärzte)
09 (Kinder- und Jugendärzte)

Überweisungfreie Leistungsmerkmale aus dem CodeSystem KBV_CS_SFHIR_BAR2_WBO:

030 (FÄ/FA Augenheilkunde)
050 (FÄ/FA Frauenheilkunde und Geburtshilfe)
341 (FÄ/FA Kinder- und Jugendmedizin)

dringlichkeit

0..1

Coding

KBV_VS_KV_DIGITAL_TS_DRITTE_Urgency (required)

Die Dringlichkeit einer Überweisung (default: urgent = dringend)

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 und der angegebenen Dringlichkeit

Mit dieser Operation kann nur für überweisungsfreie Leistungsmerkmale ein Vermittlungscode angefordert werden.

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

Parameter	Art	Anmerkung
`leistungsmerkmale`	`in`	Aktuell gibt es zwei Einschränkungen, die noch nicht in der FHIR-Spezifikation abgebildet sind und daher nur durch die Systeme der Terminschnittstelle für Dritte validiert werden: Es muss exakt ein überweisungsfreies Leistungsmerkmal übergeben werden. → Werden keine oder mehrere Leistungsmerkmale übergeben oder handelt es sich um ein nicht überweisungsfreies Leistungsmerkmal, kommt ein Fehler (OperationOutcome) zurück. Das im Feld `Documentation` des Parameters angegebene Leistungsmerkmal FÄ/FA Kinder- und Jugendmedizin ist aktuell nicht zulässig. → Wird dieses übergeben, kommt ein Fehler (OperationOutcome) zurück. In der nächsten Version der OperationDefinition werden diese Einschränkungen eingearbeitet, sodass sie nach Veröffentlichung der neuen Version auch in der FHIR-Spezifikation abgebildet sind.
`dringlichkeit`	`in`	Die Dringlichkeit darf aktuell nur den Wert `urgent` haben. Andernfalls kommt ein Fehler (OperationOutcome) zurück.
`vermittlungscode`	`out`	Der Vermittlungscode besteht immer aus exakt 12 alphanumerischen Zeichen.

leistungsmerkmale

in

Aktuell gibt es zwei Einschränkungen, die noch nicht in der FHIR-Spezifikation abgebildet sind und daher nur durch die Systeme der Terminschnittstelle für Dritte validiert werden:

Es muss exakt ein überweisungsfreies Leistungsmerkmal übergeben werden.
→ Werden keine oder mehrere Leistungsmerkmale übergeben oder handelt es sich um ein nicht überweisungsfreies Leistungsmerkmal, kommt ein Fehler (OperationOutcome) zurück.
Das im Feld Documentation des Parameters angegebene Leistungsmerkmal FÄ/FA Kinder- und Jugendmedizin ist aktuell nicht zulässig.
→ Wird dieses übergeben, kommt ein Fehler (OperationOutcome) zurück.

In der nächsten Version der OperationDefinition werden diese Einschränkungen eingearbeitet, sodass sie nach Veröffentlichung der neuen Version auch in der FHIR-Spezifikation abgebildet sind.

dringlichkeit in Die Dringlichkeit darf aktuell nur den Wert urgent haben. Andernfalls 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="341" />
        </valueCoding>
    </parameter>
    <parameter>
        <name value="dringlichkeit" />
        <valueCoding>
            <system value="http://hl7.org/fhir/request-priority" />
            <code value="urgent" />
        </valueCoding>
    </parameter>
</Parameters>

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