Referensi
Permukaan BPJS
VClaim, Antrean, dan Aplicares dipanggil lewat satu API yang sama. Tanda tangan HMAC, timestamp, dan dekripsi respons ditangani gateway — SIMRS mengirim JSON biasa.
| Endpoint | Kegunaan | Metode |
|---|---|---|
| /v1/bpjs/peserta | Cari peserta dengan noka (13 digit) atau nik (16 digit) — tepat salah satu. tglSep menentukan tanggal keaktifan yang dinilai, bukan sekadar filter. | GET |
| /v1/bpjs/sep | Terbitkan SEP. Gateway meratakan pembungkus request.t_sep milik VClaim. | POST |
| /v1/bpjs/sep/{noSep} | Ambil, ubah, atau hapus SEP. Nomor di path yang menentukan. | GET PUT DELETE |
| /v1/bpjs/rujukan/{noRujukan} | Ambil rujukan. Parameter asal memilih registri: fktp (bawaan) atau rs. | GET |
| /v1/bpjs/monitoring/klaim | Monitoring klaim per tanggal, jenis pelayanan, dan status. | GET |
| /v1/bpjs/referensi/{jenis} | Data referensi BPJS, di-cache 24 jam per tenant. Header X-Cache menyebut hit atau miss. | GET |
| /v1/bpjs/antrean | Tambah antrean, lalu perbarui tugas 1 sampai 7 lewat /v1/bpjs/antrean/{kodeBooking}/status. | POST |
| /v1/bpjs/aplicares/bed | Perbarui ketersediaan tempat tidur. | PUT |
Tiga hal yang paling sering salah
- Jangan kirim ppkPelayanan — Kode PPK disuntikkan gateway dari data tenant, supaya sebuah rumah sakit tidak bisa menerbitkan SEP atas PPK rumah sakit lain. Mengirimnya di body ditolak, bukan diabaikan.
- waktu antrean dalam milidetik epoch — Bukan detik, dan bukan string tanggal. Nilai dalam detik ditolak pre-flight.
- Field yang tidak dikenal ditolak — Salah ketik nama field pada payload SEP adalah masalah integritas data, jadi body dengan field asing ditolak alih-alih diabaikan.
Yang diperiksa sebelum BPJS dipanggil
Rujukan di luar masa berlaku (91 hari FKTP, 90 hari antar-RS) dan kode ICD-10 yang tidak berbentuk kode ditolak lebih dulu, sehingga galatnya bisa dibaca. Pemeriksaan terhadap data referensi — poliTujuan, diagAwal, DPJP — gagal secara terbuka: bila lookup tidak tersedia, kode dibiarkan tak terverifikasi alih-alih menahan SEP yang sah.