In this article
For clinics contracted with BPJS Kesehatan (Indonesia's national health insurance agency, which runs the JKN program), Medivana sends registrations, visits, diagnoses, medication, procedures, and referrals to PCare (the BPJS primary care application) and syncs the BPJS Online Queue (Antrean Online). BPJS submissions use a separate queue from SATUSEHAT, so a BPJS outage never holds up SATUSEHAT.
Preparation
- Settings → Integrations → BPJS: enter the Cons ID, Secret Key, User Key, and the facility's PCare account (permission "Manage integration credentials").
- Enter the branch's PPK code (healthcare facility code) and the BPJS clinic unit code for each clinic unit (Settings → Branches & units).
- Enter the BPJS doctor code in each doctor's user record.
- Map the BPJS procedure codes in the service master data if needed.
- JKN patients: enter the BPJS card number and choose BPJS as the payer from registration onward.
Error messages and solutions
| Message (example) | Cause | What to do |
|---|---|---|
| "BPJS is not configured yet. Enter the PCare/Online Queue credentials in Settings > Integrations, then resend." | Credentials are empty | Enter the credentials, then Resend |
| "… BPJS credentials were rejected. Check the Cons ID, Secret Key, User Key, and PCare account …" | Wrong or expired credentials, or the PCare account is locked | Check with the facility's BPJS admin; Medivana retries automatically |
| "… the BPJS service cannot be reached right now …" | BPJS outage | No action needed; it is resent automatically |
| "The patient's BPJS card number … has not been entered." | Incomplete patient data | Complete the card number, then Resend |
| "The BPJS clinic unit code for … has not been entered. Complete it in Settings > Branches & units, then resend." | The clinic unit is not mapped yet | Enter the BPJS clinic unit code |
| "The BPJS doctor code for … has not been entered." | The doctor is not mapped yet | Enter the doctor code in the user record |
| "There is no PCare registration for this visit. Make sure the visit's payer has been BPJS since registration, then resend." | The payer was changed to BPJS after registration | Correct the registration payer, then resend the registration followed by the visit |
| "The PCare visit has not been sent: the primary diagnosis is missing." | No primary diagnosis | Set the primary diagnosis |
| "The BPJS procedure code for … has not been entered in the service master data." | The procedure is not mapped yet | Complete the service master data |
| "… rejected by BPJS: (message from BPJS) …" | BPJS validation (for example an inactive card or an invalid referral) | Follow the BPJS message; correct the data, then Resend |
Online Queue
Bookings made by JKN patients in the BPJS app arrive as appointments with the source "BPJS". The queue status (called, being served, done) is synced whenever it changes. If the Online Queue is disrupted, serve patients as usual from the Medivana queue.