vn-payroll

Calculates Net Income, Personal Income Tax (PIT), and Social Insurance (BHXH) based on Vietnam's progressive tax brackets.

⭐5stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026

When & Why to Use This Skill

The Vietnam Payroll & Tax Calculator is a specialized tool designed to automate the calculation of Net Income, Personal Income Tax (PIT), and Social Insurance (BHXH) in compliance with Vietnam's 2025 progressive tax regulations. By processing gross salary, dependent counts, and regional minimum wage data, it provides precise financial breakdowns for both employers and employees, ensuring accuracy in financial planning and payroll management.

Use Cases

  • Salary Negotiation: Quickly convert gross salary offers into net take-home pay to help job seekers make informed career decisions based on actual income.
  • HR & Payroll Management: Streamline monthly payroll processing by accurately calculating statutory deductions and tax obligations for staff across different Vietnamese regions (1-4).
  • Personal Financial Planning: Enable individuals to estimate their monthly budget and tax liabilities by accounting for specific family circumstances and dependent deductions.
  • Corporate Compliance: Ensure business calculations remain up-to-date with the latest 2025 Vietnamese progressive tax brackets and social insurance requirements.
namevn-payroll
descriptionCalculates Net Income, Personal Income Tax (PIT), and Social Insurance (BHXH) based on Vietnam's progressive tax brackets.

Skill: Vietnam Payroll & Tax Calculator (2025 Rules)

Description: Calculates Net Income, Personal Income Tax (PIT), and Social Insurance (BHXH) based on Vietnam's progressive tax brackets.

Tools:

calc_pit.py: The main calculation engine.

Usage: To calculate a salary breakdown, run the python script with the following arguments:

python calc_pit.py --gross <AMOUNT> --dependents <COUNT> --region <1|2|3|4>

Arguments: --gross: The gross monthly salary in VND (e.g., 80000000). --dependents: Number of qualified dependents (children, elderly parents). Default is 0. --region: Minimum wage region (1 is Hanoi/HCM/Nha Trang). Default is 1.

Example Task: "Calculate net salary for 50 million VND with 1 baby." -> Command: run_skill_script(skill_name="vn_payroll", script_name="calc_pit.py", arguments="--gross 50000000 --dependents 1")

Output Format: The script outputs a formatted text block. Present this directly to the user.