vn-payroll

arisng's avatarfrom arisng

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

⭐1stars🔀0forks📁View on GitHub🕐Updated Dec 20, 2025

When & Why to Use This Skill

This Claude skill provides a specialized Vietnam Payroll & Tax Calculator updated for 2025 regulations. It automates the complex process of calculating Net Income, Personal Income Tax (PIT), and Social Insurance (BHXH) contributions by applying Vietnam's progressive tax brackets, regional minimum wages, and dependent deductions, ensuring high accuracy for financial planning and payroll management.

Use Cases

  • HR & Payroll Automation: Streamline monthly salary processing by automatically calculating net pay and statutory deductions for employees in Vietnam.
  • Personal Financial Planning: Help individuals estimate their actual take-home pay and understand their tax liabilities based on gross salary and family circumstances.
  • Recruitment & Budgeting: Assist hiring managers and business owners in calculating total labor costs and determining competitive net salary offers for candidates across different regions.
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.