Operation: Vermittlungscode anfordern

Beschreibung und fachlicher Kontext

Mit dieser Operation lässt sich über ein Praxisverwaltungssystem (PVS) im 116117 Terminservice ein Vermittlungscode anfordern, der anschließend zusammen mit der URL, die ebenfalls zurückgegeben wird, auf die Überweisung (Muster 6) oder das PTV11 aufgebracht werden kann.

Das bedeutet, dass diese Operation nur für überweisungsausstellende Ärzte und Psychotherapeuten, nicht aber für ausschließlich behandelnde Ärzte relevant ist, die selbst keine Überweisungen ausstellen.

FHIR-Operation

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

Invocations

URL: [base]/$vermittlungscode_anfordern

Parameters (In)

Name	Cardinality	Type	Binding	Documentation
leistungsmerkmale	1..100	Coding	KBV_VS_116117_TERMINSERVICE_VCA_Specialties (required)	Liste der für die Vermittlung benötigten Leistungsmerkmale
dringlichkeit	0..1	Coding	KBV_VS_116117_TERMINSERVICE_VCA_Urgency (required)	Dringlichkeit einer Überweisung (Muster06): default ist urgent (dringend). Dringlichkeit für PTV11 muss nicht übergeben werden; wenn eine übergeben wird, muss diese urgent (dringend) sein.
ueberweisenderArzt	1..1	canonical(KBV_PR_116117_TERMINSERVICE_VCA_Practitioner)		Arzt, der die Überweisung ausstellt

Return Values (Out)

Name	Cardinality	Type	Documentation
vermittlungscode	1..1	canonical(KBV_PR_116117_TERMINSERVICE_VCA_Identifier_Vermittlungscode)	Neuer Vermittlungscode mit den gewünschten Leistungsmerkmalen und der angegebenen Dringlichkeit.
url	1..1	url	URL, welche auf das Muster06 bzw. auf PTV11 aufgedruckt werden soll

Mit dieser Operation kann 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
`dringlichkeit`	`in`	Für ein PTV11 muss KEINE Dringlichkeit angeben werden; wird diese dennoch übergeben, muss sie den Wert `urgent` (dringend) haben. Andernfalls kommt ein Fehler (OperationOutcome) zurück. Der Standardwert für die Dringlichkeit für Muster 6 ist `urgent` (dringend).
`vermittlungscode`	`out`	Der Vermittlungscode besteht aus 12 zufälligen alphanumerischen Zeichen, die zur besseren Lesbarkeit an der 4. und 8. Stelle mit einem Bindestrich getrennt werden (Bsp.: XN6P-F4HP-Z5KX). Erlaubt sind alle Großbuchstaben (A-Z) und Zahlen (0-9) mit folgenden Ausnahmen: `O 0 I 1 E 3`

Beispiele

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

<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="13" />
        </valueCoding>
    </parameter>
    <parameter>
        <name value="leistungsmerkmale" />
        <valueCoding>
            <system value="https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_BAR2_WBO" />
            <code value="197" />
        </valueCoding>
    </parameter>
    <parameter>
        <name value="dringlichkeit" />
        <valueCoding>
            <system value="http://hl7.org/fhir/request-priority" />
            <code value="urgent" />
        </valueCoding>
    </parameter>
    <parameter>
        <name value="ueberweisenderArzt" />
        <resource>
            <Practitioner>
                <id value="12df27c7-acdc-4467-b393-93416a1cc51x" />
                <meta>
                    <profile value="https://fhir.kbv.de/StructureDefinition/KBV_PR_116117_TERMINSERVICE_VCA_Practitioner|0.1.0" />
                </meta>
                <text>
                    <status value="extensions" />
                    <div xmlns="http://www.w3.org/1999/xhtml">Diese Practitioner-Instanz beschreibt den Arzt 'Hans Topp-Glücklich' mit der LANR '123456789'.</div>
                </text>
                <identifier>
                    <type>
                        <coding>
                            <system value="http://terminology.hl7.org/CodeSystem/v2-0203" />
                            <code value="LANR" />
                            <display value="Lifelong physician number" />
                        </coding>
                    </type>
                    <system value="https://fhir.kbv.de/NamingSystem/KBV_NS_Base_ANR" />
                    <value value="123456789" />
                </identifier>
                <name>
                    <use value="official" />
                    <family value="Topp-Gl&#252;cklich" />
                    <given value="Hans" />
                </name>
            </Practitioner>
        </resource>
    </parameter>
</Parameters>

<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="08" />
        </valueCoding>
    </parameter>
    <parameter>
        <name value="ueberweisenderArzt" />
        <resource>
            <Practitioner>
                <id value="12df27c7-acdc-4467-b393-93416a1cc51x" />
                <meta>
                    <profile value="https://fhir.kbv.de/StructureDefinition/KBV_PR_116117_TERMINSERVICE_VCA_Practitioner|0.1.0" />
                </meta>
                <text>
                    <status value="extensions" />
                    <div xmlns="http://www.w3.org/1999/xhtml">Diese Practitioner-Instanz beschreibt den Arzt 'Hans Topp-Glücklich' mit der LANR '123456789'.</div>
                </text>
                <identifier>
                    <type>
                        <coding>
                            <system value="http://terminology.hl7.org/CodeSystem/v2-0203" />
                            <code value="LANR" />
                            <display value="Lifelong physician number" />
                        </coding>
                    </type>
                    <system value="https://fhir.kbv.de/NamingSystem/KBV_NS_Base_ANR" />
                    <value value="123456789" />
                </identifier>
                <name>
                    <use value="official" />
                    <family value="Topp-Gl&#252;cklich" />
                    <given value="Hans" />
                </name>
            </Practitioner>
        </resource>
    </parameter>
</Parameters>

<Parameters xmlns="http://hl7.org/fhir">
    <parameter>
        <name value="vermittlungscode" />
        <valueIdentifier>
            <system value="https://fhir.kbv.de/NamingSystem/KBV_NS_116117_TERMINSERVICE_Vermittlungscode" />
            <value value="XN6P-F4UF-Z5KX" />
        </valueIdentifier>
    </parameter>
    <parameter>
        <name value="url" />
        <valueUrl value="www.116117.de" />
    </parameter>
</Parameters>