Tính lương Gross ↔ Net API

Quy đổi lương gross ↔ net theo quy định Việt Nam: BHXH, BHYT, BHTN, giảm trừ gia cảnh, thuế TNCN từng bậc và chi phí doanh nghiệp, theo từng kỳ.

GETPOSThttps://apibox.io.vn/v1/vn-salary
Dữ liệu & JSON▶ Dùng thử online

API tính lương quy đổi lương tháng theo cả hai chiều: từ gross sang net (gross=30000000) và từ số tiền thực nhận mong muốn ngược lại lương gross cần ghi trong hợp đồng (net=26215000). Kết quả có đủ từng bước: bảo hiểm bắt buộc của người lao động (BHXH 8%, BHYT 1,5%, BHTN 1%) kèm mức trần, thu nhập trước thuế, giảm trừ gia cảnh, thu nhập tính thuế, thuế theo từng bậc và chi phí của doanh nghiệp (BHXH 17%, TNLĐ-BNN 0,5%, BHYT 3%, BHTN 1%, kinh phí công đoàn 2% tuỳ chọn).

Các quy định được lưu kèm ngày hiệu lực và kỳ tính là tham số (date hoặc month), nên bảng lương các tháng trước được tính đúng quy định khi đó: biểu 7 bậc và giảm trừ 11 / 4,4 triệu đến hết 2025; biểu 5 bậc của Luật 109/2025/QH15 và giảm trừ 15,5 / 6,2 triệu (Nghị quyết 110/2025/UBTVQH15) từ kỳ tính thuế 2026; lương cơ sở (2,34 → 2,53 triệu từ 1/7/2026) cho mức trần 20 lần và lương tối thiểu vùng cho trần BHTN. Căn cứ pháp lý của từng giá trị được trả trong rules.

insurance_salary đặt mức lương đóng bảo hiểm khác (mặc định bằng gross), non_taxable loại trừ các khoản phụ cấp không chịu thuế, region (1–4) chọn vùng lương tối thiểu và resident=false áp dụng thuế suất 20% cho người không cư trú. Kết quả mang tính ước tính để lập kế hoạch và đối chiếu bảng lương; các trường hợp đặc thù (làm thêm giờ, thưởng, bảo hiểm của người nước ngoài) cần quy định riêng của bạn.

Tham số

TênVị tríKiểuBắt buộcMặc định
grossbody|querynumberkhôngLương gross tháng (VND); gửi gross hoặc net.
netbody|querynumberkhôngLương net tháng (VND) để tìm lương gross.
dependentsbody|querynumberkhông0Số người phụ thuộc đã đăng ký.
regionbody|querynumberkhông1Vùng lương tối thiểu 1–4 (cho trần BHTN).
datebody|querystringkhôngKỳ lương, YYYY-MM-DD hoặc month=YYYY-MM (mặc định: hôm nay). Từ 07/2020.
insurance_salarybody|querynumberkhôngLương đóng bảo hiểm (mặc định: bằng gross).
non_taxablebody|querynumberkhông0Phần thu nhập không chịu thuế trong gross (phụ cấp ăn trưa…).
insurancebody|querybooleankhôngtruefalse: không đóng bảo hiểm bắt buộc.
residentbody|querybooleankhôngtruefalse: cá nhân không cư trú, thuế 20%.
union_fundbody|querybooleankhôngfalseCộng kinh phí công đoàn 2% vào chi phí doanh nghiệp.

Ví dụ

curl "https://apibox.io.vn/v1/vn-salary?gross=30000000&dependents=1&month=2026-11" \
  -H "Authorization: Bearer YOUR_API_KEY"

Kết quả trả về

{
  "period": "2026-11",
  "mode": "gross_to_net",
  "region": 1,
  "gross": 30000000,
  "net": 26592500,
  "insurance": {
    "salary": 30000000,
    "bhxh": 2400000,
    "bhyt": 450000,
    "bhtn": 300000,
    "total": 3150000,
    "caps": {
      "bhxh_bhyt": 50600000,
      "bhtn": 106200000
    }
  },
  "income_before_tax": 26850000,
  "deductions": {
    "personal": 15500000,
    "dependents": 6200000,
    "dependent_count": 1,
    "non_taxable_income": 0,
    "total": 21700000
  },
  "taxable_income": 5150000,
  "personal_income_tax": 257500,
  "tax_brackets": [
    {
      "from": 0,
      "to": 10000000,
      "rate": 0.05,
      "amount": 5150000,
      "tax": 257500
    }
  ],
  "employer": {
    "bhxh": 5100000,
    "tnld_bnn": 150000,
    "bhyt": 900000,
    "bhtn": 300000,
    "total": 6450000,
    "total_cost": 36450000
  },
  "rules": {
    "personal_deduction": 15500000,
    "dependent_deduction": 6200000,
    "deduction_ref": "Nghị quyết 110/2025/UBTVQH15",
    "tax_table": "Luật Thuế TNCN 109/2025/QH15 (5 bậc, áp dụng từ kỳ tính thuế 2026)",
    "base_salary": 2530000,
    "region_min_wage": 5310000,
    "…": "…"
  },
  "notes": []
}

Ứng dụng

  • Công cụ tính lương trên trang tuyển dụng, trang nhân sự
  • Đối chiếu phiếu lương, file xuất bảng lương
  • Thư mời nhận việc: tìm lương gross cho mức net đã thoả thuận
  • Ước tính tổng chi phí doanh nghiệp cho một vị trí

Hỏi đáp

Năm 2026 dùng biểu thuế nào?

Biểu 5 bậc (5%, 10%, 20%, 30%, 35%) của Luật Thuế TNCN 109/2025/QH15 áp dụng cho thu nhập từ tiền lương của kỳ tính thuế 2026, cùng mức giảm trừ 15,5 triệu cho bản thân và 6,2 triệu cho mỗi người phụ thuộc. Các kỳ từ 2025 trở về trước dùng biểu 7 bậc.

Vì sao lương cao thì bảo hiểm thấp hơn 10,5%?

BHXH và BHYT có mức trần bằng 20 lần lương cơ sở (50,6 triệu từ 1/7/2026), BHTN có trần bằng 20 lần lương tối thiểu vùng. Mức trần đã áp dụng có trong insurance.caps.

Net → gross được tính thế nào?

API tìm mức gross nhỏ nhất cho ra số net không thấp hơn số yêu cầu với cùng quy định, nên kết quả chính xác đến từng đồng.

API liên quan

Bắt đầu với 1.000 request miễn phí mỗi tháng. Nhận API key miễn phí →