Memetakan data RME ke resource FHIR SATUSEHAT

Mulai dari satu tahap pelayanan

Jangan langsung mengubah seluruh tabel pasien menjadi satu JSON. Tentukan pelayanan, tahap kunjungan dan versi panduan yang menjadi acuan. Satu kolom lokal dapat memerlukan kode atau referensi ke data lain sebelum dapat dikirim.

Contoh ini memilih pendaftaran kunjungan rawat jalan, dengan acuan playbook Rawat Jalan v6.3, 30 Oktober 2025, yang terlihat pada pemeriksaan 5 Oktober 2026. Riwayat versi modul berbeda dari nomor versi portal. Periksa lagi sebelum implementasi, terutama bila spesifikasi berubah.

FHIR adalah format pertukaran data; resource adalah jenis data terstruktur. Encounter menggambarkan kunjungan, sedangkan Patient, Practitioner, Location dan Organization menjadi rujukan pasien, petugas, tempat dan fasilitas. Tahap pendaftaran bukan seluruh alur rawat jalan: diagnosis, tindakan, obat dan penutupan kunjungan mempunyai kebutuhan berikutnya.

Tentukan asal dan arti setiap nilai

Gunakan lembar pemetaan RME ke FHIR untuk mencatat satu elemen tujuan per baris. Contoh berikut hanya bagian yang dibahas, bukan daftar seluruh elemen wajib.

Data asal	Tujuan dan pemeriksaan
Nomor kunjungan	Encounter.identifier: namespace fasilitas dan nomor yang stabil; jangan memakai nomor antrian yang berulang setiap hari.
Status pelayanan	Encounter.status: cocokkan tahap kedatangan atau pelayanan dengan kode resmi; jangan menandai selesai sebelum benar-benar selesai.
Jenis kunjungan	Encounter.class: rawat jalan memakai kode AMB dalam pemetaan resmi. Bedakan dari kode poli atau jenis pembayaran.
Pasien dan petugas	subject dan participant: rujukan ke resource yang benar, bukan nama bebas atau ID tabel yang dianggap sudah dikenal server.
Waktu pelayanan	period: asal timestamp, zona waktu dan tahap yang dicatat harus jelas. Jangan mengisi waktu kosong dengan waktu pengiriman.
Poli dan fasilitas	location dan serviceProvider: cocokkan rujukan tempat serta organisasi dengan fasilitas yang mengirim.

Versi v6.3 menambahkan pemetaan Encounter.serviceType.coding. Kode perlu dicocokkan dengan terminologi resmi yang dirujuk modul; jangan mengarang kode dari singkatan poli. Tinjau pula elemen wajib, extension dan aturan resource yang tidak tercakup tabel ini.

Coba pemeriksaan lokal dengan data buatan

Unduh contoh lokal data RME (.zip). Paket berisi petunjuk, kode Python tanpa dependensi tambahan dan hasil aktual observed.json. Jalankan python3 health-data-lab.py setelah ekstraksi bila ingin mengulang pemeriksaan; tidak ada koneksi jaringan atau kredensial.

Dari 22 observasi paket, delapan memeriksa bagian pendaftaran: kode AMB, referensi pasien, nomor stabil, fasilitas salah, referensi hilang, referensi lintas fasilitas, waktu tanpa zona dan status di luar tahap contoh. Semua hasil sesuai harapan pada 5 Oktober 2026. Status finished ditolak oleh contoh tahap pendaftaran ini, bukan dinyatakan selalu salah pada seluruh lifecycle FHIR.

ID LOCAL-* dan namespace urn:kompli:local-demo hanya simbol lokal. Payload sengaja tidak lengkap: terminologi serviceType, profil, extension dan seluruh alur klinis belum divalidasi. Jangan mengunggah payload contoh ini ke SATUSEHAT. Pemeriksaan lokal tidak membuktikan resource diterima, identitas cocok atau catatan klinis benar.

Lanjutkan ke sandbox resmi

Endpoint pembuatan Encounter pada dokumentasi memakai FHIR R4, Bearer token dan JSON. Ikuti katalog API resmi serta playbook untuk payload lengkap dan resource pendukung. Gunakan HTTPS dengan verifikasi sertifikat; jangan menonaktifkan verifikasi TLS untuk melewati kendala koneksi.

Sebelum mengirim, siapkan akses yang diizinkan, identitas uji resmi serta rujukan resource yang dapat diselesaikan dalam lingkungan yang sama. Jangan menyalin token produksi atau data pasien ke sandbox. Simpan ringkasan respons, ID hasil, waktu, versi modul dan hasil pemeriksaan relasi tanpa rahasia.

Pengiriman ke sandbox SATUSEHAT belum dijalankan dalam contoh Kompli ini. Tidak ada klaim respons sukses dari server, bukti registrasi sistem atau persetujuan akses produksi. Jika respons gagal, bedakan kesalahan format, referensi, terminologi dan akses; jangan mengulang kirim tanpa menelusuri hasil sebelumnya.

Bawa hasil uji ke operasi

Untuk tiap kolom, catat aturan perubahan, pemilik dan hasil yang masih belum terbukti. Minta petugas rekam medis meninjau makna serta kelengkapan data; validasi JSON tidak dapat menentukan apakah tindakan klinis benar-benar dilakukan.

Setelah uji resmi, hubungkan nomor lokal dengan ID resource hasil dan siapkan monitoring pengiriman. Saat modul, sistem atau kode berubah, jalankan ulang skenario yang terdampak. Persiapan integrasi tetap menjadi panduan registrasi dan akses, bukan halaman ini.