https://github.com/wakataw/pyproc
SPSE (Sistem Pengadaan Secara Elektronik) Python API Wrapper
https://github.com/wakataw/pyproc
data e-procurement lkpp lpse pengadaan python sedot spse
Last synced: 16 days ago
JSON representation
SPSE (Sistem Pengadaan Secara Elektronik) Python API Wrapper
- Host: GitHub
- URL: https://github.com/wakataw/pyproc
- Owner: wakataw
- License: mit
- Created: 2019-10-03T09:22:03.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2025-11-08T19:23:06.000Z (3 months ago)
- Last Synced: 2025-11-08T21:07:31.208Z (3 months ago)
- Topics: data, e-procurement, lkpp, lpse, pengadaan, python, sedot, spse
- Language: Python
- Homepage:
- Size: 267 KB
- Stars: 31
- Watchers: 6
- Forks: 22
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# PyProc
 [](https://pypi.org/project/pyproc/) [](https://www.python.org/downloads/) [](https://github.com/wakataw/pyproc)
PyProc (Python Procurement) merupakan wrapper untuk API SPSE yang ditulis dalam bahasa Python. Sistem Pengadaan Secara Elektronik (SPSE) SPSE merupakan aplikasi e-Procurement yang dikembangkan oleh LKPP untuk digunakan oleh LPSE di instansi pemerintah seluruh Indonesia.
> DISCLAIMER:
>
> Penulis tidak terafiliasi dengan pengembang SPSE atau pemilik aplikasi SPSE. Software ini dikembangkan dengan tujuan akademis, bentuk pengawasan oleh masyarakat, dan membantu pengusaha untuk mempermudah otomasi perolehan informasi pengadaan dari pemerintah.
>
> Penggunaan yang tidak wajar dan mengganggu sebagian atau seluruh fungsi aplikasi SPSE pada satuan kerja menjadi tanggung jawab masing-masing pengguna.
>
> PyProc ada karena SPSE ada, jadi gunakanlah dengan bijak dan secukupnya.
## Pemasangan
Pemasangan PyProc via `pip`:
```bash
$ pip install pyproc
```
Upgrade PyProc via `pip`:
```bash
$ pip install pyproc --upgrade
```
Instalasi versi unstable:
```bash
$ pip install git+https://github.com/wakataw/pyproc.git
```
## Penggunaan Command Line Interface
### Download Data LPSE
Format Command
```bash
$ pyproc [ARGUMENT] DAFTAR_LPSE
```
**Arguments**
| argumen | contoh | diperlukan | default | keterangan |
|-----------------------------|---------------------------------------------|------------|----------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `DAFTAR_LPSE` | `pyproc pu` | Ya | - | Daftar alamat LPSE yang akan diunduh.
[Format Daftar LPSE](#format-daftar-lpse-lanjutan) |
| `-h --help` | `pyproc --help` | optional | - | menampilkan keterangan dan bantuan |
| `-k --keyword` | `pyproc --keyword "mobil dinas" ...` | optional | - | filter pencarian index paket berdasarkan kata kunci tertentu |
| `-t --tahun-anggaran` | `pyproc --tahun-anggaran 2021 ...` | optional | Tahun Berjalan | Filter pencarian index paket berdasarkan tahun anggaran tertentu. Fungsi ini hanya berlaku mulai dari SPSE 4.4.
Format Penulisan:
**ALL**: mengunduh seluruh data
**2021**: mengunduh data untuk tahun 2021
**2015,2018,2019**: mengunduh data untuk tahun 2015, 2018, dan 2019
**2011-2020** mengunduh data untuk tahun 2011 s.d. 2020 |
| `--kategori` | `pyproc --kategori PENGADAAN_BARANG ...` | optional | - | Filter pencarian berdasarkan kategori pengadaan.
Daftar kategori: `PENGADAAN_BARANG`, `JASA_KONSULTANSI_BADAN_USAHA_NON_KONSTRUKSI`, `PEKERJAAN_KONSTRUKSI`, `JASA_LAINNYA`, `JASA_KONSULTANSI_PERORANGAN`, `JASA_KONSULTANSI_BADAN_USAHA_KONSTRUKSI` |
| `--nama-penyedia` | `pyproc --nama-penyedia "PT SUKA MAJU" ...` | optional | - | Filter pencarian index paket berdasarkan nama penyedia |
| `-c --chunk-size` | `pyproc --chunk-size 25 ...` | optional | 25 | Jumlah daftar paket per halaman yang diunduh. Semakin besar jumlah tidak menjamin proses download semakin cepat. Gunakanlah jumlah data yang wajar sehingga tidak membebani server SPSE. |
| `-w --workers` | `pyproc --workers 4 ...` | optional | 8 | Jumlah koneksi yang berjalan secara bersamaan saat mengunduh detil paket dengan maksimal 10 worker. |
| `-x --timeout` | `pyproc --timeout 60 ...` | optional | 30 | Waktu tunggu jika koneksi lambat (dalam detik) |
| `-n --non-tender` | `pyproc --non-tender ...` | optional | FALSE | Tambahkan argumen ini untuk mengunduh data non-tender/pengadaan langsung |
| `-d --index-download-delay` | `pyproc --index-download-delay 5 ...` | optional | 1 | Waktu jeda download index paket untuk setiap halaman/batch |
| `-o --output` | `pyproc --ouput csv ...` | optional | csv | Jenis data keluaran/hasil dari download. Format yang didukung csv dan json. Karena keterbatasan format, tidak semua data ditampilkan pada format csv. Jika memerlukan data detil yang komprehensif, gunakan format json karena mencangkup semua data detail. |
| `--keep-index` | `pyproc --keep-index ...` | optinal | FALSE | pyproc akan membentuk file idx (sqlite3 database) saat proses download dan akan dihapus ketika proses selesai. Tambahkan argumen ini jika tidak ingin menghapus database tersebut. |
| `-r --resume` | `pyproc --resume ...` | optinal | FALSE | Tambahkan argument ini untuk melanjutkan proses yang gagal (karena internet putus atau gangguan koneksi lainnya). Namun pastikan bahwa seluruh index sudah berhasil diunduh karena argumen --resume akan melewati proses download index. |
| `-s --sep` | `pyproc --sep ";" kemenkeu` | optional | `;` titik koma | Set custom separator untuk output format csv |
| `--log` | `pyproc --log INFO ...` | optional | INFO | Argumen untuk setting informasi yang ditampilkan pyproc pada terminal. Daftar nilai yang didukung:
`DEBUG`: menampilkan informasi sedetil mungkin
`INFO`: menampilkan informasi penting saja
`WARNING`: hanya menampilkan informasi yang bersifat warning
`ERROR`: hanya menampilkan error
`CRITICAL`: hanya menampilkan permasalahan yang bersifat kritis saja |
### Format Daftar LPSE (lanjutan)
PyProc dapat mengunduh data dari 1 atau lebih LPSE. Proses tersebut akan berjalan sesuai dengan nilai `DAFTAR_LPSE` yang diberikan user. Beberapa format yang didukung oleh PyProc adalah sebagai berikut:
- Download data dengan menyertakan nama file hasil download
Untuk set nama file secara manual, gunakan format `"alamatlpse[titik_koma]namafile"`.
```bash
$ pyproc "kemenkeu;namafileouputkemenkeu" --output json
```
perintah ini akan mengunduh data LPSE PU dan mengekspor data ke file `namafileouputkemenkeu.json`
- Download data lebih dari 1 LPSE
Untuk mengunduh lebih dari 1 lpse secara bersamaan, gunakan format `"alamat1[koma]alamat2[koma]alamat3"`
```bash
$ pyproc jakarta,pu,kemenkeu,sumbarprov
```
atau dengan menyertakan namafile dengan format `"alamat1[titikkoma]nama1[koma]alamat2[titikkoma]nama2"`
```bash
$ pyproc "jakarta;filejakarta,pu:filepu,kemenkeu:filekemenkeu,sumbarprov:filesumbarprov"
```
- Download data berdasrakan daftar lpse pada file csv
Download paket LPSE dengan sumber alamat dari file
```bash
$ pyproc daftarlpse.csv
# konten daftarlpse.csv
sumbarprov
pu
kemenkeu
# konten daftarlpse.csv dengan nama hasil download
sumbarprov;lpse-sumbar
pu;lpse-pu.csv
kemenkeu;lpse-kemenkeu
```
## Penggunaan PyProc Sebagai Package
Untuk dapat menggunakan PyProc, anda harus mengimpornya terlebih dahulu dan menginisiasi objek `Lpse`
```python
from pyproc import Lpse
# Inisiasi objek lpse kementerian pu
lpse = Lpse('kemenkeu')
```
### Pencarian Daftar Paket Lelang
```python
from pyproc import Lpse
# Inisiasi objek lpse kementerian pu
lpse = Lpse('pu')
# mendapatkan daftar paket lelang
daftar_lelang = lpse.get_paket_tender(start=0, length=2)
print(daftar_lelang)
# pencarian paket non tender (penunjukkan langsung)
daftar_pl = lpse.get_paket_non_tender(start=0, length=30)
```
Pencarian Paket dengan mengurutkan berdasarkan kolom tertentu
```python
from pyproc import Lpse
from pyproc.lpse import By
lpse = Lpse('sumbarprov')
# pencarian daftar lelang, urutkan berdasarkan Harga Perkiraan Sendiri
daftar_lelang = lpse.get_paket_tender(start=0, length=30, order=By.HPS)
```
Filter pencarian paket berdasarkan kategori pengadaan
```python
from pyproc import Lpse
from pyproc import JenisPengadaan
# Inisiasi objek lpse kementerian padang
lpse = Lpse('padang')
# Kategori Pengadaan Barang
paket_pengadaan_barang = lpse.get_paket_tender(start=0, length=30, kategori=JenisPengadaan.PENGADAAN_BARANG)
paket_konstruksi = lpse.get_paket_tender(start=0, length=30, kategori=JenisPengadaan.PEKERJAAN_KONSTRUKSI)
# dst untuk kategori lainnya
```
### Pencarian Detil Paket Lelang
```python
from pyproc import Lpse
lpse = Lpse('jakarta')
# mendapatkan semua detil paket lelang
detil = lpse.detil_paket_tender(id_paket='48658064')
detil.get_all_detil()
print(detil)
# mendapatkan hanya pemenang lelang
pemenang = detil.get_pemenang()
print(pemenang)
```
## Uninstall
Untuk uninstall package jalankan perintah berikut:
```bash
$ pip uninstall pyproc
```
## License
Paket ini di-release di bawah lisensi MIT.
## Donatur ☕️
Orang-orang yang berjasa menyediakan kopi sehingga pengembangan paket tetap berjalan
- Angga Rinaldi Rizal (50 cangkir ☕️)