Organization Resource

Resource Organization digunakan untuk mengelola data organisasi dan fasilitas pelayanan kesehatan dalam ekosistem SATUSEHAT.

Endpoint

GET    /Organization
POST   /Organization
GET    /Organization/{id}
PUT    /Organization/{id}
PATCH  /Organization/{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: "Organization"
• identifier: Identifikasi unik organisasi
• active: Status aktif organisasi
• name: Nama organisasi

Optional Fields

• type: Tipe organisasi
• telecom: Informasi kontak
• address: Alamat organisasi
• partOf: Organisasi induk
• contact: Kontak person
• endpoint: Endpoint komunikasi

Contoh Request

POST /Organization

{
  "resourceType": "Organization",
  "identifier": [
    {
      "use": "official",
      "system": "http://sys-ids.kemkes.go.id/organization",
      "value": "8529d474-30e0-4fee-81a4-7a5234003a1b"
    }
  ],
  "active": true,
  "type": [
    {
      "coding": [
        {
          "system": "http://terminology.hl7.org/CodeSystem/organization-type",
          "code": "prov",
          "display": "Healthcare Provider"
        }
      ]
    }
  ],
  "name": "Rumah Sakit Umum Daerah Kabupaten Bogor",
  "telecom": [
    {
      "system": "phone",
      "value": "+62251123456",
      "use": "work"
    },
    {
      "system": "email",
      "value": "[email protected]",
      "use": "work"
    }
  ],
  "address": [
    {
      "use": "work",
      "line": ["Jl. Raya Citeureup No. 1"],
      "city": "Bogor",
      "state": "Jawa Barat",
      "postalCode": "16810",
      "country": "ID"
    }
  ]
}

Response

{
  "resourceType": "Organization",
  "id": "8529d474-30e0-4fee-81a4-7a5234003a1b",
  "meta": {
    "versionId": "1",
    "lastUpdated": "2024-01-01T10:00:00.000+00:00"
  },
  "identifier": [
    {
      "use": "official",
      "system": "http://sys-ids.kemkes.go.id/organization",
      "value": "8529d474-30e0-4fee-81a4-7a5234003a1b"
    }
  ],
  "active": true,
  "type": [
    {
      "coding": [
        {
          "system": "http://terminology.hl7.org/CodeSystem/organization-type",
          "code": "prov",
          "display": "Healthcare Provider"
        }
      ]
    }
  ],
  "name": "Rumah Sakit Umum Daerah Kabupaten Bogor",
  "telecom": [
    {
      "system": "phone",
      "value": "+62251123456",
      "use": "work"
    },
    {
      "system": "email",
      "value": "[email protected]",
      "use": "work"
    }
  ],
  "address": [
    {
      "use": "work",
      "line": ["Jl. Raya Citeureup No. 1"],
      "city": "Bogor",
      "state": "Jawa Barat",
      "postalCode": "16810",
      "country": "ID"
    }
  ]
}

Tipe Organisasi

Code	Display	Description
prov	Healthcare Provider	Penyedia layanan kesehatan
dept	Hospital Department	Departemen rumah sakit
team	Organizational team	Tim organisasi
govt	Government	Pemerintah
ins	Insurance Company	Perusahaan asuransi
pay	Payer	Pembayar
edu	Educational Institute	Institusi pendidikan
reli	Religious Institution	Institusi keagamaan
crs	Clinical Research Sponsor	Sponsor penelitian klinis
cg	Community Group	Kelompok masyarakat
bus	Non-Healthcare Business	Bisnis non-kesehatan
other	Other	Lainnya

Identifier Systems

System	Description
http://sys-ids.kemkes.go.id/organization	ID Organisasi SATUSEHAT
http://dvma.depkes.go.id	ID DVMA
http://bpjs-kesehatan.go.id	ID BPJS Kesehatan

Search Parameters

Parameter	Type	Description
identifier	token	Pencarian berdasarkan identifier
name	string	Pencarian berdasarkan nama
type	token	Pencarian berdasarkan tipe
active	token	Pencarian berdasarkan status aktif
address	string	Pencarian berdasarkan alamat
partof	reference	Pencarian berdasarkan organisasi induk

Error Handling

Common Error Codes

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

Example Error Response

{
  "resourceType": "OperationOutcome",
  "issue": [
    {
      "severity": "error",
      "code": "required",
      "details": {
        "text": "Missing required field: name"
      }
    }
  ]
}