Nhân sự

Thiết bị chấm công, lượt chấm công và lịch sử giờ giấc nhân sự.

5 endpoint · base /api/v1/hrm

GET/api/v1/hrm/attendance/devicesThử ngay ▶

Liệt kê thiết bị chấm công.

Tool MCP: hrm_list_attendance_devicesScope: hrm.attendance_devices.viewOAuth người dùngAPI key / ứng dụng

Tham số

Không có tham số.

Ví dụ

curl https://api.nextx.vn/api/v1/hrm/attendance/devices \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

Ví dụ phản hồi

[
  {
    "id": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
    "deviceName": "string",
    "deviceSerial": "string",
    "branchId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
    "vendor": "string",
    "protocol": "string",
    "ipAddress": "string",
    "port": 0,
    "modelName": "string",
    "isOnline": false,
    "isActive": false,
    "lastPingAt": "2026-10-27T09:00:00+07:00",
    "lastEventAt": "2026-10-27T09:00:00+07:00",
    "role": "string",
    "supportsFace": false,
    "supportsFingerprint": false,
    "supportsCard": false,
    "supportsQr": false,
    "firmwareVersion": "string",
    "notes": "string",
    "hikUsername": "string",
    "authBlocked": false,
    "authBlockedReason": "string",
    "faceUsed": 0,
    "faceMax": 0,
    "supportsCaptureFaceData": false,
    "lastPunchAt": "2026-10-27T09:00:00+07:00"
  }
]

GET/api/v1/hrm/attendance/raw-punchesThử ngay ▶

Liệt kê lượt chấm công thô.

Tool MCP: hrm_list_raw_punchesScope: hrm.attendance_raw_punches.viewOAuth người dùngAPI key / ứng dụng

Tham số

Tham số	Kiểu	Vị trí	Bắt buộc	Mô tả
`page`	int	query	không	Trang (bắt đầu từ 1)
`pageSize`	int	query	không	Số dòng mỗi trang
`employeeId`	GUID	query	không	—
`from`	date	query	không	YYYY-MM-DD
`to`	date	query	không	YYYY-MM-DD

Ví dụ

curl https://api.nextx.vn/api/v1/hrm/attendance/raw-punches?page=1&pageSize=1&employeeId=%3CemployeeId%3E&from=2026-06-01&to=2026-06-01 \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

Ví dụ phản hồi

{
  "items": [
    {
      "id": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
      "employeeId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
      "employeeName": "string",
      "employeeCode": "string",
      "deviceId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
      "deviceSerial": "string",
      "deviceName": "string",
      "deviceUserId": "string",
      "punchedAt": "2026-10-27T09:00:00+07:00",
      "credentialType": "string",
      "ingestSource": "string",
      "processStatus": "string",
      "processError": "string",
      "photoStorageKey": "string",
      "photoUrl": "string",
      "createdAt": "2026-10-27T09:00:00+07:00",
      "masterPunchId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"
    }
  ],
  "totalCount": 0,
  "page": 0,
  "pageSize": 0,
  "totalPages": 0,
  "hasNextPage": false,
  "hasPreviousPage": false
}

GET/api/v1/hrm/attendance/clock-history/dailyThử ngay ▶

Tổng hợp chấm công theo ngày.

Tool MCP: hrm_get_clock_history_dailyScope: hrm.attendance_raw_punches.viewOAuth người dùngAPI key / ứng dụng

Tham số

Tham số	Kiểu	Vị trí	Bắt buộc	Mô tả
`from`	date	query	có	YYYY-MM-DD
`to`	date	query	có	YYYY-MM-DD
`employeeId`	GUID	query	không	—
`page`	int	query	không	Trang (bắt đầu từ 1)
`pageSize`	int	query	không	Số dòng mỗi trang

Ví dụ

curl https://api.nextx.vn/api/v1/hrm/attendance/clock-history/daily?from=2026-06-01&to=2026-06-01&employeeId=%3CemployeeId%3E&page=1&pageSize=1 \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

Ví dụ phản hồi

{
  "items": [
    {
      "employeeId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
      "employeeCode": "string",
      "employeeName": "string",
      "date": "2026-10-27",
      "firstIn": "2026-10-27T09:00:00+07:00",
      "lastOut": "2026-10-27T09:00:00+07:00",
      "scanCount": 0,
      "manualEntryCount": 0,
      "sources": "string"
    }
  ],
  "totalCount": 0,
  "page": 0,
  "pageSize": 0,
  "totalPages": 0,
  "hasNextPage": false,
  "hasPreviousPage": false
}

GET/api/v1/hrm/attendance/clock-history/timeline/{employeeId}Thử ngay ▶

Dòng thời gian chấm công của 1 nhân viên.

Tool MCP: hrm_get_clock_timelineScope: hrm.attendance_raw_punches.viewOAuth người dùngAPI key / ứng dụng

Tham số

Tham số	Kiểu	Vị trí	Bắt buộc	Mô tả
`employeeId`	GUID	path	có	—
`from`	date	query	có	YYYY-MM-DD
`to`	date	query	có	YYYY-MM-DD

Ví dụ

curl https://api.nextx.vn/api/v1/hrm/attendance/clock-history/timeline/<employeeId>?from=2026-06-01&to=2026-06-01 \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

Ví dụ phản hồi

[
  {
    "punchId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
    "clockRecordId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
    "at": "2026-10-27T09:00:00+07:00",
    "type": "string",
    "source": "string",
    "isManual": false,
    "deviceName": "string",
    "credentialType": "string",
    "photoStorageKey": "string",
    "photoUrl": "string"
  }
]

GET/api/v1/hrm/employees/{employeeId}/credentialsThử ngay ▶

Liệt kê vân tay/khuôn mặt/thẻ của 1 nhân viên.

Tool MCP: hrm_list_employee_credentialsScope: hrm.attendance_devices.viewOAuth người dùngAPI key / ứng dụng

Tham số

Tham số	Kiểu	Vị trí	Bắt buộc	Mô tả
`employeeId`	GUID	path	có	—

Ví dụ

curl https://api.nextx.vn/api/v1/hrm/employees/<employeeId>/credentials \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

Ví dụ phản hồi

[
  {
    "id": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
    "employeeId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
    "deviceId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
    "deviceUserId": "string",
    "credentialType": "string",
    "fingerIndex": 0,
    "deviceVendor": "string",
    "syncStatus": "string",
    "syncedAt": "2026-10-27T09:00:00+07:00",
    "syncError": "string",
    "createdAt": "2026-10-27T09:00:00+07:00",
    "deviceName": "string"
  }
]