{ "description": "OperationDefinition für die Buchung eines Termins. Die Operation überprüft ob der Termin noch verfügbar ist im Termin-Repository.", "_filename": "OperationDefinition-ISiKAppointmentBookOperation.json", "package_name": "de.gematik.isik-terminplanung", "date": "2023-11-29", "system": false, "publisher": "gematik GmbH", "instance": false, "name": "book", "type": "true", "experimental": "false", "resourceType": "OperationDefinition", "title": null, "package_version": "2.0.4", "status": "active", "id": "e4d03347-a364-4534-ac37-7ba1336a2973", "resource": [ "Appointment" ], "affectsState": true, "kind": "operation", "url": "https://gematik.de/fhir/isik/v2/Terminplanung/OperationDefinition/AppointmentBook", "code": "book", "version": "2.0.4", "parameter": [ { "max": "1", "min": 1, "use": "in", "name": "appt-resource", "type": "Appointment", "documentation": "Eine Appointment-Ressource entsprechend dem dazugehörigen ISiK-Profil MUSS übergeben werden. Falls das Parameter-Element 'Appointment' als einziges Parameter-Element verwendet wird, SOLL die Appointment-Ressource direkt im HTTP Body übergeben werden, alternativ zu einer Parameter-Ressource inklusive dem eingebetteten Appointment-Element. Invalide Ressourcen MÜSSEN abgelehnt werden durch das Termin Repository (zur Form der Ablehnung s.u.). Das Appointment MUSS den Status 'proposed' enthalten." }, { "max": "1", "min": 0, "use": "in", "name": "cancelled-appt-id", "type": "uri", "documentation": "Für die vorliegende Spezifikation ist die Verschiebung eines Termin eins zwei-stufiger Prozess, bei dem ein Termin storniert und ein neuer Termin neu gebucht wird. Dieser Parameter repräsentiert die Ressourcen-Id des stornierten Appointments. Der uri-Parameter kann eine absoulte URL enthalten, Server SOLLEN jedoch nur Termine für ihre eigene Domäne verwalten. Im neu-angelegten Appointment MUSS eine Reference auf den abgesagten Termin hinterlegt werden (vgl. Appointment.extension:replaces). Der Status der abgesagten Ressource MUSS durch den Server angepasst werden." }, { "max": "1", "min": 0, "use": "in", "name": "schedule", "type": "Reference", "documentation": "Im Falle dass ein Appointment keine Referenz auf ein oder mehrere Slots enthält, MUSS der Server die benötigten Slots auf Basis der Referenz auf Schedule, sowie dem Start- und Endzeitpunkt im Appointment ermitteln.", "targetProfile": [ "https://gematik.de/fhir/isik/v2/Terminplanung/StructureDefinition/ISiKKalender" ] }, { "max": "1", "min": 0, "use": "out", "name": "return", "type": "Bundle", "documentation": "Als Return-Parameter MUSS ein Bundle vom Typ 'searchset' zurückgegeben werden, welches eine aktualisierte Appointment- oder eine OperationOutcome-Ressource enthält. Falls die Terminbuchung akzeptiert wird, MUSS das Appointment persistiert werden. Das id-Element der Ressource MUSS korrekt gefüllt werden. Der Status der Appointment-Ressource MUSS auf 'booked' geändert werden. Der Server MUSS die verwendeten Slot-Ressourcen als Referenz im Appointment angeben." } ] }