Practitioner Resource

Resource Practitioner digunakan untuk mengelola data tenaga kesehatan dalam ekosistem SATUSEHAT.

Endpoint

GET    /Practitioner
POST   /Practitioner
GET    /Practitioner/{id}
PUT    /Practitioner/{id}
PATCH  /Practitioner/{id}

Base URL

• Sandbox: https://api-satusehat-stg.dto.kemkes.go.id/fhir-r4/v1
• Production: https://api-satusehat.kemkes.go.id/fhir-r4/v1

Headers

Header	Value	Required
Authorization	Bearer {access_token}	✅
Content-Type	application/fhir+json	✅

Structure

Mandatory Fields

• resourceType: "Practitioner"
• identifier: Identifikasi unik tenaga kesehatan
• name: Nama lengkap tenaga kesehatan

Optional Fields

• active: Status aktif
• telecom: Informasi kontak
• address: Alamat
• gender: Jenis kelamin
• birthDate: Tanggal lahir
• qualification: Kualifikasi dan sertifikasi

Contoh Request

POST /Practitioner

{
  "resourceType": "Practitioner",
  "identifier": [
    {
      "use": "official",
      "system": "https://fhir.kemkes.go.id/id/nik",
      "value": "3271010101010002"
    },
    {
      "use": "official",
      "system": "https://fhir.kemkes.go.id/id/sip",
      "value": "446/SIP/DINKES-KB/2020"
    }
  ],
  "name": [
    {
      "use": "official",
      "family": "Rose",
      "given": ["Abele"],
      "prefix": ["dr."]
    }
  ],
  "gender": "female",
  "birthDate": "1985-06-15",
  "telecom": [
    {
      "system": "phone",
      "value": "+62812345679",
      "use": "mobile"
    },
    {
      "system": "email",
      "value": "[email protected]",
      "use": "work"
    }
  ],
  "qualification": [
    {
      "identifier": [
        {
          "system": "https://fhir.kemkes.go.id/id/str",
          "value": "STR12345678"
        }
      ],
      "code": {
        "coding": [
          {
            "system": "http://terminology.kemkes.go.id/CodeSystem/profesi-tenaga-kesehatan",
            "code": "01",
            "display": "Dokter"
          }
        ]
      },
      "period": {
        "start": "2020-01-01",
        "end": "2025-12-31"
      },
      "issuer": {
        "display": "Konsil Kedokteran Indonesia"
      }
    }
  ]
}

Response

{
  "resourceType": "Practitioner",
  "id": "N10000001",
  "meta": {
    "versionId": "1",
    "lastUpdated": "2024-01-01T10:00:00.000+00:00"
  },
  "identifier": [
    {
      "use": "official",
      "system": "https://fhir.kemkes.go.id/id/nik",
      "value": "3271010101010002"
    },
    {
      "use": "official",
      "system": "https://fhir.kemkes.go.id/id/sip",
      "value": "446/SIP/DINKES-KB/2020"
    }
  ],
  "name": [
    {
      "use": "official",
      "family": "Rose",
      "given": ["Abele"],
      "prefix": ["dr."]
    }
  ],
  "gender": "female",
  "birthDate": "1985-06-15",
  "telecom": [
    {
      "system": "phone",
      "value": "+62812345679",
      "use": "mobile"
    },
    {
      "system": "email",
      "value": "[email protected]",
      "use": "work"
    }
  ],
  "qualification": [
    {
      "identifier": [
        {
          "system": "https://fhir.kemkes.go.id/id/str",
          "value": "STR12345678"
        }
      ],
      "code": {
        "coding": [
          {
            "system": "http://terminology.kemkes.go.id/CodeSystem/profesi-tenaga-kesehatan",
            "code": "01",
            "display": "Dokter"
          }
        ]
      },
      "period": {
        "start": "2020-01-01",
        "end": "2025-12-31"
      },
      "issuer": {
        "display": "Konsil Kedokteran Indonesia"
      }
    }
  ]
}

Identifier Systems

System	Description
https://fhir.kemkes.go.id/id/nik	Nomor Induk Kependudukan
https://fhir.kemkes.go.id/id/sip	Surat Izin Praktik
https://fhir.kemkes.go.id/id/str	Surat Tanda Registrasi
https://fhir.kemkes.go.id/id/sik	Surat Izin Kerja

Profesi Tenaga Kesehatan

Code	Display
01	Dokter
02	Dokter Gigi
03	Perawat
04	Bidan
05	Apoteker
06	Ahli Teknologi Laboratorium Medik
07	Radiografer
08	Fisioterapis
09	Ahli Gizi
10	Sanitarian
11	Terapis Wicara
12	Okupasi Terapis
13	Optometris
14	Ortotis Prostetis
15	Elektromedis
16	Teknisi Kardiovaskular
17	Perfusionis
18	Audiologis
19	Teknisi Transfusi Darah
20	Tenaga Promosi Kesehatan dan Ilmu Perilaku

Qualification Types

System	Description
http://terminology.kemkes.go.id/CodeSystem/profesi-tenaga-kesehatan	Profesi tenaga kesehatan
http://terminology.kemkes.go.id/CodeSystem/spesialisasi-dokter	Spesialisasi dokter
http://terminology.kemkes.go.id/CodeSystem/sub-spesialisasi-dokter	Sub-spesialisasi dokter

Search Parameters

Parameter	Type	Description
identifier	token	Pencarian berdasarkan identifier
name	string	Pencarian berdasarkan nama
given	string	Pencarian berdasarkan nama depan
family	string	Pencarian berdasarkan nama keluarga
gender	token	Pencarian berdasarkan jenis kelamin
qualification	token	Pencarian berdasarkan kualifikasi

Error Handling

Common Error Codes

• 400 Bad Request: Format data tidak sesuai
• 401 Unauthorized: Token tidak valid
• 404 Not Found: Practitioner tidak ditemukan
• 422 Unprocessable Entity: Validasi data gagal