Máy chấm công

Đẩy lượt quẹt từ máy chấm công / phần mềm trung gian lên SolidSuite

Máy chấm công không cần mở cổng ra Internet: một phần mềm trung gian (agent) trong mạng công ty đọc dữ liệu máy rồi đẩy lên.

Chuẩn bị trên SolidSuite

Chấm công → Máy chấm công: khai máy với mã máy (vd. CTY-MCC01) và múi giờ.
Chấm công → Cấu hình → Tạo API key: tạo khoá cho máy (bắt đầu bằng att_, chỉ hiện một lần).

Cấu hình agent

ERP_BASE_URL=https://congty.solidsuite.vn
ERP_DEVICE_CODE=CTY-MCC01
ERP_API_KEY=att_xxxxxxxxxxxxxxxx

API

POST https://congty.solidsuite.vn/api/hrm/attendance/punches
x-api-key: att_xxxxxxxxxxxxxxxx
Idempotency-Key: <mã lô, tuỳ chọn>
Content-Type: application/json

{
  "deviceCode": "CTY-MCC01",
  "punches": [
    {"externalId": "CTY-MCC01-000123", "employeeCode": "1024",
     "punchedAt": "2026-09-26T08:01:12+07:00", "direction": "IN", "method": "FINGERPRINT"}
  ],
  "watermark": "000123"
}

Trường	Ghi chú
`externalId`	Bắt buộc, duy nhất theo máy (tối đa 190 ký tự). Gửi lại lượt đã có thì được bỏ qua.
`employeeCode`	Mã nhân viên trên máy; ghép với nhân viên ở Ánh xạ mã máy.
`punchedAt`	ISO 8601 có múi giờ (khuyên dùng), `YYYY-MM-DD HH:mm:ss` (theo múi giờ máy) hoặc epoch giây / mili-giây.
`direction`, `method`	Tuỳ chọn (`IN` / `OUT`...).
`watermark`	Tuỳ chọn: vị trí đã đọc tới trên máy, lưu lại để agent đọc tiếp lần sau.

Cùng Idempotency-Key gửi lại trả đúng kết quả lần trước (an toàn khi mạng chập chờn).

Trong mục này

Máy chấm công: lô dữ liệu, gửi lại và phản hồi Giới hạn 1.000 lượt, chống trùng và xử lý PARTIAL