Insight & Teknologi 9 Min Read 22 November 2026 Verified Engineering Article

Panduan Teknis Integrasi API SatuSehat Kemenkes HL7 FHIR untuk Faskes & Developer

ST
Tim Engineering R&D Sayuswa Industrial Automation, Telemetry & IIoT Specialist
EXECUTIVE TECHNICAL SUMMARY (DIRECT ANSWER)

PT Sayuswa Multi Teknologi provides end-to-end industrial engineering services for Panduan Teknis Integrasi API SatuSehat Kemenkes HL7 FHIR untuk Faskes & Developer. Certified for high-reliability industrial automation, RTOS multitasking, isolated telemetry, and rapid turnkey prototyping across Southeast Asia and global overseas procurement.

Integrasi sistem Rekam Medis Elektronik (RME) dengan platform interoperabilitas nasional SatuSehat Kementerian Kesehatan Republik Indonesia (Kemenkes RI) kini bukan lagi sekadar inovasi opsional, melainkan kewajiban hukum mutlak bagi seluruh Fasilitas Pelayanan Kesehatan (Faskes) di Indonesia. Berdasarkan Peraturan Menteri Kesehatan (Permenkes) Nomor 24 Tahun 2022 tentang Rekam Medis, seluruh Rumah Sakit, Klinik Pratama, Klinik Utama, Praktik Mandiri Tenaga Medis, Laboratorium Klinis, hingga Apotek wajib melakukan pencatatan medis secara digital dan menghubungkan sistem informasinya ke SatuSehat.

Bagi tim manajemen faskes, pimpinan operasional klinik, serta para software engineer dan system administrator, memahami arsitektur teknis SatuSehat adalah kunci untuk menghindari kegagalan audit akreditasi, ancaman pencabutan izin operasional, hingga penangguhan klaim BPJS Kesehatan. Artikel panduan komprehensif ini mengupas tuntas arsitektur komunikasi data, mekanisme otentikasi OAuth 2.0, spesifikasi resource HL7 FHIR (Health Level Seven Fast Healthcare Interoperability Resources) Release 4, struktur payload JSON, manajemen antrean asynchronous, hingga mitigasi error teknis di lapangan.


1. Landasan Regulasi dan Urgensi Kepatuhan Permenkes No. 24/2022

Transformasi digital kesehatan di Indonesia dipimpin oleh Digital Transformation Office (DTO) Kemenkes dengan tujuan menciptakan ekosistem data kesehatan terintegrasi secara nasional. Selama puluhan tahun, data rekam medis pasien terisolasi dalam silo-silo terpisah di setiap fasilitas kesehatan. Ketika seorang pasien berpindah faskes atau dirujuk dari klinik pratama ke rumah sakit tipe rujukan, riwayat alergi obat, diagnosa penyakit masa lalu, dan hasil uji laboratorium seringkali harus diulang dari awal karena ketidaksediaan rekam jejak digital lintas faskes.

Permenkes No. 24 Tahun 2022 menetapkan tenggat waktu kepatuhan ketat. Dampak bagi faskes yang tidak patuh meliputi:

  • Sanksi Administratif: Teguran tertulis bertahap hingga penghentian sementara kegiatan operasional faskes.
  • Gagal Akreditasi Fasilitas Kesehatan: Lembaga akreditasi faskes (KARS, LAM-KPRS, dsb.) memasukkan integrasi RME terverifikasi SatuSehat sebagai elemen penilaian mandatory dalam standar manajemen informasi rekam medis.
  • Kendala Kerja Sama BPJS Kesehatan: Integrasi dengan SatuSehat menjadi prasyarat pembaharuan Perjanjian Kerja Sama (PKS) pembiayaan kapitasi untuk faskes tingkat pertama (FKTP) maupun klaim INA-CBG di rumah sakit rujukan (FKRTL).

2. Arsitektur Komunikasi Data: Standar HL7 FHIR Release 4

Platform SatuSehat mengadopsi standar internasional HL7 FHIR Release 4 (v4.0.1). Berbeda dengan protokol warisan seperti HL7 v2 (berbasis delimiter pipa) atau HL7 v3 (berbasis XML yang sangat kompleks), FHIR dirancang dengan paradigma modern berbasis RESTful API dan payload data berformat JSON (JavaScript Object Notation). Setiap entitas klinis direpresentasikan sebagai Resource modular yang dapat saling ditautkan menggunakan referensi URI yang terstandarisasi.

