📑🔄🗂️

Artikel 6 dari 16 | Seri Pertukaran Informasi Kesehatan

Biar Tak Salah Tafsir: Dokumentasi Pertukaran dan Cara Menyusun Struktur Data Sederhana

Dua sistem bisa saling kirim data tanpa error, tapi tetap saling salah paham. Belajar menuliskan "kesepakatan" itu supaya data pasien dibaca sama persis di kedua ujung.

Dokumentasi Pertukaran Data Struktur Data Mapping JSON

±9 menit

Estimasi baca

Dasar

Level

2026

Tahun

Bayangkan kamu mengirim data pasien dari puskesmasmu ke rumah sakit rujukan. Di sistemmu, kolom jk berisi angka 1 untuk laki-laki dan 2 untuk perempuan. Di sistem penerima, aturannya terbalik. Data terkirim sukses, tidak ada pesan error, tapi pasien perempuan mendadak tercatat sebagai laki-laki. Masalah semacam ini yang dicegah oleh dokumentasi pertukaran data: catatan tertulis tentang apa isi data, bagaimana formatnya, dan siapa yang bertanggung jawab. Artikel ini untuk kamu, mahasiswa D3 RMIK semester 3, yang sebentar lagi mengurus data pasien lintas unit dan lintas fasilitas. Di akhir, kamu bisa menyusun dokumentasi struktur data sederhana sendiri.

Capaian pembelajaran (RM5306 Pertukaran Informasi Kesehatan, Sub-CPMK T3): menerapkan prinsip dokumentasi pertukaran dan membuat dokumentasi struktur data sederhana. Artikel ini bagian dari rangkaian Keamanan dan Perlindungan Data dalam seri 16 artikel.

Apa Itu Dokumentasi Pertukaran Data dan Kenapa Kamu Perlu Peduli?

Coba ingat resep nenek: "garam secukupnya, masak sampai matang". Dua orang yang memakai resep itu bisa menghasilkan rasa yang jauh berbeda. Resep restoran justru menulis "1 sendok teh garam, 12 menit, api sedang". Hasilnya bisa diulang siapa saja. Pertukaran data bekerja dengan logika yang sama. Data adalah masakannya, dokumentasi adalah resep bakunya.

📌 Konsep Utama (definisi kerja di artikel ini)

Dokumentasi pertukaran data = Tujuan + Pihak + Struktur + Aturan Format + Mapping + Versi

Dokumen tertulis yang menjelaskan data apa yang dipertukarkan, antara siapa, dengan struktur dan aturan apa, supaya pengirim dan penerima menafsirkan data dengan cara yang sama.

Kenapa ini penting untuk perekam medis? Rekam medis elektronik diatur dalam Permenkes No. 24 Tahun 2022 tentang Rekam Medis, termasuk tuntutan agar sistem bisa saling terhubung dan datanya terlindungi (rujuk pasal rinci langsung ke naskah regulasi; nomor pasal perlu diverifikasi). Data kesehatan juga masuk kategori data pribadi yang lebih sensitif dalam UU No. 27 Tahun 2022 tentang Pelindungan Data Pribadi (nomor pasal perlu diverifikasi). Artinya, salah tafsir bukan sekadar masalah teknis. Salah tafsir bisa menjadi masalah mutu pelayanan dan masalah hukum.

🔥 Fakta Menarik

Tulisan 03/04/2026 dibaca sebagai 3 April di Indonesia, tapi sebagai 4 Maret di sistem berformat Amerika. Karena itu standar ISO 8601 menetapkan urutan tahun-bulan-hari: 2026-04-03. Satu baris dalam dokumentasi pertukaran data bisa menghapus kebingungan ini.

Prinsip Dokumentasi Pertukaran Data: Enam Pegangan Praktis

Tidak ada satu dokumen sakti yang berlaku untuk semua kasus. Tapi ada enam pegangan yang bisa kamu pakai untuk menguji apakah dokumentasimu sudah layak. Ini rangkuman praktis penulis untuk keperluan belajar, bukan kutipan dari satu standar tertentu.

Prinsip	Artinya	Contoh pada data pasien
Jelas	Satu kolom, satu makna	"tanggal_lahir" berisi tanggal lahir, bukan tanggal daftar
Lengkap	Tipe, format, wajib/opsional tertulis	Nomor RM: teks, 14 karakter, wajib
Konsisten	Istilah dan format sama di seluruh dokumen	Semua tanggal memakai YYYY-MM-DD
Terversi	Setiap perubahan punya nomor versi dan tanggal	Versi 1.1: kolom "no_hp" ditambahkan
Dapat ditelusuri	Ada penanggung jawab dan asal data	Pemilik data: Unit Rekam Medis, kontak tertera
Dapat diuji	Ada contoh data yang bisa dicoba	Contoh payload fiktif tersedia

💡 Tips

