Terminbuchungen abrufen (Appointment Search)

Inhalt

  1. Beschreibung und fachlicher Kontext
  2. Request
  3. Response

Beschreibung und fachlicher Kontext

Beim Abrufen von Terminbuchungen handelt es sich um die FHIR-Standardinteraktion search. Diese ermöglicht das Synchronisieren mit dem 116117 Terminservice, um den aktuellen Status einzelner oder mehrerer Terminbuchungen abzurufen.

Der Abruf ist für die initiale Synchronisation der Daten bzw. die Synchronisation nach längerer Zeit (bspw. aufgrund von Betriebsferien) notwendig. In beiden Fällen müssen alle vorhandenen Terminbuchungen für die im Software-System hinterlegte Praxis vom 116117 Terminservice abgerufen werden, da die Terminbuchungen alle abrechnungsrelevanten Informationen enthalten.


Entsprechend dem FHIR-Standard nutzen die Systeme des 116117 Terminservices paging bzw. page count for search results. Das bedeutet Folgendes:

  • Die Suchergebnisse sind in Seiten unterteilt. Ruft ein PVS mehrere Terminbuchungen ab, schicken die Systeme des 116117 Terminservices zunächst die erste Seite der Suchergebnisse zurück, also bspw. die ersten 10 Treffer der Suchergebnisse. In der Antwort (Response) auf die Anfrage des PVS ist auch die Information enthalten, ob es noch weitere Seiten an Suchergebnissen gibt und wie diese abzurufen sind. Ein PVS muss also prüfen, ob es noch eine nächste Seite gibt. Ist dies der Fall, muss das PVS eine weitere Anfrage mit dem entsprechenden Suchparameter an die Systeme des 116117 Terminservices schicken, um auch die nächste Seite der Suchergebnisse zu bekommen.

  • Beim Abruf mehrerer Terminbuchungen wird nur eine bestimmte Anzahl an Suchergebnissen zurückgegeben. Die Anzahl der Suchergebnisse hängt von dem entsprechenden Suchparameter sowie davon ab, wie viele Suchergebnisse die Systeme des 116117 Terminservices insgesamt gefunden haben.


Request

Das Abrufen der Terminbuchungen erfordert einen POST-Request, mit dem entweder alle Terminbuchungen aller autorisierten Einrichtungen oder nur bestimmte Terminbuchungen (bspw. nur für eine bestimmte Einrichtung) anhand entsprechender Suchparameter im Request Body abgefragt werden können (siehe hierzu Abschnitt Request Body).


HTTP Method POST
URL https://abrechnungsinformation.eterminservice.kv-safenet.de/pvs​/abrechnungsinformation/api/Appointment/_search
Request Body [suchparameter]

Bitte beachten: Laut FHIR-Standard wäre auch eine Suche mit Suchparametern innerhalb der URL und/oder mittels GET-Request möglich, was durch die Systeme des 116117 Terminservices jedoch NICHT unterstützt wird. Ein GET-Request auf die oben angegebene URL führt zu einem Fehler. Suchparameter in der URL werden von den Systemen des 116117 Terminservices ignoriert, d.h. weder validiert noch verarbeitet.


Request Header

Folgende Request Header werden von den Systemen des 116117 Terminservices unterstützt und verarbeitet:

Header Verpflichtend? Beschreibung Wert
Authorization ja Im Authentisierungsverfahren erhaltener ACCESS_TOKEN als Bearer Token Bearer ey...
Content-Type ja Gibt den ursprünglichen Medien- bzw. Dateitypen der Ressource an. application/x-www-form-urlencoded
Accept nein Gibt an, welche Inhaltstypen die Systeme des Anfragenden verstehen.
  • Der 116117 Terminservice unterstützt die Werte fhir+xml und xml.
  • Es wird empfohlen, den Wert fhir+xml für diesen Header zu setzen.
 application/fhir+xml

Request Body

Der Request Body muss alle Suchparameter enthalten, nach denen die Suchergebnisse gefiltert werden sollen.

Für die initiale Synchronisation bzw. die Synchronisation nach längerer Zeit wird beim Abruf nur der Suchparameter bsnr benötigt. Die anderen Suchparameter dienen dazu, die Kompatibilität mit der Schnittstelle Terminsynchronisation – TVS zu gewährleisten.

In den folgenden Abschnitten werden die einzelnen Suchparameter im Detail beschrieben. Suchparameter, die hier nicht aufgelistet sind, aber dennoch im Request Body übergeben werden, werden von den Systemen des 116117 Terminservices ignoriert, d.h. weder validiert noch verarbeitet.


Bitte beachten: Die Systeme des 116117 Terminservices prüfen bei Angabe mehrerer Suchparameter nur bedingt auf Plausibilität, was bedeutet, dass nicht zwangsweise eine Fehlermeldung als Response zurückkommt, wenn sich mehrere Suchparameter gegenseitig ausschließen (bspw. UND-Verknüpfung bei mehreren BSNRs oder UND-Verknüpfung einer ANR und einer BSNR, wobei der zur ANR zugehörige Arzt nicht in der Praxis / medizinischen Einrichtung arbeitet, die zur angegebene BSNR gehört). In solch einem Fall kommt stattdessen der HTTP-Statuscode 200 OK mit einem leeren Suchergebnis zurück.


Suchparameter: ID

