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 vor allem 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 / medizinische Einrichtung vom 116117 Terminservice abgerufen werden. Bei Bedarf können aber auch einzelne Terminbuchungen abgerufen und so deren aktueller Status überprüft werden.

Beim Abrufen der Terminbuchungen können als Antwort unter Umständen größere Datenmengen zurückgegeben werden. Dies hängt vor allem davon ab, wie aktiv eine Praxis / medizinische Einrichtung den 116117 Terminservice bisher genutzt hat. Hat die Praxis / medizinische Einrichtung in der Vergangenheit viele Terminslots an den 116117 Terminservice gemeldet, ist die Wahrscheinlichkeit entsprechend höher, dass beim Abruf der Terminbuchungen für diese Praxis / medizinische Einrichtung mehr Daten zurückkommen.


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 TVS 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 TVS ist auch die Information enthalten, ob es noch weitere Seiten an Suchergebnissen gibt und wie diese abzurufen sind. Ein TVS muss also prüfen, ob es noch eine nächste Seite gibt. Ist dies der Fall, muss das TVS 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 von Terminbuchungen erfordert einen POST-Request. Es können entweder alle Terminbuchungen aller autorisierten Einrichtungen oder nur bestimmte Terminbuchungen anhand entsprechender Suchparameter im Request Body abgefragt werden (siehe hierzu Abschnitt Request Body).


HTTP Method POST
URL https://terminsynchronisation.eterminservice.kv-safenet.de/tvs​/terminsynchronisation/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.

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. Das bedeutet, dass die Systeme des 116117 Terminservice diese Suchparameter nicht verarbeiten. Es wird in diesem Fall kein Fehler geworfen; die Suche wird ohne die unbekannten Suchparameter durchgeführt.


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, die den Termin anbietet.
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: Terminprofil-ID

Parameter slot.schedule
Beschreibung ID des Terminprofils, auf dem die Terminbuchung basiert. Das Appointment referenziert auf den zugrundeliegenden Terminslot über Appointment.slot. Im Terminslot ist wiederum über Slot.schedule das Terminprofil referenziert.
Kardinalität 0..*
Erlaubte Verknüpfungen1 ODER-Verknüpfung
Erlaubte Präfixe2 -
Suchergebnis Alle Terminbuchungen, die auf einem der angegebenen Terminprofile basieren.
Anmerkung

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

Die ID eines Terminprofils kann über die Interaktion Terminprofile abrufen (Schedule Search) ermittelt 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://terminsynchronisation.eterminservice.kv-safenet.de/tvs​/terminsynchronisation/api/Appointment/_search
Content-Type: application/x-www-form-urlencoded
bsnr=123456789

Weitere Beispiele

Beispiel 1: Suche anhand einer ANR

# Suche alle Terminbuchungen, die von dem Arzt durchgeführt werden, dessen ANRs mit den Ziffern 1234567 beginnen
POST https://terminsynchronisation.eterminservice.kv-safenet.de/tvs​/terminsynchronisation/api/Appointment/_search
Content-Type: application/x-www-form-urlencoded
anr=1234567

Beispiel 2: Suche anhand mehrerer IDs

# Suche alle Terminbuchungen, die eine der folgenden IDs haben: 084c8796-a6e8-402d-9170-67a9d05b79a0, 68698730-6e1c-4a09-83e1-b730dcb7fe81
POST https://terminsynchronisation.eterminservice.kv-safenet.de/tvs​/terminsynchronisation/api/Appointment/_search
Content-Type: application/x-www-form-urlencoded
_id=084c8796-a6e8-402d-9170-67a9d05b79a0,68698730-6e1c-4a09-83e1-b730dcb7fe81

Beispiel 3: Suche anhand einer Terminprofil-ID und eines Zeitpunktes

# Suche alle Terminbuchungen, die auf dem Terminprofil mit der ID 48931c91-8fac-4ed0-a0f5-c3a381a60a31 basieren und zeitlich nach dem 14.01.2024, 10:00 Uhr starten
POST https://terminsynchronisation.eterminservice.kv-safenet.de/tvs​/terminsynchronisation/api/Appointment/_search
Content-Type: application/x-www-form-urlencoded
slot.schedule=48931c91-8fac-4ed0-a0f5-c3a381a60a31&date=gt2024-01-14T10:00:00+02:00

Beispiel 4: Suche anhand eines Zeitraumes und einer BSNR

# Suche alle Terminbuchungen, die im Zeitraum zwischen dem 14.01.2024, 10:00 Uhr und dem 16.01.2024, 12:35 Uhr starten und in der Praxis mit der BSNR 123456789 durchgeführt werden
POST https://terminsynchronisation.eterminservice.kv-safenet.de/tvs​/terminsynchronisation/api/Appointment/_search
Content-Type: application/x-www-form-urlencoded
date=lt2024-01-16T12:35:00+01:00&date=gt2024-01-14T10:00:00+01:00&bsnr=123456789

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 BSNRs.

  • 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" />
                <slot>
                    <reference value="urn:uuid:643dc2af-2ba0-4fdd-bcd5-d0aac69c700f" />
                </slot>
                <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="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: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" />
                <slot>
                    <reference value="urn:uuid:e1e07804-6c64-4de1-80f1-113fc24b6a73" />
                </slot>
                <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="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 eine Practitioner-Instanz.</div>
                </text>
                <practitioner>
                    <reference value="urn:uuid:3f03e5bc-f5ba-4017-971d-fd7de95db07c" />
                </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: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="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="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" />
                <slot>
                    <reference value="urn:uuid:da65f825-7ddc-4503-bebd-7a4c94f4a80c" />
                </slot>
                <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?anr=123456789&amp;date=gt2024-01-14T12:00:00+01:00&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" />
                <slot>
                    <reference value="urn:uuid:66078451-6307-4f1f-82bd-a159a094dc69" />
                </slot>
                <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 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>
</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>