REVISI BLU REST FORMAT WEBSERVICE

Transkripsi

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 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

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 : Contoh rest php: Url Penerimaan BLU : Url Pengeluaran BLU : webblu.id/pengeluaran_blu.php?tanggalupdate= Url Saldo BLU : webblu.id/saldo_blu.php?tanggalupdate= 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 :00: :33:23

5 VIEW JSON : { "Penerimaan": [ { "Tanggal": " :00:00", "KodeAkun": "424121", "Saldo": " ", "TanggalUpdate": " :33:23" ] Keterangan Nilai : Nilai saldo sebesar 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 Periode 2: Transaksi s.d Tanggal 15 (Tengah Bulan) 28/30/31 (Akhir Bulan) Tanggal Update 1. Update data keuangan per-periode pelaporan dilakukan maksimal satu hari berikutnya (H+1); Uraian : Tanggal : :00:00 maksimal TanggalUpdate : :00:00

6 2. Update revisi data keuangan pada suatu periode dapat dilakukan kapan saja; Uraian : Jika terdapat revisi atas akumulasi data penerimaan s.d dilakukan update data di tanggal Tanggal : :00:00 maksimal TanggalUpdate : :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":" ", "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":" :00:00","KodeAkun":"424121","Saldo":" ","TanggalUpdate":" :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).

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; 8. URL webservice BLU dikirimkan ke alamat : restblu@gmail.com

9 LIST REPORT WEBSERVICE BLU No BLU LINK STATUS KETERANGAN 1. BBLK PALEMBANG Port Port supaya diubah ke 80 atau 443 Susunan Array List 2. Universitas Negeri Terdapat Untuk data layanan, direvisi, tidak perlu Semarang (UNNES) 3. Politeknik Negeri Malang token Method Get pada WS Keuangan 4. BKMM Mata Makassar Data Tidak ada 5. RS Paru Dr.H.A Rotinsulu Method Get pada WS Keuangan, Format Tanggal da nisi data belum sesuai 6. RS Fatmawati Format data json belum sesuai 7. RSUP Dr. Sardjito Format Tanggal belum sesuai 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;

10 8. Universitas Negeri Surabaya Tidak dapat diakses 9. Universitas Negeri Belum ada Yogyakarta Webservice Keuangan, Belum ada Parameter 10. UIN Raden Fatah Port belum 443/ Universitas Jenderal Link tidak Soedirman dapat diakses Tanggal periode transaksi setidaknya H- 1 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