Công cụ AI — Nhân sự

30 công cụ. Schema luôn mới nhất ở hrm_tool_catalog khi đã kết nối.

Máy chấm công

ĐọcScope: hrm:read

hrm_attendance_devices_list

Danh sách máy chấm công: tên, số serial, hãng, giao thức, IP, vai trò vào/ra, trạng thái. Không trả mật khẩu máy.

Tham số	Kiểu	Bắt buộc	Mô tả
`includeInactive`	boolean	không	true = gồm cả máy đã tắt

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/hrm/hrm_attendance_devices_list/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "hrm_attendance_devices_list",
  "arguments": {
    "args": {}
  }
}

Giờ vào/ra theo ngày

ĐọcScope: hrm:read

hrm_clock_history_daily

Giờ vào/ra mỗi ngày của nhân viên trong khoảng ngày (tối đa 62 ngày), lọc theo nhân viên hoặc phòng ban.

Tham số	Kiểu	Bắt buộc	Mô tả
`from`	string	có	Từ ngày (yyyy-MM-dd)
`to`	string	có	Đến ngày (yyyy-MM-dd)
`employeeId`	string	không	Id nhân viên
`orgUnitId`	string	không	Id phòng ban
`page`	integer	không	Trang, bắt đầu từ 1
`pageSize`	integer	không	Số dòng mỗi trang, tối đa 50

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/hrm/hrm_clock_history_daily/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"from":"2026-10-01","to":"2026-10-27"}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "hrm_clock_history_daily",
  "arguments": {
    "args": {
      "from": "2026-10-01",
      "to": "2026-10-27"
    }
  }
}

Lượt chấm công của một người

ĐọcScope: hrm:read

hrm_clock_history_timeline

Mọi lượt chấm công của một nhân viên trong khoảng ngày (tối đa 62 ngày), theo thứ tự thời gian.

Tham số	Kiểu	Bắt buộc	Mô tả
`employeeId`	string	có	Id nhân viên
`from`	string	có	Từ ngày (yyyy-MM-dd)
`to`	string	có	Đến ngày (yyyy-MM-dd)

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/hrm/hrm_clock_history_timeline/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"employeeId":"0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b","from":"2026-10-20","to":"2026-10-27"}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "hrm_clock_history_timeline",
  "arguments": {
    "args": {
      "employeeId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
      "from": "2026-10-20",
      "to": "2026-10-27"
    }
  }
}

Hợp đồng lao động sắp hết hạn

ĐọcScope: hrm:read

hrm_contracts_expiring

Hợp đồng lao động sắp hết hạn trong N ngày, trong phạm vi người dùng được xem.

Tham số	Kiểu	Bắt buộc	Mô tả
`days`	integer	không	Số ngày tới, mặc định 30, tối đa 90
`page`	integer	không	Trang, bắt đầu từ 1
`pageSize`	integer	không	Số dòng mỗi trang

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/hrm/hrm_contracts_expiring/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"days":30}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "hrm_contracts_expiring",
  "arguments": {
    "args": {
      "days": 30
    }
  }
}

Sinh trắc và thẻ đã đăng ký

ĐọcScope: hrm:read

hrm_employee_credentials_list

Khuôn mặt, vân tay, thẻ, QR đã đăng ký cho một nhân viên trên từng máy và trạng thái đồng bộ. Không trả số thẻ.

Tham số	Kiểu	Bắt buộc	Mô tả
`employeeId`	string	có	Id nhân viên

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/hrm/hrm_employee_credentials_list/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"employeeId":"0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "hrm_employee_credentials_list",
  "arguments": {
    "args": {
      "employeeId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"
    }
  }
}

Hồ sơ nhân viên

ĐọcScope: hrm:read

hrm_employees_get

Hồ sơ một nhân viên: phòng ban, chức danh, ngày vào làm, ngày hết thử việc. Không trả giấy tờ tuỳ thân, tài khoản ngân hàng, địa chỉ.

Tham số	Kiểu	Bắt buộc	Mô tả
`employeeId`	string	có	Id nhân viên

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/hrm/hrm_employees_get/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"employeeId":"0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "hrm_employees_get",
  "arguments": {
    "args": {
      "employeeId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"
    }
  }
}

Tìm nhân viên

ĐọcScope: hrm:read

hrm_employees_search

Tìm nhân viên theo tên hoặc mã: phòng ban, chức danh, ngày hết thử việc. Không trả số điện thoại, email, giấy tờ tuỳ thân.

