PHPackages                             black-coffee04/ws-siasn-php - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. black-coffee04/ws-siasn-php

ActiveLibrary[API Development](/categories/api)

black-coffee04/ws-siasn-php
===========================

Software Development Kit Web Service SiASN

2.0.1(1y ago)91234MITPHPPHP >=7.4CI passing

Since Jun 19Pushed 10mo ago1 watchersCompare

[ Source](https://github.com/black-coffee04/ws-siasn-php)[ Packagist](https://packagist.org/packages/black-coffee04/ws-siasn-php)[ RSS](/packages/black-coffee04-ws-siasn-php/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (2)Versions (14)Used By (0)

SDK PHP Web Services SIASN
==========================

[](#sdk-php-web-services-siasn)

[![Latest Version](https://camo.githubusercontent.com/f0f32befcb38c456aa92664de9cc5adab9560b03dea981d041044b48f18eefbf/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f626c61636b2d636f6666656530342f77732d736961736e2d7068702e7376673f7374796c653d666c61742d737175617265266c6162656c3d72656c65617365)](https://packagist.org/packages/black-coffee04/ws-siasn-php)[![PHP Version](https://camo.githubusercontent.com/4f9785b5a1ab84d31728030ce6e7f3532bdf833def03bf43064b1802324349b4/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f626c61636b2d636f6666656530342f77732d736961736e2d7068702e7376673f7374796c653d666c61742d737175617265)](https://php.net)[![tests](https://github.com/black-coffee04/ws-siasn-php/actions/workflows/tests.yml/badge.svg)](https://github.com/black-coffee04/ws-siasn-php/actions/workflows/tests.yml)[![Total Downloads](https://camo.githubusercontent.com/05dbc9231ec7d45edf514456a155eba6dc614be0a85270d26f0981dc5e660349/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f626c61636b2d636f6666656530342f77732d736961736e2d7068702e7376673f7374796c653d666c61742d73717561726526636f6c6f72423d6d656469756d76696f6c6574726564)](https://packagist.org/packages/black-coffee04/ws-siasn-php)

Selamat datang di SiASN Web Service SDK! SDK ini dirancang untuk memudahkan pengembang dalam mengakses layanan SiASN menggunakan PHP. Dengan SDK ini, Anda dapat mengintegrasikan aplikasi Anda dengan layanan SiASN seperti otentikasi, akses data referensi, dan operasi lainnya dengan mudah.

Daftar Isi
----------

[](#daftar-isi)

- [Instalasi](#instalasi)
    - [Requirement System](#requirement-system)
    - [Instalasi Menggunakan Composer](#instalasi-menggunakan-composer)
    - [Instalasi Manual](#instalasi-manual)
- [Konfigurasi](#konfigurasi)
    - [Detail Konfigurasi](#detail-konfigurasi)
- [Dokumentasi API](#dokumentasi-api)
    - [Authentication](#authentication)
    - [Referensi](#referensi)
    - [PNS](#pns)
    - [Jabatan](#jabatan)
    - [Dokumen](#dokumen)
    - [Pemberhentian](#pemberhentiaan)
    - [Pengadaan](#pengadaan)
    - [Penghargaan](#penghargaan)
    - [Kenaikan Pangkat](#kenaikan-pangkat)
    - [Riwayat](#riwayat)
    - [Angka Kredit](#angka-kredit)
    - [CPNS](#cpns)
    - [Diklat](#diklat)
    - [Hukuman Disiplin](#hukuman-disiplin)
    - [Kinerja Periodik](#kinerja-periodik)
    - [Kursus](#kursus)
    - [SKP](#skp)
- [Menjalankan Tes](#menjalankan-tes)
- [Lisensi](#lisensi)

Instalasi
---------

[](#instalasi)

### Requirement System

[](#requirement-system)

Pastikan sistem Anda memenuhi persyaratan berikut sebelum melanjutkan instalasi SDK SiASN:

- PHP versi minimal yang diperlukan adalah **7.4**
- Ekstensi PHP yang diperlukan:
    - `ext-curl`
    - `ext-json`

### Instalasi Menggunakan Composer

[](#instalasi-menggunakan-composer)

Anda dapat menginstal SDK SiASN menggunakan Composer. Pastikan Anda telah menginstal Composer sebelum memulai.

```
composer require black-coffee04/ws-siasn-php
```

**atau**

#### Tambahkan Baris Require ke File composer.json Anda

[](#tambahkan-baris-require-ke-file-composerjson-anda)

Jika Anda memilih untuk menambahkan dependensi SDK SiASN melalui file `composer.json`, berikut adalah langkah-langkahnya:

1. **Edit File composer.json**

    Buka file `composer.json` proyek Anda.
2. **Tambahkan Baris Require**

    Tambahkan baris berikut di dalam bagian `"require"`:

    ```
    {
      "require": {
        "black-coffee04/ws-siasn-php": "^1.*"
      }
    }
    ```

### Instalasi Manual

[](#instalasi-manual)

Jika Anda memilih untuk melakukan instalasi SDK SiASN secara manual, berikut adalah langkah-langkahnya:

1. **Unduh SDK**

    [Unduh SDK SiASN](https://github.com/black-coffee04/ws-siasn-php/archive/refs/heads/main.zip).
2. **Ekstrak SDK**

    Ekstrak file SDK ke dalam direktori proyek Anda.
3. **Gunakan Autoload**

    Pastikan untuk memasukkan file `autoload.php` SDK ke dalam proyek Anda. File ini akan mengatur autoload sehingga kelas-kelas SDK dapat diakses dengan benar. Berikut adalah contoh cara menggunakan autoload dalam aplikasi PHP:

    ```
    require_once __DIR__ . '/path/to/ws-siasn-php/autoload.php';
    ```

Konfigurasi
-----------

[](#konfigurasi)

Sebelum menggunakan SDK SiASN, pastikan Anda telah menyiapkan konfigurasi yang diperlukan. Konfigurasi ini biasanya berisi informasi otentikasi dan pengaturan lain yang diperlukan untuk mengakses layanan SiASN. Berikut adalah contoh konfigurasi yang perlu Anda siapkan:

```
require_once __DIR__ . './../vendor/autoload.php';

use SiASN\Sdk\SiasnClient;

$config = [
    "consumerKey"    => 'consumerKeyAnda',
    "consumerSecret" => 'consumerSecretAnda',
    "clientId"       => 'clientIdAnda',
    "ssoAccessToken" => 'ssoAccessTokenAnda'
];

$siasnClient = new SiasnClient($config);
```

### Detail Konfigurasi

[](#detail-konfigurasi)

ParameterNilai DefaultDeskripsi`consumerKey`-Kunci konsumen untuk otentikasi aplikasi.`consumerSecret`-Rahasia konsumen untuk otentikasi aplikasi.`clientId`-ID klien untuk otentikasi aplikasi.`ssoAccessToken`-Token otentikasi SSO.**atau**

Anda dapat melihat contoh penggunaan pada folder [examples](https://github.com/black-coffee04/ws-siasn-php/tree/main/examples).

Dokumentasi API
---------------

[](#dokumentasi-api)

### Authentication

[](#authentication)

Berikut adalah daftar lengkap metode yang tersedia pada resource Authentication:

MetodeDeskripsiKembalian`$siasnClient->authentication()->getWsoAccessToken()`Mengambil access token untuk layanan WSO SiASN.`string` Access token`$siasnClient->authentication()->getSsoAccessToken()`Mengambil access token untuk layanan SSO SiASN.`string` Access token#### Contoh Penggunaan Authentication

[](#contoh-penggunaan-authentication)

Mendapatkan Access Token WSO:

```
$siasnClient->authentication()->getWsoAccessToken();
```

Mendapatkan Access Token SSO:

```
$siasnClient->authentication()->getSsoAccessToken();
```

### Referensi

[](#referensi)

Berikut adalah daftar lengkap metode yang tersedia pada resource Referensi:

Referensi SIASN Client
----------------------

[](#referensi-siasn-client)

Berikut adalah daftar lengkap metode yang tersedia pada resource Referensi:

### Daftar Metode Referensi

[](#daftar-metode-referensi)

MetodeDeskripsiKembalian`$siasnClient->referensi()->unor($storeCache)`Mengambil data referensi Unit Organisasi (UNOR). Parameter `$storeCache` dapat diatur ke `true` untuk menyimpan data di cache dengan masa berlaku 3600 detik (default: `false`).`Array` data referensi Unit Organisasi (UNOR).`$siasnClient->referensi()->agama()`Mengambil data referensi agama.`Array` data referensi agama.`$siasnClient->referensi()->alasanHukumanDisiplin()`Mengambil data referensi alasan hukuman disiplin.`Array` data referensi alasan hukuman disiplin.`$siasnClient->referensi()->cltn()`Mengambil data referensi CLTN.`Array` data referensi CLTN.`$siasnClient->referensi()->dokumen()`Mengambil data referensi dokumen.`Array` data referensi dokumen.`$siasnClient->referensi()->eselon()`Mengambil data referensi eselon.`Array` data referensi eselon.`$siasnClient->referensi()->golonganPns()`Mengambil data referensi golongan PNS.`Array` data referensi golongan PNS.`$siasnClient->referensi()->instansi()`Mengambil data referensi instansi.`Array` data referensi instansi.`$siasnClient->referensi()->jabatanFungsional()`Mengambil data referensi jabatan fungsional.`Array` data referensi jabatan fungsional.`$siasnClient->referensi()->jabatanPelaksana()`Mengambil data referensi jabatan pelaksana.`Array` data referensi jabatan pelaksana.`$siasnClient->referensi()->jenisDiklat()`Mengambil data referensi jenis diklat.`Array` data referensi jenis diklat.`$siasnClient->referensi()->jenisHukuman()`Mengambil data referensi jenis hukuman.`Array` data referensi jenis hukuman.`$siasnClient->referensi()->jenisJabatan()`Mengambil data referensi jenis jabatan.`Array` data referensi jenis jabatan.`$siasnClient->referensi()->jenisKursus()`Mengambil data referensi jenis kursus.`Array` data referensi jenis kursus.`$siasnClient->referensi()->jenisMutasi()`Mengambil data referensi jenis mutasi.`Array` data referensi jenis mutasi.`$siasnClient->referensi()->jenisPegawai()`Mengambil data referensi jenis pegawai.`Array` data referensi jenis pegawai.`$siasnClient->referensi()->jenisPemberhentian()`Mengambil data referensi jenis pemberhentian.`Array` data referensi jenis pemberhentian.`$siasnClient->referensi()->jenisPengadaan()`Mengambil data referensi jenis pengadaan.`Array` data referensi jenis pengadaan.`$siasnClient->referensi()->jenisPensiun()`Mengambil data referensi jenis pensiun.`Array` data referensi jenis pensiun.`$siasnClient->referensi()->jenisPenugasan()`Mengambil data referensi jenis penugasan.`Array` data referensi jenis penugasan.`$siasnClient->referensi()->jenisRiwayat()`Mengambil data referensi jenis riwayat.`Array` data referensi jenis riwayat.`$siasnClient->referensi()->kabupaten()`Mengambil data referensi kabupaten.`Array` data referensi kabupaten.`$siasnClient->referensi()->kawin()`Mengambil data referensi kawin.`Array` data referensi kawin.`$siasnClient->referensi()->kedudukanHukum()`Mengambil data referensi kedudukan hukum.`Array` data referensi kedudukan hukum.`$siasnClient->referensi()->kelasJabatan()`Mengambil data referensi kelas jabatan.`Array` data referensi kelas jabatan.`$siasnClient->referensi()->kenaikanPangkat()`Mengambil data referensi kenaikan pangkat.`Array` data referensi kenaikan pangkat.`$siasnClient->referensi()->kepanitiaan()`Mengambil data referensi kepanitiaan.`Array` data referensi kepanitiaan.`$siasnClient->referensi()->koefisien()`Mengambil data referensi koefisien.`Array` data referensi koefisien.`$siasnClient->referensi()->kompetensi()`Mengambil data referensi kompetensi.`Array` data referensi kompetensi.`$siasnClient->referensi()->kpkn()`Mengambil data referensi KPKN.`Array` data referensi KPKN.`$siasnClient->referensi()->kuadranNilai()`Mengambil data referensi kuadran nilai.`Array` data referensi kuadran nilai.`$siasnClient->referensi()->kursus()`Mengambil data referensi kursus.`Array` data referensi kursus.`$siasnClient->referensi()->latihanStruktural()`Mengambil data referensi latihan struktural.`Array` data referensi latihan struktural.`$siasnClient->referensi()->pendidikan()`Mengambil data referensi pendidikan.`Array` data referensi pendidikan.`$siasnClient->referensi()->penghargaan()`Mengambil data referensi penghargaan.`Array` data referensi penghargaan.`$siasnClient->referensi()->perilakuDanKinerja()`Mengambil data referensi perilaku dan kinerja.`Array` data referensi perilaku dan kinerja.`$siasnClient->referensi()->periodik()`Mengambil data referensi periodik.`Array` data referensi periodik.`$siasnClient->referensi()->profesi()`Mengambil data referensi profesi.`Array` data referensi profesi.`$siasnClient->referensi()->rumpunJabatan()`Mengambil data referensi rumpun jabatan.`Array` data referensi rumpun jabatan.`$siasnClient->referensi()->satuanKerja()`Mengambil data referensi satuan kerja.`Array` data referensi satuan kerja.`$siasnClient->referensi()->subJabatan()`Mengambil data referensi sub jabatan.`Array` data referensi sub jabatan.`$siasnClient->referensi()->taspen()`Mengambil data referensi taspen.`Array` data referensi taspen.#### Contoh Penggunaan Referensi

[](#contoh-penggunaan-referensi)

```
#Buat ke true apa bila ingin menyimpan dalam cache, cache akan expired dalam 1 jam
$storeCache = true;

#Mengambil referensi data unor
$siasnClient->referensi()->unor($cache)->get();

#Mengambil referensi data agama
$siasnClient->referensi()->agama()->get();
```

#### Metode Tambahan

[](#metode-tambahan)

- **`->search($attributes)`**: Melakukan pencarian berdasarkan atribut yang ditentukan.
- **`->like($keywords)`**: Melakukan penyaringan dengan menggunakan kata kunci tertentu pada atribut yang telah ditentukan.
- **`->limit($limit)`**: Membatasi jumlah data yang ditampilkan berdasarkan nilai `$limit`.
- **`->get()`**: Mengambil hasil akhir dari pencarian dan penyaringan data.

> **Note:** Metode ini hanya berlaku untuk pemanggilan resource referensi saja, dan tidak dapat digunakan pada resource lain

#### Contoh Penggunaan Metode Tambahan

[](#contoh-penggunaan-metode-tambahan)

```
# Mengambil semua data referensi Unit Organisasi (UNOR)
$unorData = $siasnClient->referensi()->unor()->get();

# Mengambil data referensi UNOR dengan batasan 3 data
$unorDataLimited = $siasnClient->referensi()->unor()->limit(3)->get();

# Mengambil data referensi UNOR berdasarkan atribut 'NamaUnor' yang mengandung kata 'puskesmas' dengan batasan 3 data
$filteredUnorData = $siasnClient->referensi()
                                ->agama()
                                ->search('NamaUnor')
                                ->like('puskesmas')
                                ->limit(3)
                                ->get();

# Mengambil semua data referensi UNOR berdasarkan atribut 'NamaUnor' yang mengandung kata 'puskesmas'
$unfilteredUnorData = $siasnClient->referensi()
                                  ->agama()
                                  ->search('NamaUnor')
                                  ->like('puskesmas')
                                  ->get();
```

### PNS

[](#pns)

Berikut adalah daftar lengkap metode yang tersedia pada resource PNS:

MetodeDeskripsiParameterKembalian`$siasnClient->pns()->dataUtama($nipAsn)`Mengambil data utama ASN berdasarkan NIP ASN.`$nipAsn` (string): NIP ASNArray data utama ASN.`$siasnClient->pns()->dataPasangan($nipAsn)`Mengambil data pasangan ASN berdasarkan NIP ASN.`$nipAsn` (string): NIP ASNArray data pasangan ASN.`$siasnClient->pns()->dataAnak($nipAsn)`Mengambil data anak ASN berdasarkan NIP ASN.`$nipAsn` (string): NIP ASNArray data anak ASN.`$siasnClient->pns()->dataOrangTua($nipAsn)`Mengambil data orang tua ASN berdasarkan NIP ASN.`$nipAsn` (string): NIP ASNArray data orang tua ASN.`$siasnClient->pns()->refreshJabatan($nipAsn)`Memperbarui data jabatan ASN berdasarkan NIP ASN.`$nipAsn` (string): NIP ASNArray Respon api.`$siasnClient->pns()->refreshGolongan($nipAsn)`Memperbarui data golongan ASN berdasarkan NIP ASN.`$nipAsn` (string): NIP ASNArray Respon api.`$siasnClient->pns()->nilaiIpAsn($nipAsn)`Mengambil nilai IP ASN berdasarkan NIP ASN.`$nipAsn` (string): NIP ASNArray nilai IP ASN.`$siasnClient->pns()->foto($nipAsn)->setName($fileName)->outputStream()`Mengambil foto profil ASN berdasarkan NIP ASN dan menyimpannya sebagai file dengan nama tertentu.`$nipAsn` (string): NIP ASN, `$fileName` (string): Nama fileMenghasilkan output stream foto profil ASN.`$siasnClient->pns()->foto($nipAsn)->setName($fileName)->saveTo($path)`Menyimpan foto profil ASN ke direktori yang ditentukan.`$nipAsn` (string): NIP ASN, `$path` (string): direktoriString nama file.`$siasnClient->pns()->updateDataUtama([...])`Memperbarui data utama ASN dengan parameter yang diberikan.`$data` (array): Data yang akan diperbarui pada data utama ASNArray.#### Contoh Penggunaan Api PNS

[](#contoh-penggunaan-api-pns)

```
$nipAsn = 'xxxxxxxxxxxxxxxxxxxxx';

#Mengambil data pns berdasarkan NIP
$siasn  = new SiasnClient($config);

#Mengambil Data Utama
$dataUtama = $siasn->pns()->dataUtama($nipAsn);

$data = [
    "alamat"          => "string",
    "email"           => "string",
    "email_gov"       => "string",
    "kabupaten_id"    => "string",
    "karis_karsu"     => "string",
    "kelas_jabatan"   => "string",
    "kpkn_id"         => "string",
    "lokasi_kerja_id" => "string",
    "nomor_bpjs"      => "string",
    "nomor_hp"        => "string",
    "nomor_telpon"    => "string",
    "npwp_nomor"      => "string",
    "npwp_tanggal"    => "string",
    "pns_orang_id"    => "string",
    "tanggal_taspen"  => "string",
    "tapera_nomor"    => "string",
    "taspen_nomor"    => "string",
];
#Update data utama
$update = $siasn->pns()->updateDataUtama($nipAsn);
var_dump($update);
```

### Jabatan

[](#jabatan)

Berikut adalah daftar lengkap metode yang tersedia pada resource **Jabatan**:

MetodeDeskripsiParameterKembalian`$siasnClient->jabatan()->pns($nipAsn)`Mengambil data jabatan ASN berdasarkan NIP ASN.`$nipAsn` (string): NIP ASNArray data jabatan ASN.`$siasnClient->jabatan()->riwayat($idJabatan)`Mengambil data riwayat jabatan berdasarkan ID Jabatan.`$idJabatan` (string): ID JabatanArray data riwayat jabatan.`$siasnClient->jabatan()->create($data)->save()`Menambahkan data jabatan baru.`$data` (array): Data jabatanArray respons API.`$siasnClient->jabatan()->createUnorJabatan($data)->save()`Menambahkan data unit organisasi jabatan.`$data` (array): Data jabatanArray respons API.`$siasnClient->jabatan()->remove($idRiwayatJabatan)`Menghapus riwayat jabatan berdasarkan ID.`$idRiwayatJabatan` (string): ID Riwayat JabatanArray respons API atau `false`.#### Metode Tambahan

[](#metode-tambahan-1)

**`->includeDokumen($file)`**: Menambahkan dokumen/file saat menambahkan data jabatan `$file` bisa menggunakan url/binary file.

#### Contoh Penggunaan Api Jabatan

[](#contoh-penggunaan-api-jabatan)

Mendapatkan data jabatan PNS:

```
$siasnClient->jabatan()->pns($nipAsn);

#Menambahakan data jabatan beserta dokumennya
$dokumen = "http://url/to/pdf"; #Bisa mengunakan url/binary file
$riwayatJabatanId = $siasnClient->jabatan()
    ->create($data)
    ->includeDokumen($dokumen)
    ->save();
```

### Dokumen

[](#dokumen)

Berikut adalah daftar lengkap metode yang tersedia pada resource dokumen:

MetodeDeskripsiParameterKembalian`$siasnClient->dokumen()->download($args)->setName($fileName)->outputStream()`Mengambil dokumen pada siasn dan langsung menampilkan tanpa disimpan pada local server.`$args` >(json), (array), (object): respon upload file pada siasn >(string) $dokUri, `$fileName` (string): Nama fileMenghasilkan output stream dokumen.`$siasnClient->dokumen()->download($args)->setName($fileName)->saveTo($path)`Menyimpan dokumen ke direktori yang ditentukan.`$args` >(json), (array), (object): respon upload file pada siasn >(string) $dokUri, `$fileName`(string): Nama file,`$path ` (string): direktoriString $filename.`$siasnClient->dokumen()->upload($idRefDokumen, $file)`Mengunggah dokumen ke SiASN dari file lokal.`(string) $idRefDokumen`, `(string) $file`: Path file lokal atau URLData dari respons upload dokumen ke SiASN.`$siasnClient->dokumen()->uploadRiwayat($idRiwayat, $idRefDokumen, $file)`Mengunggah riwayat dokumen ke SiASN dari file lokal.`(string) $idRiwayat`, `(string) $idRefDokumen`, `(string) $file`: Path file lokal atau URLData dari respons upload riwayat dokumen ke SiASN.#### Contoh Penggunaan Api Dokumen

[](#contoh-penggunaan-api-dokumen)

```
$idRefDokumen = 'string';
$dokumen      = 'path\to\esample.pdf' #Dapat menggunakan binary dokumen/URL dokumen;
$path         = 'path/to/penyimpanan/dokumen';
$fileName     = 'nama file tanpa extensi'; #Nama file tanpa extensi

$response     = $siasnClient->dokumen()->upload($idRefDokumen, $dokumen);
#Save dokumen ke local server
echo $siasnClient->dokumen()->download($response)->setName($fileName)->saveTo($path);

#Tampilkan dokumen tanpa menyimpan
$siasnClient->dokumen()->download($response)->setName($fileName)->outputStream();
```

### Pemberhentiaan

[](#pemberhentiaan)

Berikut adalah daftar lengkap metode yang tersedia pada resource pemberhentian:

MetodeDeskripsiParameterKembalian`$siasnClient->pemberhentian()->get($tanggalAwal, $tanggalAkhir)`Mengambil semua data pensiun instansi berdasarkan periode tanggal.`$tanggalAwal` (string): Tanggal Awal, `$tanggalAkhir` (string): Tanggal AkhirArray data pemberhentian Instansi.#### Contoh Penggunaan Api Pemberhentian

[](#contoh-penggunaan-api-pemberhentian)

```
$tanggalAwal   = '2022-01-01';
$tanggalAkhir  = '2022-12-01';

$daftarPemberhentian   = $siasnClient->pemberhentian()->get($tanggalAwal, $tanggalAkhir);
```

### Pengadaan

[](#pengadaan)

Berikut adalah daftar lengkap metode yang tersedia pada resource pengadaan:

MetodeDeskripsiParameterKembalian`$siasnClient->pengadaan()->get($tahun)`Mengambil semua data pengadaan instansi berdasarkan tahun pengadaan.`$tahun` (string): Tanggal AwalArray data pengadaan Instansi.`$siasnClient->pengadaan()->dokumen()`Mengambil semua data dokumen pengadaan instansi.-Array data dokumen pengadaan Instansi.#### Contoh Penggunaan Api pengadaan

[](#contoh-penggunaan-api-pengadaan)

```
$tahunAnggaran = '2023';

$daftarPengadaan  = $siasnClient->pengadaan()->get($tahunAnggaran);
$dokumenPengadaan = $siasnClient->pengadaan()->dokumen();
```

### Penghargaan

[](#penghargaan)

Berikut adalah daftar lengkap metode yang tersedia pada resource **Penghargaan**:

MetodeDeskripsiParameterKembalian`$siasnClient->penghargaan()->get($idRiwayatPenghargaan)`Mengambil data riwayat penghargaan berdasarkan ID riwayat.`$idRiwayatPenghargaan` (string): ID riwayat penghargaanArray data riwayat penghargaan.`$siasnClient->penghargaan()->create($data)->save()`Membuat data riwayat penghargaan tanpa dokumen.`$data` (array): Data penghargaanArray data penghargaan.`$siasnClient->penghargaan()->create($data)->includeDokumen($file)->save()`Membuat data riwayat penghargaan dengan dokumen.`$data` (array): Data penghargaan, `$file` (string): Path file atau URL dokumenArray data penghargaan.`$siasnClient->penghargaan()->remove($idRiwayatPenghargaan)`Menghapus data riwayat penghargaan.`$idRiwayatPenghargaan` (string): ID riwayat penghargaanArray respons API atau `false`.#### Contoh Penggunaan Api Penghargaan

[](#contoh-penggunaan-api-penghargaan)

```
#minyam data penghargaan
$data = [
    "hargaId"    => "ref_penghargaan",
    "pnsOrangId" => "pnsOrangId",
    "skDate"     => "dd-mm-yyyy",
    "skNomor"    => "string",
    "tahun"      => int,
];

$response = $siasnClient->penghargaan()->create($data)->save();

if (isset($response['success']) && $response['success']) {
    #mengambil data riwayat penghargaan
    $penghargaan = $siasnClient->penghargaan()->get($response['data']['id']);
}

print_r($penghargaan);

#Hapus data riwayat penghargaan
$siasnClient->penghargaan()->remove($idRiwayatPenghargaan)
```

### Kenaikan Pangkat

[](#kenaikan-pangkat)

Berikut adalah daftar lengkap metode yang tersedia pada resource kp:

Daftar Metode SiASN Client
--------------------------

[](#daftar-metode-siasn-client)

MetodeDeskripsiParameterKembalian`$siasnClient->kp()->get($tanggalAwal, $tanggalAkhir)`Mengambil semua data kenaikan pangkat instansi berdasarkan periode kp.`$tanggalAwal` (string): Tanggal awal periode KP
`$tanggalAkhir` (string): Tanggal akhir periode KPArray data kenaikan pangkat instansi sesuai periode KP.`$siasnClient->kp()->uploadDokumenSk($idUsulan, $nomorSk, $tanggalSk, $file)`Mengunggah dokumen SK terkait usulan kenaikan pangkat instansi.`$idUsulan` (string): ID usulan kenaikan pangkat
`$nomorSk` (string): Nomor SK
`$tanggalSk` (string): Tanggal SK
`$file` (mixed): Dokumen SK yang akan diunggahArray data kenaikan pangkat instansi yang telah diperbarui dengan dokumen SK terlampir.#### Contoh Penggunaan Api Kenaikan Pangkat

[](#contoh-penggunaan-api-kenaikan-pangkat)

```
$periode = '2022-04-01';

$daftarKp = $siasnClient->kp()->get($periode);
```

### Riwayat

[](#riwayat)

Berikut adalah daftar lengkap metode yang tersedia pada resource riwayat:

MetodeDeskripsiParameterKembalian`$siasnClient->riwayat()->angkaKredit($nip)`Mengambil data riwayat angka kredit dari ASN.`$nip` (string): NIP AsnArray data riwayat angka kredit.`$siasnClient->riwayat()->cltn($nip)`Mengambil data riwayat cltn dari ASN.`$nip` (string): NIP AsnArray data riwayat cltn.`$siasnClient->riwayat()->diklat($nip)`Mengambil data riwayat diklat dari ASN.`$nip` (string): NIP AsnArray data riwayat diklat.`$siasnClient->riwayat()->dp3($nip)`Mengambil data riwayat dp3 dari ASN.`$nip` (string): NIP AsnArray data riwayat dp3.`$siasnClient->riwayat()->golongan($nip)`Mengambil data riwayat golongan dari ASN.`$nip` (string): NIP AsnArray data riwayat golongan.`$siasnClient->riwayat()->hukdis($nip)`Mengambil data riwayat hukdis dari ASN.`$nip` (string): NIP AsnArray data riwayat hukdis.`$siasnClient->riwayat()->jabatan($nip)`Mengambil data riwayat jabatan dari ASN.`$nip` (string): NIP AsnArray data riwayat jabatan.`$siasnClient->riwayat()->kinerjaPeriodik($nip)`Mengambil data riwayat kinerja periodik dari ASN.`$nip` (string): NIP AsnArray data riwayat kinerja periodik.`$siasnClient->riwayat()->kursus($nip)`Mengambil data riwayat kursus dari ASN.`$nip` (string): NIP AsnArray data riwayat kursus.`$siasnClient->riwayat()->masaKerja($nip)`Mengambil data riwayat masa kerja dari ASN.`$nip` (string): NIP AsnArray data riwayat masa kerja.`$siasnClient->riwayat()->pemberhentian($nip)`Mengambil data riwayat pemberhentian dari ASN.`$nip` (string): NIP AsnArray data riwayat pemberhentian.`$siasnClient->riwayat()->pendidikan($nip)`Mengambil data riwayat pendidikan dari ASN.`$nip` (string): NIP AsnArray data riwayat pendidikan.`$siasnClient->riwayat()->penghargaan($nip)`Mengambil data riwayat penghargaan dari ASN.`$nip` (string): NIP AsnArray data riwayat penghargaan.`$siasnClient->riwayat()->pindahInstansi($nip)`Mengambil data riwayat pindah instansi dari ASN.`$nip` (string): NIP AsnArray data riwayat pindah instansi.`$siasnClient->riwayat()->unor($nip)`Mengambil data riwayat unor dari ASN.`$nip` (string): NIP AsnArray data riwayat unor.`$siasnClient->riwayat()->pwk($nip)`Mengambil data riwayat pwk dari ASN.`$nip` (string): NIP AsnArray data riwayat pwk.`$siasnClient->riwayat()->skp($nip)`Mengambil data riwayat skp dari ASN.`$nip` (string): NIP AsnArray data riwayat skp.`$siasnClient->riwayat()->skp22($nip)`Mengambil data riwayat skp 2022 dari ASN.`$nip` (string): NIP AsnArray data riwayat skp 2022.#### Contoh Penggunaan Api Riwayat

[](#contoh-penggunaan-api-riwayat)

```
$nip  = 'xxxxxxxxxxxxxxxxxx';

$riwayatKursus = $siasnClient->riwayat()->kursus($nip);
```

### Angka Kredit

[](#angka-kredit)

Berikut adalah daftar lengkap metode yang tersedia pada resource **Angka Kredit**:

MetodeDeskripsiParameterKembalian`$siasnClient->angkaKredit()->get($idRiwayatAngkaKredit)`Mengambil data riwayat angka kredit berdasarkan ID riwayat.`$idRiwayatAngkaKredit` (string): ID riwayat angka kreditArray data riwayat angka kredit.`$siasnClient->angkaKredit()->create($data)->save()`Membuat data riwayat angka kredit tanpa dokumen.`$data` (array): Data angka kreditArray data angka kredit.`$siasnClient->angkaKredit()->create($data)->includeDokumen($file)->save()`Membuat data riwayat angka kredit dengan dokumen.`$data` (array): Data angka kredit, `$file` (string): Path file atau URL dokumenArray data angka kredit.`$siasnClient->angkaKredit()->remove($idRiwayatAngkaKredit)`Menghapus data riwayat angka kredit.`$idRiwayatAngkaKredit` (string): ID riwayat angka kreditArray respons API atau `false`.#### Contoh Penggunaan Api Angka Kredit

[](#contoh-penggunaan-api-angka-kredit)

```
$data = [
    "bulanMulaiPenailan"   => "string",
    "bulanSelesaiPenailan" => "string",
    "isAngkaKreditPertama" => "string",
    "isIntegrasi"          => "string",
    "isKonversi"           => "string",
    "kreditBaruTotal"      => "string",
    "kreditPenunjangBaru"  => "string",
    "kreditUtamaBaru"      => "string",
    "nomorSk"              => "string",
    "pnsId"                => "pnsId",
    "rwJabatanId"          => "rwJabatanId",
    "tahunMulaiPenailan"   => "yyyy",
    "tahunSelesaiPenailan" => "yyyy",
    "tanggalSk"            => "dd-mm-yyyy",
];

#Menyimpan data angka kredir
$response = $siasnClient->angkaKredit()
    ->create($data)
    ->includeDokumen("https://url_to_file_angka_kredit.pdf")
    ->save();
if (isset($response['success']) && $response['success']) {
    #Mengambil data angka kredir
    $angkaKredit = $siasnClient->angkaKredit()->get($response['data']['id']);
    #Menghapus data angka kredir
    $angkaKredit = $siasnClient->angkaKredit()->remove($response['data']['id']);
}
var_dump($angkaKredit);die();
```

CPNS
----

[](#cpns)

Berikut adalah daftar lengkap metode yang tersedia pada resource cpns:

MetodeDeskripsiParameterKembalian`$siasnClient->cpns()->create($data)->includeDokumen($skCpns, $spmt)->save()`Menambahkan data cpns dengan dokumen.`$data` (array): Data CPNS, `$file` (string) Dokumen SK CPNS file/URLArray data.`$siasnClient->cpns()->create($data)->save()`Menambahkan data cpns tanpa dokumen.`$data` (array): Data CPNSArray data.#### Contoh Penggunaan Api CPNS

[](#contoh-penggunaan-api-cpns)

```
$skCpns = "path/to/dokumen.pdf";
$spmt = "path/to/dokumen.pdf";
$siasnClient->cpns()
    ->create($data)
    ->includeDokumen($skCpns, $spmt) #URL FILE atau Path to dokumen
    ->save()
```

Diklat
------

[](#diklat)

Berikut adalah daftar lengkap metode yang tersedia pada resource diklat:

MetodeDeskripsiParameterKembalian`$siasnClient->diklat()->get($idRiwayatDiklat)`Mengambil data riwayat diklat berdasarkan id riwayat.`$idRiwayatDiklat` (string): Id riwayat diklatArray data riwayat diklat.`$siasnClient->diklat()->create($data)->save()`Membuat data riwayat diklat tanpa dokumen.`$data` (array): data diklatArray data diklat.`$siasnClient->diklat()->create($data)->includeDokumen($file)->save()`Membuat data riwayat diklat dengan dokumen.`$data` (array): data diklat, `$file` (string) path file atau url dokumenArray data diklat.`$siasnClient->diklat()->remove($idRiwayatDiklat)`Menghapus data riwayat diklat.`$idRiwayatDiklat` (string) Id riwayat diklatArray.#### Contoh Penggunaan Api Diklat

[](#contoh-penggunaan-api-diklat)

```
$data = [
    "bobot"                  => integer,
    "id"                     => null,
    "institusiPenyelenggara" => "string",
    "jenisKompetensi"        => "string",
    "jumlahJam"              => integer,
    "latihanStrukturalId"    => "string",
    "nomor"                  => "string",
    "pnsOrangId"             => "string",
    "tahun"                  => integer,
    "tanggal"                => "d-m-Y",
    "tanggalSelesai"         => "d-m-Y",
];
$response = $siasnClient->diklat()
    ->create($data)
    ->includeDokumen("file.pdf") //Hapus methods ini jika tidak menggunakan dokumen
    ->save();

$riwayatDiklat = $siasnClient->diklat()->get($response['data']['id']);
print_r($riwayatDiklat);

$riwayatDiklat = $siasnClient->diklat()->remove($response['data']['id']);
```

Hukuman Disiplin
----------------

[](#hukuman-disiplin)

Berikut adalah daftar lengkap metode yang tersedia pada resource hukuman disiplin:

MetodeDeskripsiParameterKembalian`$siasnClient->hukdis()->get($idRiwayatHukdis)`Mengambil data riwayat hukdis berdasarkan id riwayat.`$idRiwayatHukdis` (string): Id riwayat hukdisArray data riwayat hukdis.`$siasnClient->hukdis()->create($data)->save()`Membuat data riwayat hukdis tanpa dokumen.`$data` (array): data hukdisArray data hukdis.`$siasnClient->hukdis()->create($data)->includeDokumen($file)->save()`Membuat data riwayat hukdis dengan dokumen.`$data` (array): data hukdis, `$file` (string) path file atau url dokumenArray data hukdis.#### Contoh Penggunaan Api Hukdis

[](#contoh-penggunaan-api-hukdis)

```
$data = [
    "akhirHukumanTanggal"       => "string",
    "alasanHukumanDisiplinId"   => "string",
    "golonganId"                => "string",
    "golonganLama"              => "string",
    "hukdisYangDiberhentikanId" => "string",
    "hukumanTanggal"            => "string",
    "id"                        => "string",
    "jenisHukumanId"            => "string",
    "jenisTingkatHukumanId"     => "string",
    "kedudukanHukumId"          => "string",
    "keterangan"                => "string",
    "masaBulan"                 => "string",
    "masaTahun"                 => "string",
    "nomorPp"                   => "string",
    "pnsOrangId"                => "string",
    "skNomor"                   => "string",
    "skPembatalanNomor"         => "string",
    "skPembatalanTanggal"       => "string",
    "skTanggal"                 => "string",
];
$response = $siasnClient->hukdis()
    ->create($data)
    ->includeDokumen("path/to/dokumen.pdf") //Hapus metod ini apabila tidak menggunakan dokumen
    ->save();

print_r($siasnClient->hukdis()->get($response['data']['id']));
```

Kinerja Periodik
----------------

[](#kinerja-periodik)

Berikut adalah daftar lengkap metode yang tersedia pada resource kinerja periodik:

MetodeDeskripsiParameterKembalian`$siasnClient->kinerjaPeriodik()->create($data)->save()`Membuat data riwayat kinerja periodik tanpa dokumen.`$data` (array): data kinerja periodikArray data kinerja periodik`$siasnClient->kinerjaPeriodik()->create($data)->includeDokumen($file)->save()`Membuat data riwayat kinerja periodik dengan dokumen.`$data` (array): data kinerja periodik
`$file` (string): path file atau URL dokumenArray data kinerja periodik`$siasnClient->kinerjaPeriodik()->remove($idRiwayatKinerjaPeriodik)`Menghapus data riwayat kinerja periodik.`$idRiwayatKinerjaPeriodik` (string): ID riwayat kinerja periodikArray atau `false` jika gagal#### Contoh Penggunaan Api Kinerja Periodik

[](#contoh-penggunaan-api-kinerja-periodik)

```
$data        = [
    "bulanMulaiPenilaian"   => "numeric",
    "bulanSelesaiPenilaian" => "numeric",
    "hasilKinerjaNilai"     => "referensi perilakuDanKinerja", //integer
    "koefisienId"           => "referensi koefisien",
    "kuadranKinerjaNilai"   => referensi kuadranNilai,
    "penilaiGolongan"       => "referensi golonganPns",
    "penilaiJabatanNama"    => "string",
    "penilaiNama"           => "string",
    "penilaiNipNrp"         => "string",
    "penilaiUnorNama"       => "string",
    "perilakuKerjaNilai"    => "referensi perilakuDanKinerja", //integer,
    "periodikId"            => "referensi periodik",
    "pnsDinilaiId"          => "string",
    "statusPenilai"         => "ASN/NON ASN",
    "tahun"                 => integer,
    "tahunMulaiPenilaian"   => integer,
    "tahunSelesaiPenilaian" => integer,
];

$response = $siasnClient->kinerjaPeriodik()
    ->create($data)
    ->includeDokumen("https://pdfobject.com/pdf/sample.pdf")
    ->save();

$deleted = $siasnClient->kinerjaPeriodik()->remove($response['data']['id']);
```

Kursus
------

[](#kursus)

Berikut adalah daftar lengkap metode yang tersedia pada resource kursus:

MetodeDeskripsiParameterKembalian`$siasnClient->kursus()->get($idRiwayatKursus)`Mengambil data riwayat kursus berdasarkan ID.`$idRiwayatKursus` (string): ID riwayat kursusArray data riwayat kursus`$siasnClient->kursus()->create($data)->save()`Membuat data riwayat kursus tanpa dokumen.`$data` (array): data kursusArray data kursus`$siasnClient->kursus()->create($data)->includeDokumen($file)->save()`Membuat data riwayat kursus dengan dokumen.`$data` (array): data kursus
`$file` (string): path file atau URL dokumenArray data kursus`$siasnClient->kursus()->remove($idRiwayatKursus)`Menghapus data riwayat kursus.`$idRiwayatKursus` (string): ID riwayat kursusArray atau `false` jika gagal#### Contoh Penggunaan Api Kursus

[](#contoh-penggunaan-api-kursus)

```
$data = [
    "instansiId"             => "string",
    "institusiPenyelenggara" => "string",
    "jenisDiklatId"          => "referensi jenis diklat",
    "jenisKursus"            => "",
    "jenisKursusSertipikat"  => "string",
    "jumlahJam"              => integer,
    "lokasiId"               => "",
    "namaKursus"             => "string",
    "nomorSertipikat"        => "string",
    "pnsOrangId"             => "string",
    "tahunKursus"            => integer,
    "tanggalKursus"          => "string",
    "tanggalSelesaiKursus"   => "string",
];
$response = $siasnClient->kursus()->create($data)->save();
$kursus = $siasnClient->kursus()->get($response['data']['id']);

$siasnClient->kursus()->remove($response['data']['id']);
```

SKP
---

[](#skp)

Berikut adalah daftar lengkap metode yang tersedia pada resource skp:

Daftar Metode SiASN Client untuk SKP
------------------------------------

[](#daftar-metode-siasn-client-untuk-skp)

MetodeDeskripsiParameterKembalian`$skp = $siasnClient->skp()->get($tahun, $idRiwayatSkp);`Mengambil data SKP berdasarkan tahun dan ID riwayat SKP.`$tahun` (string): Tahun data SKP
`$idRiwayatSkp` (string): ID riwayat SKPArray data SKP sesuai dengan tahun dan ID riwayat SKP.`$skp = $siasnClient->skp()->create($tahun, $data)->includeDokumen($file)->save();`Membuat data SKP baru, menyertakan dokumen, dan menyimpannya.`$tahun` (string): Tahun data SKP
`$data` (array): Data untuk dibuat
`$file` (mixed): Dokumen yang akan disertakanArray data SKP yang disimpan setelah operasi berhasil.#### Contoh Penggunaan Api SKP

[](#contoh-penggunaan-api-skp)

```
#minyam data kursus
$response = $siasnClient->skp()
    ->create($tahun, $data)
    ->includeDokumen($file)
    ->save();

#mengambil data riwayat skp
$skp = $siasnClient->skp()->get($tahun, $idRiwayatSkp);

print_r($skp);
```

Menjalankan Tes
---------------

[](#menjalankan-tes)

Untuk menjalankan tes pada SDK ini, pastikan Anda telah menginstal dependensi dengan Composer dan konfigurasi yang diperlukan seperti yang dijelaskan sebelumnya.

### Langkah-langkah Menjalankan Tes

[](#langkah-langkah-menjalankan-tes)

1. **Persiapkan Lingkungan**

    Pastikan lingkungan pengembangan Anda sudah siap dengan PHP >= 7.4 dan ekstensi yang diperlukan seperti `ext-curl` dan `ext-json`.
2. **Clone Repositori**

    Clone repositori SDK ini ke komputer lokal Anda:

    ```
    git clone https://github.com/black-coffee04/ws-siasn-php.git
    cd ws-siasn-php
    ```
3. **Instal Dependensi**

    Instal semua dependensi menggunakan Composer:

    ```
    composer install
    ```
4. **Jalankan Test**

    Jalankan perintah untuk menjalankan tes:

    ```
    composer test

    composer test:service #Testing service
    ```

License
-------

[](#license)

[MIT](https://github.com/black-coffee04/ws-siasn-php/blob/main/LICENSE.md)

###  Health Score

33

—

LowBetter than 75% of packages

Maintenance49

Moderate activity, may be stable

Popularity18

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity47

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~21 days

Recently: every ~37 days

Total

12

Last Release

452d ago

Major Versions

1.1.1 → 2.0.12025-02-14

### Community

Maintainers

![](https://www.gravatar.com/avatar/d9eabc676253870205f6e54c75a7a0000a670ca2bddee74f7eedf8c0130d23f2?d=identicon)[black-coffee04](/maintainers/black-coffee04)

---

Top Contributors

[![black-coffee04](https://avatars.githubusercontent.com/u/171791784?v=4)](https://github.com/black-coffee04 "black-coffee04 (53 commits)")

---

Tags

api-siasnsdk-phpsdk-php-siasnsdk-siasnsdk-ws-siasn-phpsdk-wssiasnsiasnsiasn-apisiasn-api-phpsiasn-phpsiasn-referensisiasn-referensi-datasetweb-service-siasnws-siasn-phpwssiasnsdksiasnws siasnws siasn phpweb service siasnsiasn bkn

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/black-coffee04-ws-siasn-php/health.svg)

```
[![Health](https://phpackages.com/badges/black-coffee04-ws-siasn-php/health.svg)](https://phpackages.com/packages/black-coffee04-ws-siasn-php)
```

###  Alternatives

[openai-php/laravel

OpenAI PHP for Laravel is a supercharged PHP API client that allows you to interact with the Open AI API

3.7k7.6M74](/packages/openai-php-laravel)[saloonphp/saloon

Build beautiful API integrations and SDKs with Saloon

2.4k9.6M468](/packages/saloonphp-saloon)[facebook/php-business-sdk

PHP SDK for Facebook Business

90121.9M34](/packages/facebook-php-business-sdk)[php-opencloud/openstack

PHP SDK for OpenStack APIs. Supports BlockStorage, Compute, Identity, Images, Networking and Metric Gnocchi

2292.2M24](/packages/php-opencloud-openstack)[mailchimp/transactional

458.9M16](/packages/mailchimp-transactional)[resend/resend-php

Resend PHP library.

564.7M21](/packages/resend-resend-php)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)