Ngày nay, nhiều doanh nghiệp chủ động xây dựng hệ thống ERP, HRM riêng, khiến việc tích hợp dữ liệu chấm công để tính lương trở nên thiết yếu. Tuy nhiên, mỗi loại máy chấm công lại có phương thức kết nối khác nhau, gây khó khăn cho việc đồng bộ. Bài viết này sẽ hướng dẫn bạn lấy dữ liệu chấm công thông qua API của phần mềm FTA, giúp đơn giản hóa quá trình mà không cần quan tâm đến cách thức kết nối trực tiếp với thiết bị.
Cơ chế hoạt động
Thay vì phải viết code kết nối trực tiếp vào IP của từng máy chấm công (ZKTeco, Hikvision, Dahua…), bạn sẽ giao tiếp với FTA Server. Phần mềm FTA đóng vai trò là “trung gian”:
Tự động thu thập dữ liệu từ các máy chấm công dưới xưởng/văn phòng…
Lưu trữ vào cơ sở dữ liệu tập trung.
Cung cấp các Endpoint API để hệ thống của bạn (ERP/HRM) gọi và lấy dữ liệu về.
Các bước chuẩn bị
Cài đặt FTA: Đảm bảo phần mềm FTA đã được cài đặt và đang hoạt động ổn định (có thể kết nối được với máy chấm công).
Thông tin API: Bạn cần địa chỉ IP Server cài FTA và Port (thường mặc định là 8081 hoặc tùy chỉnh trong cấu hình).
API Key/Token: Truy cập phần cài đặt, tìm mục API Key và bấm tạo mới.
API key trên FTS
Quy trình lấy dữ liệu qua API
- Bước 1: Cấu hình Endpoint và Header
URL: http://[IP_Server]:[Port]/api/open-api/get-att-log
Method: POST
Content-Type: application/json - Bước 2: Truy vấn dữ liệu.
- Bước 3: Xử lý cấu trúc JSON trả về
Dữ liệu trả về thường có định dạng JSON như sau:
ảnh test kết nối api lấy dữ liệu chấm công bằng postman
Việc sử dụng API của phần mềm FTA thay vì trực tiếp kết nối (SDK/Socket) với từng máy chấm công mang lại những lợi ích vượt trội. Mỗi hãng máy chấm công (ZKTeco, Hikvision, Dahua, Ronald Jack…) đều có phương thức kết nối, cổng (port) và cấu trúc dữ liệu khác nhau. Bạn chỉ cần viết đúng 01 cấu trúc gọi API duy nhất. Mọi việc “giao tiếp” với các loại máy khác nhau đã có FTA xử lý. Nếu máy chấm công bị mất kết nối hoặc hỏng đột xuất, dữ liệu đã được FTA lưu trữ trong Database. API sẽ lấy từ Database này thay vì truy vấn trực tiếp vào thiết bị, đảm bảo hệ thống ERP của bạn luôn có dữ liệu để hoạt động mà không bị treo (Timeout) do chờ đợi thiết bị phản hồi.