---
title: Module Jadwal dan Profil Dokter
tags: fhir-module-id
disqus: victoriatjia
---

Module Jadwal dan Profil Dokter
===
###### tags: `fhir-module-id`

## Table of Contents
[TOC]

## Pendahuluan
**Struktur Departemen di RS**
*<center>fig 1.1 Diagram struktur departemen di rumah sakit</center>*

Struktur organisasi fasilitas layanan kesehatan (fasyankes) dimulai dari organisasi fasyankes itu sendiri sebagai induknya yang mana data tsb bisa kita simpan di FHIR Organization resource (selanjutnya disebut "*Organization*").

*Organization* juga bisa digunakan untuk mendefinisikan berbagai jenis departemen atau unit di rumah sakit. Contohnya di diagram organisasi (fig 1.1), *Organization* menunjukkan pohon hierarki yang menyajikan hubungan antara parent dan child antara rumah sakit, cluster, dan klinik spesialis.

*<center>fig 1.2 Diagram struktur dokter spesialis di rumah sakit</center>*

Untuk data staff fasyankes sendiri disimpan di FHIR Practitioner resource. *Practitioner* hanya menyimpan data pribadi dokter seperti nama, jenis kelamin, DOB, dsb. Sedangkan nama spesialis dokter akan disimpan di *PractitionerRole*. Sehingga dalam scenario dokter yang memiliki lebih dari 1 spesialis bisa digambarkan dengan 1 Practitioner dan 2 Practitioner Role, seperti contoh di fig 1.2, Dr. Jackie dengan 2 role spesialis.

**Jadwal Dokter Spesialis**
*<center>fig 1.3 Diagram relasi antar resource pada jadwal dokter</center>*

Berdasarkan contoh diagram fig 1.3 Dr. Will Smith memiliki jadwal di setiap hari Senin dari jam 10:00 - 11:30. Durasi konsultasinya adalah 30 menit/ pasien. Jadwal ini berlaku dari tanggal 1 Oktober 2022 hingga 14 Januari 2023. Data-data ini tersimpan dalam *Schedule* resource. Sedangkan *Slot* resource akan menyimpan sesi konsultasi per hari dan jamnya. Sehingga bisa kita lihat dari *Schedule* di fig 1.3 akan menghasilkan 45 *Slot*, dikarenakan antara tanggal 1 Oktober 2022 sampai 14 Januari 2023 ada 15 hari Senin, dan dalam 1 hari ada 3 sesi konsultasi (I= 10:00-10:30; II= 10:30-11:00; III= 11:00-11:30). Untuk status apakah sesi tersebut masih available untuk di booked pasien, atau sudah di booked ataupun unavailable dikarenakan dokter tersebut cuti juga akan tercatat di *Slot* resource.

Apabila dilihat secara keseluruhan, relasi antar data struktur organisasi, jadwal dokter, dan juga data appointment pasien akan membentuk diagram dibawah ini:
*<center>fig 1.4 Diagram relasi antar struktur organisasi, jadwal dokter, dan appointment pasien</center>*

## Specs Data Format
### 1. [FHIR Organization](https://www.hl7.org/fhir/organization.html)
#### 1.1. Deskripsi
Pengelompokan orang atau organisasi yang diakui secara formal atau informal yang dibentuk untuk mencapai tujuan tertentu. Termasuk perusahaan, institusi, korporasi, departemen, kelompok masyarakat, tim medis, pembayar/penjamin, dll.