Parameter _id
Beschreibung ID einer Terminbuchung
Kardinalität 0..*
Erlaubte Verknüpfungen1 ODER-Verknüpfung
Erlaubte Präfixe2 -
Suchergebnis Alle Terminbuchungen, die eine der genannten IDs im Feld Appointment.id hinterlegt haben.
Anmerkung

Mithilfe dieses Suchparameters lässt sich gezielt eine einzeilne Terminbuchung abrufen.

Es müssen alle Zeichen der ID übergeben werden. Eine Suche mit bspw. nur den ersten drei Zeichen einer ID ist nicht zulässig und führt zu einem Fehler.

Suchparameter: Betriebsstättennummer (BSNR)

Parameter bsnr
Beschreibung 9-stellige BSNR der Praxis / medizinischen Einrichtung
Kardinalität 0..*
Erlaubte Verknüpfungen1 ODER-Verknüpfung
Erlaubte Präfixe2 -
Suchergebnis Alle Terminbuchungen, die von den Praxen / medizinischen Einrichtungen angeboten werden, zu denen die angegebenen BSNRs gehören.
Anmerkung

Bei der BSNR handelt es sich um einen custom search parameter, der auf der Seite Suchparameter: BSNR (SearchParameter) näher beschrieben ist.

Wird keine BSNR übergeben, werden alle BSNRs aus dem Access Token als Suchparameter übernommen.

Suchparameter: Start-/Endzeitpunkt des Termins

Parameter date
Beschreibung Startzeitpunkt des Termins
Kardinalität 0..*
Erlaubte Verknüpfungen1 UND-Verknüpfung
ODER-Verknüpfung
Erlaubte Präfixe2 lt (less than / kleiner als)
gt (greater than / größer als)
Suchergebnis Alle Terminbuchungen, deren Startzeitpunkt in dem angegebenen Zeitraum liegt.
Anmerkung

Um nach dem Endzeitpunkt von Terminen zu filtern, kann man die Termindauer zum Startzeitpunkt addieren und date auf diesen errechneten Wert setzen.

Wie nach Zeiträumen gefiltert werden kann, ist in der HL7-FHIR-Dokumentation unter Search – Standard Parameters: date beschrieben.

Suchparameter: Arztnummer (ANR)

Parameter anr
Beschreibung ANR des Arztes, der den Termin durchführt.
Kardinalität 0..*
Erlaubte Verknüpfungen1 ODER-Verknüpfung
Erlaubte Präfixe2 -
Suchergebnis Alle Terminbuchungen, die von den Ärzten durchgeführt werden, zu denen die angegebenen ANRs gehören.
Anmerkung

Bei der ANR handelt es sich um einen custom search parameter, der auf der Seite Suchparameter: ANR (SearchParameter) näher beschrieben ist.

Es können entweder nur die ersten 7 Stellen oder alle 9 Stellen der ANR übergeben werden.

Suchparameter: Vermittlungscode

Parameter based-on:identifier
Beschreibung Vermittlungscode, der bei der Terminbuchung verwendet wurde.
Kardinalität 0..*
Erlaubte Verknüpfungen1 ODER-Verknüpfung
Erlaubte Präfixe2 -
Suchergebnis Alle Terminbuchungen, die mit den angegebenen Vermittlungscodes gebucht wurden.
Anmerkung

Der Vermittlungscode darf mit oder ohne Bindestrich übergeben werden. D.h., entweder werden die 12 alphanumerischen Zeichen an der 4. und 8. Stelle jeweils mit einem Bindestrich getrennt (Bsp.: XN6P-F4HP-Z5KX) oder die 12 Zeichen werden ohne zusätzliches Trennzeichen übergeben (Bsp.: XN6PF4HPZ5KX).

Es müssen alle Zeichen eines Vermittlungscodes übergeben werden. Eine Suche mit bspw. nur den ersten vier Zeichen eines Vermittlungscodes ist nicht zulässig und führt zu einem Fehler.

Bei den Buchstaben eines Vermittlungscodes muss NICHT auf Groß- bzw. Kleinschreibung geachtet werden. Das bedeutet, die Buchstaben in einem Vermittlungscode dürfen sowohl groß- als auch kleingeschrieben sein (Bsp.: XN6PF4HPZ5KX, xn6pf4hpz5kx, xN6pf4HPZ5kX).

Das NamingSystem für Vermittlungscodes sollte bei allen Vermittlungscodes angegeben werden, auch wenn laut FHIR-Standard die Nennung des NamingSystems nicht zwangsweise notwendig ist. Das bedeutet, dass wenn bspw. drei verschiedene Vermittlungscodes als Suchparameter übergeben werden, auch bei all diesen drei Suchparametern das NamingSystem angegeben werden muss.

Suchparameter: Anzahl der Suchergebnisse

Parameter _count
Beschreibung Anzahl der Suchergebnisse pro Seite
Kardinalität 0..1
Erlaubte Verknüpfungen1 -
Erlaubte Präfixe2 -
Suchergebnis Es werden maximal so viele Terminbuchungen im Response Body zurückgegeben, wie in _count angegeben wurde.
Anmerkung

Wird keine Anzahl angegeben, so wird der Standardwert von 10 als Suchparameter übernommen.

