Pengaturan SATUSEHAT

Pengaturan SATUSEHAT

Menu Pengaturan terdiri dari Sinkronisasi, Barang, Referensi, dan Tindakan. Bagian ini digunakan admin untuk menentukan data yang disinkronkan serta menjaga kecocokan kode lokal dengan terminologi SATUSEHAT.

⚠️ Perhatian — Batasi akses admin

Perubahan mapping dapat memengaruhi banyak transaksi dan resource. Catat perubahan, lakukan uji pada data terbatas, dan pastikan konsep klinisnya disetujui penanggung jawab terkait.

Sinkronisasi#

Layar Sinkronisasi menampilkan daftar proses, jenis resource, waktu terakhir dijalankan, dan status aktifnya.

Informasi pada daftar#

Cara memeriksa sinkronisasi#

1. Buka Pengaturan → Sinkronisasi.
2. Cari proses yang sesuai dengan resource bermasalah.
3. Periksa Tanggal Terakhir dan Status.
4. Aktifkan hanya proses yang memang digunakan rumah sakit.
5. Simpan perubahan.
6. Gunakan tombol muat ulang untuk memastikan nilai yang tersimpan sudah tampil.
7. Pantau hasilnya melalui Dashboard dan Monitoring.

🛑 Peringatan — Jangan mengaktifkan massal tanpa verifikasi

Mengaktifkan banyak proses sekaligus dapat membentuk antrean besar dan mengirim data yang mapping-nya belum siap. Verifikasi master, terminologi, serta dependensi resource terlebih dahulu.

Barang#

Mapping Barang menghubungkan master obat/produk farmasi SIMGOS dengan kode yang dipakai SATUSEHAT, termasuk KFA sesuai implementasi.

Layar terdiri dari tiga bagian:

Cara mapping barang ke KFA#

1. Cari obat pada panel Master Barang.
2. Pilih satu barang dan pastikan nama, kekuatan, bentuk sediaan, serta satuannya benar.
3. Cari produk pada panel Master KFA (SATU SEHAT).
4. Pilih KFA yang benar. Aplikasi akan mengambil informasi produk dan mengisi mapping yang tersedia.
5. Periksa POA (Produk Obat Aktual) dan POV (Produk Obat Virtual).
6. Periksa Rute Pemberian dan Bentuk Sediaan.
7. Periksa daftar BZA atau zat aktif, termasuk dosis KFA, satuan KFA, dosis per satuan, dan satuan lokal.
8. Klik Simpan.
9. Buka ulang barang tersebut untuk memastikan mapping tersimpan.

Field mapping KFA#

Periksa hal berikut:

• kode dan nama barang lokal;
• status aktif barang;
• kode KFA/BZA/POA/POV yang benar sesuai jenis produk;
• bentuk sediaan, kekuatan, satuan, dan kemasan;
• tidak ada lebih dari satu mapping aktif yang saling bertentangan.

🛑 Peringatan — Jangan memilih KFA hanya dari kemiripan nama

Produk dengan nama serupa dapat memiliki kekuatan, bentuk sediaan, rute, kemasan, POA, POV, atau BZA yang berbeda. Jika hasil pencarian KFA kosong, periksa koneksi dan layanan referensi; jangan mengisi kode dengan perkiraan.

Referensi#

Mapping Referensi digunakan untuk kode umum atau terminologi yang tidak langsung berasal dari master barang/tindakan.

Layar Referensi memiliki dua panel:

Contoh Code Reference adalah Encounter.class dengan system http://terminology.hl7.org/CodeSystem/v3-ActCode. Nilai yang tersedia pada Type Code Reference dapat berupa AMB, EMER, dan IMP.

Cara memeriksa Referensi#

1. Cari resource atau entity pada panel Code Reference.
2. Pilih baris yang akan diperiksa.
3. Periksa daftar nilai pada panel Type Code Reference.
4. Klik ikon edit pada nilai yang perlu diperbaiki.
5. Periksa Kode, Display, System, dan status Aktif.
6. Simpan hanya setelah kode dan system URI sesuai spesifikasi resource.

Periksa hal berikut:

