# Validasi NPWP

Validasi NPWP API APIPedia: Uraikan struktur NPWP 15 digit maupun 16 digit berbasis NIK. Panggil dengan satu token API di `https://api.apipedia.id/v1/npwp`.

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 parsed",
  "data": {
    "valid": true,
    "npwp": "012345678912000",
    "format": "15-digit",
    "errors": [],
    "catatan": [
      "Format validation only, not a check that the NPWP exists at DJP.",
      "The taxpayer category derived from the first two digits is indicative; DJP does not publish an official mapping for public reference.",
      "The ninth digit is read as a check digit structurally only — there is no public NPWP checksum specification to verify against."
    ],
    "struktur": {
      "kode_wp": "01",
      "jenis_wp": "Badan",
      "nomor_urut": "234567",
      "digit_pemeriksa": "8",
      "kode_kpp": "912",
      "kode_cabang": "000",
      "is_pusat": true
    }
  }
}
```
