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

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)

Vui lòng tham khảo test API sau đây:

Chi tiết phương thức kết nối API, vui lòng liên hệ trực tiếp với Smartid

Tin tham khảo:

https://smartid.com.vn/demo-cong-cu-tich-hop-thiet-bi-kiem-soat-ra-vao-zkteco-su-dung-zkbiosecurity-api.html

https://smartid.com.vn/huong-dan-tich-hop-sdk-may-cham-cong-co-tinh-nang-tu-dong-day-du-lieu-qua-internetwifi3g.html

https://smartid.com.vn/ket-noi-va-dong-bo-hoa-du-lieu-cham-cong-diem-danh-tren-nen-web-based.html

https://smartid.com.vn/goi-y-cau-lenh-lap-trinh-dieu-khien-trong-ta-push-sdk-danh-cho-cac-may-cham-cong-kiem-soat-ra-vao-zkteco.html