REVISI BLU REST FORMAT WEBSERVICE

(1)

(2)

REVISI BLU REST FORMAT WEBSERVICE

AKSES PORT

Port yang digunakan dalam webservice hanya port 80 (http) atau 443 (secure http).

PENGGUNAAN METHOD 1. Webservice LayananBLU

Menggunakan Metode Get tanpa JSON Web Token (JWT)

2. Webservice KeuanganBLU

Menggunakan Metode Postdengan atau tanpa JSON Web Token (JWT);

JSON Web Token (JWT) merupakan fitur optional pada webservice;

URI/URL dan Format WEBSERVICE LAYANAN BLU

1. Parameter Data Update langsung pada data Array JSON:

Contoh Layanan Kesehatan JSON Format :

{"layanan_kesehatan":[ { "kode_satker":"415423", "tahun":"2012", “bulan”:”12”, "kelas":"01", "jumlah_pasien":"5", "jumlah_hari":"6", “tanggal_update”:”2014/12/31 00:00:00”}] };

Webservice Layanan BLU

(3)

Contoh Layanan Pendidikan JSON Format : { "layanan_pendidikan":[{ "kode_satker":"189662", "tahun":"2016", “bulan” : “12”, "kode_fakultas":"01", "kode_program_studi":"09", "kode_akreditasi":"B", "kode_jurusan":"188", “tanggal_update”: “2014/12/31 00:00:00”}] }

Contoh Layanan Lainnya JSON Format :

{ "layanan_lainnya":[ { "kode_satker":"539060", "tahun":"2009", “bulan” : “12”, "indikator":"0062", "jumlah":"30", “tanggal_update”: “2014/12/31 00:00:00” } ] }

(4)

2. Validasi Data Webservice Layanan :

 Kesehatan : kelas;

 Pendidikan : fakultas,program studi, akreditasi, jurusan;

 Lainnnya : indikator;

3. Parameter data yang dijadikan check dan filter data adalah “bulan” dan “tahun”;

4. Menggunakan Format Tanggal = yyyy/mm/dd hh:mm:ss;

URI/URL PARAMETER WEBSERVICE KEUANGAN

1. Penulisan parameter pada URI/URL webservice Keuangan menggunakan parameter : tanggal update data (YYYY-MM-DD)

Penulisan URL :

http://weblinkblu/keterangandata?TanggalUpdate=yyyy-mm-dd Contohrest php:

 Url Penerimaan BLU : http://webblu.id/penerimaan_blu.php?TanggalUpdate=2017-05-15

 Url Pengeluaran BLU : http:// webblu.id/pengeluaran_blu.php?TanggalUpdate=2017-05-15

 Url Saldo BLU : http:// webblu.id/saldo_blu.php?TanggalUpdate=2017-05-15

2. Tanggal Parameter pada URL harus sama dengan ‘TanggalUpdate’ pada data JSON

TANGGAL PARAMETER dan DATA WEBSERVICE KEUANGAN

Data Keuangan yang ditampilkan pada webservice keuangan adalah nilai akumulasi sampai dengan tanggal.

Contoh Data Webservice Keuangan : Data Saldo s.d tanggal 15 April 2017

Tanggal KodeAkun Saldo TanggalUpdate

(5)

VIEW JSON :

{ "Penerimaan": [ { "Tanggal": "2017-04-15 00:00:00", "KodeAkun": "424121", "Saldo": "400000000", "TanggalUpdate":

"2017-04-16 14:33:23" } ] }

KeteranganNilai :

Nilai saldo sebesar 400.000.000 merupakan nilai akumulasi saldo BLU dari awal Tahun Anggaran (1 Januari) sampai dengan tanggal 15 April

2017

NILAI yang DITAMPILKAN WEBSERVICE

Nilai yang ditampilkan pada Webservice Keuangan (Penerimaan, Pengeluaran, dan Saldo BLU) adalah Nilai Akumulasi dari Transaksi