Tham số	Kiểu	Bắt buộc	Mô tả
`search`	string	không	Tên hoặc mã nhân viên
`page`	integer	không	Trang, bắt đầu từ 1
`pageSize`	integer	không	Số dòng mỗi trang

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/hrm/hrm_employees_search/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"search":"An"}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "hrm_employees_search",
  "arguments": {
    "args": {
      "search": "An"
    }
  }
}

Đơn chờ tôi duyệt

ĐọcScope: hrm:read

hrm_inbox_list

Đơn đang chờ chính người dùng duyệt (nghỉ, sửa công, tăng ca…).

Tham số	Kiểu	Bắt buộc	Mô tả
`status`	string	không	Trạng thái, mặc định PENDING
`kind`	string	không	Loại đơn
`search`	string	không	Từ khoá
`page`	integer	không	Trang, bắt đầu từ 1
`pageSize`	integer	không	Số dòng mỗi trang

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/hrm/hrm_inbox_list/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "hrm_inbox_list",
  "arguments": {
    "args": {}
  }
}

Tổng hợp BHXH theo tháng

ĐọcScope: hrm:read

hrm_insurance_summary

Số tổng hợp bảo hiểm xã hội của một tháng, theo quyền xem.

Tham số	Kiểu	Bắt buộc	Mô tả
`year`	integer	có	Năm
`month`	integer	có	Tháng (1–12)

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/hrm/hrm_insurance_summary/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"year":2026,"month":10}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "hrm_insurance_summary",
  "arguments": {
    "args": {
      "year": 2026,
      "month": 10
    }
  }
}

Chấm công hôm nay của tôi

ĐọcScope: hrm:read

hrm_me_clock_today

Ca và các lượt chấm công hôm nay của chính người dùng.

Không có tham số.

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/hrm/hrm_me_clock_today/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "hrm_me_clock_today",
  "arguments": {
    "args": {}
  }
}

Hợp đồng của tôi

ĐọcScope: hrm:read

hrm_me_contracts

Hợp đồng lao động của chính người dùng, gồm ngày kết thúc nếu có.

Không có tham số.

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/hrm/hrm_me_contracts/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "hrm_me_contracts",
  "arguments": {
    "args": {}
  }
}

Phiếu lương của tôi

ĐọcScope: hrm:read

hrm_me_payslips

Phiếu lương đã chốt của chính người dùng; có payslipId thì trả chi tiết một phiếu.

Tham số	Kiểu	Bắt buộc	Mô tả
`year`	integer	không	Năm
`payslipId`	string	không	Id phiếu lương để xem chi tiết

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/hrm/hrm_me_payslips/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"year":2026}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "hrm_me_payslips",
  "arguments": {
    "args": {
      "year": 2026
    }
  }
}

Đơn của tôi

ĐọcScope: hrm:read

hrm_me_requests

Đơn nghỉ, sửa công, tăng ca của chính người dùng theo trạng thái.

Tham số	Kiểu	Bắt buộc	Mô tả
`status`	string	không	pending (mặc định), approved, rejected hoặc cancelled
`page`	integer	không	Trang, bắt đầu từ 1
`pageSize`	integer	không	Số dòng mỗi trang

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/hrm/hrm_me_requests/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"status":"pending"}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "hrm_me_requests",
  "arguments": {
    "args": {
      "status": "pending"
    }
  }
}

Tổng quan của tôi

ĐọcScope: hrm:read

hrm_me_summary

Tổng quan của chính người dùng: phép năm còn lại, số đơn đang chờ, công tháng.

Không có tham số.

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/hrm/hrm_me_summary/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "hrm_me_summary",
  "arguments": {
    "args": {}
  }
}

Checklist nhận việc

ĐọcScope: hrm:read

hrm_onboarding_list

Checklist nhận việc trong phạm vi được xem.

Tham số	Kiểu	Bắt buộc	Mô tả
`employeeId`	string	không	Id nhân viên
`status`	string	không	Trạng thái

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/hrm/hrm_onboarding_list/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"status":"in_progress"}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "hrm_onboarding_list",
  "arguments": {
    "args": {
      "status": "in_progress"
    }
  }
}

Phòng ban

ĐọcScope: hrm:read

hrm_org_units

Phòng ban người dùng được xem: tên, số người, người quản lý.

Tham số	Kiểu	Bắt buộc	Mô tả
`search`	string	không	Tên phòng ban

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/hrm/hrm_org_units/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "hrm_org_units",
  "arguments": {
    "args": {}
  }
}

Buổi 1-1 sắp tới

ĐọcScope: hrm:read

hrm_performance_meetings

Các buổi trao đổi 1-1 sắp tới của người dùng.

