Tính lương làm thêm giờ API

Tính tiền lương làm thêm giờ theo BLLĐ: 150/200/300%, làm đêm +30% +20%, làm ngày lễ Tết, giới hạn giờ tháng/năm và phần được miễn thuế TNCN từ 2026.

Tham số

Ví dụ

curl -X POST "https://apibox.io.vn/v1/vn-overtime" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"monthly_salary":10400000,"workday_ot_hours":20,"weekly_off_ot_hours":8,"holiday_night_ot_hours":2,"tax_year":2026}'

const res = await fetch('https://apibox.io.vn/v1/vn-overtime', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "monthly_salary": 10400000,
    "workday_ot_hours": 20,
    "weekly_off_ot_hours": 8,
    "holiday_night_ot_hours": 2,
    "tax_year": 2026
  }),
});
const data = await res.json();
console.log(data);

import requests

res = requests.post(
    "https://apibox.io.vn/v1/vn-overtime",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"monthly_salary": 10400000, "workday_ot_hours": 20, "weekly_off_ot_hours": 8, "holiday_night_ot_hours": 2, "tax_year": 2026},
    timeout=30,
)
print(res.json())

<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-overtime');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"monthly_salary":10400000,"workday_ot_hours":20,"weekly_off_ot_hours":8,"holiday_night_ot_hours":2,"tax_year":2026}',
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));

Kết quả trả về

{
  "hourly_wage": 50000,
  "hourly_basis": "monthly_salary / (26 days × 8 h)",
  "lines": [
    {
      "date": null,
      "type": "workday",
      "kind": "overtime",
      "hours": 20,
      "percent": 150,
      "pay": 1500000,
      "normal_pay": 1000000,
      "premium": 500000
    },
    {
      "date": null,
      "type": "weekly_off",
      "kind": "overtime",
      "hours": 8,
      "percent": 200,
      "pay": 800000,
      "normal_pay": 400000,
      "premium": 400000
    },
    {
      "date": null,
      "type": "holiday",
      "kind": "night_overtime",
      "hours": 2,
      "percent": 390,
      "pay": 390000,
      "normal_pay": 100000,
      "premium": 290000
    }
  ],
  "totals": {
    "overtime_hours": 30,
    "night_hours": 0,
    "pay": 2690000,
    "overtime_pay": 2690000,
    "night_work_pay": 0,
    "premium_above_normal": 1190000
  },
  "caps": {
    "daily_workday_hours": 4,
    "daily_day_off_hours": 12,
    "monthly": 40,
    "annual": 200,
    "ytd_before": 0,
    "excess_hours": 0,
    "compliant": true
  },
  "pit": {
    "tax_year": 2026,
    "rule": "whole_pay_within_limits",
    "exempt": 2690000,
    "taxable": 0
  },
  "warnings": [],
  "legal": [
    "Bộ luật Lao động 45/2019/QH14 Điều 98, 106, 107",
    "Nghị định 145/2020/NĐ-CP Điều 55–61",
    "Luật Thuế TNCN 109/2025/QH15 Điều 4 khoản 8; Nghị định 253/2026/NĐ-CP Điều 26"
  ],
  "reviewed": "2026-11-11"
}

Ứng dụng

• Tính các dòng lương làm thêm trong phần mềm tính lương
• Cho người lao động biết tiền đi làm ngày Tết
• Cảnh báo giờ làm thêm vượt giới hạn trước khi chốt lương
• Tách phần tiền làm thêm được miễn thuế theo quy định 2026

Hỏi đáp

API liên quan