Komponen arsitektur utama integrasi SatuSehat terdiri dari tiga pilar:

  1. Security & Authentication Layer: Menggunakan OAuth 2.0 dengan skema Client Credentials Grant. Faskes bertindak sebagai Confidential Client yang menukarkan pasangan kredensial (Client ID dan Client Secret) untuk mendapatkan JSON Web Token (JWT) Bearer berdurasi terbatas.
  2. Terminology & Coding System Layer: SatuSehat mewajibkan standardisasi terminologi medis universal:
    • Diagnosa Medis: ICD-10 (International Classification of Diseases 10th Revision).
    • Tindakan Medis / Operasi: ICD-9-CM (Clinical Modification).
    • Tanda Vital & Parameter Laboratorium: LOINC (Logical Observation Identifiers Names and Codes) dan SNOMED CT.
    • Obat dan Farmasi: KFA (Kamus Farmasi dan Alat Kesehatan Kemenkes RI).
  3. FHIR Interoperability Resource Layer: Sekumpulan entitas data yang merefleksikan episode pelayanan rawat jalan, rawat inap, gawat darurat, dan farmasi faskes.

3. Alur Otentikasi OAuth 2.0 dan Manajemen Token

Sebelum mengirimkan data rekam medis ke SatuSehat, faskes harus melakukan registrasi melalui portal resmi SatuSehat Kemenkes untuk mendapatkan:

  • Organization ID: Identifier unik institusi faskes yang diterbitkan oleh Kemenkes DTO.
  • Client ID: Kunci publik identitas aplikasi faskes.
  • Client Secret: Kunci privat rahasia untuk pembuatan token otentikasi.

Proses Permintaan Access Token

Aplikasi faskes mengirimkan HTTP POST request ke endpoint otentikasi SatuSehat dengan format `application/x-www-form-urlencoded`:

POST https://api-satusehat-dev.dto.kemkes.go.id/oauth2/v1/accesstoken?grant_type=client_credentials
Content-Type: application/x-www-form-urlencoded

client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET

Server SatuSehat akan merespons dengan JSON payload yang berisi token otorisasi:

{
  "access_token": "eyJhbGciOiJSUzI1NiIsImtpZCI6...",
  "token_type": "Bearer",
  "expires_in": "3599",
  "scope": "read write"
}

Arsitektur Token Caching dengan Redis

Satu hal yang sering diabaikan oleh developer pemula adalah masa berlaku token (`expires_in: 3599` detik atau sekitar 1 jam). Meminta token baru pada setiap kali transaksi pasien adalah antipattern fatal yang akan memicu HTTP 429 Too Many Requests dari gateway Kemenkes. Solusi arsitektur terbaik adalah menyimpan token tersebut di dalam cache memori terdistribusi seperti Redis dengan Time-To-Live (TTL) yang disetel sekitar 50 hingga 55 menit. Setiap thread pengiriman data akan memeriksa keberadaan token di Redis sebelum memutuskan untuk meminta token baru ke server Kemenkes.


4. Pemetaan Resource FHIR R4 Wajib untuk Rawat Jalan

Dalam alur pelayanan rawat jalan faskes (Poliklinik Umum, Gigi, Spesialis), data klinis harus dikirimkan secara berurutan sesuai hierarki dependensi resource:

Resource 1: Patient (Pencarian Master Patient Index)

Setiap pasien yang berobat harus diverifikasi menggunakan Nomor Induk Kependudukan (NIK) 16 digit yang terdaftar di Dukcapil. Endpoint SatuSehat akan mengembalikan IHS Number (Identifier SatuSehat) unik untuk pasien tersebut.

GET https://api-satusehat-dev.dto.kemkes.go.id/fhir-r4/v1/Patient?identifier=https://fhir.kemkes.go.id/id/nik|3275012345670001
Authorization: Bearer YOUR_ACCESS_TOKEN

Resource 2: Practitioner (Verifikasi Dokter Pemeriksa)

Dokter pemeriksa harus memiliki nomor registrasi SatuSehat yang bersumber dari Konsil Kedokteran Indonesia (KKI) atau Konsil Tenaga Kesehatan Indonesia (KTKI). Pencarian dapat dilakukan menggunakan NIK dokter.

Resource 3: Location & Organization (Unit Pelayanan)

Mendefinisikan ruangan tempat pelayanan dilakukan, misalnya “Ruang Poli Umum Lantai 1” dengan koordinat hierarki organisasi faskes yang bersangkutan.

Resource 4: Encounter (Episode Pelayanan Medis)