Riil dari Awal Tahun Anggaran (1 Januari) per-periode pelaporan transaksi keuangan, yakni tanggal 15 dan akhir bulan; TANGGAL TRANSAKSI DAN TANGGAL UPDATE

1. Hanya terdapatDua Periode transaksi keuangan yang harus dilaporkan yakni pada periode tengah bulan (tanggal 15) dan akhir bulan (tanggal 28/30/31);

2. Data JSON yang ditampilkan per-tanggal parameter sesuai dengan tanggal parameter (TanggalUpdate) pada URL;

3. Push Data awal untuk setiap periode pelaporan dilakukan segera setelah proses rekapitulasi dan validasi data keuangan BLU;

Tabel Periode Penyampaian Data Melalui Webservice KATEGORI PELAPORAN KEUANGAN Periode 1: Transaksi s.d Tanggal Periode 2: Transaksi s.d Tanggal Tanggal Update PENERIMAAN 15 (Tengah Bulan) 28/30/31 (Akhir Bulan)

1. Update data keuangan per-periode pelaporan dilakukan

maksimal satu hari berikutnya (H+1); Uraian :

“Tanggal” : ”2017-10-15 00:00:00”  maksimal

“TanggalUpdate” : ”2017-10-16 00:00:00” PENGELUARAN

(6)

2. Update revisi data keuangan pada suatu periode dapat dilakukan kapan saja;

Uraian :

Jika terdapat revisi atas akumulasi data penerimaan s.d 2017-10-15 dilakukan update data di tanggal 2017-11-12

“Tanggal” : ”2017-10-15 00:00:00”  maksimal

“TanggalUpdate” : ”2017-11-12 00:00:00”

3. Tanggal Update setidaknya menggunakan tanggal dari

System Datetime/Server Datetime;

4. Jika terdapat perubahan/ralat/revisi akumulasi data keuangan untuk akumulasi transaksi keuangan per tanggal 15 ataupun

akhir bulan, BLU dapat melakukan update nilai revisi tersebut dengan berpatokan pada periode ralat revisi (tanggal 15 atau akhir bulan), sedangan penggunaan parameter tanggal update atas revisi tersebut disamakan dengan tanggal dilakukannya Push Data pada webservice (system datetime/server datetime).

FORMAT JSON WEBSERVICE KEUANGAN 1. VIEW JSON PENERIMAAN BLU

Response json : {"Penerimaan": [{"Tanggal":"yyyy-mm-dd hh:mm:ss", "KodeAkun":"424121", "Saldo":"1xxxxxxxxxx", "TanggalUpdate":"yyyy-mm-dd hh:mm:ss"}] }

(7)

2. VIEW JSON PENGELUARAN BLU Response json : {"Pengeluaran": [{"Tanggal":"yyyy-mm-dd hh:mm:ss", "KodeAkun":"5251190", "Saldo":"2xxxxxxxxxx", "TanggalUpdate":"yyyy-mm-dd hh:mm:ss"}] }

3. VIEW JSON SALDO BLU Response json : {"SaldoBLU": [{"Tanggal":"yyyy-mm-dd hh:mm:ss", "KodeJenisRekening":"3", "NamaBank":"B*I KC xxxxxxxxx", "Saldo":"3xxxxxxxxxx", "TanggalUpdate":"yyyy-mm-dd hh:mm:ss"}] }

CONTOH FORMAT JSON WEBSERVICE PENERIMAAN Contoh JSON Penerimaan :

{"Penerimaan":[{"Tanggal":"2017-03-15 00:00:00","KodeAkun":"424121","Saldo":"1000000000000","TanggalUpdate":"2017-03-16 14:33:23"}]}

*Catatan Format DateTime :

(8)

KETERANGAN TAMBAHAN

1. Auto Scheduler Server pada Kementerian Keuangan akan melakukan check, validate, dan read data untuk webservice

Keuangan BLU setiap hari;

2. Auto Scheduler Server pada Kementerian Keuangan akan melakukan check, validate, dan read data untuk webservice Layanan

