Web Service Antrean BPJS Mobile JKN FKTL

Spesifikasi resmi untuk integrasi antrean di RUMKIT dr. EDDY KOUNANG 2025.

1. Pendahuluan & Otentikasi

URL Dasar: http://ipserverws:port/api-bpjsfktl

Header Wajib: Setiap *endpoint* (kecuali `/auth`) memerlukan Header `x-token` (Token) dan `x-username` (Username RS).

1.1 Mengambil Token Akses

GET /auth

Header Permintaan (Auth)

HeaderDeskripsiWajib
x-usernameUser yang diberikan RSYa
x-passwordPassword yang diberikan RSYa

Respons Sukses (200 OK)

{ "response": { "token": "xxxxxxxxxxxxxxxxx" }, "metadata": { "message": "Ok", "code": 200 } }

2. Antrean Poli

Bagian ini mencakup semua API untuk mengelola antrean pasien di Poliklinik.

2.1 Menampilkan Status Antrean Poli

POST /statusantrean

Body Permintaan

{ "kodepoli":"XXX", "kodedokter":"XXXXX", "tanggalperiksa":"XXXX-XX-XX", "jampraktek":"XX:XX-XX:XX" }

2.2 Mengambil Antrean Poli

POST /ambilantrean

Body Permintaan

{ "nomorkartu": "...", "nik": "...", "nohp": "...", "kodepoli": "...", "norm": "...", "tanggalperiksa": "...", "kodedokter": "...", "jeniskunjungan": "x", "nomorreferensi": "..." }

2.3 Melakukan Checkin Poli

POST /checkinantrean
Waktu harus dalam format **timestamp milliseconds** (13 digit) sesuai BPJS.

Body Permintaan

{ "kodebooking": "XXXXXXXXXXXXXX", "waktu": XXXXXXXXXXX }

2.4 Membatalkan Antrean Poli

POST /batalantrean
Hanya bisa dilakukan **sebelum** pasien *checkin*.

Body Permintaan

{ "kodebooking": "XXXXXXXXXXXXXX", "keterangan": "Alasan pembatalan" }

2.5 Melihat Sisa Antrean Poli (Setelah Checkin)

POST /sisaantrean

Body Permintaan

{ "kodebooking": "XXXXXXXXXXXXXX" }

3. Jadwal Operasi

API untuk melihat jadwal operasi yang tersedia di RS.

3.1 Melihat Jadwal Operasi RS (Umum)

POST /jadwaloperasirs

Body Permintaan

{ "tanggalawal": "XXXX-XX-XX", "tanggalakhir": "XXXX-XX-XX" }

3.2 Melihat Jadwal Operasi Pasien (Personal)

POST /jadwaloperasipasien

Body Permintaan

{ "nopeserta": "XXXXXXXXXX" }

4. Pendaftaran Pasien & Farmasi

Bagian ini menangani alur pendaftaran awal dan antrean pengambilan obat.

4.1 Pasien Baru

POST /pasienbaru
Digunakan untuk mendaftarkan pasien BPJS baru dan mendapatkan **Nomor Rekam Medis (NORM)**.

Body Permintaan (Data Kependudukan Lengkap)

{ "nomorkartu": "...", "nik": "...", "nama": "...", "jeniskelamin": "L/P", "tanggallahir": "...", "nohp": "...", "alamat": "...", /* dst. */ }

4.2 Ambil Antrean Farmasi

POST /ambilantreanfarmasi

Body Permintaan

{ "kodebooking": "XXXXXXXXXXXXX" }

4.3 Status Antrean Farmasi

POST /statusantreanfarmasi

Body Permintaan

{ "kodebooking": "XXXXXXXXXXXXX" }