Erlaubte Werte sind alle natürlichen Zahlen zwischen 1 und 10, wobei 1 und 10 ebenfalls erlaubt sind.
Bitte beachten: Laut FHIR-Standard wäre auch ein Wert von 0 zulässig, um nur die Anzahl aller Suchergebnisse als Antwort zu bekommen. Dies wird von den Systeme des 116117 Terminservices jedoch NICHT unterstützt. Das bedeutet, der Parameter _count=0 führt zu einem Fehler aufgrund eines unzulässigen Wertes für diesen Parameter.

Es kann sein, dass insgesamt mehr Suchergebnisse gefunden werden, als hier angegeben wurden. In diesem Fall ist ein weiterer Request mit dem entsprechenden Wert für den Suchparameter page notwendig, um auch die anderen Suchergebnisse abzurufen.

Suchparameter: Seite der Suchergebnisse

Parameter page
Beschreibung Seite der Suchergebnisse, die zurückgegeben werden soll.
Kardinalität 0..1
Erlaubte Verknüpfungen1 -
Erlaubte Präfixe2 -
Suchergebnis Es wird die angegebene Seite der Suchergebnisse zurückgegeben.
Anmerkung

Wird keine Anzahl angegeben, so wird der Standardwert von 1 als Suchparameter übernommen. Es wird dann also immer die erste Seite zurückgegeben.

Welche Suchergebnisse zurückgegeben werden, hängt auch vom Wert des Suchparameters _count ab. Wird bspw. mit _count=5 und page=2 gesucht, werden die Suchergebnisse 6 bis 10 zurückgegeben.

1 Wie Parameter mit UND bzw. ODER verknüpft werden können, ist in der HL7-FHIR-Dokumentation unter Search – Standard Parameters: Composite Search Parameters beschrieben.

2 Die möglichen Präfixe sind in der HL7-FHIR-Dokumentation unter Search – Standard Parameters: Prefixes beschrieben.


Beispiele

Initiale Synchronisation

Beispiel: Suche anhand einer BSNR

# Suche alle Terminbuchungen, die von der Praxis mit der BSNR 123456789 angeboten werden
POST https://abrechnungsinformation.eterminservice.kv-safenet.de/pvs​/abrechnungsinformation/api/Appointment/_search
Content-Type: application/x-www-form-urlencoded
bsnr=123456789

Weitere Beispiele

Beispiel 1: Suche anhand von Vermittlungscodes

# Suche alle Terminbuchungen, die mit einem der folgenden Vermittlungscodes gebucht wurden: XN6PF4HPZ5KX oder XN6PF4HPZ5KZ
POST https://abrechnungsinformation.eterminservice.kv-safenet.de/pvs​/abrechnungsinformation/api/Appointment/_search
Content-Type: application/x-www-form-urlencoded
based-on:identifier=https://fhir.kbv.de/NamingSystem/KBV_NS_116117_TERMINSERVICE_Vermittlungscode|XN6PF4HPZ5KX,https://fhir.kbv.de/NamingSystem/KBV_NS_116117_TERMINSERVICE_Vermittlungscode|XN6PF4HPZ5KZ

Beispiel 2: Suche anhand von ANRs

# Suche alle Terminbuchungen, die von dem Arzt mit der ANR 123456789 oder 111222333 durchgeführt wurden
POST https://abrechnungsinformation.eterminservice.kv-safenet.de/pvs​/abrechnungsinformation/api/Appointment/_search
Content-Type: application/x-www-form-urlencoded
anr=123456789,111222333

Beispiel 3: Suche anhand eines Vermittlungscodes und einer ANR

# Suche alle Terminbuchungen, die von dem Arzt mit der ANR 123456789 durchgeführt wurden und mit dem Vermittlungscode XN6PF4HPZ5KX gebucht wurden
POST https://abrechnungsinformation.eterminservice.kv-safenet.de/pvs​/abrechnungsinformation/api/Appointment/_search
Content-Type: application/x-www-form-urlencoded
anr=123456789&based-on:identifier=https://fhir.kbv.de/NamingSystem/KBV_NS_116117_TERMINSERVICE_Vermittlungscode|XN6PF4HPZ5KX

Response

Für die Suche von Terminbuchungen wird im Erfolgsfall der HTTP-Statuscode 200 OK sowie ein Searchset Bundle im Response Body zurückgegeben.

  • Wurden bei der Suche keine Suchparameter übergeben, enthält das zurückgegebene Searchset alle nicht anonymisierten Terminbuchungen der Haupt- und Nebenbetriebsstätten der in der Autorisierung übergebenen BSNR.

  • Wurde bei der Suche min. ein Suchparameter übergeben, enthält dieses Searchset alle Terminbuchungen, die anhand der Suchparameter in Verbindung mit den autorisierten BSNRs ermittelt werden konnten.


Im Fehlerfall wird ein dem Fehler entsprechender HTTP-Statuscode (bspw. 400 Bad Request oder 500 Internal Server Error) sowie ein OperationOutcome im Response Body zurückgegeben. Dieses OperationOutcome enthält Details zum aufgetretenen Fehler.


Response Header

Folgende Response Header werden von den Systemen des 116117 Terminservices gesetzt und an den Anfragenden zurückgesendet:

Header Beschreibung Wert
Content-Type Gibt den ursprünglichen Medien- bzw. Dateitypen der Ressource an. application/fhir+xml

Response Body

