Tính bảng lương online

Tính lương cả công ty: gross hoặc net, phụ cấp, người phụ thuộc, trần đóng bảo hiểm, thuế TNCN, chi phí doanh nghiệp, file Excel và phiếu lương PDF.

Kết quả

Bấm “Chạy” để xem kết quả.

Gửi danh sách nhân viên dạng JSON (employees) hoặc tải file CSV / XLSX có dòng tiêu đề (nhận các cột tiếng Việt như "Họ tên", "Lương", "Số NPT", "Vùng", "Lương đóng BH"). Mỗi dòng được tính theo cùng quy tắc với vn-salary: BHXH, BHYT, BHTN của người lao động (8 / 1,5 / 1 %) trên lương đóng bảo hiểm, có trần 20 lần lương cơ sở (2.530.000 đ từ 1/7/2026) và 20 lần lương tối thiểu vùng; giảm trừ gia cảnh 15,5 triệu và 6,2 triệu mỗi người phụ thuộc, biểu thuế 5 bậc từ 2026; phần doanh nghiệp đóng (17 % + 0,5 % + 3 % + 1 %, tuỳ chọn 2 % kinh phí công đoàn).

Mỗi dòng có thể là lương gross (salary / gross) hoặc net (net: API tự tính ngược ra gross), tính theo ngày công (work_days / standard_days), kèm thưởng, làm thêm giờ (phần miễn thuế), tạm ứng và khấu trừ khác. Phụ cấp gửi qua allowances (mảng { name, amount, taxable, insurance }) hoặc các cột có tiền tố pc_ (chịu thuế), pckct_ (miễn thuế), pcbh_ (tính vào lương đóng bảo hiểm); allowance_rules phân loại lại theo tên. API không tự áp định mức miễn thuế: bạn quyết định khoản nào được miễn.

format=json trả từng dòng và tổng từng cột; format=xlsx trả "Bảng thanh toán tiền lương" sẵn để in (font Times New Roman, dòng tổng, chỗ ký); format=payslips trả file ZIP gồm phiếu lương PDF khổ A5 cho từng người, tiếng Việt hoặc tiếng Anh (font Be Vietnam Pro). Giới hạn: 2.000 dòng, 200 phiếu lương mỗi lần gọi. File chỉ xử lý trong bộ nhớ, không lưu lại.

Dùng trong code của bạn

curl -X POST "https://apibox.io.vn/v1/vn-payroll-batch" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"period":"2026-11","employees":[{"employee_id":"NV01","name":"Nguyễn Văn An","department":"Kế toán","salary":30000000},{"employee_id":"NV02","name":"Trần Thị Bình","salary":20000000,"dependents":1,"insurance_salary":15000000,"allowances":[{"name":"Ăn trưa","amount":730000,"taxable":false},{"name":"Điện thoại","amount":500000}]}]}'

const res = await fetch('https://apibox.io.vn/v1/vn-payroll-batch', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "period": "2026-11",
    "employees": [
      {
        "employee_id": "NV01",
        "name": "Nguyễn Văn An",
        "department": "Kế toán",
        "salary": 30000000
      },
      {
        "employee_id": "NV02",
        "name": "Trần Thị Bình",
        "salary": 20000000,
        "dependents": 1,
        "insurance_salary": 15000000,
        "allowances": [
          {
            "name": "Ăn trưa",
            "amount": 730000,
            "taxable": false
          },
          {
            "name": "Điện thoại",
            "amount": 500000
          }
        ]
      }
    ]
  }),
});
const data = await res.json();
console.log(data);

import requests

res = requests.post(
    "https://apibox.io.vn/v1/vn-payroll-batch",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"period": "2026-11", "employees": [{"employee_id": "NV01", "name": "Nguyễn Văn An", "department": "Kế toán", "salary": 30000000}, {"employee_id": "NV02", "name": "Trần Thị Bình", "salary": 20000000, "dependents": 1, "insurance_salary": 15000000, "allowances": [{"name": "Ăn trưa", "amount": 730000, "taxable": False}, {"name": "Điện thoại", "amount": 500000}]}]},
    timeout=30,
)
print(res.json())

<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-payroll-batch');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"period":"2026-11","employees":[{"employee_id":"NV01","name":"Nguyễn Văn An","department":"Kế toán","salary":30000000},{"employee_id":"NV02","name":"Trần Thị Bình","salary":20000000,"dependents":1,"insurance_salary":15000000,"allowances":[{"name":"Ăn trưa","amount":730000,"taxable":false},{"name":"Điện thoại","amount":500000}]}]}',
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));

Tài liệu API → Nhận API key miễn phí

Hỏi đáp

API dùng quy định nào?

Quy định có hiệu lực ở tháng tính lương: thuế TNCN theo Luật 109/2025/QH15 và NQ 110/2025/UBTVQH15 từ 2026, bảo hiểm theo Luật BHXH 2024, lương cơ sở 2.530.000 đ từ 1/7/2026, lương tối thiểu vùng theo NĐ 293/2025/NĐ-CP.

Tiền ăn trưa, điện thoại có được miễn thuế không?

Chỉ khi bạn đánh dấu (taxable: false hoặc cột pckct_). Định mức miễn thuế phụ thuộc quy chế và chứng từ của doanh nghiệp nên API không tự đoán.

Có đặt mật khẩu cho phiếu lương được không?

Chưa: môi trường Workers chưa hỗ trợ mã hoá PDF. Hãy gửi file ZIP qua kênh riêng tư.