TUTORIAL INSTALASI BRIDGING SEP DENGAN SIMRS MENGGUNAKAN

WEBSERVICE
Oleh Indra Saputra , Anung Budiranto

Tujuan dari tutorial ini adalah agar pembaca bisa menginstall webservice SEP. Penginstallan
webservice SEP ini bertujuan agar SEP bisa diakses oleh aplikasi lain tanpa harus membaca
langsung ke dalam database SEP. Untuk tujuan itu dibuatlah webservice yang bertugas
melakukan read update delete data SEP dengan hanya mengakses link url tertentu. Untuk
memahami definisi dan konsep webservice lebih lanjut silakan cari di google konsep webservice.

SEBELUM DIMULAI..
Persiapkan file-file yang dibutuhkan sebagai berikut
1.
2.
3.
4.

TOMCAT STACK , download disini

JDK JAVA DEVELOPMENT KIT 8 , download disini
WEBSERVICE SEP , download disini
ADVANCED REST CLIENT CHROME EXTENSION, download disini

MULAI INSTALASI
STEP 1
Dowload dan install BITNAMI TOMCAT STACK pada link diatas.
STEP 2
Download dan install JDK JAVA DEVELOPMENT KIT 8 pada link diatas
STEP 3
Download dan exctract WEBSERVICE SEP diatas, file rar ini terdiri dari :
SepLokalRest.war , file ini adalah aplikasi inti yang dikemas dalam file java. Yang akan
kita akses yang mengandung function untuk read, update dan delete file SEP. function functionnya akan diakses cukup dengan menjalankan url tertentu dengan parameter
tertentu. Letakkan file ini pada directory webapps pada folder BITNAMI,seperti ilustrasi
berikut ini :

1|Page

AUTHOR INDRA SAPUTRA

Gambar 1. Letak SEPLOKALREST.WAR pada folder BITNAMI TOMCAT

BridgingScript.sql, file ini adalah file sql untuk mengupdate database SEP, mengandung
konfigurasi ConsumerID dan SecretKey (ini akan diberikan nanti bila SEP dan SIMRS benar
benar berfungsi dengan baik), kode RS yang sedang menggunakan webservice, kode
KC BPJS wilayah RS berada. Jalankan file sql ini pada server SEP pada database BPJSRS.
Edit dan sesuaikan kodeRS , Kode cabang, kode regional ,consID dan secretkeynya.
Seperti Ilustrasi berikut:

Gambar 2. BridgingScript.sql
2|Page

AUTHOR INDRA SAPUTRA

WarUpdater, file ini digunakan untuk mengedit file SepLokalRest.war , mengedit

konfigurasi alamat IP server SEP , username dan password mysql server SEP. Sesuaikan url,
username dan passwordnya sesuai server SEP.

Gambar 3. WarUpdater
BPJS signature, file ini adalah generator parameter untuk mengakses webservice ,
diantaranya X-CONS-ID , X-TIMESTAMP, X-SIGNATURE. Demi menjaga keamanan
webservice (untuk menghindari orang orang tak bertanggung jawab yang memflooding
server webservice dengan request-request denial of service ). Gunakan file ini saat
melakukan testing get dan post. Tanpa parameter-parameter yang digenerate oleh
generator ini, webservice tidak akan melayani request dari user walaupun url yang
diakses sudah benar.

Gambar 4. ASTERIX signature Generator

Pada tutorial terpisah, akan diinfokan cara meng-generate parameter-parameter ini
dengan Bahasa pemrograman yang disesuaikan dengan Bahasa SIMRS. Diantaranya
java, php, vb.net, phyton, perl dsb. Tutorialnya bisa dilihat disini.

3|Page

AUTHOR INDRA SAPUTRA

MULAI TESTING
TEST 1 : PERIKSA APAKAH TOMCAT TERINSTALL DENGAN BENAR
Ketikkan pada browser HTTP://LOCALHOST ,maka akan muncul seperti gambar berikut

Gambar 5. Halaman home Tomcat Stack

TEST 2 : PERIKSA APAKAH APLIKASI WEBSERCIE TERPASANG DENGAN BENAR

4|Page

AUTHOR INDRA SAPUTRA

Ketikkan pada browser http://localhost/SepLokalRest , perhatikan huruf kapitalnya,

maka akan dibawa ke halaman home dari webservice , seperti gambar berikut :

Gambar 6. Halaman home Webservice

