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
