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)

NameCardinalityTypeBindingDocumentation
leistungsmerkmale1..100CodingKBV_VS_116117_TERMINSERVICE_VCA_Specialties (required)

Liste der für die Vermittlung benötigten Leistungsmerkmale

dringlichkeit0..1CodingKBV_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.

ueberweisenderArzt1..1canonical(KBV_PR_116117_TERMINSERVICE_VCA_Practitioner)

Arzt, der die Überweisung ausstellt

patient0..1canonical(KBV_PR_116117_TERMINSERVICE_VCA_Patient)

Patient, der die Überweisung benötigt und die Einwilligung zur Datenweitergabe erteilt hat

Return Values (Out)

NameCardinalityTypeDocumentation
vermittlungscode1..1canonical(KBV_PR_116117_TERMINSERVICE_VCA_Identifier_Vermittlungscode)

Neuer Vermittlungscode mit den gewünschten Leistungsmerkmalen und der angegebenen Dringlichkeit.

url1..1url

URL, welche auf das Muster06 bzw. auf PTV11 aufgedruckt werden soll

Mit dieser Operation kann ein Vermittlungscode angefordert werden.


Anmerkungen

Im Fehlerfall wird ein Profil: 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 Profil: 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 Profil: 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.2.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>
    <parameter>
        <name value="patient" />
        <resource>
            <Patient>
                <id value="12df27c6-acdc-4067-b393-93416a1cc511" />
                <meta>
                    <profile value="https://fhir.kbv.de/StructureDefinition/KBV_PR_116117_TERMINSERVICE_VCA_Patient|0.1.0" />
                </meta>
                <text>
                    <status value="extensions" />
                    <div xmlns="http://www.w3.org/1999/xhtml">Diese Patient-Instanz beschreibt Prof. Maxi Mustermensch</div>
                </text>
                <identifier>
                    <type>
                        <coding>
                            <system value="http://fhir.de/CodeSystem/identifier-type-de-basis" />
                            <version value="1.5.0" />
                            <code value="GKV" />
                            <display value="Gesetzliche Krankenversicherung" />
                        </coding>
                    </type>
                    <system value="http://fhir.de/sid/gkv/kvid-10" />
                    <value value="A123456789" />
                </identifier>
                <name>
                    <use value="official" />
                    <family value="Mustermensch" />
                    <given value="Maxi" />
                    <prefix value="Prof.">
                        <extension url="http://hl7.org/fhir/StructureDefinition/iso21090-EN-qualifier">
                            <valueCode value="AC" />
                        </extension>
                    </prefix>
                </name>
                <telecom>
                    <system value="phone" />
                    <value value="030123456789" />
                </telecom>
                <gender value="other">
                    <extension url="http://fhir.de/StructureDefinition/gender-amtlich-de">
                        <valueCoding>
                            <system value="http://fhir.de/CodeSystem/gender-amtlich-de" />
                            <code value="D" />
                            <display value="divers" />
                        </valueCoding>
                    </extension>
                </gender>
                <birthDate value="2023-11-11" />
                <address>
                    <type value="both" />
                    <line value="Musterstr. 1">
                        <extension url="http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-houseNumber">
                            <valueString value="1" />
                        </extension>
                        <extension url="http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetName">
                            <valueString value="Musterstr." />
                        </extension>
                    </line>
                    <city value="Darmstadt" />
                    <postalCode value="64283" />
                </address>
            </Patient>
        </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.2.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-termine.de" />
    </parameter>
</Parameters>