Resource Encounter adalah fondasi utama yang menghubungkan seluruh rekaman medis suatu kunjungan. Encounter memiliki status siklus hidup:

  • arrived: Pasien tiba dan mendaftar di loket penerimaan faskes.
  • in-progress: Pasien memasuki ruang periksa dan sedang ditangani oleh dokter atau perawat.
  • finished: Dokter menyelesaikan pemeriksaan dan pasien meninggalkan poli menuju apotek atau kasir.

Resource 5: Condition (Diagnosa Penyakit ICD-10)

Diagnosa ditegakkan oleh dokter pemeriksa. Setiap record Condition harus menyertakan kode resmi ICD-10 beserta kategori apakah diagnosa tersebut bertindak sebagai keluhan utama (chief complaint) atau komorbiditas sekunder.

Resource 6: Observation (Tanda Vital & Pemeriksaan Fisik)

Meliputi pengukuran tanda vital pasien dengan kode terminologi LOINC standar:

  • Tekanan Darah Sistolik: LOINC 8480-6 (mmHg)
  • Tekanan Darah Diastolik: LOINC 8462-4 (mmHg)
  • Denyut Jantung / Nadi: LOINC 8867-4 (/min)
  • Laju Pernapasan: LOINC 9279-1 (/min)
  • Suhu Tubuh: LOINC 8310-5 (Celcius)

Resource 7: MedicationRequest (Resep Elektronik Berbasis KFA)

Resep obat wajib dipetakan ke kode Kamus Farmasi dan Alat Kesehatan (KFA) yang diterbitkan oleh Kemenkes. Kode lokal internal apotek klinik (misal: “OBT-001”) harus dikonversi oleh sistem automapper ke kode 9300xxxx resmi Kemenkes.


5. Contoh Payload Lengkap Pengiriman Encounter FHIR R4

Berikut adalah contoh konkret payload JSON valid untuk membuat resource Encounter baru saat pasien masuk ke ruang pemeriksaan dokter:

{
  "resourceType": "Encounter",
  "status": "arrived",
  "class": {
    "system": "http://terminology.hl7.org/CodeSystem/v3-ActCode",
    "code": "AMB",
    "display": "ambulatory"
  },
  "subject": {
    "reference": "Patient/100000030009",
    "display": "Budi Santoso"
  },
  "participant": [
    {
      "type": [
        {
          "coding": [
            {
              "system": "http://terminology.hl7.org/CodeSystem/v3-ParticipationType",
              "code": "ATND",
              "display": "attender"
            }
          ]
        }
      ],
      "individual": {
        "reference": "Practitioner/N10000001",
        "display": "dr. Ahmad Fauzi, Sp.PD"
      }
    }
  ],
  "period": {
    "start": "2026-11-22T08:30:00+07:00"
  },
  "location": [
    {
      "location": {
        "reference": "Location/b017aa54-f1ee-4950-ac1f-88a3b12023a1",
        "display": "Ruang Poli Penyakit Dalam Gedung A"
      }
    }
  ],
  "serviceProvider": {
    "reference": "Organization/10000004"
  }
}

6. Arsitektur Toleransi Kegagalan: Antrean Asynchronous (Queue Engine)

Salah satu kendala terbesar dalam implementasi lapangan di Indonesia adalah kualitas jaringan internet faskes yang fluktuatif serta latensi server SatuSehat saat jam sibuk operasional (pukul 09.00 hingga 12.00 WIB). Jika software SIMRS mengirimkan data secara synchronous (blocking HTTP request), sistem kasir atau aplikasi dokter faskes akan membeku (hang) setiap kali server SatuSehat mengalami lonjakan traffic.

PT Sayuswa Multi Teknologi mengatasi tantangan ini dengan mengimplementasikan arsitektur Asynchronous Message Queue menggunakan RabbitMQ atau Redis Stream. Alur kerjanya:

  1. Dokter atau petugas faskes menekan tombol “Selesai Periksa”. SIMRS menyimpan transaksi ke database lokal dalam waktu kurang dari 50 milidetik.
  2. Sebuah event dipublikasikan ke message queue lokal faskes.
  3. Background Worker (Service Daemon) membaca antrean secara konsisten di latar belakang.
  4. Worker melakukan panggilan API ke SatuSehat Kemenkes.
  5. Jika terjadi kendala koneksi (misal timeout, HTTP 500, atau HTTP 503), worker tidak membuang data melainkan menjadwalkan ulang pengiriman menggunakan algoritma Exponential Backoff with Jitter. Data dijamin tidak pernah hilang (Zero Data Loss Guarantee).