Không có tham số.

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/hrm/hrm_performance_meetings/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "hrm_performance_meetings",
  "arguments": {
    "args": {}
  }
}

Lượt chấm công thô từ máy

ĐọcScope: hrm:read

hrm_raw_punches_search

Lượt chấm công thô từ máy, lọc theo nhân viên, trạng thái xử lý, loại (FACE, FINGERPRINT, CARD, QR), serial máy và khoảng ngày.

Tham số	Kiểu	Bắt buộc	Mô tả
`employeeId`	string	không	Id nhân viên
`status`	string	không	PENDING, PROCESSED, UNMATCHED, DUPLICATE hoặc FAILED
`credentialType`	string	không	FACE, FINGERPRINT, CARD hoặc QR
`deviceSerial`	string	không	Serial máy
`search`	string	không	Từ khoá
`from`	string	không	Từ ngày (yyyy-MM-dd)
`to`	string	không	Đến ngày (yyyy-MM-dd)
`page`	integer	không	Trang, bắt đầu từ 1
`pageSize`	integer	không	Số dòng mỗi trang, tối đa 50

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/hrm/hrm_raw_punches_search/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"status":"UNMATCHED"}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "hrm_raw_punches_search",
  "arguments": {
    "args": {
      "status": "UNMATCHED"
    }
  }
}

Ứng viên

ĐọcScope: hrm:read

hrm_recruitment_list

Danh sách ứng viên người dùng được xem: tên, nguồn, ghi chú. Không trả số điện thoại.

Tham số	Kiểu	Bắt buộc	Mô tả
`search`	string	không	Tên ứng viên
`page`	integer	không	Trang, bắt đầu từ 1
`pageSize`	integer	không	Số dòng mỗi trang

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/hrm/hrm_recruitment_list/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "hrm_recruitment_list",
  "arguments": {
    "args": {}
  }
}

Bảng chấm công tháng

ĐọcScope: hrm:read

hrm_report_attendance

Bảng chấm công một tháng theo ký hiệu, trong phạm vi người dùng được xem.

Tham số	Kiểu	Bắt buộc	Mô tả
`year`	integer	có	Năm
`month`	integer	có	Tháng (1–12)
`orgUnitId`	string	không	Id phòng ban

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/hrm/hrm_report_attendance/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"year":2026,"month":10}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "hrm_report_attendance",
  "arguments": {
    "args": {
      "year": 2026,
      "month": 10
    }
  }
}

Tăng ca theo tháng

ĐọcScope: hrm:read

hrm_report_overtime

Tổng hợp tăng ca một tháng, trong phạm vi người dùng được xem.

Tham số	Kiểu	Bắt buộc	Mô tả
`year`	integer	có	Năm
`month`	integer	có	Tháng (1–12)
`orgUnitId`	string	không	Id phòng ban

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/hrm/hrm_report_overtime/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"year":2026,"month":10}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "hrm_report_overtime",
  "arguments": {
    "args": {
      "year": 2026,
      "month": 10
    }
  }
}

Lớp đào tạo

ĐọcScope: hrm:read

hrm_training_courses

Danh sách lớp đào tạo đang mở.

Tham số	Kiểu	Bắt buộc	Mô tả
`search`	string	không	Tên lớp
`page`	integer	không	Trang, bắt đầu từ 1
`pageSize`	integer	không	Số dòng mỗi trang

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/hrm/hrm_training_courses/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "hrm_training_courses",
  "arguments": {
    "args": {}
  }
}

Lớp đã ghi danh của nhân viên

ĐọcScope: hrm:read

hrm_training_learner

Các lớp một nhân viên đã ghi danh.

Tham số	Kiểu	Bắt buộc	Mô tả
`employeeId`	string	có	Id nhân viên (lấy từ hrm_employees_search)
`page`	integer	không	Trang, bắt đầu từ 1
`pageSize`	integer	không	Số dòng mỗi trang

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/hrm/hrm_training_learner/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"employeeId":"0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "hrm_training_learner",
  "arguments": {
    "args": {
      "employeeId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"
    }
  }
}

Gửi đơn sửa công

Write proposalScope: hrm:write

hrm.correction.submit

Gửi đơn sửa giờ vào hoặc giờ ra của chính người dùng cho một ngày. Tạo đề xuất; người dùng bấm Xác nhận trong app mới thực hiện.