BLU setiap Minggu;

3. Jika terjadi perubahan data webservice, maka server pada Kementerian Keuangan akan melakukan pembacaan data posisi

update terakhir dengan kunci pengecekan juga pada tanggal transaksi;

4. Jika data sumber webservice JSON bukan berasal dari database (data warehouse), pastikan data tersebut sudah benar dan

valid serta pastikan data yang digenerate sesuai antara parameter dengan periode pelaporan (H+1);

5. Jika data sumber webservice JSON berasal dari database (data warehouse), maka pastikan terdapat auto scheduler push data

pada webservice sesuai dengan ketentuan, yakni : data layanan BLU dipush dan load per-bulan dan data keuangan BLU dipush dan load per-tengah (tanggal 15) dan akhir bulan kalendar;

6. Data keuangan BLU yang dipush hanya 2 (dua) periode setiap bulannya, yakni : hanya nilai akumulasi dari awal tahun anggaran

sampai dengan tengah bulan berjalan (tanggal 15) dan sampai dengan akhir bulan berjalan (tanggal 28/30/31);

7. Format Tanggal yang digunakan pada Webservice Keuangan adalah : yyyy-mm-dd hh:mm:ss sedangkan pada Webservice

Layanan adalah yyyy/mm/dd hh:mm:ss;

(9)

LIST REPORT WEBSERVICE

BLU

No BLU LINK STATUS KETERANGAN

1. BBLK PALEMBANG http://pme.bblkpalembang.com:xxx/xxxx Port Port supaya diubah ke 80 atau 443

Susunan Array List

2. Universitas Negeri

Semarang (UNNES)

http://data.unnes.ac.id/xxx Terdapat

token

Untuk data layanan, direvisi, tidak perlu Token

3. Politeknik Negeri

Malang

http://bios.poltekkes-malang.ac.id/xxx Method Get

pada WS Keuangan

Untuk Webservice Keuangan, method perlu diubah menjadi Post

4. BKMM Mata Makassar http://rskmatamakassar.org/xxx/xxxx/xxx Data Tidak

ada

Hanya link Saldo_BLU dan Layanan yang terbaca tetapi dengan JSON ERROR PARSE dan masih menggunakan Methods Get untuk Webservice Keuangan. 5. RS Paru Dr.H.A Rotinsulu http://219.83.56.xxx/xxxxxxx/xxx? Method Get pada WS Keuangan, Format Tanggal da nisi data belum sesuai

Methods Webservice Keuangan diganti menjadi Post;

Parameter TanggalUpdate disesuaikan dengan data pada JSON;

Format tanggal disesuaikan;

6. RS Fatmawati http://202.137.25.xxx/integrasi Format data

json belum sesuai

Susunan array mengikuti revisi ini; Belum ada Webservice Keuangan; Format Tanggal disesuaikan;

7. RSUP Dr. Sardjito http://simetris.net:xxxx Format

Tanggal belum sesuai

Format Tanggal agar dapat disesuaikan; Parameter tanggalupdate dengan data Tanggal update pada Array Json belum sama;

(10)

Tanggal periode transaksi setidaknya H-1 dari Tanggal Update kecuali terjadi revisi data keuangan;

Surabaya

https://bios.unesa.ac.id/xxxxxx Tidak dapat

diakses

Username dan password invalid

Yogyakarta

http://bios.uny.ac.id/service Belum ada

Webservice Keuangan, Belum ada Parameter

Hanya ada data layanan pendidikan; Tidak ada data pada Webservice Keuangan;

Belum ada Parameter Tanggal Update; Belum ada field array “bulan”

10. UIN Raden Fatah http://xxx.74.125.222:xxxx/bios.asmx Port belum

443/80

Penggunaan Port menjadi 80 dan 443; Error akses;

11. Universitas Jenderal Soedirman

http://sie.unsoed.ac.id:8040/services Link tidak

dapat diakses