# Introduction

> Sumber: https://www.sipajak.com/developers/introduction
> Dokumentasi API Sipajak · Versi 1.8 · Modul Pengenalan
> Ditulis oleh Tim Pajak Sipajak · Diperbarui 7 November 2026
> Publisher: Sipajak (PT Hexa Sarana Intermedia), PJAP resmi yang terdaftar dan diawasi DJP.

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.

## 1.1 About this document

This document specifies the Sipajak API surface — the complete set of endpoints exposed for integration with partner and customer systems. It is intended for developers integrating Sipajak's tax-compliance services into their own platforms — typically backend engineers building connectors from an ERP, accounting platform, or master-data system.

The API surface is organised into six functional modules: Organization (profile and NPWP registration), VSWP (taxpayer validation), e-Faktur (VAT invoices), e-Bupot (withholding tax receipts), SPT (tax returns), and e-Billing (payment-code issuance). Sections 4 through 9 of this document cover each module in turn. The conventions established in section 3 (response envelope, authentication, soft-error pattern, date formats) apply across all modules and should be read once before working with any of them.

This is version 1.8 of the document. All module sections are now fully specified: Section 4 (Organization), 5 (VSWP), 6 (e-Faktur), 7 (e-Bupot), 8 (SPT), and 9 (e-Billing). The cross-cutting material (sections 1–3, 10–11) is complete and stable.

## 1.2 About Sipajak

Sipajak (PT Hexa Sarana Intermedia) is a Penyedia Jasa Aplikasi Perpajakan (PJAP) appointed by the Direktorat Jenderal Pajak (DJP) under KEP-423/PJ/2021 (15 October 2021); see [DJP's PJAP profile](https://www.pajak.go.id/id/pt-hexa-sarana-intermedia). The platform provides DJP-integrated services for VAT invoicing (e-Faktur), withholding tax (e-Bupot), tax-return submission (SPT), payment-code issuance (e-Billing), and taxpayer validation (VSWP), with Host-to-Host integration to DJP's Coretax system.

## 1.3 Module overview

The API surface is organised into six functional modules. Sections 4 through 9 cover each module in detail; the table below offers an at-a-glance summary.

| Module | Purpose | Section |
| --- | --- | --- |
| Organization | Client profile, usage, history, and NPWP registration. The entry point for any new integration. | 4 |
| VSWP | Taxpayer-status validation (NPWP / NIK lookup against DJP Coretax CTAS). | 5 |
| e-Faktur | VAT invoice lifecycle: create, replace, cancel, return — for output and input invoices, including equivalent documents. | 6 |
| e-Bupot | Withholding-tax receipts (Bukti Potong) across all DJP variants. | 7 |
| SPT | Tax-return submission with seven-step lifecycle ending in DJP BPE acknowledgement. | 8 |
| e-Billing | DJP payment-code issuance for tax-payable amounts. | 9 |

## 1.4 Document conventions

Throughout this document:

- **JSON path notation** (e.g. `body.data.status`) refers to the JSON Pointer–equivalent location in a request or response payload.
- **Path templates** enclose path parameters in braces, e.g. `/v1/vswp/{id}`.
- **Placeholder values** in examples (such as `1234567890123000`) are synthetic — they are valid in shape but do not correspond to real taxpayers.

## Pertanyaan umum

### Modul apa saja yang tersedia di Sipajak API?

Ada enam modul: Organization (profil dan pendaftaran NPWP), VSWP (validasi status wajib pajak), e-Faktur, e-Bupot, SPT, dan e-Billing.

### Untuk siapa dokumentasi ini ditulis?

Untuk developer yang mengintegrasikan layanan Sipajak ke platform mereka sendiri, biasanya backend engineer yang membangun konektor dari ERP, platform akuntansi, atau sistem master data.

### Apakah contoh NPWP di dokumentasi milik wajib pajak sungguhan?

Tidak. Nilai contoh seperti `1234567890123000` bersifat sintetis: bentuknya valid, tetapi tidak terkait dengan wajib pajak sungguhan.

### Bagaimana Sipajak terhubung ke DJP?

Sipajak (PT Hexa Sarana Intermedia) adalah PJAP yang ditunjuk DJP melalui KEP-423/PJ/2021 dan terhubung ke Coretax DJP secara host-to-host.

---
Akses API: minta kredensial staging lewat https://www.sipajak.com/developers (tombol "Minta Akses API"). Semua modul: https://www.sipajak.com/developers.md · Peta konten: https://www.sipajak.com/sitemap.md
