Terminbuchungen abrufen (Appointment Search)
Inhalt
- Beschreibung und fachlicher Kontext
- Request
- 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.
Generelle Hinweise, die für alle search interactions gelten, sind auf der Seite Operationen und Interaktionen gelistet. Dort sind auch detaillierte Informationen zum Thema Paging
zu finden. Beim Paging ist zu beachten, dass sich die Gesamtzahl der Seiten zwischen dem Abruf von bspw. Seite 1 und Seite 2 ändern kann. Voraussetzung hierfür ist, dass zwischen den beiden Abrufen neue Terminbuchungen vorgenommen oder bestehende Terminbuchungen aus dem 116117 Terminservice gelöscht wurden.
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/pvs/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. Dies wird durch die Systeme des 116117 Terminservices aktuell jedoch NICHT unterstützt. 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, also weder validiert noch verarbeitet.
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. Das bedeutet, dass nicht zwangsweise ein Fehler als Response zurückkommt, wenn sich mehrere Suchparameter gegenseitig ausschließen. Beispiele hierfür sind UND-Verknüpfungen bei mehreren BSNRs oder eine 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 solchen Fällen kommt der HTTP-Statuscode 200 OK mit einem Searchset Bundle (im Response Body) zurück, welches KEINE Suchergebnisse enthält.
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 angegebenen IDs im Feld Appointment.id hinterlegt haben. |
| Anmerkung |
Mithilfe dieses Suchparameters lässt sich gezielt eine einzelne Terminbuchung abrufen. Es müssen alle Zeichen der ID übergeben werden. Eine Suche mit bspw. nur den ersten 3 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. Details hierzu sind auf der Seite Suchparameter: BSNR (SearchParameter) zu finden. Wird der Parameter nicht übergeben, werden alle BSNRs aus dem Access Token als Suchparameter übernommen. |
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. Details hierzu sind auf der Seite Suchparameter: ANR (SearchParameter) zu finden. Es können entweder nur die ersten 7 Stellen oder alle 9 Stellen der ANR übergeben werden. |
Suchparameter: Startzeitpunkt 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 (Feld Appointment.start) in dem angegebenen Zeitraum liegt. |
| Anmerkung |
Dieser Parameter muss folgendes Format haben: yyyy-mm-ddThh:mm:ss[(+|-)hh:mm] Ein anderes Format oder eine abweichende Formatierung der Zeitzone kann vom 116117 Terminservice derzeit NICHT verarbeitet werden und führt zu einem Fehler. Weitere Information sind auf der Seite FAQ zu finden. Wie nach Zeiträumen gefiltert werden kann, ist in der HL7-FHIR-Dokumentation unter Search – Standard Parameters: date beschrieben. |
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 den Terminprofilen basieren, die eine der angegebenen IDs im Feld Schedule.id hinterlegt haben. |
| Anmerkung |
Es müssen alle Zeichen der Terminprofil-ID übergeben werden. Eine Suche mit bspw. nur den ersten 3 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 einem der 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 4 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. 3 verschiedene Vermittlungscodes als Suchparameter übergeben werden, auch bei all diesen 3 Suchparametern das NamingSystem angegeben werden sollte. |
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. (Ressourcen, die in den Terminbuchungen referenziert und ebenfalls mit zurückgegeben werden, werden hier nicht mit eingerechnet.) |
| Anmerkung |
Wird der Parameter nicht übergeben, 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. Es kann sein, dass insgesamt mehr Suchergebnisse gefunden werden, als in _count angegeben wurde. In diesem Fall gibt es mehrere Seiten mit Suchergebnissen; die anderen Seiten können über weitere Requests mit dem entsprechenden Wert für den Suchparameter page abgerufen werden. Weitere Details zum Thema Paging sind auf der Seite Operationen und Interaktionen zu finden. |
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 der Parameter nicht übergeben, wird der Standardwert von 1 als Suchparameter übernommen. Es wird dann also immer die 1. 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. Wird eine nicht existente Seitenzahl angegeben, ist der Request dennoch valide – im Response Body sind in diesem Fall jedoch keine Suchergebnisse enthalten. Wenn bspw. insgesamt 15 Suchergebnisse gefunden wurden und 10 Suchergebnisse pro Seite zurückgegeben werden, enthält der Response Body auf eine Suchanfrage mit page=3 keine Suchergebnisse. Weitere Details zum Thema Paging sind auf der Seite Operationen und Interaktionen zu finden. |
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/pvs/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/pvs/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/pvs/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/pvs/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/pvs/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 mindestens 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.
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, wenn vorhanden: Terminbuchungen (im Element Bundle.entry)
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)
Bitte beachten: Hierbei handelt es sich um einen Verweis in Form einer URL – um die Seite tatsächlich abzurufen, muss jedoch ein POST-Request mit den Suchparametern im Request Body abgeschickt werden.
Details zum Thema Paging
sind auf der Seite Operationen und Interaktionen zu finden.
Folgende in den Appointments 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">
<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" />
<url value="https://fhir.kbv.de/pvs/terminsynchronisation/api/Appointment?bsnr=123456789&_count=10&page=1" />
</link>
<url value="https://fhir.kbv.de/pvs/terminsynchronisation/api/Appointment?bsnr=123456789&_count=10&page=2&page=1" />
</link>
<fullUrl value="urn:uuid:eac5e3b4-9d20-4fa1-a900-cb27f4ea8fb6" />
<Appointment>
<id value="eac5e3b4-9d20-4fa1-a900-cb27f4ea8fb6" />
<profile value="https://fhir.kbv.de/StructureDefinition/KBV_PR_116117_TERMINSERVICE_TVS_TERMINSYNCHRONISATION_Appointment|1.0.0" />
</meta>
<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">
<system value="https://fhir.kbv.de/CodeSystem/KBV_CS_Base_Role_Care_Team" />
<display value="Hausarzt/-ärztin" />
</coding>
</valueCodeableConcept>
</extension>
<system value="http://terminology.hl7.org/CodeSystem/appointment-cancellation-reason" />
</coding>
</cancelationReason>
<system value="https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_BAS_FACHGEBIET_GROB" />
<display value="Kinderarzt / Kinderärztin" />
</coding>
</serviceType>
<system value="https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_BAR2_WBO" />
<display value="FÄ/FA Kinder- und Jugendmedizin" />
</coding>
</serviceType>
<extension url="https://fhir.kbv.de/StructureDefinition/KBV_EX_116117_TERMINSERVICE_TVS_TERMINSYNCHRONISATION_Urgency">
<system value="http://snomed.info/sct" />
<code value="103391001" />
</valueCoding>
</extension>
</priority>
<start value="2024-01-27T10:15:00+01:00" />
<end value="2024-01-27T10:30:00+01:00" />
<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" />
<system value="https://fhir.kbv.de/NamingSystem/KBV_NS_116117_TERMINSERVICE_Vermittlungscode" />
<value value="XN6P-F4HP-Z5KX" />
</identifier>
</basedOn>
<reference value="https://fhir.kbv.de/PractitionerRole/123456789-1122334" />
<type value="PractitionerRole" />
</actor>
</participant>
<reference value="urn:uuid:f28714b1-627d-426e-88ae-e348076d9738" />
</actor>
</participant>
</Appointment>
</resource>
</search>
</entry>
<fullUrl value="https://fhir.kbv.de/PractitionerRole/123456789" />
<PractitionerRole>
<profile value="https://fhir.kbv.de/StructureDefinition/KBV_PR_116117_TERMINSERVICE_TVS_TERMINSYNCHRONISATION_PractitionerRole|1.0.0" />
</meta>
<div xmlns="http://www.w3.org/1999/xhtml">Diese PractitionerRole-Instanz enthält nur die BSNR einer Praxis.</div>
</text>
<system value="https://fhir.kbv.de/NamingSystem/KBV_NS_Base_BSNR" />
<value value="123456789" />
</identifier>
</organization>
</PractitionerRole>
</resource>
</search>
</entry>
<fullUrl value="urn:uuid:25f88e86-b526-490a-8a49-2a7af7ce743c" />
<Patient>
<id value="25f88e86-b526-490a-8a49-2a7af7ce743c" />
<profile value="https://fhir.kbv.de/StructureDefinition/KBV_PR_116117_TERMINSERVICE_TVS_TERMINSYNCHRONISATION_Patient|1.0.0" />
</meta>
<div xmlns="http://www.w3.org/1999/xhtml">Diese Patient-Instanz beschreibt Mini Mustermensch</div>
</text>
<system value="http://fhir.de/CodeSystem/identifier-type-de-basis" />
<display value="Gesetzliche Krankenversicherung" />
</coding>
</type>
<system value="http://fhir.de/sid/gkv/kvid-10" />
<value value="A111222333" />
</identifier>
<family value="Mustermensch" />
</name>
<value value="030123456789" />
</telecom>
</Patient>
</resource>
</search>
</entry>
<fullUrl value="urn:uuid:467eddcd-68fd-4f20-9de9-b8fcc6510ed2" />
<Appointment>
<id value="467eddcd-68fd-4f20-9de9-b8fcc6510ed2" />
<profile value="https://fhir.kbv.de/StructureDefinition/KBV_PR_116117_TERMINSERVICE_TVS_TERMINSYNCHRONISATION_Appointment|1.0.0" />
</meta>
<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">
<system value="https://fhir.kbv.de/CodeSystem/KBV_CS_Base_Role_Care_Team" />
<display value="Facharzt/-ärztin" />
</coding>
</valueCodeableConcept>
</extension>
<system value="https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_BAS_FACHGEBIET_GROB" />
<display value="Hals-Nasen-Ohrenheilkunde" />
</coding>
</serviceType>
<extension url="https://fhir.kbv.de/StructureDefinition/KBV_EX_116117_TERMINSERVICE_TVS_TERMINSYNCHRONISATION_Urgency">
<system value="http://snomed.info/sct" />
<code value="50811001" />
</valueCoding>
</extension>
</priority>
<start value="2024-02-27T09:00:00+01:00" />
<end value="2024-02-27T10:00:00+01:00" />
<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" />
<system value="https://fhir.kbv.de/NamingSystem/KBV_NS_116117_TERMINSERVICE_Vermittlungscode" />
<value value="XN6P-F4HP-Z5KX" />
</identifier>
</basedOn>
<reference value="https://fhir.kbv.de/PractitionerRole/123456789-1122334" />
<type value="PractitionerRole" />
</actor>
</participant>
<reference value="urn:uuid:f28714b1-627d-426e-88ae-e348076d9738" />
</actor>
</participant>
</Appointment>
</resource>
</search>
</entry>
<fullUrl value="https://fhir.kbv.de/PractitionerRole/123456789-1122334" />
<PractitionerRole>
<id value="123456789-1122334" />
<profile value="https://fhir.kbv.de/StructureDefinition/KBV_PR_116117_TERMINSERVICE_TVS_TERMINSYNCHRONISATION_PractitionerRole|1.0.0" />
</meta>
<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>
<reference value="urn:uuid:3f03e5bc-f5ba-4017-971d-fd7de95db07c" />
</practitioner>
<system value="https://fhir.kbv.de/NamingSystem/KBV_NS_Base_BSNR" />
<value value="123456789" />
</identifier>
</organization>
</PractitionerRole>
</resource>
</search>
</entry>
<fullUrl value="urn:uuid:f28714b1-627d-426e-88ae-e348076d9738" />
<Patient>
<id value="f28714b1-627d-426e-88ae-e348076d9738" />
<profile value="https://fhir.kbv.de/StructureDefinition/KBV_PR_116117_TERMINSERVICE_TVS_TERMINSYNCHRONISATION_Patient|1.0.0" />
</meta>
<div xmlns="http://www.w3.org/1999/xhtml">Diese Patient-Instanz beschreibt Prinzessin Melanie Mustermensch</div>
</text>
<system value="https://fhir.kbv.de/CodeSystem/KBV_CS_Base_identifier_type" />
<display value="Krankenversichertenkarte" />
</coding>
</type>
<system value="http://fhir.de/sid/gkv/kvk-versichertennummer" />
<value value="987654321" />
</identifier>
<extension url="http://fhir.de/StructureDefinition/humanname-namenszusatz">
</extension>
<extension url="http://hl7.org/fhir/StructureDefinition/humanname-own-name">
</extension>
</family>
<given value="Melanie" />
</name>
<value value="030123456789" />
</telecom>
<value value="m.mustermensch@gmail.com" />
</telecom>
<extension url="http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-postBox">
</extension>
</line>
<city value="Darmstadt" />
</address>
</Patient>
</resource>
</search>
</entry>
<fullUrl value="urn:uuid:e49ff6e9-d577-4a1f-94df-31148bbfa3d8" />
<Appointment>
<id value="e49ff6e9-d577-4a1f-94df-31148bbfa3d8" />
<profile value="https://fhir.kbv.de/StructureDefinition/KBV_PR_116117_TERMINSERVICE_TVS_TERMINSYNCHRONISATION_Appointment|1.0.0" />
</meta>
<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">
<system value="https://fhir.kbv.de/CodeSystem/KBV_CS_Base_Role_Care_Team" />
<display value="Hausarzt/-ärztin" />
</coding>
</valueCodeableConcept>
</extension>
<system value="https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_BAS_FACHGEBIET_GROB" />
<display value="Kinderarzt / Kinderärztin" />
</coding>
</serviceType>
<extension url="https://fhir.kbv.de/StructureDefinition/KBV_EX_116117_TERMINSERVICE_TVS_TERMINSYNCHRONISATION_Urgency">
<system value="http://snomed.info/sct" />
<code value="103391001" />
</valueCoding>
</extension>
</priority>
<start value="2024-01-15T15:45:00+01:00" />
<end value="2024-01-15T16:00:00+01:00" />
<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" />
<system value="https://fhir.kbv.de/NamingSystem/KBV_NS_116117_TERMINSERVICE_Vermittlungscode" />
<value value="XN6P-F4HP-Z5KX" />
</identifier>
</basedOn>
<reference value="https://fhir.kbv.de/PractitionerRole/123456789-1122334" />
<type value="PractitionerRole" />
</actor>
</participant>
<reference value="urn:uuid:f28714b1-627d-426e-88ae-e348076d9738" />
</actor>
</participant>
</Appointment>
</resource>
</search>
</entry>
<fullUrl value="urn:uuid:61cb8d62-9038-49f7-a357-b2bc924b0cca" />
<Patient>
<id value="61cb8d62-9038-49f7-a357-b2bc924b0cca" />
<profile value="https://fhir.kbv.de/StructureDefinition/KBV_PR_116117_TERMINSERVICE_TVS_TERMINSYNCHRONISATION_Patient|1.0.0" />
</meta>
<div xmlns="http://www.w3.org/1999/xhtml">Diese Patient-Instanz beschreibt Minerva Mustermensch</div>
</text>
<system value="http://fhir.de/CodeSystem/identifier-type-de-basis" />
<display value="Gesetzliche Krankenversicherung" />
</coding>
</type>
<system value="http://fhir.de/sid/gkv/kvid-10" />
<value value="A123456789" />
</identifier>
<system value="https://fhir.kbv.de/CodeSystem/KBV_CS_Base_identifier_type" />
<display value="Krankenversichertenkarte" />
</coding>
</type>
<system value="http://fhir.de/sid/gkv/kvk-versichertennummer" />
<value value="987654321" />
</identifier>
<extension url="http://hl7.org/fhir/StructureDefinition/humanname-own-name">
</extension>
<extension url="http://hl7.org/fhir/StructureDefinition/humanname-own-prefix">
</extension>
</family>
<given value="Minerva" />
</name>
<value value="030123456789" />
</telecom>
<value value="m.mustermensch@gmail.com" />
</telecom>
</Patient>
</resource>
</search>
</entry>
</Bundle>
<Bundle xmlns="http://hl7.org/fhir">
<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" />
<url value="https://fhir.kbv.de/pvs/terminsynchronisation/api/Appointment?anr=123456789&date=gt2024-01-14T12:00:00+01:00&bsnr=123456789&_count=10&page=1" />
</link>
<fullUrl value="urn:uuid:0286855c-b49c-48b4-9775-58b6cb031aed" />
<Appointment>
<id value="0286855c-b49c-48b4-9775-58b6cb031aed" />
<profile value="https://fhir.kbv.de/StructureDefinition/KBV_PR_116117_TERMINSERVICE_TVS_TERMINSYNCHRONISATION_Appointment|1.0.0" />
</meta>
<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">
<system value="https://fhir.kbv.de/CodeSystem/KBV_CS_116117_TERMINSERVICE_TVS_TERMINSYNCHRONISATION_Roles" />
<code value="Patient" />
</coding>
</valueCodeableConcept>
</extension>
<system value="https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_BAS_FACHGEBIET_GROB" />
</coding>
</serviceType>
<extension url="https://fhir.kbv.de/StructureDefinition/KBV_EX_116117_TERMINSERVICE_TVS_TERMINSYNCHRONISATION_Urgency">
<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" />
<reference value="urn:uuid:66078451-6307-4f1f-82bd-a159a094dc69" />
</slot>
<created value="2024-01-29T09:23:05+02:00" />
<system value="https://fhir.kbv.de/NamingSystem/KBV_NS_116117_TERMINSERVICE_Vermittlungscode" />
<value value="XN6PF4HPZ5KX" />
</identifier>
</basedOn>
<reference value="https://fhir.kbv.de/PractitionerRole/123456789" />
<type value="PractitionerRole" />
</actor>
</participant>
<reference value="urn:uuid:529c2a3a-7f3c-4d17-9f15-595b29b4cf9c" />
</actor>
</participant>
</Appointment>
</resource>
</search>
</entry>
<fullUrl value="https://fhir.kbv.de/PractitionerRole/123456789" />
<PractitionerRole>
<profile value="https://fhir.kbv.de/StructureDefinition/KBV_PR_116117_TERMINSERVICE_TVS_TERMINSYNCHRONISATION_PractitionerRole|1.0.0" />
</meta>
<div xmlns="http://www.w3.org/1999/xhtml">Diese PractitionerRole-Instanz enthält nur die BSNR einer Praxis.</div>
</text>
<system value="https://fhir.kbv.de/NamingSystem/KBV_NS_Base_BSNR" />
<value value="123456789" />
</identifier>
</organization>
</PractitionerRole>
</resource>
</search>
</entry>
<fullUrl value="urn:uuid:529c2a3a-7f3c-4d17-9f15-595b29b4cf9c" />
<Patient>
<id value="529c2a3a-7f3c-4d17-9f15-595b29b4cf9c" />
<profile value="https://fhir.kbv.de/StructureDefinition/KBV_PR_116117_TERMINSERVICE_TVS_TERMINSYNCHRONISATION_Patient|1.0.0" />
</meta>
<div xmlns="http://www.w3.org/1999/xhtml">Diese Patient-Instanz beschreibt Prinzessin Melanie Mustermensch</div>
</text>
<system value="https://fhir.kbv.de/CodeSystem/KBV_CS_Base_identifier_type" />
<display value="Krankenversichertenkarte" />
</coding>
</type>
<system value="http://fhir.de/sid/gkv/kvk-versichertennummer" />
<value value="987654321" />
</identifier>
<extension url="http://fhir.de/StructureDefinition/humanname-namenszusatz">
</extension>
<extension url="http://hl7.org/fhir/StructureDefinition/humanname-own-name">
</extension>
</family>
<given value="Melanie" />
</name>
<value value="030123456789" />
</telecom>
<value value="m.mustermensch@gmail.com" />
</telecom>
<extension url="http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-postBox">
</extension>
</line>
<city value="Darmstadt" />
</address>
</Patient>
</resource>
</search>
</entry>
</Bundle>
<id value="cc8e9f90-31ad-4021-9639-e5b940a88a94" />
<profile value="https://fhir.kbv.de/StructureDefinition/KBV_PR_116117_TERMINSERVICE_TVS_TERMINSYNCHRONISATION_OperationOutcome_Error|1.0.0" />
</meta>
--- We have skipped the narrative for better readability of the resource ---
</text>
<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ähere Informationen zum Fehler." />
</coding>
</details>
</issue>
</OperationOutcome>
<id value="81758936-362c-411f-9d95-7fac5b19deb6" />
<profile value="https://fhir.kbv.de/StructureDefinition/KBV_PR_116117_TERMINSERVICE_TVS_TERMINSYNCHRONISATION_OperationOutcome_Error|1.0.0" />
</meta>
--- We have skipped the narrative for better readability of the resource ---
</text>
<system value="https://fhir.kbv.de/CodeSystem/KBV_CS_116117_TERMINSERVICE_TVS_TERMINSYNCHRONISATION_Errors" />
<code value="TVSTS0018" />
<display value="Die Dringlichkeit ist ungültig." />
</coding>
</details>
</issue>
</OperationOutcome>