(File Size: 2.02 MB)

REVISI BLU REST FORMAT WEBSERVICE
AKSES PORT
Port yang digunakan dalam webservice hanya port 80 (http) atau 443 (secure http).
PENGGUNAAN METHOD
1. Webservice Layanan BLU
Menggunakan Metode Get tanpa JSON Web Token (JWT)
2. Webservice Keuangan BLU
Menggunakan Metode Post dengan 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
Format tanggal_update : yyyy/mm/dd hh:mm:ss
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”
}
]
}
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
Contoh rest 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
2017-04-15 00:00:00 424121
TanggalUpdate
400000000 2017-04-16 14:33:23
VIEW JSON :
{ "Penerimaan": [ { "Tanggal": "2017-04-15 00:00:00", "KodeAkun": "424121", "Saldo": "400000000", "TanggalUpdate":
"2017-04-16 14:33:23" } ] }
Keterangan Nilai :
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 terdapat Dua 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
PENERIMAAN
PENGELUARAN
SALDO BLU
Periode 1:
Transaksi s.d
Tanggal
15 (Tengah Bulan)
Periode 2:
Transaksi s.d
Tanggal
28/30/31
(Akhir Bulan)
Tanggal Update
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”
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-1112
“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"}]
}
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 :
Format “Tanggal” dan “TanggalUpdate” menggunakan yyyy-mm-dd hh:mm:ss dengan Unix epoch (00:00:00 UTC on 1 January 1970).
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;
8. URL webservice BLU dikirimkan ke alamat : [email protected]
LIST REPORT WEBSERVICE BLU
No
1.
BLU
BBLK PALEMBANG
LINK
http://pme.bblkpalembang.com:xxx/xxxx
2.
Universitas Negeri
Semarang (UNNES)
Politeknik Negeri
Malang
http://data.unnes.ac.id/xxx
3.
STATUS
Port
Terdapat
token
http://bios.poltekkes-malang.ac.id/xxx
Method Get
pada WS
Keuangan
http://rskmatamakassar.org/xxx/xxxx/xxx Data Tidak
ada
4.
BKMM Mata Makassar
5.
RS Paru Dr.H.A
Rotinsulu
http://219.83.56.xxx/xxxxxxx/xxx?
6.
RS Fatmawati
http://202.137.25.xxx/integrasi
7.
RSUP Dr. Sardjito
http://simetris.net:xxxx
Method Get
pada WS
Keuangan,
Format
Tanggal da
nisi data
belum
sesuai
Format data
json belum
sesuai
Format
Tanggal
belum
sesuai
KETERANGAN
Port supaya diubah ke 80 atau 443
Susunan Array List
Untuk data layanan, direvisi, tidak perlu
Token
Untuk Webservice Keuangan, method
perlu diubah menjadi Post
Hanya link Saldo_BLU dan Layanan
yang terbaca tetapi dengan JSON
ERROR PARSE dan masih
menggunakan Methods Get untuk
Webservice Keuangan.
Methods Webservice Keuangan diganti
menjadi Post;
Parameter TanggalUpdate disesuaikan
dengan data pada JSON;
Format tanggal disesuaikan;
Susunan array mengikuti revisi ini;
Belum ada Webservice Keuangan;
Format Tanggal disesuaikan;
Format Tanggal agar dapat disesuaikan;
Parameter tanggalupdate dengan data
Tanggal update pada Array Json belum
sama;
8.
Universitas Negeri
Surabaya
Universitas Negeri
Yogyakarta
https://bios.unesa.ac.id/xxxxxx
10.
UIN Raden Fatah
http://xxx.74.125.222:xxxx/bios.asmx
11.
Universitas Jenderal
Soedirman
http://sie.unsoed.ac.id:8040/services
9.
http://bios.uny.ac.id/service
Tidak dapat
diakses
Belum ada
Webservice
Keuangan,
Belum ada
Parameter
Port belum
443/80
Link tidak
dapat
diakses
Tanggal periode transaksi setidaknya H1 dari Tanggal Update kecuali terjadi
revisi data keuangan;
Username dan password invalid
Hanya ada data layanan pendidikan;
Tidak ada data pada Webservice
Keuangan;
Belum ada Parameter Tanggal Update;
Belum ada field array “bulan”
Penggunaan Port menjadi 80 dan 443;
Error akses;
The requested URL can't be reached