6 Penyebab FHIR Bundle Ditolak SatuSehat dan Cara Memperbaikinya

Bundle FHIR yang dikirim RS ke SatuSehat gagal tervalidasi biasanya karena satu dari enam sebab teknis: Organization ID tidak terdaftar, Encounter tanpa referensi Location yang valid, Practitioner tanpa IHS Number yang sesuai, mapping terminologi (ICD-10/ICD-9-CM/KFA) yang keliru, token OAuth2 kedaluwarsa, atau efek berantai dari satu resource gagal yang menyeret modul lain. Mengetahui titik gagal ini jauh lebih cepat daripada menebak-nebak dari log error yang panjang.

Bagi Direktur RS, ini bukan sekadar masalah IT. Kelengkapan data SatuSehat adalah salah satu indikator yang diperiksa surveyor akreditasi dan menjadi syarat interoperabilitas yang diwajibkan regulasi rekam medis elektronik. RS yang datanya konsisten gagal terkirim—tanpa pernah tahu alasannya—berisiko kena teguran administratif dan kehilangan basis data klinis yang seharusnya mendukung keputusan manajemen.

Apa itu FHIR Bundle dan kenapa validasinya ketat

FHIR Bundle adalah satu paket transaksi berisi beberapa resource klinis—Encounter, Condition, Procedure, MedicationRequest, dan lainnya—yang dikirim RS ke SatuSehat dalam satu kali panggilan API. SatuSehat memvalidasi setiap resource di dalam Bundle terhadap Implementation Guide-nya sebelum data disimpan; satu resource yang gagal referensi atau format bisa menggagalkan seluruh entry yang berkaitan.

Validasi ini ketat karena SatuSehat berfungsi sebagai rujukan identitas tunggal (RS, dokter, pasien) di seluruh sistem kesehatan nasional. Jika Organization atau Practitioner yang direferensikan tidak valid, data klinis yang menumpang di atasnya kehilangan konteks yang bisa dipertanggungjawabkan—karena itu, SatuSehat menolaknya di gerbang validasi, bukan membiarkannya masuk lalu dibersihkan belakangan.

6 Penyebab Umum FHIR Bundle Ditolak

Dari pola kegagalan yang berulang di lapangan, enam penyebab berikut mencakup sebagian besar kasus penolakan Bundle oleh SatuSehat.

1. Organization ID tidak valid atau belum terdaftar

Setiap resource klinis yang dikirim RS harus mereferensikan ID Organization yang sudah terdaftar resmi di SatuSehat. ID ini berfungsi sebagai identitas institusi di seluruh ekosistem data kesehatan nasional—jika salah ketik, belum aktif, atau masih memakai ID lama dari migrasi sistem, seluruh Bundle yang mereferensikannya otomatis ditolak sejak awal.

2. Encounter tanpa referensi Location yang valid

Encounter wajib mereferensikan Location yang sudah terdaftar dan sesuai kelas layanan (rawat jalan, rawat inap, IGD). Kesalahan umum: Location dikirim dengan ID ruangan internal SIMRS yang belum dipetakan ke Location SatuSehat, atau extension kelas layanan tidak diisi. Karena Encounter adalah resource yang paling banyak direferensikan resource lain, kegagalan di titik ini punya efek berantai paling luas.

3. Practitioner tanpa IHS Number yang sesuai

Practitioner (dokter, perawat) harus mereferensikan IHS Number yang valid dan aktif. IHS Number menjadi referensi wajib pada Encounter dan MedicationRequest; jika dokter belum terdaftar, masih berstatus tidak aktif, atau ID-nya tertukar dengan staf lain, resource yang mereferensikannya ditolak.

4. Mapping terminologi yang keliru

Kepmenkes HK.01.07/MENKES/1423/2022 tentang standar variabel dan metadata rekam medis elektronik mencantumkan ICD-10, ICD-9-CM, SNOMED CT, LOINC, dan Kamus Farmasi dan Alat Kesehatan (KFA) sebagai terminologi wajib untuk interoperabilitas data kesehatan. Diagnosis harus dipetakan ke ICD-10, tindakan/prosedur ke ICD-9-CM, dan data obat ke kode KFA—bukan kode internal SIMRS. Mapping yang tidak sinkron dengan versi terminologi terbaru adalah salah satu penyebab penolakan yang paling sering luput dari perhatian tim IT, karena errornya sering muncul di level value, bukan struktur resource.

5. Token OAuth2 kedaluwarsa atau versi FHIR tidak sesuai

Integrasi SatuSehat memakai autentikasi OAuth2 dengan token yang punya masa berlaku terbatas. Token yang tidak diperbarui otomatis menyebabkan seluruh request ditolak di level autentikasi, bukan validasi data—gejalanya sering disalahartikan sebagai masalah konten Bundle, padahal akar masalahnya di lapisan koneksi. Format resource yang mengikuti versi Implementation Guide lama, sementara SatuSehat sudah memperbarui skemanya, menimbulkan gejala serupa.

6. Efek berantai: satu resource gagal, modul lain ikut gagal diam-diam

Bila Encounter dalam satu episode gagal terbentuk, seluruh resource yang mereferensikannya—Condition, Procedure, MedicationRequest—ikut gagal terkirim meski datanya sudah lengkap di RME. Yang membuat ini berbahaya: status pengiriman di level dashboard sering tetap terlihat "berjalan" karena modul Encounter terkirim normal, sementara modul lain gagal secara diam-diam tanpa notifikasi yang mencolok.