Im Erfolgsfall ist im Response Body ein Searchset Bundle enthalten, welches folgende Ressourcen und Informationen enthält:

  • Suchergebnisse als Set: Dieses Set kann auch leer sein, wenn anhand der gesetzten Suchparameter keine passenden Terminbuchungen gefunden werden konnten.

  • Alle Suchparameter, die durch die Systeme des 116117 Terminservices verarbeitet und für die Suche genutzt wurden (im Element Bundle.link).

  • Verweis auf die vorherige und/oder nächste Seite der Suchergebnisse, wenn vorhanden (im Element Bundle.link).

  • Im Appointment referenzierte Ressourcen:

Details zum Searchset Bundle sind unter Profil: Suchergebnisse (Bundle) zu finden.


Im Fehlerfall ist im Response Body ein OperationOutcome enthalten. Details hierzu sind unter Profil: Fehler (OperationOutcome) zu finden.


Beispiele

Alle Beispiele für den Erfolgsfall sind hier im vorliegenden Projekt zu finden.

Alle Beispiele für den Fehlerfall sind hier im vorliegenden Projekt zu finden.


<Bundle xmlns="http://hl7.org/fhir">
    <meta>
        <profile value="https://fhir.kbv.de/StructureDefinition/KBV_PR_116117_TERMINSERVICE_TVS_TERMINSYNCHRONISATION_Bundle_Searchset|1.0.0" />
    </meta>
    <type value="searchset" />
    <timestamp value="2024-09-01T05:51:32+02:00" />
    <total value="102" />
    <link>
        <relation value="self" />
        <url value="https://fhir.kbv.de/Appointment?bsnr=123456789&amp;_count=10" />
    </link>
    <link>
        <relation value="next" />
        <url value="https://fhir.kbv.de/Appointment?bsnr=123456789&amp;_count=10&amp;page=2" />
    </link>
    <entry>
        <fullUrl value="urn:uuid:eac5e3b4-9d20-4fa1-a900-cb27f4ea8fb6" />
        <resource>
            <Appointment>
                <id value="eac5e3b4-9d20-4fa1-a900-cb27f4ea8fb6" />
                <meta>
                    <versionId value="2" />
                    <profile value="https://fhir.kbv.de/StructureDefinition/KBV_PR_116117_TERMINSERVICE_TVS_TERMINSYNCHRONISATION_Appointment|1.0.0" />
                </meta>
                <text>
                    <status value="extensions" />
                    <div xmlns="http://www.w3.org/1999/xhtml">Diese Appointment-Instanz enthält einen Termin am 2024-01-27 von 10:15 bis 10:30 Uhr für die Leistungsmerkmale 09 (Arztgruppe) und 341 (WBO)</div>
                </text>
                <extension url="https://fhir.kbv.de/StructureDefinition/KBV_EX_116117_TERMINSERVICE_TVS_TERMINSYNCHRONISATION_Appointment_Booked_By">
                    <valueCodeableConcept>
                        <coding>
                            <system value="https://fhir.kbv.de/CodeSystem/KBV_CS_Base_Role_Care_Team" />
                            <version value="1.7.0" />
                            <code value="HA" />
                            <display value="Hausarzt/-&#228;rztin" />
                        </coding>
                    </valueCodeableConcept>
                </extension>
                <status value="cancelled" />
                <cancelationReason>
                    <coding>
                        <system value="http://terminology.hl7.org/CodeSystem/appointment-cancellation-reason" />
                        <code value="prov" />
                        <display value="Provider" />
                    </coding>
                </cancelationReason>
                <serviceType>
                    <coding>
                        <system value="https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_BAS_FACHGEBIET_GROB" />
                        <code value="09" />
                        <display value="Kinderarzt / Kinder&#228;rztin" />
                    </coding>
                </serviceType>
                <serviceType>
                    <coding>
                        <system value="https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_BAR2_WBO" />
                        <code value="341" />
                        <display value="F&#196;/FA Kinder- und Jugendmedizin" />
                    </coding>
                </serviceType>
                <priority>
                    <extension url="https://fhir.kbv.de/StructureDefinition/KBV_EX_116117_TERMINSERVICE_TVS_TERMINSYNCHRONISATION_Urgency">
                        <valueCoding>
                            <system value="http://snomed.info/sct" />
                            <code value="103391001" />
                            <display value="Urgent" />
                        </valueCoding>
                    </extension>
                </priority>
                <start value="2024-01-27T10:15:00+01:00" />
                <end value="2024-01-27T10:30:00+01:00" />
                <created value="2024-01-05T11:34:15+02:00" />
                <comment value="Patient allergisch gegen Latex" />
                <basedOn>
                    <identifier>
                        <system value="https://fhir.kbv.de/NamingSystem/KBV_NS_116117_TERMINSERVICE_Vermittlungscode" />
                        <value value="XN6P-F4HP-Z5KX" />
                    </identifier>
                </basedOn>
                <participant>
                    <actor>
                        <reference value="https://fhir.kbv.de/PractitionerRole/123456789" />
                        <type value="PractitionerRole" />
                    </actor>
                    <status value="accepted" />
                </participant>
                <participant>
                    <actor>
                        <reference value="urn:uuid:f28714b1-627d-426e-88ae-e348076d9738" />
                        <type value="Patient" />
                    </actor>
                    <status value="accepted" />
                </participant>
            </Appointment>
        </resource>
        <search>
            <mode value="match" />
        </search>
    </entry>
    <entry>
        <fullUrl value="https://fhir.kbv.de/PractitionerRole/123456789-1122334" />
        <resource>
            <PractitionerRole>
                <id value="123456789-1122334" />
                <meta>
                    <profile value="https://fhir.kbv.de/StructureDefinition/KBV_PR_116117_TERMINSERVICE_TVS_TERMINSYNCHRONISATION_PractitionerRole|1.0.0" />
                </meta>
                <text>
                    <status value="extensions" />
                    <div xmlns="http://www.w3.org/1999/xhtml">Diese PractitionerRole-Instanz enthält die BSNR einer Praxis und die Referenz auf einen Arzt.</div>
                </text>
                <practitioner>
                    <reference value="urn:uuid:55ddacce-3257-44d4-a9dd-a04fb7247723" />
                </practitioner>
                <organization>
                    <identifier>
                        <system value="https://fhir.kbv.de/NamingSystem/KBV_NS_Base_BSNR" />
                        <value value="123456789" />
                    </identifier>
                </organization>
            </PractitionerRole>
        </resource>
        <search>
            <mode value="include" />
        </search>
    </entry>
    <entry>
        <fullUrl value="urn:uuid:25f88e86-b526-490a-8a49-2a7af7ce743c" />
        <resource>
            <Patient>
                <id value="25f88e86-b526-490a-8a49-2a7af7ce743c" />
                <meta>
                    <profile value="https://fhir.kbv.de/StructureDefinition/KBV_PR_116117_TERMINSERVICE_TVS_TERMINSYNCHRONISATION_Patient|1.0.0" />
                </meta>
                <text>
                    <status value="extensions" />
                    <div xmlns="http://www.w3.org/1999/xhtml">Diese Patient-Instanz beschreibt Mini Mustermensch</div>
                </text>
                <identifier>
                    <type>
                        <coding>
                            <system value="http://fhir.de/CodeSystem/identifier-type-de-basis" />
                            <code value="GKV" />
                            <display value="Gesetzliche Krankenversicherung" />
                        </coding>
                    </type>
                    <system value="http://fhir.de/sid/gkv/kvid-10" />
                    <value value="A111222333" />
                </identifier>
                <name>
                    <use value="official" />
                    <family value="Mustermensch" />
                    <given value="Mini" />
                </name>
                <telecom>
                    <system value="phone" />
                    <value value="030123456789" />
                </telecom>
                <gender value="female" />
                <birthDate value="2002" />
            </Patient>
        </resource>
        <search>
            <mode value="include" />
        </search>
    </entry>
    <entry>
        <fullUrl value="urn:uuid:467eddcd-68fd-4f20-9de9-b8fcc6510ed2" />
        <resource>
            <Appointment>
                <id value="467eddcd-68fd-4f20-9de9-b8fcc6510ed2" />
                <meta>
                    <versionId value="1" />
                    <profile value="https://fhir.kbv.de/StructureDefinition/KBV_PR_116117_TERMINSERVICE_TVS_TERMINSYNCHRONISATION_Appointment|1.0.0" />
                </meta>
                <text>
                    <status value="extensions" />
                    <div xmlns="http://www.w3.org/1999/xhtml">Diese Appointment-Instanz enthält einen Termin am 2024-01-27 von 10:15 bis 10:30 Uhr für die Leistungsmerkmale 09 (Arztgruppe) und 341 (WBO)</div>
                </text>
                <extension url="https://fhir.kbv.de/StructureDefinition/KBV_EX_116117_TERMINSERVICE_TVS_TERMINSYNCHRONISATION_Appointment_Booked_By">
                    <valueCodeableConcept>
                        <coding>
                            <system value="https://fhir.kbv.de/CodeSystem/KBV_CS_Base_Role_Care_Team" />
                            <version value="1.7.0" />
                            <code value="FA" />
                            <display value="Facharzt/-&#228;rztin" />
                        </coding>
                    </valueCodeableConcept>
                </extension>
                <status value="booked" />
                <serviceType>
                    <coding>
                        <system value="https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_BAS_FACHGEBIET_GROB" />
                        <code value="06" />
                        <display value="Hals-Nasen-Ohrenheilkunde" />
                    </coding>
                </serviceType>
                <priority>
                    <extension url="https://fhir.kbv.de/StructureDefinition/KBV_EX_116117_TERMINSERVICE_TVS_TERMINSYNCHRONISATION_Urgency">
                        <valueCoding>
                            <system value="http://snomed.info/sct" />
                            <code value="50811001" />
                            <display value="Routine" />
                        </valueCoding>
                    </extension>
                </priority>
                <start value="2024-02-27T09:00:00+01:00" />
                <end value="2024-02-27T10:00:00+01:00" />
                <created value="2024-01-05T11:34:15+02:00" />
                <comment value="Patient allergisch gegen Latex" />
                <basedOn>
                    <identifier>
                        <system value="https://fhir.kbv.de/NamingSystem/KBV_NS_116117_TERMINSERVICE_Vermittlungscode" />
                        <value value="XN6P-F4HP-Z5KX" />
                    </identifier>
                </basedOn>
                <participant>
                    <actor>
                        <reference value="https://fhir.kbv.de/PractitionerRole/123456789" />
                        <type value="PractitionerRole" />
                    </actor>
                    <status value="accepted" />
                </participant>
                <participant>
                    <actor>
                        <reference value="urn:uuid:f28714b1-627d-426e-88ae-e348076d9738" />
                        <type value="Patient" />
                    </actor>
                    <status value="accepted" />
                </participant>
            </Appointment>
        </resource>
        <search>
            <mode value="match" />
        </search>
    </entry>
    <entry>
        <fullUrl value="https://fhir.kbv.de/PractitionerRole/123456789" />
        <resource>
            <PractitionerRole>
                <id value="123456789" />
                <meta>
                    <profile value="https://fhir.kbv.de/StructureDefinition/KBV_PR_116117_TERMINSERVICE_TVS_TERMINSYNCHRONISATION_PractitionerRole|1.0.0" />
                </meta>
                <text>
                    <status value="extensions" />
                    <div xmlns="http://www.w3.org/1999/xhtml">Diese PractitionerRole-Instanz enthält nur die BSNR einer Praxis.</div>
                </text>
                <organization>
                    <identifier>
                        <system value="https://fhir.kbv.de/NamingSystem/KBV_NS_Base_BSNR" />
                        <value value="123456789" />
                    </identifier>
                </organization>
            </PractitionerRole>
        </resource>
        <search>
            <mode value="include" />
        </search>
    </entry>
    <entry>
        <fullUrl value="urn:uuid:f28714b1-627d-426e-88ae-e348076d9738" />
        <resource>
            <Patient>
                <id value="f28714b1-627d-426e-88ae-e348076d9738" />
                <meta>
                    <profile value="https://fhir.kbv.de/StructureDefinition/KBV_PR_116117_TERMINSERVICE_TVS_TERMINSYNCHRONISATION_Patient|1.0.0" />
                </meta>
                <text>
                    <status value="extensions" />
                    <div xmlns="http://www.w3.org/1999/xhtml">Diese Patient-Instanz beschreibt Prinzessin Melanie Mustermensch</div>
                </text>
                <identifier>
                    <type>
                        <coding>
                            <system value="https://fhir.kbv.de/CodeSystem/KBV_CS_Base_identifier_type" />
                            <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="Prinzessin" />
                        </extension>
                        <extension url="http://hl7.org/fhir/StructureDefinition/humanname-own-name">
                            <valueString value="Mustermensch" />
                        </extension>
                    </family>
                    <given value="Melanie" />
                </name>
                <telecom>
                    <system value="phone" />
                    <value value="030123456789" />
                </telecom>
                <telecom>
                    <system value="email" />
                    <value value="m.mustermensch@gmail.com" />
                </telecom>
                <gender value="female" />
                <birthDate value="2002-02" />
                <address>
                    <type value="postal" />
                    <line value="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>
        <search>
            <mode value="include" />
        </search>
    </entry>
    <entry>
        <fullUrl value="urn:uuid:e49ff6e9-d577-4a1f-94df-31148bbfa3d8" />
        <resource>
            <Appointment>
                <id value="e49ff6e9-d577-4a1f-94df-31148bbfa3d8" />
                <meta>
                    <versionId value="3" />
                    <profile value="https://fhir.kbv.de/StructureDefinition/KBV_PR_116117_TERMINSERVICE_TVS_TERMINSYNCHRONISATION_Appointment|1.0.0" />
                </meta>
                <text>
                    <status value="extensions" />
                    <div xmlns="http://www.w3.org/1999/xhtml">Diese Appointment-Instanz enthält einen Termin am 2024-01-27 von 10:15 bis 10:30 Uhr für die Leistungsmerkmale 09 (Arztgruppe) und 341 (WBO)</div>
                </text>
                <extension url="https://fhir.kbv.de/StructureDefinition/KBV_EX_116117_TERMINSERVICE_TVS_TERMINSYNCHRONISATION_Appointment_Booked_By">
                    <valueCodeableConcept>
                        <coding>
                            <system value="https://fhir.kbv.de/CodeSystem/KBV_CS_Base_Role_Care_Team" />
                            <version value="1.7.0" />
                            <code value="HA" />
                            <display value="Hausarzt/-&#228;rztin" />
                        </coding>
                    </valueCodeableConcept>
                </extension>
                <status value="pending" />
                <serviceType>
                    <coding>
                        <system value="https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_BAS_FACHGEBIET_GROB" />
                        <code value="09" />
                        <display value="Kinderarzt / Kinder&#228;rztin" />
                    </coding>
                </serviceType>
                <priority>
                    <extension url="https://fhir.kbv.de/StructureDefinition/KBV_EX_116117_TERMINSERVICE_TVS_TERMINSYNCHRONISATION_Urgency">
                        <valueCoding>
                            <system value="http://snomed.info/sct" />
                            <code value="103391001" />
                            <display value="Urgent" />
                        </valueCoding>
                    </extension>
                </priority>
                <start value="2024-01-15T15:45:00+01:00" />
                <end value="2024-01-15T16:00:00+01:00" />
                <created value="2024-01-05T11:34:15+02:00" />
                <comment value="Patient allergisch gegen Latex" />
                <basedOn>
                    <identifier>
                        <system value="https://fhir.kbv.de/NamingSystem/KBV_NS_116117_TERMINSERVICE_Vermittlungscode" />
                        <value value="XN6P-F4HP-Z5KX" />
                    </identifier>
                </basedOn>
                <participant>
                    <actor>
                        <reference value="https://fhir.kbv.de/PractitionerRole/123456789-1122334" />
                        <type value="PractitionerRole" />
                    </actor>
                    <status value="accepted" />
                </participant>
                <participant>
                    <actor>
                        <reference value="urn:uuid:f28714b1-627d-426e-88ae-e348076d9738" />
                        <type value="Patient" />
                    </actor>
                    <status value="accepted" />
                </participant>
            </Appointment>
        </resource>
        <search>
            <mode value="match" />
        </search>
    </entry>
    <entry>
        <fullUrl value="urn:uuid:61cb8d62-9038-49f7-a357-b2bc924b0cca" />
        <resource>
            <Patient>
                <id value="61cb8d62-9038-49f7-a357-b2bc924b0cca" />
                <meta>
                    <profile value="https://fhir.kbv.de/StructureDefinition/KBV_PR_116117_TERMINSERVICE_TVS_TERMINSYNCHRONISATION_Patient|1.0.0" />
                </meta>
                <text>
                    <status value="extensions" />
                    <div xmlns="http://www.w3.org/1999/xhtml">Diese Patient-Instanz beschreibt Minerva 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" />
                            <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://hl7.org/fhir/StructureDefinition/humanname-own-name">
                            <valueString value="Mustermensch" />
                        </extension>
                        <extension url="http://hl7.org/fhir/StructureDefinition/humanname-own-prefix">
                            <valueString value="zu" />
                        </extension>
                    </family>
                    <given value="Minerva" />
                </name>
                <telecom>
                    <system value="phone" />
                    <value value="030123456789" />
                </telecom>
                <telecom>
                    <system value="email" />
                    <value value="m.mustermensch@gmail.com" />
                </telecom>
                <gender value="female" />
                <birthDate value="2006-06" />
            </Patient>
        </resource>
        <search>
            <mode value="include" />
        </search>
    </entry>