TEST 3 : PERIKSA APAKAH WEBSERVICE BISA MEMANGGIL SEP YANG SUDAH TERSIMPAN
Pada browser ketikkan
http://localhost/SepLokalRest/sepcbg/sep/1323R00105140000009 , sebagai contoh
1323R00105140000009 adalah salah satu nomor SEP yang sudah ada pada database
5|Page

AUTHOR INDRA SAPUTRA

BPJSRS penulis, gantilah dengan nomor SEP yang sebenarnya. Maka akan mendapat
feedback dari webservice berupa xml yang berisi data detil dari SEP tersebut. Seperti
pada gambar berikut :

Gambar 7. Feedback XML dari webservice

TEST 4 : PERIKSA APAKAH AKSES KE API.ASTERIX.CO.ID NORMAL
Pada test ini , kita akan mencoba mengakses API.ASTERIX.CO.ID untuk mengambil
informasi nomor kartu. Namun untuk mengaksesnya diperlukan CONSUMER ID dan
SECRET KEY (semacam kombinasi username dan password) yang dienkripsi sebagai
parameter tambahan selain parameter pada URL. Untuk itu gunakan BPJS signature.exe
untuk meng-generate CONSUMER ID dan SECRET KEYnya dan gunakan juga ADVANCED
REST CLIENT CHROME yang bisa didownload pada google store(lihat pada seksi Sebelum
memulai pada halaman awal ).

6|Page

AUTHOR INDRA SAPUTRA

Dengan BPJS signature , masukkan CONSUMER ID 1000 dan SECRET KEY 1112 , aplikasi
akan men-generate beberapa parameter yang siap digunakan untuk mengakses
webservice pusat

Gambar 8. Generate signature

Kemudian dengan menggunakan ADVANCED REST CLIENT CHROME ,ketikan alamat
http://api.asterix.co.id/SepWebRest/peserta/0000 110507578 , 0000110507578 adalah
contoh nomor kartu yang akan kita cari tau siapa pemiliknya. Pilih method GET.
Masukkan hasil generate SignatureGenerator ke kolom RAW parameter. Kemudian klik
tombol SEND. Maka akan mendapat respons XML berupa detil peserta pemilik kartu tsb.
Ilustrasi seperti berikut:

Gambar 9. Proses pencarian data nomor kartu pada ADVANCED REST CLIENT
7|Page

AUTHOR INDRA SAPUTRA

TEST 5 : PERIKSA APAKAH PEMBUATAN SEP DENGAN WEBSERVICE BERFUNGSI NORMAL

Pada test ini kita akan melakukan request ke webservice local, untuk melakukan create
nomor SEP. Ketikan alamat http://localhost/SepLokalRest/sep/ , kemudian masukkan
CONSUMER ID dan SECRET KEY hasil generate SignatureGenerator sebagai parameter
tambahan persis seperti test 4 . Masukkan parameter detil pelayanan peserta seperti
berikut. Gantilah PPK Pelayanan dengan kode RS pembaca.
<request>
<data>
<t_sep>
<noKartu>0000110507578</noKartu>
<tglSep>2015-02-10 13:05:03</tglSep>
<tglRujukan>2015-02-10 13:05:03</tglRujukan>
<noRujukan>1234590000300003</noRujukan>
<ppkRujukan>09010100</ppkRujukan>
<ppkPelayanan>1323R001</ppkPelayanan>
<jnsPelayanan>1</jnsPelayanan>
<catatan>dari WS</catatan>
<diagAwal>B010</diagAwal>
<poliTujuan>SAR</poliTujuan>
<klsRawat>2</klsRawat>
<user>INDRAOOO</user>
<noMr>1234</noMr>
</t_sep>
</data>
</request>

8|Page

AUTHOR INDRA SAPUTRA

Ilustrasi request ke webservice local

Gambar 10. Ilustrasi request ke webservice local

Setelah selesai proses requestnya , akan ada feedback xml bahwa proses create SEP berhasil

Gambar 11. Feedback proses pembuatan SEP

9|Page

AUTHOR INDRA SAPUTRA

Proses create SEP tersebut, akan menghasilkan data nomor SEP pada database BPJSRS yang
telah didefinisikan sebelumnya. Bisa dilakukan crosscheck ke database BPJSRS pada table datsjp.

Gambar 12. Pencarian dataSJP pada database BPJSRS

10 | P a g e

AUTHOR INDRA SAPUTRA

SEKIAN
SEMOGA BERMANFAAT

11 | P a g e

AUTHOR INDRA SAPUTRA