Encounter Resource

Resource Encounter digunakan untuk mengelola data kunjungan pasien ke fasilitas pelayanan kesehatan dalam ekosistem SATUSEHAT.

Endpoint

GET    /Encounter
POST   /Encounter
GET    /Encounter/{id}
PUT    /Encounter/{id}
PATCH  /Encounter/{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: "Encounter"
• status: Status kunjungan (planned, arrived, in-progress, finished)
• class: Klasifikasi kunjungan
• subject: Referensi ke Patient
• participant: Tenaga kesehatan yang terlibat
• period: Periode waktu kunjungan
• serviceProvider: Referensi ke Organization

Optional Fields

• identifier: Identifikasi unik kunjungan
• type: Tipe kunjungan
• priority: Prioritas kunjungan
• reasonCode: Alasan kunjungan
• diagnosis: Diagnosis terkait kunjungan
• hospitalization: Informasi rawat inap

Contoh Request

POST /Encounter

{
  "resourceType": "Encounter",
  "identifier": [
    {
      "system": "http://sys-ids.kemkes.go.id/encounter/8529d474-30e0-4fee-81a4-7a5234003a1b",
      "value": "P20240001"
    }
  ],
  "status": "finished",
  "class": {
    "system": "http://terminology.hl7.org/CodeSystem/v3-ActCode",
    "code": "AMB",
    "display": "ambulatory"
  },
  "subject": {
    "reference": "Patient/100000030009",
    "display": "John Doe"
  },
  "participant": [
    {
      "type": [
        {
          "coding": [
            {
              "system": "http://terminology.hl7.org/CodeSystem/v3-ParticipationType",
              "code": "ATND",
              "display": "attender"
            }
          ]
        }
      ],
      "individual": {
        "reference": "Practitioner/N10000001",
        "display": "dr. Abele Rose"
      }
    }
  ],
  "period": {
    "start": "2024-01-01T07:00:00+00:00",
    "end": "2024-01-01T08:00:00+00:00"
  },
  "serviceProvider": {
    "reference": "Organization/8529d474-30e0-4fee-81a4-7a5234003a1b"
  }
}

Response

{
  "resourceType": "Encounter",
  "id": "693c4ac9-c79a-44c0-b8bc-37126c3bf6db",
  "meta": {
    "versionId": "1",
    "lastUpdated": "2024-01-01T10:00:00.000+00:00"
  },
  "identifier": [
    {
      "system": "http://sys-ids.kemkes.go.id/encounter/8529d474-30e0-4fee-81a4-7a5234003a1b",
      "value": "P20240001"
    }
  ],
  "status": "finished",
  "class": {
    "system": "http://terminology.hl7.org/CodeSystem/v3-ActCode",
    "code": "AMB",
    "display": "ambulatory"
  },
  "subject": {
    "reference": "Patient/100000030009",
    "display": "John Doe"
  },
  "participant": [
    {
      "type": [
        {
          "coding": [
            {
              "system": "http://terminology.hl7.org/CodeSystem/v3-ParticipationType",
              "code": "ATND",
              "display": "attender"
            }
          ]
        }
      ],
      "individual": {
        "reference": "Practitioner/N10000001",
        "display": "dr. Abele Rose"
      }
    }
  ],
  "period": {
    "start": "2024-01-01T07:00:00+00:00",
    "end": "2024-01-01T08:00:00+00:00"
  },
  "serviceProvider": {
    "reference": "Organization/8529d474-30e0-4fee-81a4-7a5234003a1b"
  }
}

Status Encounter

Status	Description
planned	Kunjungan direncanakan
arrived	Pasien sudah tiba
triaged	Pasien sedang dalam triase
in-progress	Kunjungan sedang berlangsung
onleave	Pasien meninggalkan sementara
finished	Kunjungan selesai
cancelled	Kunjungan dibatalkan

Class Encounter

Code	Display	Description
AMB	ambulatory	Rawat jalan
EMER	emergency	Unit gawat darurat
FLD	field	Kunjungan lapangan
HH	home health	Perawatan di rumah
IMP	inpatient encounter	Rawat inap
ACUTE	inpatient acute	Rawat inap akut
NONAC	inpatient non-acute	Rawat inap non-akut
OBSENC	observation encounter	Observasi
PRENC	pre-admission	Pra-admisi
SS	short stay	Tinggal singkat
VR	virtual	Virtual/telemedicine

Search Parameters

Parameter	Type	Description
patient	reference	Pencarian berdasarkan pasien
date	date	Pencarian berdasarkan tanggal
status	token	Pencarian berdasarkan status
class	token	Pencarian berdasarkan class
type	token	Pencarian berdasarkan tipe

Error Handling

Common Error Codes

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