Sipajak

Developers

Dokumentasi API Sipajak

Hubungkan sistem kamu ke DJP lewat satu API: e-Faktur, e-Bupot, e-Billing, SPT, dan validasi status wajib pajak.

Versi 1.8 · terbaru Cara dapat kredensial

Akses API

Dapatkan kredensial staging untuk tim developer kamu

Kredensial dan koleksi Postman Sipajak tidak dibagikan secara publik. Ajukan akses, tim kami verifikasi kebutuhan integrasi kamu, lalu kredensial dikirim secara privat ke kontak teknis yang terdaftar.

  1. Ajukan aksesIsi data perusahaan, kontak teknis, dan modul yang ingin diintegrasikan.
  2. Verifikasi tim SipajakKami konfirmasi cakupan integrasi dan NPWP yang akan didaftarkan.
  3. Terima kredensial stagingUsername, password, dan koleksi Postman dikirim secara privat. Kredensial production menyusul setelah uji staging.
Siap mulai integrasi?

Tim kami membalas di hari kerja.

atau konsultasi gratis dulu →

Modul & panduan

Pengenalan Pengenalan

Sipajak API adalah kumpulan endpoint resmi dari Sipajak, PJAP terdaftar DJP, untuk menghubungkan ERP, software akuntansi, atau aplikasi kamu langsung ke layanan pajak DJP Coretax secara host-to-host. Halaman ini menjelaskan cakupan dokumen dan enam modul API.

 Memulai Memulai

Mulai integrasi dengan Sipajak API dalam hitungan menit: kenali environment staging dan production, cara autentikasi HTTP Basic, header npwp wajib, dan aturan versioning URL. Kredensial API diberikan oleh tim Sipajak, ajukan lewat tombol Minta Akses API.

 Konvensi API Konvensi API

Baca bagian ini sekali sebelum memakai modul apa pun: format response envelope, pola soft-error (HTTP 200 tapi gagal di sisi DJP), kode status HTTP, format tanggal dan angka, idempotensi, rate limit, caching, dan penanganan field sensitif.

 Organization Organization

Modul Organization adalah titik awal setiap integrasi: kelola profil klien, sertifikat dan penandatangan default, pantau usage serta histori panggilan API, dan daftarkan NPWP tambahan ke kredensial kamu.

5 endpoint VSWP VSWP

API VSWP (Validasi Status Wajib Pajak) memvalidasi NPWP atau NIK langsung ke DJP Coretax, cocok untuk onboarding nasabah, KYC fintech, dan verifikasi vendor. Tersedia lookup tunggal real-time dan alur bulk berbasis job.

4 endpoint e-Faktur e-Faktur

API e-Faktur Sipajak mengotomatiskan siklus faktur pajak dari sistem kamu ke DJP Coretax secara host-to-host: buat, ganti (pengganti), batalkan, dan retur faktur keluaran maupun masukan, termasuk dokumen yang dipersamakan.

24 endpoint e-Bupot e-Bupot

API e-Bupot Sipajak membuat dan mengelola bukti potong PPh langsung dari sistem payroll atau ERP kamu: delapan varian DJP, verifikasi dokumen, kalkulator PPh 21 dan BPA1, serta katalog referensi.

30 endpoint SPT SPT

API SPT Sipajak memandu pelaporan SPT dari sistem kamu dalam tujuh langkah: cek revisi, buat SPT, baca status, upload isi, submit ke DJP, lalu verifikasi hingga Bukti Penerimaan Elektronik (BPE) terbit.

7 endpoint e-Billing e-Billing

API e-Billing Sipajak menerbitkan ID Billing (kode billing) pajak langsung dari sistem kamu: validasi NPWP dan kode KAP/KJS lewat inquiry, lalu buat kode pembayaran yang siap dibayar di bank persepsi.

2 endpoint Contoh Integrasi Postman & Akses API

Koleksi Postman resmi dan kredensial staging diberikan secara privat setelah permintaan akses kamu disetujui tim Sipajak. Ajukan lewat tombol Minta Akses API.

 Glosarium Glosarium

Kamus istilah yang dipakai di seluruh dokumentasi: terminologi pajak Indonesia, kode varian e-Bupot, kode jenis SPT, regulasi yang dirujuk, dan istilah teknis protokol.

Cari endpoint