• jenis referensi (TypeCodeReference);
• kode lokal dan kode tujuan (CodeReference);
• system URI dan display;
• status aktif;
• kesesuaian konsep, bukan hanya kemiripan nama.

⚠️ Perhatian — Code Reference dan Type Code Reference berbeda

Code Reference menentukan lokasi pemakaian kode pada resource. Type Code Reference menyimpan nilai yang boleh dipakai. Jangan memindahkan kode antar-resource hanya karena display terlihat sama.

Tindakan#

Mapping Tindakan menghubungkan tindakan pelayanan atau pemeriksaan SIMGOS dengan terminologi yang dibutuhkan resource, misalnya ICD-9-CM, SNOMED CT, atau LOINC sesuai use case.

Mapping tindakan Laboratorium#

Pilih Laboratorium pada combobox jenis tindakan. Daftar menampilkan ID tindakan, informasi KPTL, nama tindakan, kategori, dan tombol Mapping.

Menu Mapping menyediakan:

• Tindakan To Loinc untuk mapping pemeriksaan induk;
• Paramter To Loinc untuk mapping setiap parameter hasil. Penulisan Paramter mengikuti label aplikasi.

Tindakan Laboratorium ke LOINC#

1. Pilih Mapping → Tindakan To Loinc.
2. Cari dan pilih LOINC yang mewakili pemeriksaan induk.
3. Pilih spesimen yang benar.
4. Pilih kategori pemeriksaan.
5. Klik Simpan dan buka kembali dialog untuk memastikan mapping tersimpan.

Parameter Laboratorium ke LOINC#

Setiap parameter hasil harus dipasangkan dengan konsep LOINC yang sesuai:

1. Pilih Mapping → Paramter To Loinc.
2. Klik tombol tambah untuk menambahkan parameter yang belum ada.
3. Pilih parameter hasil lokal.
4. Pilih kode LOINC yang tepat untuk parameter tersebut.
5. Aktifkan hanya mapping yang digunakan.
6. Klik Simpan.

Jangan menggunakan satu kode LOINC untuk beberapa parameter dengan konsep berbeda. Perhatikan komponen, spesimen, property, timing, scale, dan method pada LOINC.

Mapping tindakan Radiologi#

Pilih Radiologi pada combobox jenis tindakan. Pada implementasi saat ini, tindakan Radiologi menyediakan Tindakan To Loinc dan tidak menampilkan mapping parameter hasil.

1. Pilih tindakan Radiologi.
2. Klik Mapping → Tindakan To Loinc.
3. Pilih LOINC yang benar-benar mewakili modalitas, anatomi, proyeksi, dan jenis pemeriksaan.
4. Klik Simpan.
5. Pastikan mapping sesuai resource yang dibentuk, misalnya ServiceRequest, Observation/DiagnosticReport, atau ImagingStudy sesuai alur implementasi.

⚠️ Perhatian — Nilai pada capture adalah data demo

Kode yang terlihat pada capture menggambarkan cara kerja layar, bukan rekomendasi mapping klinis. Validasi setiap LOINC bersama penanggung jawab Laboratorium/Radiologi sebelum digunakan.

Checklist mapping tindakan#

Periksa hal berikut:

• tindakan lokal yang benar;
• jenis layanan dan resource tujuan;
• kode terminologi dan display;
• parameter hasil serta satuan untuk pemeriksaan;
• satu mapping aktif untuk satu konteks yang sama.

Urutan konfigurasi yang disarankan#

1. Pastikan environment, Organization ID, URL, dan kredensial SATUSEHAT dikonfigurasi melalui mekanisme aman.
2. Lengkapi Referensi umum.
3. Lengkapi mapping Tindakan dan parameter hasil.
4. Lengkapi mapping Barang farmasi.
5. Validasi master Organization, Location, Practitioner, dan Patient.
6. Aktifkan Sinkronisasi secara bertahap.
7. Periksa Dashboard, Monitoring, dan respons pengiriman.

🛑 Peringatan — Rahasiakan konfigurasi koneksi

Jangan menampilkan Client ID, client secret, token, atau URL internal pada capture panduan. Simpan dan bagikan konfigurasi hanya melalui kanal resmi yang ditetapkan rumah sakit.