Tính bảng công từ máy chấm công online
Chuyển dữ liệu máy chấm công thành bảng công: giờ làm và số công mỗi ngày, phút đi muộn / về sớm, thiếu chấm, tăng ca theo loại ngày, giờ làm đêm.
Kết quả
Bấm “Chạy” để xem kết quả.
Gửi dữ liệu chấm công xuất từ máy (ZKTeco, Ronald Jack, Wise Eye… dạng CSV hoặc JSON) cùng các ca làm việc. Cột dữ liệu được nhận theo tiêu đề thường gặp (AC-No., Mã NV, Name, Họ tên, Time, Thời gian, Ngày + Giờ, nhiều giờ chấm trong một ô) hoặc khai báo bằng columns; ngày đọc theo dd/mm/yyyy trừ khi đặt date_format=mdy / ymd. Ca có giờ vào, giờ ra (ca đêm qua ngày hôm sau vẫn được), giờ nghỉ giữa ca và số phút cho phép đi muộn, về sớm.
Mỗi nhân viên mỗi ngày được gán ca có giờ vào gần lần chấm đầu nhất, lấy giờ vào đầu và giờ ra cuối, tính phút đi muộn, về sớm, số phút làm (trừ giờ nghỉ) và số công, đánh dấu thiếu chấm, giờ tăng ca sau ca (từ ot_min_minutes, có thể làm tròn) và số phút làm đêm từ 22:00 đến 06:00 (Bộ luật Lao động 2019, Điều 106). Ngày nghỉ hằng tuần (rest_days, mặc định Chủ nhật) và ngày lễ (tính từ /v1/vn-holidays, hoặc danh sách holidays riêng) thì toàn bộ thời gian làm là tăng ca loại đó.
Bảng tổng hợp mỗi nhân viên gồm số ngày và số công, số giờ, số lần đi muộn / về sớm, ngày thiếu chấm, ngày vắng, giờ tăng ca chia theo ngày thường / ngày nghỉ / ngày lễ (trả ít nhất 150% / 200% / 300%, Điều 98) và tăng ca ban đêm, kèm cảnh báo khi tăng ca quá 40 giờ trong tháng (Điều 107). API không áp đơn giá, nên kết quả dùng được cho mọi cách tính lương.
Dùng trong code của bạn
curl -X POST "https://apibox.io.vn/v1/vn-timesheet" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"csv":"AC-No.,Name,Time\n1,Nguyễn An,02/11/2026 07:58\n1,Nguyễn An,02/11/2026 17:45\n1,Nguyễn An,03/11/2026 08:12\n1,Nguyễn An,03/11/2026 16:50\n1,Nguyễn An,08/11/2026 08:00\n1,Nguyễn An,08/11/2026 12:00","from":"2026-11-02","to":"2026-11-08"}'const res = await fetch('https://apibox.io.vn/v1/vn-timesheet', {
method: 'POST',
headers: {
Authorization: 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({
"csv": "AC-No.,Name,Time\n1,Nguyễn An,02/11/2026 07:58\n1,Nguyễn An,02/11/2026 17:45\n1,Nguyễn An,03/11/2026 08:12\n1,Nguyễn An,03/11/2026 16:50\n1,Nguyễn An,08/11/2026 08:00\n1,Nguyễn An,08/11/2026 12:00",
"from": "2026-11-02",
"to": "2026-11-08"
}),
});
const data = await res.json();
console.log(data);import requests
res = requests.post(
"https://apibox.io.vn/v1/vn-timesheet",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={"csv": "AC-No.,Name,Time\n1,Nguyễn An,02/11/2026 07:58\n1,Nguyễn An,02/11/2026 17:45\n1,Nguyễn An,03/11/2026 08:12\n1,Nguyễn An,03/11/2026 16:50\n1,Nguyễn An,08/11/2026 08:00\n1,Nguyễn An,08/11/2026 12:00", "from": "2026-11-02", "to": "2026-11-08"},
timeout=30,
)
print(res.json())<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-timesheet');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY', 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => '{"csv":"AC-No.,Name,Time\\n1,Nguyễn An,02/11/2026 07:58\\n1,Nguyễn An,02/11/2026 17:45\\n1,Nguyễn An,03/11/2026 08:12\\n1,Nguyễn An,03/11/2026 16:50\\n1,Nguyễn An,08/11/2026 08:00\\n1,Nguyễn An,08/11/2026 12:00","from":"2026-11-02","to":"2026-11-08"}',
]);
$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
Hỗ trợ máy chấm công nào?
Mọi file xuất có cột nhân viên và cột ngày giờ (hoặc ngày + giờ): ZKTeco, Ronald Jack, Wise Eye, Hikvision CSV… File Excel cần lưu thành CSV trước (hoặc chuyển bằng /v1/xlsx-convert).
Ca đêm được tính thế nào?
Ca như 22:00–06:00 thuộc ngày bắt đầu ca; các lần chấm đến hết giờ ra cộng ot_window_hours (8 giờ) đều thuộc ca đó.
Ngày lễ có được tính tự động không?
Có, ngày lễ Việt Nam lấy từ /v1/vn-holidays (theo lịch nghỉ chính thức khi đã công bố). Gửi holidays để dùng lịch riêng của công ty, hoặc none.