Selalu tulis contoh nilai nyata di samping setiap kolom. Kalimat "format tanggal standar" bisa ditafsirkan macam-macam, tapi 1990-04-03 hanya punya satu tafsir.

⚡ Insight Penting

Anggap dokumentasi sebagai kontrak antara dua sistem. Standar seperti HL7 FHIR bekerja dengan cara ini: setiap sumber daya, misalnya Patient, punya daftar elemen, tipe data, dan aturan isian yang tertulis publik. Kamu tidak perlu langsung memakai FHIR, tapi kebiasaan menulis "kontrak" itu bisa kamu mulai dari struktur data sederhana.

Menyusun Struktur Data Sederhana untuk Dokumentasi Pertukaran Data

Struktur data adalah cara kita menata data supaya bisa dibaca mesin dan manusia. Pikirkan formulir pendaftaran: ada kotak nama, kotak tanggal lahir, dan kotak alamat, dan setiap kotak punya aturan isi. Berikut lima langkah menyusunnya. Kamu bisa langsung praktik dengan data fiktif.

Tentukan tujuan dan pihak yang bertukar.
Tulis satu kalimat: data apa, dari siapa, untuk apa. Contoh: "Puskesmas Contoh mengirim ringkasan kunjungan ke RS Rujukan Contoh untuk keperluan rujukan."

Inventarisasi elemen data yang benar-benar dibutuhkan.
Daftar kolom satu per satu. Prinsipnya minimalis: kalau penerima tidak butuh, jangan kirim. Ini sekaligus melindungi data pasien.

Tetapkan tipe, format, dan status wajib/opsional.
Untuk tiap kolom, tulis tipe (teks, angka, tanggal), format (misalnya YYYY-MM-DD), dan apakah boleh kosong.

Buat mapping dan contoh data.
Cocokkan nama kolom sistem sumber dengan sistem tujuan, lalu tulis aturan konversi nilainya. Tambahkan satu contoh data fiktif utuh.

Beri versi, tanggal, dan penanggung jawab.
Cantumkan "Versi 1.0, 15 September 2026, pemilik: Unit Rekam Medis". Uji dokumen dengan meminta temanmu menafsirkannya tanpa penjelasan lisan.

Hasil langkah 1 sampai 4 bisa berbentuk JSON, format teks ringan yang diatur dalam RFC 8259 (Bray, 2017) dan sangat umum untuk pertukaran data antarsistem. Berikut contoh data pasien fiktif. Klik tombol "Salin" untuk menyalinnya.

ringkasan-kunjungan-v1.0.json

{
  "versi_dokumen": "1.0",
  "pengirim": "Puskesmas Contoh (fiktif)",
  "pasien": {
    "no_rm": "RM-2026-000123",
    "nama": "Siti Rahayu",
    "tanggal_lahir": "1990-04-03",
    "jenis_kelamin": "P"
  },
  "kunjungan": {
    "tanggal": "2026-09-15",
    "poli": "Poli Umum",
    "diagnosis": {
      "kode_icd10": "I10",
      "keterangan": "Hipertensi esensial"
    }
  }
}

🔍 Analisis: Tanpa vs Dengan Dokumentasi

Tanpa dokumentasi

Kolom "jk" berisi 1 atau 2, maknanya hanya diketahui programmer lama.
Tanggal tertulis 03/04/2026, bulan atau hari?
Kolom baru ditambah, penerima tidak tahu.

Dengan dokumentasi

"jenis_kelamin" bernilai L atau P, aturan konversi tertulis.
Semua tanggal YYYY-MM-DD, lengkap dengan contoh.
Perubahan tercatat sebagai versi 1.1 dengan tanggalnya.

⚠️ Perhatian

Jangan pernah memakai data pasien asli sebagai contoh di dokumentasi, latihan, atau tugas kuliah. Dokumentasi biasanya dibagikan ke banyak pihak, dan data kesehatan termasuk data pribadi yang harus dilindungi. Pakai nama, nomor RM, dan tanggal fiktif seperti di atas.

Tabel Mapping dan Contoh Request: Dokumentasi Pertukaran Data dalam Praktik

Mapping adalah "kamus terjemahan" antara dua sistem. Di rumah sakit yang memakai SIMRS lama, nama kolom sering singkat dan bergaya internal. Penerima butuh tahu kolom mana setara dengan kolom mana, dan bagaimana nilainya diubah. Tabel di bawah contoh mapping untuk data pada JSON tadi.

Kolom sumber (SIMRS)	Elemen tujuan	Tipe dan format	Aturan konversi	Wajib
`no_rm`	`pasien.no_rm`	Teks, 14 karakter	Salin apa adanya	Ya
`tgl_lhr`	`pasien.tanggal_lahir`	Tanggal, YYYY-MM-DD	Ubah dari DD/MM/YYYY	Ya
`jk`	`pasien.jenis_kelamin`	Teks, 1 huruf	1 menjadi L, 2 menjadi P	Ya
`tgl_kunj`	`kunjungan.tanggal`	Tanggal, YYYY-MM-DD	Ubah dari DD/MM/YYYY	Ya
`dx`	`diagnosis.kode_icd10`	Teks, kode ICD-10	Pakai kode, bukan nama penyakit	Ya

