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.
bsnr	1..1	canonical(IdentifierBsnr)		Die BSNR der Einrichtung, die den Vermittlungscode anfordert
ueberweisenderArzt	1..1	canonical(KBV_PR_116117_TERMINSERVICE_VCA_Practitioner)		Arzt, der die Überweisung ausstellt
patient	0..1	canonical(KBV_PR_116117_TERMINSERVICE_VCA_Patient)		Patient, der die Überweisung benötigt und die Einwilligung zur Datenweitergabe erteilt hat

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 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).
`bsnr`	`in`	Details zur BSNR sind im zugehörigen NamingSystem KBV_NS_Base_BSNR beschrieben.
`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

Alle Beispiele für Eingabeparameter (Request Body) und Ausgabeparameter (Response Body) sind hier im vorliegenden Projekt zu finden.

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="bsnr" />
        <valueIdentifier>
            <type>
                <coding>
                    <system value="http://terminology.hl7.org/CodeSystem/v2-0203" />
                    <code value="BSNR" />
                    <display value="Primary physician office number" />
                </coding>
            </type>
            <system value="https://fhir.kbv.de/NamingSystem/KBV_NS_Base_BSNR" />
            <value value="123456789" />
        </valueIdentifier>
    </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|1.0.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|2.0.0" />
                </meta>
                <text>
                    <status value="extensions" />
                    <div xmlns="http://www.w3.org/1999/xhtml">Diese Patient-Instanz beschreibt Gräfin Prof. Maxi von Mustermensch</div>
                </text>
                <identifier>
                    <type>
                        <coding>
                            <system value="http://fhir.de/CodeSystem/identifier-type-de-basis" />
                            <version value="1.4.0" />
                            <code value="GKV" />
                            <display value="Gesetzliche Krankenversicherung" />
                        </coding>
                    </type>
                    <system value="http://fhir.de/sid/gkv/kvid-10" />
                    <value value="A123456789" />
                </identifier>
                <identifier>
                    <type>
                        <coding>
                            <system value="https://fhir.kbv.de/CodeSystem/KBV_CS_Base_identifier_type" />
                            <version value="1.5.0" />
                            <code value="kvk" />
                            <display value="Krankenversichertenkarte" />
                        </coding>
                    </type>
                    <system value="http://fhir.de/sid/gkv/kvk-versichertennummer" />
                    <value value="987654321" />
                </identifier>
                <name>
                    <use value="official" />
                    <family value="Mustermensch">
                        <extension url="http://fhir.de/StructureDefinition/humanname-namenszusatz">
                            <valueString value="Gr&#228;fin" />
                        </extension>
                        <extension url="http://hl7.org/fhir/StructureDefinition/humanname-own-name">
                            <valueString value="Mustermensch" />
                        </extension>
                        <extension url="http://hl7.org/fhir/StructureDefinition/humanname-own-prefix">
                            <valueString value="von" />
                        </extension>
                    </family>
                    <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>
                    <extension url="http://hl7.org/fhir/StructureDefinition/data-absent-reason">
                        <valueCode value="unknown" />
                    </extension>
                </birthDate>
                <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>
                        <extension url="http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-additionalLocator">
                            <valueString value="3. OG Seitenfl&#252;gel" />
                        </extension>
                    </line>
                    <city value="Darmstadt" />
                    <postalCode value="64283" />
                    <country value="D" />
                </address>
                <address>
                    <type value="postal" />
                    <line value="Postfach 112233">
                        <extension url="http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-postBox">
                            <valueString value="112233" />
                        </extension>
                    </line>
                    <city value="Darmstadt" />
                    <postalCode value="64283" />
                    <country value="D" />
                </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="bsnr" />
        <valueIdentifier>
            <type>
                <coding>
                    <system value="http://terminology.hl7.org/CodeSystem/v2-0203" />
                    <code value="BSNR" />
                    <display value="Primary physician office number" />
                </coding>
            </type>
            <system value="https://fhir.kbv.de/NamingSystem/KBV_NS_Base_BSNR" />
            <value value="123456789" />
        </valueIdentifier>
    </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|1.0.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>