Integrasi BPJS pada Antrean
Panduan fitur integrasi BPJS pada modul Antrean, termasuk status job BPJS (PCare dan Antrean FKTP) serta fitur pengiriman ulang (resend) data PCare.
Status Job BPJS pada Antrean
Pengantar
Untuk setiap antrean pasien dengan penjamin BPJS, Dekacare secara otomatis mengirimkan data pendaftaran ke sistem BPJS melalui dua job (proses latar belakang). Status dari kedua job ini ditampilkan secara real-time pada kartu antrean, membantu petugas memantau keberhasilan sinkronisasi data dengan BPJS.
Pemahaman terhadap status job BPJS sangat penting untuk memastikan data kunjungan pasien tercatat dengan benar di sistem Jaminan Kesehatan Nasional.
Jenis Job BPJS
Setiap antrean BPJS memiliki dua job yang berjalan secara otomatis:
| Badge | Nama Job | Job Type | Fungsi |
|---|---|---|---|
| P | Pendaftaran PCare | pendaftaran_pcare | Mengirimkan data pendaftaran kunjungan pasien ke layanan PCare BPJS |
| A | Antrean FKTP | tambah_antrean_fktp | Mengirimkan data antrean ke sistem antrean FKTP (Fasilitas Kesehatan Tingkat Pertama) BPJS |
Tampilan Badge Status
Status job ditampilkan dalam bentuk badge kecil pada baris detail kartu antrean. Badge hanya muncul untuk pasien dengan penjamin BPJS (penjamin_id = 2).
Format Badge
Setiap badge menampilkan format: [Huruf]: [Status]
- P: OK — Pendaftaran PCare berhasil
- P: Gagal — Pendaftaran PCare gagal
- P: processing — Pendaftaran PCare sedang diproses
- A: OK — Antrean FKTP berhasil
- A: Gagal — Antrean FKTP gagal
- A: processing — Antrean FKTP sedang diproses
Warna Badge
| Status | Warna Badge | Keterangan |
|---|---|---|
| OK (Success) | Hijau | Job berhasil dieksekusi dan data terkirim ke BPJS |
| Gagal (Failed) | Merah | Job gagal, data tidak terkirim ke BPJS |
| Processing | Kuning | Job sedang dalam antrian proses |
| N/A | Abu-abu | Tidak ada data job tracker untuk antrean ini |
Nomor Antrean PCare
Selain badge status job, kartu antrean juga menampilkan badge PCare di area status (pojok kanan atas) yang menunjukkan nomor antrean PCare:
| Kondisi | Tampilan | Warna |
|---|---|---|
| Pendaftaran PCare sukses | PCare: [nomor] | Hijau (background hijau muda) |
| Pendaftaran PCare gagal | PCare: 0 | Merah (background merah muda) |
Detail Error BPJS
Ketika badge status menunjukkan Gagal, petugas dapat melihat detail error dengan cara:
- Hover (arahkan kursor) pada badge yang berstatus Gagal
- Sistem akan menampilkan tooltip berisi pesan error dari BPJS
- Pesan error ini berasal langsung dari respons API BPJS dan membantu mengidentifikasi penyebab kegagalan
Tips: Pesan error dari BPJS biasanya cukup deskriptif. Contoh umum: “Nomor kartu BPJS tidak ditemukan”, “Pasien tidak aktif”, “Tanggal kunjungan tidak valid”.
Validasi Status BPJS Sebelum Terima Antrean
Saat petugas menekan tombol Terima pada antrean BPJS, sistem melakukan validasi status job terlebih dahulu:
Alur Validasi
- Sistem memeriksa status Pendaftaran PCare (job type:
pendaftaran_pcare) - Sistem memeriksa status Antrean FKTP (job type:
tambah_antrean_fktp) - Jika salah satu atau keduanya gagal:
- Dialog peringatan ditampilkan dengan detail error dari setiap job yang gagal
- Petugas harus mengonfirmasi apakah tetap ingin melanjutkan penerimaan
- Jika keduanya sukses: proses penerimaan berjalan normal tanpa peringatan tambahan
Peringatan: Menerima antrean dengan status job BPJS gagal berarti data kunjungan pasien belum tercatat di sistem BPJS. Hal ini dapat berdampak pada:
- Klaim BPJS yang tidak dapat diproses
- Data kunjungan yang tidak tersinkronisasi
- Potensi penolakan klaim di kemudian hari
Disarankan untuk melakukan Resend PCare terlebih dahulu sebelum menerima antrean.
Panduan Penanganan Status Job
| Skenario | Tindakan yang Disarankan |
|---|---|
| P: OK, A: OK | Terima antrean seperti biasa |
| P: Gagal, A: OK | Coba Resend PCare terlebih dahulu. Jika tetap gagal, hubungi administrator |
| P: OK, A: Gagal | Terima antrean dengan konfirmasi. Antrean FKTP dapat di-handle manual |
| P: Gagal, A: Gagal | Coba Resend PCare. Jika gagal, konsultasikan dengan administrator sebelum menerima |
| P: Processing, A: Processing | Tunggu beberapa saat dan Refresh data. Job sedang dalam antrian proses |
Resend PCare
Pengantar
Fitur Resend PCare memungkinkan petugas mengirim ulang data pendaftaran PCare/BPJS yang sebelumnya gagal. Fitur ini sangat penting untuk memastikan data kunjungan pasien BPJS tercatat dengan benar di sistem PCare tanpa harus membatalkan dan membuat ulang antrean.
Kondisi Munculnya Tombol Resend PCare
Tombol Resend PCare tidak selalu tampil pada setiap kartu antrean. Sistem menampilkan tombol ini hanya jika seluruh kondisi berikut terpenuhi secara bersamaan:
| No | Kondisi | Keterangan |
|---|---|---|
| 1 | Penjamin BPJS | Pasien menggunakan penjamin BPJS (penjamin_id = 2) |
| 2 | Jenis kunjungan Rawat Jalan | Ruangan memiliki jenis kunjungan 1 (Rawat Jalan/Poliklinik) |
| 3 | Ada kegagalan pengiriman | Minimal salah satu kondisi berikut terpenuhi:
|
Catatan: Tombol Resend PCare hanya muncul untuk antrean rawat jalan (jenis kunjungan 1), karena pendaftaran PCare khusus digunakan untuk layanan rawat jalan di FKTP. Antrean apotek, laboratorium, dan radiologi tidak memerlukan fitur ini.
Tampilan Tombol
Tombol Resend PCare ditampilkan sebagai tombol kecil dengan:
- Ikon: RefreshCw (panah melingkar) berwarna kuning
- Variant:
flat-warning - Tooltip: “Resend PCare” (muncul saat hover)
- Posisi: Di baris aksi kartu antrean, di samping tombol Panggil dan Batalkan
Cara Menggunakan Resend PCare
- Identifikasi kartu antrean BPJS yang memiliki status job gagal (badge P atau A berwarna merah)
- Klik tombol Resend PCare (ikon panah melingkar kuning) pada kartu antrean
- Sistem menampilkan dialog konfirmasi:
“Apakah anda yakin ingin mengirim ulang data PCare untuk antrean #[nomor antrean]?” - Klik “Ya, Kirim Ulang” untuk melanjutkan atau “Batal” untuk membatalkan
- Jika dikonfirmasi, sistem akan memproses pengiriman ulang
Proses Pengiriman Ulang
Setelah konfirmasi, sistem menjalankan proses berikut:
| No | Proses | Keterangan |
|---|---|---|
| 1 | Disable Tombol | Tombol berubah menjadi spinner untuk mencegah klik ganda |
| 2 | Kirim Request | Mengirim request POST ke API antrian_ruangan/resend-pcare/[id] |
| 3 | Proses di Server | Server mengirim ulang data pendaftaran ke layanan PCare BPJS |
| 4 | Response | Server mengembalikan status keberhasilan pengiriman |
| 5 | Update Tampilan | Data antrean dimuat ulang untuk memperbarui status badge |
Feedback Status Setelah Resend
Pengiriman Berhasil
Jika pengiriman ulang berhasil:
- Notifikasi sukses: “Data PCare berhasil dikirim ulang”
- Data antrean di-refresh secara otomatis
- Badge status job akan berubah dari merah (Gagal) menjadi hijau (OK)
- Nomor antrean PCare akan terisi jika sebelumnya kosong
Pengiriman Gagal
Jika pengiriman ulang gagal:
- Notifikasi error dengan prefix: “INFO RESPON DARI BPJS:” diikuti pesan error dari BPJS
- Atau pesan umum: “Tidak dapat mengirim ulang data PCare” jika error tidak berasal dari BPJS
- Badge status tetap berwarna merah
Peringatan: Jika resend berulang kali gagal, kemungkinan penyebabnya adalah:
- Data pasien BPJS tidak valid (nomor kartu, status kepesertaan)
- Layanan PCare BPJS sedang mengalami gangguan
- Konfigurasi BPJS pada faskes perlu diperiksa
Hubungi administrator atau tim IT untuk penanganan lebih lanjut.
Alur Kerja yang Disarankan
Berikut adalah alur kerja yang disarankan untuk menangani kegagalan job BPJS:
- Identifikasi — Periksa badge status job (P dan A) pada kartu antrean BPJS
- Analisis — Hover pada badge yang gagal untuk melihat detail error
- Resend — Klik tombol Resend PCare untuk mengirim ulang data
- Verifikasi — Periksa apakah badge berubah menjadi hijau setelah resend
- Terima — Jika semua badge sudah hijau, terima antrean seperti biasa
- Eskalasi — Jika resend tetap gagal, hubungi administrator
Tips: Sebelum melakukan resend, pastikan koneksi internet stabil. Kegagalan pengiriman bisa disebabkan oleh masalah jaringan yang bersifat sementara.