# Validasi NPWP

> Uraikan struktur NPWP 15 digit maupun 16 digit berbasis NIK.

Membaca struktur NPWP menjadi golongan wajib pajak, nomor urut, kode KPP, dan kode cabang. Format 16 digit diuraikan sebagai NIK sesuai ketentuan NPWP orang pribadi terbaru. Ini validasi format, bukan pengecekan keberadaan NPWP di DJP — struktur yang benar bukan bukti NPWP terdaftar atau aktif.

- Base URL: `https://api.apipedia.id/v1/npwp`
- Autentikasi: `Authorization: Bearer apk_…` (token dari console.apipedia.id)
- Kategori: Data Publik
- Halaman: https://apipedia.id/docs/validasi-npwp
- OpenAPI: https://console.apipedia.id/openapi/validasi-npwp.yaml

Semua respons memakai amplop `{ "is_success", "message", "data" }` kecuali disebutkan lain. Kode error umum: lihat https://apipedia.id/docs#kode-status-error.

## Endpoint (1)

- `GET /parse/{npwp}`: Uraikan struktur satu NPWP

### Uraikan struktur satu NPWP

`GET https://api.apipedia.id/v1/npwp/parse/{npwp}`

Membaca struktur NPWP 15 digit menjadi golongan wajib pajak, nomor urut, kode KPP, dan kode cabang. Masukan 16 digit diuraikan sebagai NIK sesuai ketentuan NPWP orang pribadi terbaru. Ini validasi format, bukan pengecekan keberadaan NPWP di DJP — struktur yang benar bukan bukti NPWP terdaftar atau aktif. Untuk masukan 16 digit, `format` bernilai `16-digit` dan `struktur` berisi `{ berbasis_nik, nik }` dengan `nik` hasil penguraian NIK (atau null). Masukan yang bukan 15/16 digit dijawab 400.

| Parameter | Lokasi | Tipe | Wajib | Keterangan |
|---|---|---|---|---|
| `npwp` | path | string | ya | NPWP dengan atau tanpa titik dan strip. |

Contoh request:

```bash
curl -X GET "https://api.apipedia.id/v1/npwp/parse/012345678912000" \
  -H "Authorization: Bearer apk_xxxxxxxxxxxxxxxx"
```

Contoh respons (200):

```json
{
  "is_success": true,
  "message": "NPWP berhasil diuraikan",
  "data": {
    "valid": true,
    "npwp": "012345678912000",
    "format": "15-digit",
    "errors": [],
    "catatan": [
      "Validasi format, bukan pengecekan keberadaan NPWP di DJP.",
      "Golongan wajib pajak dari dua digit pertama bersifat indikatif; DJP tidak menerbitkan pemetaan resmi yang bisa dirujuk publik.",
      "Digit kesembilan dibaca sebagai digit pemeriksa secara struktural saja — tidak ada spesifikasi checksum NPWP yang terbuka untuk diverifikasi."
    ],
    "struktur": {
      "kode_wp": "01",
      "jenis_wp": "Badan",
      "nomor_urut": "234567",
      "digit_pemeriksa": "8",
      "kode_kpp": "912",
      "kode_cabang": "000",
      "is_pusat": true
    }
  }
}
```