</Bundle>

<Bundle xmlns="http://hl7.org/fhir">
    <meta>
        <profile value="https://fhir.kbv.de/StructureDefinition/KBV_PR_116117_TERMINSERVICE_TVS_TERMINSYNCHRONISATION_Bundle_Searchset|1.0.0" />
    </meta>
    <type value="searchset" />
    <timestamp value="2024-09-01T05:51:32+02:00" />
    <total value="1" />
    <link>
        <relation value="self" />
        <url value="https://fhir.kbv.de/Appointment?based-on:identifier=https://fhir.kbv.de/NamingSystem/KBV_NS_116117_TERMINSERVICE_Vermittlungscode|XN6PF4HPZ5KX&amp;_count=10" />
    </link>
    <entry>
        <fullUrl value="urn:uuid:0286855c-b49c-48b4-9775-58b6cb031aed" />
        <resource>
            <Appointment>
                <id value="0286855c-b49c-48b4-9775-58b6cb031aed" />
                <meta>
                    <versionId value="1" />
                    <profile value="https://fhir.kbv.de/StructureDefinition/KBV_PR_116117_TERMINSERVICE_TVS_TERMINSYNCHRONISATION_Appointment|1.0.0" />
                </meta>
                <text>
                    <status value="extensions" />
                    <div xmlns="http://www.w3.org/1999/xhtml">Diese Appointment-Instanz enthält einen Termin am 2024-01-14 von 12:15 bis 12:45 Uhr für das Leistungsmerkmal 20 (Arztgruppe)</div>
                </text>
                <extension url="https://fhir.kbv.de/StructureDefinition/KBV_EX_116117_TERMINSERVICE_TVS_TERMINSYNCHRONISATION_Appointment_Booked_By">
                    <valueCodeableConcept>
                        <coding>
                            <system value="https://fhir.kbv.de/CodeSystem/KBV_CS_116117_TERMINSERVICE_TVS_TERMINSYNCHRONISATION_Roles" />
                            <version value="1.0.0" />
                            <code value="​Patient" />
                            <display value="Patient" />
                        </coding>
                    </valueCodeableConcept>
                </extension>
                <status value="booked" />
                <serviceType>
                    <coding>
                        <system value="https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_BAS_FACHGEBIET_GROB" />
                        <code value="20" />
                        <display value="Humangenetik" />
                    </coding>
                </serviceType>
                <priority>
                    <extension url="https://fhir.kbv.de/StructureDefinition/KBV_EX_116117_TERMINSERVICE_TVS_TERMINSYNCHRONISATION_Urgency">
                        <valueCoding>
                            <system value="http://snomed.info/sct" />
                            <code value="709122007" />
                            <display value="As soon as possible" />
                        </valueCoding>
                    </extension>
                </priority>
                <start value="2024-01-14T12:15:00+01:00" />
                <end value="2024-01-14T12:45:00+01:00" />
                <created value="2024-01-29T09:23:05+02:00" />
                <basedOn>
                    <identifier>
                        <system value="https://fhir.kbv.de/NamingSystem/KBV_NS_116117_TERMINSERVICE_Vermittlungscode" />
                        <value value="XN6PF4HPZ5KX" />
                    </identifier>
                </basedOn>
                <participant>
                    <actor>
                        <reference value="https://fhir.kbv.de/PractitionerRole/123456789" />
                        <type value="PractitionerRole" />
                    </actor>
                    <status value="accepted" />
                </participant>
                <participant>
                    <actor>
                        <reference value="urn:uuid:529c2a3a-7f3c-4d17-9f15-595b29b4cf9c" />
                        <type value="Patient" />
                    </actor>
                    <status value="accepted" />
                </participant>
            </Appointment>
        </resource>
        <search>
            <mode value="match" />
        </search>
    </entry>
    <entry>
        <fullUrl value="https://fhir.kbv.de/PractitionerRole/123456789" />
        <resource>
            <PractitionerRole>
                <id value="123456789" />
                <meta>
                    <profile value="https://fhir.kbv.de/StructureDefinition/KBV_PR_116117_TERMINSERVICE_TVS_TERMINSYNCHRONISATION_PractitionerRole|1.0.0" />
                </meta>
                <text>
                    <status value="extensions" />
                    <div xmlns="http://www.w3.org/1999/xhtml">Diese PractitionerRole-Instanz enthält nur die BSNR einer Praxis.</div>
                </text>
                <organization>
                    <identifier>
                        <system value="https://fhir.kbv.de/NamingSystem/KBV_NS_Base_BSNR" />
                        <value value="123456789" />
                    </identifier>
                </organization>
            </PractitionerRole>
        </resource>
        <search>
            <mode value="include" />
        </search>
    </entry>
    <entry>
        <fullUrl value="urn:uuid:529c2a3a-7f3c-4d17-9f15-595b29b4cf9c" />
        <resource>
            <Patient>
                <id value="529c2a3a-7f3c-4d17-9f15-595b29b4cf9c" />
                <meta>
                    <profile value="https://fhir.kbv.de/StructureDefinition/KBV_PR_116117_TERMINSERVICE_TVS_TERMINSYNCHRONISATION_Patient|1.0.0" />
                </meta>
                <text>
                    <status value="extensions" />
                    <div xmlns="http://www.w3.org/1999/xhtml">Diese Patient-Instanz beschreibt Dipl.-Ing. Mike van Mustermensch</div>
                </text>
                <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://hl7.org/fhir/StructureDefinition/humanname-own-prefix">
                            <valueString value="van" />
                        </extension>
                    </family>
                    <given value="Mike" />
                    <prefix value="Dipl.-Ing.">
                        <extension url="http://hl7.org/fhir/StructureDefinition/iso21090-EN-qualifier">
                            <valueCode value="AC" />
                        </extension>
                    </prefix>
                </name>
                <telecom>
                    <system value="phone" />
                    <value value="030123456789" />
                </telecom>
                <telecom>
                    <system value="email" />
                    <value value="m.mustermensch@gmail.com" />
                </telecom>
                <gender value="male" />
                <birthDate>
                    <extension url="http://hl7.org/fhir/StructureDefinition/data-absent-reason">
                        <valueCode value="unknown" />
                    </extension>
                </birthDate>
                <address>
                    <type value="both" />
                    <line value="Musterstr.">
                        <extension url="http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-houseNumber">
                            <valueString value="1" />
                        </extension>
                    </line>
                    <city value="Darmstadt" />
                    <country value="D" />
                </address>
                <address>
                    <type value="postal" />
                    <line value="112233">
                        <extension url="http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-postBox">
                            <valueString value="112233" />
                        </extension>
                    </line>
                    <city value="Darmstadt" />
                    <country value="D" />
                </address>
            </Patient>
        </resource>
        <search>
            <mode value="include" />
        </search>
    </entry>