Cara Mendiagnosis Kegagalan lewat OperationOutcome

Setiap respons API SatuSehat yang gagal menyertakan OperationOutcome—objek FHIR standar yang memuat detail resource dan elemen mana yang ditolak, bukan sekadar kode status HTTP. Tim IT RS perlu membaca isi OperationOutcome ini secara rutin, bukan hanya mengecek apakah response code-nya sukses.

Langkah diagnosis yang efektif: (1) cek OperationOutcome pada request yang gagal untuk tahu resource dan field spesifik yang bermasalah, (2) validasi silang Organization, Location, dan Practitioner ID yang direferensikan terhadap daftar yang terdaftar di SatuSehat, (3) periksa mapping kode ICD-10/ICD-9-CM/KFA terhadap versi terminologi yang berlaku, dan (4) pastikan token OAuth2 masih aktif sebelum menyalahkan struktur data.

Checklist Pencegahan untuk Direktur RS

Mencegah kegagalan berulang bukan hanya tugas tim IT—Direktur RS perlu memastikan tiga hal berjalan sebagai bagian dari tata kelola data, bukan proyek sekali jalan:

• Audit kelengkapan data berkala, bukan hanya status koneksi "terhubung". Bandingkan jumlah Encounter yang terkirim dengan jumlah Condition dan MedicationRequest yang menyertainya—selisih besar menandakan ada modul yang gagal diam-diam.
• Validasi ID referensi sebelum go-live modul baru. Setiap kali RS menambah unit layanan atau praktisi baru, pastikan ID Organization/Location/Practitioner sudah terdaftar dan sinkron di SatuSehat sebelum modul tersebut mulai mengirim data produksi.
• Jadwalkan pembaruan mapping terminologi setiap ada revisi kode ICD atau KFA, agar SIMRS tidak terus memakai mapping lama yang sudah tidak sesuai standar.

Dampak bagi RS yang Gagal Mengatasi Penolakan Berulang

Kegagalan pengiriman data yang dibiarkan berlarut-larut berdampak langsung pada kepatuhan RS. Permenkes 24/2022 tentang Rekam Medis mewajibkan fasilitas pelayanan kesehatan menyelenggarakan rekam medis elektronik yang terintegrasi—kelengkapan data yang rendah ke SatuSehat menjadi indikator kepatuhan yang bisa diperiksa dalam proses akreditasi maupun pengawasan Kemenkes. RS yang datanya konsisten tidak lengkap berisiko mendapat catatan ketidaksesuaian saat survei, terlepas dari seberapa baik dokumentasi klinis internal mereka sebenarnya.

FAQ

Apa itu FHIR Bundle dalam konteks SatuSehat?

FHIR Bundle adalah paket berisi satu atau lebih resource klinis (Encounter, Condition, MedicationRequest, dan sejenisnya) yang dikirim RS ke SatuSehat dalam satu transaksi API. Bundle yang tidak lengkap atau salah referensi akan ditolak oleh validator SatuSehat sebelum data tersimpan.

Kenapa modul Encounter paling sering jadi sumber kegagalan?

Encounter adalah resource inti yang direferensikan hampir semua resource klinis lain (Condition, Procedure, MedicationRequest). Jika Encounter gagal tervalidasi—biasanya karena referensi Location atau Organization yang tidak valid—seluruh modul yang bergantung padanya ikut gagal terkirim meski datanya sudah ada di RME.

Bagaimana cara RS tahu kegagalan pengiriman yang "diam-diam"?

RS perlu membaca OperationOutcome pada setiap respons API—bukan hanya status HTTP sukses di level Encounter. Dashboard kelengkapan data SatuSehat juga menunjukkan modul mana yang gap-nya besar dibanding Encounter yang terkirim, sehingga kegagalan diam-diam pada Condition atau Medication bisa terdeteksi lebih awal.

Dasar Hukum

• Permenkes 24/2022 tentang Rekam Medis — mewajibkan setiap fasilitas pelayanan kesehatan menyelenggarakan rekam medis elektronik yang terintegrasi dengan platform data kesehatan nasional.
• Kepmenkes HK.01.07/MENKES/1423/2022 tentang Standar Variabel dan Metadata Rekam Medis Elektronik — menetapkan ICD-10, ICD-9-CM, SNOMED CT, LOINC, dan Kamus Farmasi dan Alat Kesehatan (KFA) sebagai terminologi wajib untuk interoperabilitas data kesehatan, termasuk pertukaran data berbasis HL7 FHIR.
• UU 17/2023 tentang Kesehatan, Pasal 4 huruf (i) — menetapkan hak atas kerahasiaan data kesehatan pribadi yang menjadi dasar pengamanan data pada platform SatuSehat.

Sumber

• Kepmenkes HK.01.07/MENKES/1423/2022 tentang Standar Variabel dan Metadata Penyelenggaraan Rekam Medis Elektronik (dikutip Hukumonline)
• Permenkes 24/2022 tentang Rekam Medis
• Dokumentasi resmi SatuSehat — Konsep Resource dan Terminologi, Katalog Modul Interoperabilitas (dokumentasisatusehat.dto.kemkes.go.id)
• UU 17/2023 tentang Kesehatan