MethodPathFungsiModul
GET /v1/profile Retrieve the authenticated client's profile Organization
POST /v1/profile Update profile fields (partial update) Organization
GET /v1/usage Inspect API usage and quota consumption Organization
GET /v1/histories Retrieve history of past API calls Organization
POST /v1/organization Register an additional NPWP Organization
POST /v2/vswp Single taxpayer lookup VSWP
POST /v1/vswp/bulking Submit a bulk lookup job VSWP
GET /v1/vswp/{id} Poll status of a bulk job VSWP
GET /v1/vswp/{id}/export Download CSV result of a completed bulk job VSWP
GET /v1/ref/country ISO 3166 country codes (3-letter alpha-3) e-Faktur
GET /v1/ref/unit Units of measure (DJP "UM.xxxx" codes) e-Faktur
GET /v1/ref/transaction-code DJP transaction codes (TD.003xx) e-Faktur
GET /v1/ref/goods-services Goods and services classification codes e-Faktur
GET /v1/ref/additional-info Additional-information codes used with TD.00307 / TD.00308 e-Faktur
POST /v2/efaktur/create-faktur-pk Issue a new sales invoice e-Faktur
POST /v2/efaktur/create-faktur-pk-amended Issue a Pengganti (replacement) of an existing invoice e-Faktur
POST /v2/efaktur/cancel-faktur-pk Cancel an existing invoice e-Faktur
POST /v2/efaktur/create-retur-faktur-pk List DJP-prepopulated returns for a period — see note below e-Faktur
POST /v2/efaktur/cancel-retur-faktur-pk Cancel a previously-issued return e-Faktur
POST /v2/efaktur/create-document-pk Issue a new equivalent document e-Faktur
POST /v2/efaktur/create-document-pk-amended Issue a Pengganti e-Faktur
POST /v2/efaktur/cancel-document-pk Cancel an issued equivalent document e-Faktur
POST /v2/efaktur/create-retur-document-pk Create a retur on an equivalent document e-Faktur
POST /v2/efaktur/cancel-retur-document-pk Cancel a previously-issued retur e-Faktur
POST /v2/efaktur/create-faktur-pm Prepopulate / claim an incoming invoice e-Faktur
POST /v2/efaktur/confirmation-amended-cancel-faktur-pm Acknowledge a supplier-initiated amend or cancel e-Faktur
POST /v2/efaktur/create-retur-faktur-pm Create a return on a claimed invoice e-Faktur
POST /v2/efaktur/cancel-retur-faktur-pm Cancel a previously-issued return e-Faktur
POST /v2/efaktur/create-document-pm Claim an incoming equivalent document e-Faktur
POST /v2/efaktur/create-document-pm-amended Acknowledge or issue a Pengganti e-Faktur
POST /v2/efaktur/cancel-document-pm Cancel a claimed document e-Faktur
POST /v2/efaktur/create-retur-document-pm Create a retur e-Faktur
POST /v2/efaktur/cancel-retur-document-pm Cancel a previously-issued retur e-Faktur
POST /v2/ebupot/validate-bpu-a0-21 Validate withholding receipt — BPPU, BPMP, BP21 e-Bupot
POST /v2/ebupot/create-bpu-a0-21 Create withholding receipt — BPPU, BPMP, BP21 e-Bupot
POST /v2/ebupot/update-bpu-a0-21 Update withholding receipt — BPPU, BPMP, BP21 e-Bupot
POST /v2/ebupot/cancel-bpu-a0-21 Cancel withholding receipt — BPPU, BPMP, BP21 e-Bupot
POST /v2/ebupot/validate-bpnr-26 Validate withholding receipt — BPNR e-Bupot
POST /v2/ebupot/create-bpnr-26 Create withholding receipt — BPNR e-Bupot
POST /v2/ebupot/update-bpnr-26 Update withholding receipt — BPNR e-Bupot
POST /v2/ebupot/cancel-bpnr-26 Cancel withholding receipt — BPNR e-Bupot
POST /v2/ebupot/validate-cumulative-payment Validate withholding receipt — BPCY e-Bupot
POST /v2/ebupot/create-cumulative-payment Create withholding receipt — BPCY e-Bupot
POST /v2/ebupot/update-cumulative-payment Update withholding receipt — BPCY e-Bupot
POST /v2/ebupot/cancel-cumulative-payment Cancel withholding receipt — BPCY e-Bupot
POST /v2/ebupot/validate-self-payment Validate withholding receipt — BPSP e-Bupot
POST /v2/ebupot/create-self-payment Create withholding receipt — BPSP e-Bupot
POST /v2/ebupot/update-self-payment Update withholding receipt — BPSP e-Bupot
POST /v2/ebupot/cancel-self-payment Cancel withholding receipt — BPSP e-Bupot
POST /v2/ebupot/validate-a1-a2 Validate withholding receipt — BPA1, BPA2 e-Bupot
POST /v2/ebupot/create-a1-a2 Create withholding receipt — BPA1, BPA2 e-Bupot
POST /v2/ebupot/update-a1-a2 Update withholding receipt — BPA1, BPA2 e-Bupot
POST /v2/ebupot/cancel-a1-a2 Cancel withholding receipt — BPA1, BPA2 e-Bupot
POST /v2/ebupot/verify-document Refresh DJP-side state of an existing bupot. See section 7.9. e-Bupot
POST /calculation Local calculator for BPMP and BP21. Unauthenticated. See section 7.10. e-Bupot
POST /calculation/bpa1 Local calculator for BPA1 (year-end gross-up). Unauthenticated. See section 7.10. e-Bupot
GET /v1/ref-{variant} Full-search across the variant's reference data (paginated) e-Bupot
GET /v1/ref-{variant}/tax-objects Distinct tax-object descriptions e-Bupot
GET /v1/ref-{variant}/tax-articles Distinct tax-article codes ("Pasal X") e-Bupot
GET /v1/ref-{variant}/tax-codes Distinct tax-object codes e-Bupot
GET /v1/ref-{variant}/income-tax-statuses Distinct status enums (final / non-final etc.) e-Bupot
GET /v1/ref-{variant}/income-tax-rates Distinct tax-rate values e-Bupot
GET /v1/ref-{variant}/revenue-codes Distinct revenue-code values e-Bupot
POST /v2/spt/inquiry-max-rev-no Check whether an SPT already exists for a period SPT
POST /v2/spt/create-spt Create a new SPT for a period SPT
POST /v2/spt/inquiry-spt Read the current state of an SPT by idSpt SPT
POST /v2/spt/summary Summary report (currently unavailable, see 8.7) SPT
POST /v2/spt/upload Upload SPT line-item content SPT
POST /v2/spt/submit-spt Submit the SPT to DJP for acceptance SPT
POST /v2/spt/verify-spt Verify acceptance and retrieve BPE SPT
POST /v2/ebilling/inquiry Validate NPWP + KAP/KJS and fetch taxpayer name and address e-Billing
POST /v2/ebilling/create Generate a DJP payment code (ID Billing) e-Billing