</Bundle>

<OperationOutcome xmlns="http://hl7.org/fhir">
    <id value="cc8e9f90-31ad-4021-9639-e5b940a88a94" />
    <meta>
        <profile value="https://fhir.kbv.de/StructureDefinition/KBV_PR_116117_TERMINSERVICE_TVS_TERMINSYNCHRONISATION_OperationOutcome_Error|1.0.0" />
    </meta>
    <text>
        <status value="extensions" />
        --- We have skipped the narrative for better readability of the resource ---
    </text>
    <issue>
        <severity value="fatal" />
        <code value="value" />
        <details>
            <coding>
                <system value="https://fhir.kbv.de/CodeSystem/KBV_CS_116117_TERMINSERVICE_TVS_TERMINSYNCHRONISATION_Errors" />
                <code value="TVSTS0000" />
                <display value="Sonstiger Fehler. Unter diagnostics finden Sie n&#228;here Informationen zum Fehler." />
            </coding>
        </details>
        <diagnostics value="Ung&#252;ltiger Input-Parameter" />
    </issue>
</OperationOutcome>

<OperationOutcome xmlns="http://hl7.org/fhir">
    <id value="81758936-362c-411f-9d95-7fac5b19deb6" />
    <meta>
        <profile value="https://fhir.kbv.de/StructureDefinition/KBV_PR_116117_TERMINSERVICE_TVS_TERMINSYNCHRONISATION_OperationOutcome_Error|1.0.0" />
    </meta>
    <text>
        <status value="extensions" />
        --- We have skipped the narrative for better readability of the resource ---
    </text>
    <issue>
        <severity value="fatal" />
        <code value="value" />
        <details>
            <coding>
                <system value="https://fhir.kbv.de/CodeSystem/KBV_CS_116117_TERMINSERVICE_TVS_TERMINSYNCHRONISATION_Errors" />
                <code value="TVSTS0018" />
                <display value="Die Dringlichkeit ist ung&#252;ltig." />
            </coding>
        </details>
    </issue>
</OperationOutcome>