Operationen und Interaktionen
Folgende FHIR-Operationen und -Standardinteraktionen werden in den Unterkapiteln näher erläutert:
- Operationen und Interaktionen
- Terminbuchungen abrufen (Appointment Search)
- Terminslots abrufen (Slot Search)
- Terminslot anlegen (Slot Create)
- Terminslots anlegen (Slot Batch Create)
- Terminslot löschen (Slot Delete)
- Terminslots löschen (Slot Batch Delete)
- Terminprofile abrufen (Schedule Search)
- Terminprofil anlegen (Schedule Create)
- Terminprofil aktualisieren (Schedule Update)
- Terminprofil löschen (Schedule Delete)
- PractitionerRole abrufen (PractitionerRole Search)
- Ärzte abrufen (Practitioner Search)
- Änderungen abrufen (Provenance Search)
- Operation: Status eines Terminslots aktualisieren
- Operation: Terminbuchung absagen
- Operation: Patientenankunft dokumentieren
Einleitung
Eine Kommunikation mit dem 116117 Terminservice erfolgt ausschließlich über die hier beschriebenen Operationen und Interaktionen.
Einige Use Cases werden über Standardinteraktionen abgebildet, die über einen REST-Abruf entsprechend der gängigen Standards erfolgen. Diese Standardinteraktionen sind in der offiziellen HL7-Dokumentation unter RESTful API näher erläutert. Generell werden folgende Interaktionen 116117 Terminservice unterstützt:
search zum Abrufen einzelner oder mehrerer Ressourcen anhand von Suchparametern
create zum Erstellen einzelner Ressourcen
update zum Aktualisieren einzelner Ressourcen anhand der Ressourcen-ID
delete zum Löschen einzelner Ressourcen anhand der Ressourcen-ID
batch zum Löschen oder Erstellen mehrerer Ressourcen in einem einzigen Request
Darüber hinaus gibt es einige custom operations, die sehr spezifische Use Cases abbilden und an den entsprechenden Stellen beschrieben werden.
Allgemeingültige Anmerkungen
Für alle Operationen und Interaktionen gilt:
Im Fehlerfall wird ein eigens dafür definiertes OperationOutcome mit Details zum aufgetretenen Fehler zurückgegeben.
Alle Suchparameter (bei der Standardinteraktion search) müssen im Request Body übergeben werden; Suchparameter in der URL werden ignoriert.
Die FHIR-Standardinteraktion read wird nicht umgesetzt; stattdessen kann über die FHIR-Standardinteraktion search auf der jeweiligen Ressourcenart eine spezifische Ressource anhand ihrer ID abgerufen. Details hierzu sind auf den entsprechenden Unterseiten zu finden.