Ada dua contoh *Organization* yang bisa kita lihat di website HL7 FHIR, [Burgers UMC](https://www.hl7.org/fhir/organization-example-f001-burgers.html) dan [Burgers UMC Cardiology unit](https://www.hl7.org/fhir/organization-example-f002-burgers-card.html). "Burger UMC" adalah rumah sakit dan "Burgers UMC Cardiology unit" adalah salah satu departemen di UMC Burger.

**Organization.Partof**

Di contoh JSON dari [Burgers UMC Cardiology unit](https://www.hl7.org/fhir/organization-example-f002-burgers-card.html), kita bisa lihat ada kolom "partof" yang menunjukkan hubungan antara departemen Kardiologi Burgers UMC dengan parentnya yaitu Rumah Sakit Burgers UMC.

*<center>fig 1.5 Hubungan antara Burgers UMC Hospital dan Burgers UMC Cardiology unit</center>*

Kolom “partof” dapat menghubungkan setiap unit di rumah sakit dan menunjukkan hubungan antara *parent* dan *child*. Ketika seluruh relasi dihubungkan, maka diagram pohon organisasi akan terbentuk, yang mana diagram ini merupakan dasar dalam implementasi sebuah sistem healthcare.

#### 1.2. Spesifikasi data format -> [link](https://github.com/victoriatjia/Guideline/blob/master/SatuSehat/Specs%20Format%20FHIR/custom/Organization.xlsx)

#### 1.3. Scenario
<table>
<tr>
<td><b>Scenario 1</b></td>
<td>Rumah sakit</td>
</tr>
<tr>
<td><b>Scenario 2</b></td>
<td>Cluster/departemen/klinik spesialis</td>
</tr>
</table>

**Example SC1**: Rumah Sakit Oxford
https://hapi.fhir.org/baseR4/Organization/tch

{
  "resourceType": "Organization",
  "id": "tch",
  "identifier": [ {
    "use": "official",
    "system": "code",
    "value": "8888"
  } ],
  "active": true,
  "type": [ {
    "coding": [ {
      "system": "http://terminology.hl7.org/CodeSystem/organization-type",
      "code": "prov",
      "display": "Healthcare Provider"
    } ]
  } ],
  "name": "Oxford Hospital",
  "telecom": [ {
    "system": "email",
    "value": "[e-mail]",
    "use": "work"
  } ],
  "address": [ {
    "text": "Jl. Pantai Indah Kapuk Boulevard. Jakarta Utara 14470"
  } ],
  "contact": [ {
    "purpose": {
      "coding": [ {
        "system": "http://terminology.hl7.org/CodeSystem/contactentity-type",
        "code": "ADMIN"
      } ]
    },
    "name": {
      "text": "Emergency"
    },
    "telecom": [ {
      "system": "phone",
      "value": "[phone]",
      "use": "work"
    } ]
  }, {
    "purpose": {
      "coding": [ {
        "system": "http://terminology.hl7.org/CodeSystem/contactentity-type",
        "code": "ADMIN"
      } ]
    },
    "name": {
      "text": "Call Center Telephone"
    },
    "telecom": [ {
      "system": "phone",
      "value": "[phone]",
      "use": "work"
    } ]
  }, {
    "purpose": {
      "coding": [ {
        "system": "http://terminology.hl7.org/CodeSystem/contactentity-type",
        "code": "ADMIN"
      } ]
    },
    "name": {
      "text": "Call Center WA"
    },
    "telecom": [ {
      "system": "other",
      "value": "([phone]",
      "use": "work"
    } ]
  } ]
}

**Example SC2**: Cluster Gigi
https://hapi.fhir.org/baseR4/Organization/cde

{
  "resourceType": "Organization",
  "id": "cde",
  "identifier": [ {
    "use": "official",
    "system": "code",
    "value": "CDE"
  } ],
  "active": true,
  "type": [ {
    "coding": [ {
      "system": "http://terminology.hl7.org/CodeSystem/organization-type",
      "code": "dept",
      "display": "Hospital Department"
    } ]
  } ],
  "name": "Dental Center",
  "partOf": {
    "reference": "Organization/tch"
  }
}

:::info
:pushpin: **Untuk search semua cluster dari RS Oxford, gunakan search parameter dibawah ini**:
https://hapi.fhir.org/baseR4/Organization?partof=tch
:::

**Example SC2**: Klinik Gigi
https://hapi.fhir.org/baseR4/Organization/tchden

{
  "resourceType": "Organization",
  "id": "tchden",
  "identifier": [ {
    "use": "official",
    "system": "code",
    "value": "TCHDEN"
  } ],
  "active": true,
  "type": [ {
    "coding": [ {
      "system": "http://terminology.hl7.org/CodeSystem/organization-type",
      "code": "dept",
      "display": "Hospital Department"
    } ]
  } ],
  "name": "Dental Clinic (3rd fl)",
  "partOf": {
    "reference": "Organization/cde"
  }
}

:::info
:pushpin: **Untuk search semua klinik dari Cluster Dental, gunakan search parameter dibawah ini**:
https://hapi.fhir.org/baseR4/Organization?partof=cde
:::

---
### 2. [FHIR Practitioner](https://www.hl7.org/fhir/practitioner.html)
#### 2.1. Deskripsi
Seseorang yang secara langsung atau tidak langsung terlibat dalam penyediaan layanan kesehatan, atau disebut juga tenaga kesehatan (Nakes)

#### 2.2. Spesifikasi data format -> [link](https://github.com/victoriatjia/Guideline/blob/master/SatuSehat/Specs%20Format%20FHIR/custom/Practitioner.xlsx)

#### 2.3. Scenario
<table>
<tr>
<td><b>Scenario 1</b></td>
<td>Dokter</td>
</tr>
</table>

**Example SC1**: Dr. Marcia
https://hapi.fhir.org/baseR4/Practitioner/8xx5

{
  "resourceType": "Practitioner",
  "id": "8xx5",
  "identifier": [ {
    "system": "code",
    "value": "8xx5"
  } ],
  "active": true,
  "name": [ {
    "use": "official",
    "text": "Marcia, drg, Sp.PM"
  } ],
  "gender": "female"
}

---
### 3. [FHIR PractitionerRole](https://www.hl7.org/fhir/practitionerrole.html)
#### 3.1. Deskripsi
Nama spesialis Nakes. PractitionerRole berfungsi sebagai penghubung antara Dokter (Practitioner) dan nama spesialis (Organization)

#### 3.2. Spesifikasi data format -> [link](https://github.com/victoriatjia/Guideline/blob/master/SatuSehat/Specs%20Format%20FHIR/custom/PractitionerRole.xlsx)

#### 3.3. Scenario
<table>
<tr>
<td><b>Scenario 1</b></td>
<td>Spesialis Nakes</td>
</tr>
</table>

**Example SC1**: Nama spesialis Dr. Marcia
https://hapi.fhir.org/baseR4/PractitionerRole/7046229

{
  "resourceType": "PractitionerRole",
  "id": "7046229",
  "active": true,
  "practitioner": {
    "reference": "Practitioner/8xx5",
    "display": "Marcia, drg, Sp.PM"
  },
  "organization": {
    "reference": "Organization/tchden",
    "display": "Dental Clinic (3rd fl)"
  },
  "code": [ {
    "coding": [ {
      "system": "http://hl7.org/fhir/R4/valueset-practitioner-role.html",
      "code": "doctor",
      "display": "Doctor"
    } ]
  } ],
  "specialty": [ {
    "coding": [ {
      "system": "code",
      "code": "DR0043",
      "display": "Dental"
    }, {
      "system": "sub-specialty",
      "display": "Konsultan Dental"
    } ]
  } ]
}

---
### 4. [FHIR Schedule](https://hl7.org/fhir/schedule.html)
#### 4.1. Deskripsi
Jadwal Dokter

#### 4.2. Spesifikasi data format -> [link](https://github.com/victoriatjia/Guideline/blob/master/SatuSehat/Specs%20Format%20FHIR/custom/Schedule.xlsx)

#### 4.3. Scenario
<table>
<tr>
<td><b>Scenario 1</b></td>
<td>Jadwal dokter</td>
</tr>
</table>

**Example SC1**: Jadwal Dr. Marcia
https://hapi.fhir.org/baseR4/Schedule/7046231

{
  "resourceType": "Schedule",
  "id": "7046231",
  "identifier": [ {
    "use": "usual",
    "system": "row-id",
    "value": "597||2||6"
  } ],
  "active": true,
  "serviceCategory": [ {
    "coding": [ {
      "code": "O",
      "display": "Outpatient"
    } ]
  } ],
  "serviceType": [ {
    "coding": [ {
      "code": "APPT01",
      "display": "Appointment"
    } ]
  } ],
  "actor": [ {
    "reference": "PractitionerRole/7046229",
    "display": "Marcia, drg, Sp.PM"
  } ],
  "planningHorizon": {
    "start": "2022-03-01T16:00:00Z",
    "end": "2022-12-19T19:00:00Z"
  },
  "comment": "tuesday"
}

---
### 5. [FHIR Slot](https://www.hl7.org/fhir/slot.html)
#### 5.1. Deskripsi
Slot waktu pada jadwal dokter yang tersedia untuk membuat appointment

#### 5.2. Spesifikasi data format -> [link](https://github.com/victoriatjia/Guideline/blob/master/SatuSehat/Specs%20Format%20FHIR/custom/Slot.xlsx)

#### 5.3. Scenario
<table>
<tr>
<td><b>Scenario 1</b></td>
<td>Slot jadwal Dokter</td>
</tr>
</table>

**Example SC1**: Slot untuk appointment
https://hapi.fhir.org/baseR4/Slot/7046233

{
  "resourceType": "Slot",
  "id": "7046233",
  "serviceType": [ {
    "coding": [ {
      "code": "APPT01",
      "display": "Appointment"
    } ]
  } ],
  "schedule": {
    "reference": "Schedule/7046231"
  },
  "status": "free",
  "start": "2021-10-01T13:00:00Z",
  "end": "2021-11-08T13:30:00Z",
  "comment": "Slot untuk appointment pelayanan pada jam 13.00 WIB s/d 13.30 WIB"
}