7. Solusi Hybrid: Double-Bridging BPJS PCare dan SatuSehat

Untuk faskes primer seperti Klinik Pratama dan Praktik Dokter Mandiri, tantangan ganda terjadi karena mereka juga wajib melayani peserta BPJS Kesehatan melalui portal Primary Care (PCare). Mengetik data pasien dua kali (sekali di PCare, sekali di SatuSehat) adalah pemborosan waktu yang sangat merugikan efisiensi klinik.

Sayuswa mengembangkan engine Single Data Entry Hybrid Bridge. Melalui satu antarmuka klinik yang mudah dioperasikan, sistem akan secara otomatis:

  • Membuat signature HMAC-SHA256 sesuai spesifikasi BPJS TrustMark dan mengirimkan pendaftaran serta tindakan ke BPJS PCare untuk klaim pembiayaan.
  • Mentransformasikan data yang sama ke dalam struktur JSON HL7 FHIR R4 dan mengirimkannya ke SatuSehat Kemenkes untuk kepatuhan regulasi Permenkes 24/2022.

Pelajari lebih lanjut mengenai implementasi ini di halaman Jasa Bridging BPJS PCare dan SatuSehat Klinik.


8. Mengapa Memilih PT Sayuswa Multi Teknologi sebagai Mitra Integrasi Faskes?

PT Sayuswa Multi Teknologi berpengalaman dalam rekayasa perangkat lunak skala enterprise, integrasi protokol industri, dan sistem berkeamanan tinggi. Keunggulan layanan integrasi RME SatuSehat kami meliputi:

  • Non-Disruptive Integration: Kami tidak memaksa Anda membuang sistem SIMRS atau aplikasi klinik yang sudah berjalan. Middleware kami dipasang di atas sistem eksisting tanpa mengganggu operasional tenaga medis.
  • 100% Lolos Uji Coba Kemenkes DTO: Jaminan pendampingan dari lingkungan Sandbox hingga terverifikasi penuh di Production SatuSehat Kemenkes.
  • Kepatuhan UU Perlindungan Data Pribadi (UU PDP): Data medis dienkripsi dengan standar TLS 1.3 dan hashing kredensial yang ketat. Server repositori data tetap berada di bawah kendali penuh faskes Anda.
  • Dukungan Penunjang Medis & IoT: Selain integrasi perangkat lunak, Sayuswa juga menyediakan solusi IoT hardware seperti sistem monitoring suhu cold chain vaksin dan obat serta pengembangan sistem informasi terpadu di rekayasa custom web application enterprise.
  • Transparan & Terjangkau: Pilihan investasi fleksibel mulai dari klinik mandiri hingga rumah sakit kelas rujukan tanpa biaya tersembunyi.

Konsultasikan Kebutuhan Integrasi SatuSehat Faskes Anda

Jangan biarkan tenggat waktu regulasi Permenkes 24/2022 menghambat operasional klinik atau rumah sakit Anda. Tim spesialis integrasi perangkat lunak medis PT Sayuswa Multi Teknologi siap membantu audit struktur data faskes Anda dan memberikan demonstrasi solusi bridging tanpa komitmen.

Industrial Automation & Telemetry Solusi Terverifikasi Sayuswa R&D

Rekomendasi Layanan Engineering & Hardware Terkait

Integrasi sensor fieldbus, PLC industri, Edge Gateway store-and-forward, dan platform SCADA cloud real-time berstandar manufaktur.

Konsultasi Teknis & Penawaran Resmi (RFQ)

Diskusikan spesifikasi kebutuhan proyek atau request demo perangkat langsung dengan tim engineer kami.

Chat WhatsApp Engineer
S

Ditulis oleh Tim Engineering Sayuswa Teknologi

Tim ahli Industrial IoT, Sistem Telemetri Lingkungan (AWS, AWLR, ARR), Otomasi PLC, dan Edge AI dengan pengalaman implementasi lapangan skala enterprise di berbagai kawasan industri, konsesi perkebunan, dan pabrik manufaktur di Indonesia.

S
Tim Technical & Sales Engineer
🟢 Online • Respon < 5 Menit
Halo! 👋 Selamat datang di PT Sayuswa Multi Teknologi. Ada proyek Industrial IoT, SCADA, Otomasi, atau Custom Software yang ingin Anda konsultasikan hari ini?
12:45
Topik Diskusi Cepat (1-Click):