Tham số	Kiểu	Bắt buộc	Mô tả
`date`	string	có	Ngày (yyyy-MM-dd)
`clockIn`	string	không	Giờ vào đúng (ISO)
`clockOut`	string	không	Giờ ra đúng (ISO)
`reason`	string	có	Lý do

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "hrm.correction.submit",
  "arguments": {
    "args": {
      "date": "2026-10-27",
      "clockIn": "2026-10-27T08:00:00+07:00",
      "reason": "Quên chấm"
    }
  }
}

Duyệt đơn

Write proposalScope: hrm:write

hrm.inbox.approve

Duyệt một đơn đang chờ chính người dùng duyệt. Tạo đề xuất; người dùng bấm Xác nhận trong app mới thực hiện.

Tham số	Kiểu	Bắt buộc	Mô tả
`itemId`	string	có	Id đơn (lấy từ hrm_inbox_list)
`kind`	string	có	Loại đơn (lấy từ hrm_inbox_list)
`comment`	string	không	Ý kiến

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "hrm.inbox.approve",
  "arguments": {
    "args": {
      "itemId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
      "kind": "leave",
      "comment": "Đồng ý"
    }
  }
}

Từ chối đơn

Write proposalScope: hrm:write

hrm.inbox.reject

Từ chối một đơn đang chờ chính người dùng duyệt, bắt buộc có lý do. Tạo đề xuất; người dùng bấm Xác nhận trong app mới thực hiện.

Tham số	Kiểu	Bắt buộc	Mô tả
`itemId`	string	có	Id đơn
`kind`	string	có	Loại đơn
`reason`	string	có	Lý do từ chối

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "hrm.inbox.reject",
  "arguments": {
    "args": {
      "itemId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
      "kind": "leave",
      "reason": "Trùng lịch trực của bộ phận"
    }
  }
}

Gửi đơn nghỉ

Write proposalScope: hrm:write

hrm.leave.submit

Gửi đơn xin nghỉ của chính người dùng vào luồng duyệt nhân sự. Tạo đề xuất; người dùng bấm Xác nhận trong app mới thực hiện.

Tham số	Kiểu	Bắt buộc	Mô tả
`fromDate`	string	có	Từ ngày (yyyy-MM-dd)
`toDate`	string	có	Đến ngày (yyyy-MM-dd)
`reason`	string	có	Lý do
`leaveType`	string	không	FULL_DAY hoặc HALF_DAY; bỏ trống = cả ngày

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "hrm.leave.submit",
  "arguments": {
    "args": {
      "fromDate": "2026-11-03",
      "toDate": "2026-11-03",
      "reason": "Việc gia đình"
    }
  }
}

Đánh dấu mục nhận việc

Write proposalScope: hrm:write

hrm.onboarding.tick

Đánh dấu một mục trong checklist nhận việc là xong hoặc chưa xong. Tạo đề xuất; người dùng bấm Xác nhận trong app mới thực hiện.

Tham số	Kiểu	Bắt buộc	Mô tả
`checklistId`	string	có	Id checklist
`taskId`	string	có	Id mục
`status`	string	có	done hoặc pending
`notes`	string	không	Ghi chú

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "hrm.onboarding.tick",
  "arguments": {
    "args": {
      "checklistId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
      "taskId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5c",
      "status": "done",
      "notes": "Đã cấp laptop"
    }
  }
}

Gửi đơn tăng ca

Write proposalScope: hrm:write

hrm.overtime.submit

Gửi đơn tăng ca của chính người dùng. Tạo đề xuất; người dùng bấm Xác nhận trong app mới thực hiện.

Tham số	Kiểu	Bắt buộc	Mô tả
`workDate`	string	có	Ngày làm (yyyy-MM-dd)
`startTime`	string	có	Bắt đầu (HH:mm)
`endTime`	string	có	Kết thúc (HH:mm)
`reason`	string	có	Lý do
`breakMinutes`	integer	không	Số phút nghỉ giữa giờ

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "hrm.overtime.submit",
  "arguments": {
    "args": {
      "workDate": "2026-10-28",
      "startTime": "18:00",
      "endTime": "21:00",
      "reason": "Chốt báo cáo"
    }
  }
}

Ghi hoàn thành lớp đào tạo

Write proposalScope: hrm:write

hrm.training.complete

Ghi một học viên hoàn thành một lớp đào tạo. Tạo đề xuất; người dùng bấm Xác nhận trong app mới thực hiện.

Tham số	Kiểu	Bắt buộc	Mô tả
`enrollmentId`	string	có	Id ghi danh
`note`	string	không	Ghi chú

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "hrm.training.complete",
  "arguments": {
    "args": {
      "enrollmentId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
      "note": "Đạt bài kiểm tra cuối khoá"
    }
  }
}