💡 Tips

Untuk diagnosis, tulis rujukan kodenya, yaitu ICD-10 terbitan WHO. Kode "I10" artinya hipertensi esensial. Satu kode baku jauh lebih aman daripada nama penyakit yang bisa ditulis "HT", "Hipertensi", atau "darah tinggi".

Kalau pertukaran terjadi lewat internet, dokumentasi juga perlu mencantumkan contoh permintaan (request). Metode dan status HTTP dijelaskan dalam RFC 9110 (Fielding dkk., 2022). Contoh di bawah mengirim JSON tadi ke alamat fiktif.

contoh-request-http.txt

POST /api/v1/ringkasan-kunjungan HTTP/1.1
Host: api.rs-rujukan-contoh.test
Content-Type: application/json
Authorization: Bearer TOKEN_CONTOH

{ ...isi JSON ringkasan kunjungan di atas... }

Respons yang diharapkan:
HTTP/1.1 201 Created

⚡ Insight Penting

Perhatikan bahwa token otorisasi ditulis sebagai placeholder. Dokumentasi pertukaran data boleh menjelaskan cara autentikasi, tapi tidak boleh memuat kunci atau kata sandi asli. Topik autentikasi dan enkripsi kita bahas lebih dalam di artikel berikutnya.

Sebelum kamu merilis dokumen pertamamu, kenali tiga kesalahan yang paling sering muncul pada dokumentasi pertukaran data. Pertama, dokumen ditulis sekali lalu dilupakan, sehingga isinya tertinggal dari sistem yang terus berubah. Biasakan mengubah nomor versi setiap kali ada kolom yang ditambah, dihapus, atau berganti makna. Kedua, dokumen hanya mendaftar nama kolom tanpa aturan nilai. Daftar kolom tanpa aturan konversi sama seperti peta tanpa legenda: kamu tahu ada jalan, tapi tidak tahu jalan apa. Ketiga, dokumen disimpan di laptop satu orang. Simpan di tempat yang bisa diakses pihak yang berwenang, dan tentukan siapa yang boleh mengubahnya.

Kamu juga bisa memakai satu pertanyaan sederhana sebagai uji akhir: "Kalau orang yang belum pernah bertemu denganku membaca dokumen ini, apakah dia bisa mengirim data yang benar tanpa bertanya?" Kalau jawabannya ya, dokumentasi pertukaran data milikmu sudah layak dibagikan. Kalau masih ragu, tambahkan contoh data dan penjelasan nilai, lalu minta teman satu kelasmu mencoba membacanya.

🏁 Kesimpulan

Dokumentasi pertukaran data adalah kontrak tertulis yang membuat pengirim dan penerima membaca data pasien dengan makna yang sama. Ingat empat hal ini:

Pakai rumus: tujuan, pihak, struktur, aturan format, mapping, dan versi.
Uji dokumentasimu dengan enam prinsip: jelas, lengkap, konsisten, terversi, dapat ditelusuri, dapat diuji.
Susun struktur data dalam lima langkah, dan selalu sertakan contoh data fiktif.
Tulis mapping beserta aturan konversi nilai, bukan hanya nama kolom.

Tantangan untukmu: pilih lima elemen data dari formulir pendaftaran pasien di tempat praktikmu (bisa pakai contoh fiktif), lalu tulis tabel dokumentasinya. Bagikan hasilnya di kolom komentar.

Tulis komentar Bagikan artikel

Daftar Referensi

Bray, T. (Ed.). (2017). The JavaScript Object Notation (JSON) Data Interchange Format (RFC 8259). Internet Engineering Task Force. https://www.rfc-editor.org/info/rfc8259
Fielding, R., Nottingham, M., & Reschke, J. (Eds.). (2022). HTTP Semantics (RFC 9110). Internet Engineering Task Force. https://www.rfc-editor.org/info/rfc9110
HL7 International. HL7 FHIR (Fast Healthcare Interoperability Resources). https://hl7.org/fhir/ (nomor rilis yang kamu pakai perlu diverifikasi).
International Organization for Standardization. (2019). ISO 8601-1:2019 Date and time: Representations for information interchange, Part 1: Basic rules.
Kementerian Kesehatan Republik Indonesia. (2022). Peraturan Menteri Kesehatan No. 24 Tahun 2022 tentang Rekam Medis. (Nomor pasal rinci perlu diverifikasi pada naskah resmi di JDIH Kemenkes.)
Republik Indonesia. (2022). Undang-Undang No. 27 Tahun 2022 tentang Pelindungan Data Pribadi. (Nomor pasal rinci perlu diverifikasi.)
World Health Organization. ICD-10: International Statistical Classification of Diseases and Related Health Problems, 10th Revision.