NPWP

Utilities for working with Indonesian Tax Identity Numbers (Nomor Pokok Wajib Pajak).

Overview

The NPWP module provides utilities to validate, format, parse, and mask Indonesian Tax Identity Numbers. It follows the official 15-digit format and handles both formatted (with dots and dashes) and unformatted input.

Features

• Validation: Check if an NPWP is valid based on its length and basic structure.
• Formatting: Format raw 15-digit NPWP into the standard 00.000.000.0-000.000 pattern.
• Parsing: Extract information from NPWP like identity code, serial number, and office code.
• Masking: Mask NPWP for privacy while optionally preserving its format.

Installation

npm install @indodev/toolkit

pnpm add @indodev/toolkit

yarn add @indodev/toolkit

bun add @indodev/toolkit

Quick Start

import { validateNPWP, formatNPWP, parseNPWP, maskNPWP } from '@indodev/toolkit/npwp';
 
// Validate NPWP
validateNPWP('091234567012000'); // true
 
// Format NPWP
formatNPWP('091234567012000');
// '09.123.456.7-012.000'
 
// Parse NPWP
const info = parseNPWP('09.123.456.7-012.000');
console.log(info?.identityCode); // '09'
 
// Mask NPWP
maskNPWP('09.123.456.7-012.000');
// '09.123.***.*-012.000'

API Reference

validateNPWP()

Validates an Indonesian NPWP string.

Type Signature:

function validateNPWP(npwp: string): boolean;

Parameters:

Returns:

boolean - Returns true if valid, false otherwise.

formatNPWP()

Formats a 15-digit NPWP string into the standard 00.000.000.0-000.000 format.

Type Signature:

function formatNPWP(npwp: string): string;

Parameters:

Returns:

string - Formatted NPWP string, or the original if invalid.

parseNPWP()

Parses an NPWP string and extracts its components.

Type Signature:

function parseNPWP(npwp: string): NPWPInfo | null;

Parameters:

Returns:

NPWPInfo | null - Parsed NPWP information or null if invalid.

maskNPWP()

Masks an NPWP for privacy.

Type Signature:

function maskNPWP(npwp: string, options?: MaskOptions): string;

Parameters:

Returns:

string - Masked NPWP.

Type Reference

NPWPInfo

interface NPWPInfo {
  identityCode: string;
  serialNumber: string;
  checkDigit: string;
  officeCode: string;
  branchCode: string;
  formatted: string;
  isValid: boolean;
}

MaskOptions

interface MaskOptions {
  start?: number; // Digits visible at start (default: 5)
  end?: number; // Digits visible at end (default: 3)
  char?: string; // Mask character (default: '*')
  preserveFormat?: boolean; // Keep dots and dashes (default: true)
}