Hướng dẫn sử dụng kết nối máy chấm công ZKTeco sử dụng API của Smartid

25-06-2023, 9:52 am

Máy chấm công vân tay, thẻ từ, khuôn mặt của Hãng ZKTeco hiện là thương hiệu phổ biến nhất tại Việt nam với hơn 80% thị phần, được đông đảo khách hàng, các đối tác, nhà tích hợp tin tưởng lựa chọn. ZKTeco cũng là thương hiệu có đa dạng mẫu mã, chức năng và luôn nâng cấp cải tiến để ngày càng đáp ứng đa dạng mọi nhu cầu khách hàng. Bên cạnh đó, ZKTeco cũng hỗ trợ tối đa việc tích hợp điều khiển thiết bị cho các đối tác, thông qua việc cung cấp SDK tiêu chuẩn Standalone SDK, TA/AC Push SDK, Phần mềm chuẩn Biotime/BioSecurity/BioAccess, Công cụ API...Các đối tác làm giải pháp có thể sử dụng nhiều phương thức trên để điều khiển, lấy dữ liệu theo mong muốn.

Song song đó, Công ty TNHH Smartid cũng nghiên cứu để đưa ra thêm các tùy chọn phương thức kết nối dữ liệu và điều khiển thiết bị, nhằm giúp mọi đối tác có thể tích hợp các dòng máy chấm công ZKTeco thuận tiện, dễ dàng, nhanh chóng, tiết kiệm thời gian và chi phí nhân lực, kết nối dữ liệu tin cậy đảm bảo an toàn ổn định...Sau đây, Smartid xin gửi tới quý đối tác là các công ty tích hợp, nhà phát triển phần mềm và các bạn quan tâm tham khảo thêm một phương thức kết nối dữ liệu chấm công & kiểm soát ra vào cho các sản phẩm ZKTeco thông qua API có sẵn của chúng tôi. Hơn nữa, Smartid cũng cung cấp dịch vụ tùy chỉnh API để đáp ứng chi tiết, sâu hơn và đáp ứng mọi yêu cầu khác nhau của quý vị. Chi tiết vui lòng liên hệ trực tiếp.

1. Giới thiệu

GMES Public API được phát triển để hỗ trợ việc tích hợp và trao đỏi dữ liệu giữa GMES và các nền tảng website khác

2. Chức năng

Mô tả thông tin chi tiết từng API:

Tên API
Mục đích sử dụng
Cấu trúc API
Chi tiết tham số request
Nội dung response trả về

2.1 Lấy thông tin token Đăng nhập

Mục đích sử dụng: API lấy thông tin token để đăng nhập
Phương thức và URL: POST https://chamcong.gmes.vn/gmes_lite_token/api/v1/users/login

- Header Request:

- Request:

- Response:

2.2 Báo cáo ra vào

Mục đích sử dụng: Trả về toàn bộ thông tin danh sách nhân viên, thời gian checkin/checkout
Phương thức và URL: POST https://chamcong.gmes.vn/gmes_lite/api/v1/timesheetinout/get_daily

- Header Request:

- Request:

+ orgid_link: id đơn vị
+ grantid_link: id bộ phận
+ month: tháng
+ year: năm

- Response:

Chú thích:
personnel_code: mã nhân viên,
personnelid_link: id nhân viên
orgid_link: id đơn vị,
grantid_link: id bộ phận,
month: tháng,
year: năm,
sortvalue: 0: Tổng hợp giờ làm việc, 1: tt checkin, 2: tt bắt đầu giờ nghỉ, 3: tt kết thúc giờ nghỉ, 4: thông tin checkout,
fullname: họ tên nhân viên

2.3 Báo cáo tổng hợp công tháng

Mục đích sử dụng: Trả về toàn bộ thông tin danh sách nhân viên kèm tổng giờ công ứng với từng ngày trong tháng, tổng giờ công/ ngày công cả tháng; thông tin số ngày nghỉ ứng với từng loại nghỉ
Phương thức và URL: POST https://chamcong.gmes.vn/gmes_lite/api/v1/timesheetinout/getTimesheetMonthByDat

- Header Request:

- Request:

+ orgid_link: id đơn vị

+ grantid_link: id bộ phận

+ dateFromObj: ngày bắt đầu

+ dateToObj : ngày kết thúc

- Response:

Chú thích:
personnel_code: mã nhân viên,
personnelid_link: id nhân viên
orgid_link: id đơn vị,
grantid_link: id bộ phận,
fullname: họ tên nhân viên
time_working: Giờ công (h),
day_working: Ngày công,
minute_checkinlate: Đi làm muộn (phút),
minute_checkoutearly: Đi về sớm (phút),
nghi_khongluong: Ko Lương,
nghi_phep: Nghỉ phép,
nghi_khongphep: Nghỉ không phép,
nghi_le: Nghỉ lễ,
nghi_thaisan: Nghỉ thai sản,
nghi_hoctap: Nghỉ học tập,
nghi_congtac: Nghỉ công tác,
nghi_conom: Nghỉ con ốm,
nghi_chedo: Nghỉ chế độ,
nghi_hieuhi: Nghỉ hiếu hỉ,
nghi_duongsuc: Nghỉ dưỡng sức,
nghi_dinhchi: Nghỉ đình chỉ,
mapTimeSheetMonthValues: thông tin ngày nhóm theo mã nhân viên, Off: Chủ nhật, - : Thứ 7, V: Vắng, 0: ko checkin/out

2.4 Báo cáo tổng hợp đi trễ về sớm

Mục đích sử dụng: Trả về toàn bộ thông tin danh sách nhân viên kèm cụ thể ngày, giờ đi trễ, về sớm
Phương thức và URL: POST https://chamcong.gmes.vn/gmes_lite/api/v1/timesheetinout/getTimesheetReportEarlyLate

- Header Request:

- Request:

+ orgid_link: id đơn vị

+ grantid_link: id bộ phận

+ dateFromObj: ngày bắt đầu

+ dateToObj : ngày kết thúc

+ isLate: đi trễ = true, về sớm = false

- Response:

Chú thích:
personnel_code: mã nhân viên,
personnelid_link: id nhân viên
orgid_link: id đơn vị,
orgName: tên đơn vị,
grantid_link: id bộ phận,
position_name: chức vụ,
fullname: tên nhân viên,
workingdate: ngày làm việc,
dayOfWeek: thứ,
shiftstart_time: giờ bắt đầu ca,
shiftend_time: giờ kết thúc ca,
lunchstart_time: giờ bắt đầu nghỉ,
lunchend_time: giờ kết thúc nghỉ,
checkin_time: giờ checkin,
checkout_time: giờ checkout,
minute_checkinlate: Vào trễ (phút),
minute_checkoutearly: Về sớm (phút)