Changelog

  1. 1.8terbaru

    Section 10 now explains how to request API access; the Postman collection and credentials are shared privately with approved partners. Section 11 (Glossary) expanded: Indonesian tax terminology, e-Bupot variant codes, SPT type codes, regulations referenced, and technical/protocol terms.

  2. 1.7

    Added Section 7 (e-Bupot) covering all eight variants (BPPU, BPMP, BP21, BPNR, BPCY, BPSP, BPA1, BPA2) across five endpoint families, the verify-document endpoint, both calculation utilities, and the reference catalogues. Module conventions section documents the fgJnsBupot discriminator, the per-variant field-naming case differences, and the HTTP 400 soft-error wrapping.

  3. 1.6

    Added Section 6 (e-Faktur) covering all twenty-two endpoints across the five functional groups: reference catalogues, Pajak Keluaran lifecycle, Dokumen Keluaran delta, Pajak Masukan, Dokumen Masukan, and the scan / check-status utilities.

  4. 1.5

    Corrected SPT section to remove a documentation error — request bodies are flat across all modules.

  5. 1.4

    Added Section 8 (SPT): seven-step lifecycle, module conventions, JnsSpt enum, MasaPajak format, DJP error catalogue.

  6. 1.3

    Added Section 9 (e-Billing): inquiry and create endpoints, module conventions (server-generated traceId, MMMMYYYY periode format, HTTP 400 wrapping for soft errors), and DJP error catalogue.

  7. 1.2

    Module sections reordered to reflect the recommended onboarding flow — Organization first, then VSWP. No endpoint contract changed; only section numbering.

  8. 1.1

    Added Section 4 (Organization): profile, usage, histories, and additional-NPWP registration.

  9. 1.0

    First released version. Covers Introduction, Getting Started, API Conventions, VSWP module, and glossary.