- ỨNG DỤNG
- Máy chấm công ZKTeco - ADMS và TCP/UDP 20.0
Tích hợp máy chấm công ZKTeco - ADMS và TCP/UDP
Đưa lượt chấm từ máy chấm công vân tay, khuôn mặt, thẻ của ZKTeco vào ứng dụng Chấm công của Odoo, từ bất kỳ văn phòng nào, không cần mở cổng. Biết ngay máy nào đang trực tuyến, biến mỗi lượt chấm thành bản ghi chấm công chính xác, và biết ai đi muộn, vắng mặt hay quên chấm ra.
Chạy trên Odoo.sh và máy chủ riêng. Không phải cài thêm thư viện. Cài đặt có trợ lý từng bước, quy tắc vào / ra cho máy khuôn mặt, bảng chấm công tháng in sẵn, và tài liệu giải thích mọi thông báo lỗi.
Thông tin nhanh
Tính năng chính
ADMS, dữ liệu tức thì
Máy tự gọi Odoo và gửi từng lượt chấm ngay khi chấm. Không chuyển tiếp cổng, không cần IP tĩnh, bao nhiêu văn phòng cũng được. Máy đời cũ dùng TCP/UDP.
Cài đặt có hướng dẫn
Trợ lý năm bước trên mỗi máy, đúng các thông số cần nhập trên máy ADMS, và cảnh báo khi có điều gì cản máy tới được Odoo.
Bảng máy và cảnh báo mất kết nối
Trực tuyến, Mất kết nối hay Chưa kết nối nhìn là thấy, kèm lần liên lạc gần nhất và lỗi. Kỹ thuật viên nhận hoạt động nhắc khi máy im lặng.
Người dùng và nhân viên
Tải người dùng về và ghép theo Mã số Thẻ hoặc theo tên, hoặc đưa nhân viên lên máy mới kèm mẫu vân tay và khuôn mặt.
Vào / ra chính xác
Chế độ Luân phiên cho máy khuôn mặt không có trạng thái, bỏ qua lượt chấm lặp, xử lý quên chấm ra, tính lại chấm công từ lượt chấm bất cứ lúc nào.
Báo cáo và bảng chấm công tháng
Bảng Hôm nay, đi muộn / về sớm / vắng mặt / thiếu giờ ra theo từng ngày so với lịch làm việc, biểu đồ, và bảng chấm công tháng để in và ký.
Điểm mới ở bản 20.0
- Bảng máy chấm công với trạng thái kết nối của từng máy, và cảnh báo mất kết nối cho kỹ thuật viên.
- Trợ lý cài đặt trên form máy, với thông số cần nhập trên máy ADMS và các kiểm tra phía máy chủ.
- Quy tắc vào / ra cho từng máy (Luân phiên, lượt chấm lặp, ca dài nhất) và Tính lại chấm công của một khoảng thời gian.
- Báo cáo Chấm công theo ngày kèm biểu đồ các trường hợp cần xem xét theo nhân viên, bảng Hôm nay và Bảng chấm công tháng in được.
- Bản ghi chấm công được đánh dấu Máy chấm công trong Odoo, giờ ra thật thay cho giờ chấm ra tự động của Odoo.
- Mã người dùng trên máy dài tới 24 ký tự, nhiều máy ADMS tại cùng một vị trí, menu rõ ràng hơn và chú thích trên mọi trường, máy demo kèm lượt chấm của tháng này và tháng trước.
Cài một máy trong năm bước
Kết nối tới máy, xác nhận máy, đọc thông tin máy, ghép người dùng trên máy với nhân viên, nhận những lượt chấm đầu tiên: mỗi bước tự đánh dấu khi xong.
Với máy ADMS, form hiển thị đúng những gì cần nhập ở Menu > COMM. > Cloud Server Setting, lấy từ địa chỉ Odoo của bạn, và cảnh báo khi máy chủ có nhiều cơ sở dữ liệu hoặc Odoo đang dùng địa chỉ nội bộ.
Máy khuôn mặt không có chấm ra? Đã giải quyết.
Hầu hết máy khuôn mặt gửi mọi lượt chấm mà không kèm trạng thái vào / ra. Chuyển máy sang Luân phiên: lượt chấm của nhân viên xen kẽ vào rồi ra, lượt quét lặp được bỏ qua, và quên chấm ra không còn "nuốt" lượt chấm vào của hôm sau.
Vừa đổi quy tắc, hay vừa ghép muộn một người dùng? Tính lại chấm công dựng lại cả một khoảng thời gian từ lượt chấm, vốn được Odoo lưu vĩnh viễn.
Hôm nay ai đã vào, ai đi muộn
Bảng Hôm nay so chấm công trong ngày với lịch làm việc của từng nhân viên: đúng giờ, đi muộn (bao nhiêu phút), đang làm việc, chưa chấm vào.
Từng ngày của từng nhân viên, đều được kiểm
Chấm công theo ngày liệt kê giờ vào và số giờ theo lịch, giờ vào, giờ ra, giờ làm, số phút đi muộn và về sớm, cùng trạng thái: Đúng giờ, Đi muộn, Về sớm, Thiếu giờ ra, Vắng mặt, Nghỉ phép / Ngày lễ, Làm ngày nghỉ. Nghỉ phép và ngày lễ đã được trừ, có tính thời gian cho phép.
Báo cáo mở sẵn các trường hợp cần xem; chế độ pivot và biểu đồ so sánh giữa nhân viên và giữa các ngày.
Ai hay đi muộn, nhìn là thấy
Biểu đồ các trường hợp cần xem xét theo nhân viên cho thấy ai hay đi muộn, về sớm hay quên chấm ra nhất trong kỳ. Nhóm theo phòng ban hoặc theo tuần để thấy xu hướng.
Bảng chấm công tháng, sẵn sàng để ký
Mỗi nhân viên một dòng, mỗi ngày một cột, mỗi ngày một ký hiệu (đúng giờ, đi muộn, về sớm, vắng mặt, thiếu giờ ra, nghỉ phép), kèm giờ làm và các cột tổng của tháng: dùng để chốt công và tính lương.
ADMS hay TCP/UDP?
| Tình huống của bạn | TCP/UDP | ADMS |
|---|---|---|
| Odoo đặt tại văn phòng, cùng mạng với máy | Nên dùng | Dùng được |
| Odoo trên cloud (Odoo.sh, máy chủ thuê), máy đặt ở văn phòng | Chuyển tiếp cổng và IP tĩnh hoặc tên miền động | Nên dùng: không phải mở gì |
| Nhiều văn phòng, một Odoo | Mỗi văn phòng chuyển tiếp một cổng | Nên dùng |
| Lượt chấm phải hiện ngay | Mỗi 30 phút, hoặc khi bấm tải | Ngay khi chấm |
| Máy đời cũ không có ADMS | Cách duy nhất | Không dùng được |
Máy ADMS cần có menu ADMS / Cloud Server, có trên hầu hết máy ZKTeco bán ra từ năm 2018. Máy không có HTTPS vẫn dùng được: tài liệu hướng dẫn cấu hình nginx để phục vụ đường dẫn /iclock/ qua HTTP.
Máy chấm công được hỗ trợ
Máy ZKTeco và các máy dựa trên ZKTeco, ở chế độ Time Attendance (hoặc Access Control kèm quy tắc Luân phiên). Chưa chắc máy của bạn? Thử trên bản demo miễn phí trước, hoặc gửi cho chúng tôi dòng máy và phiên bản firmware.
Viindoo đã kiểm thử
ZKTeco SenseFace 7A, K14, K20, K40, K50, MA300, T4C, G3, U580, F18, F19, MB20, IN0A-1, SpeedFace V5L, SpeedFace H5L(P), VF680, RSP10k1, iFace402/ID, iFace702, iFace800, iClock 700, iClock880-H, iClock3000, Uface 302, Uface 800 (vân tay và khuôn mặt); Ronald Jack B3-C, iClock260, T8, 1000Plus.
Khách hàng xác nhận chạy tốt
SpeedPalm-V5L, SenseFace 2A, 3, 4, 7, SF400, dòng MB, F21, F22, dòng uFace, dòng SilkBio, IN05 và IN05-A, X628-C, U260-C, U300-C, iClock360, iClock680, dòng UA, dòng WL, dòng P, EFace10, và các máy có chức năng ADMS.
Câu hỏi thường gặp
Odoo của tôi trên Odoo.sh, máy đặt ở văn phòng. Có cần IP tĩnh không?
Không: dùng ADMS. Máy gọi Odoo bằng tên miền qua HTTPS; không phải mở gì trên mạng của bạn.
Có phải cài thư viện Python không?
Không. Thư viện giao tiếp đã nằm sẵn trong mô-đun.
Máy khuôn mặt ghi mọi lượt chấm là chấm vào.
Đặt máy sang Luân phiên vào / ra và tính lại chấm công: lượt chấm xen kẽ vào rồi ra, lượt quét lặp được bỏ qua.
Mất Internet thì sao?
Máy giữ lượt chấm và gửi lên khi có mạng trở lại. Lượt chấm được lưu vĩnh viễn trong Odoo và có thể tính lại chấm công bất cứ lúc nào.
Nhiều văn phòng ở nhiều quốc gia?
Được: mỗi văn phòng một vị trí máy với múi giờ riêng, số máy không giới hạn.
Có tính tăng ca và lương không?
Mô-đun tạo dữ liệu chấm công sạch; Odoo tính tăng ca bằng quy tắc thời gian của ứng dụng Chấm công, và các ứng dụng lương đọc dữ liệu chấm công này.
Hikvision, Suprema, Anviz?
Không hỗ trợ: các hãng này dùng giao thức riêng. Hỗ trợ ZKTeco và các hãng dựa trên ZKTeco.
Tài liệu và hỗ trợ
- Hướng dẫn đầy đủ ở tab Tài liệu: chọn ADMS hay TCP/UDP, cài đặt từng bước, Odoo.sh và nginx, quy tắc vào / ra, báo cáo, bảng xử lý sự cố theo thông báo lỗi, và các giới hạn.
- Chú thích trên mọi trường của ứng dụng, màn hình trống luôn chỉ cách bắt đầu.
- Sửa lỗi miễn phí. Câu hỏi mà tài liệu chưa trả lời: gửi yêu cầu hỗ trợ kèm dòng máy và phiên bản firmware.
Tích hợp Máy chấm công Sinh trắc học
Tài liệu này dành cho: cán bộ nhân sự / chấm công theo dõi chấm công hằng ngày, kỹ thuật viên CNTT kết nối máy, và quản trị viên cài ứng dụng. Hãy đọc một lượt từ đầu đến cuối: tài liệu trả lời các câu hỏi khi cài đặt lần đầu, còn mục Xử lý sự cố trả lời các thông báo lỗi.
Tổng quan
Tích hợp Máy chấm công Sinh trắc học đưa lượt chấm từ các máy chấm công vân tay, khuôn mặt, thẻ của ZKTeco (và các máy dựa trên ZKTeco: Ronald Jack, eSSL, nhiều thương hiệu OEM) vào ứng dụng Chấm công của Odoo:
- Kết nối bao nhiêu máy cũng được, ở nhiều nơi và nhiều múi giờ, theo một trong hai cách:
- TCP/UDP: Odoo kết nối tới máy theo địa chỉ IP hoặc tên miền của máy. Phù hợp khi Odoo chạy ngay tại văn phòng, hoặc khi router văn phòng chuyển tiếp được một cổng tới máy.
- ADMS (máy tự đẩy dữ liệu): máy tự gọi Odoo và gửi từng lượt chấm ngay khi nhân viên chấm. Không cần mở gì trên mạng văn phòng: không chuyển tiếp cổng, không cần IP tĩnh. Máy cần có chức năng ADMS (Cloud Server), hầu hết máy bán ra từ năm 2018 đều có.
- Ghép người dùng trên máy với nhân viên: tải người dùng về rồi ghép (theo Mã số Thẻ, rồi theo tên), hoặc đưa nhân viên lên một máy mới, kèm mẫu vân tay và khuôn mặt.
- Chuyển lượt chấm thành chấm công mỗi 30 phút, có quy tắc riêng cho máy không gửi trạng thái vào / ra (hầu hết máy khuôn mặt).
- Giám sát máy: một bảng cho biết máy nào đang trực tuyến; máy nào im lặng quá lâu sẽ tạo một hoạt động nhắc kỹ thuật viên.
- Báo cáo: hôm nay ai đã vào, ai đi muộn, về sớm, vắng mặt hay quên chấm ra, theo từng ngày, và bảng chấm công tháng để ký.
Mọi dữ liệu nằm trong Odoo: lượt chấm được lưu vĩnh viễn, nên có thể tính lại chấm công bất cứ lúc nào.
Điểm mới ở bản 20.0
- Bảng máy chấm công: mỗi máy kèm trạng thái kết nối (Trực tuyến, Mất kết nối, Chưa kết nối), liên lạc gần nhất, số người dùng, người dùng chưa ghép và lượt chấm trong ngày. Hoạt động Cảnh báo mất kết nối báo cho kỹ thuật viên khi máy im lặng.
- Trợ lý cài đặt ngay trên form máy: năm bước tự đánh dấu khi xong, đúng các thông số cần nhập trên máy ADMS, và cảnh báo những gì làm máy không tới được Odoo (Odoo đang dùng địa chỉ nội bộ, máy chủ có nhiều cơ sở dữ liệu, thiếu số sê-ri).
- Quy tắc vào / ra cho từng máy: chế độ Luân phiên cho máy không có trạng thái chấm, bỏ qua lượt chấm lặp, quên chấm ra không còn "nuốt" lượt chấm vào của hôm sau; Tính lại chấm công của một khoảng thời gian sau khi đổi quy tắc.
- Báo cáo: bảng Hôm nay, Chấm công theo ngày (đúng giờ, đi muộn, về sớm, vắng mặt, thiếu giờ ra, nghỉ phép) so với lịch làm việc, Bảng chấm công tháng in được, biểu đồ các trường hợp cần xem xét theo nhân viên, và phân tích Lượt chấm công từ máy.
- Bản ghi chấm công từ máy hiển thị chế độ Máy chấm công và vị trí là chính chiếc máy; giờ ra thật của máy thay cho giờ chấm ra tự động của Odoo.
- Mã người dùng trên máy dài tới 24 ký tự; Kiểm tra kết nối dùng được trước khi xác nhận máy; nhiều máy ADMS tại cùng một vị trí.
- Menu, nhãn rõ ràng hơn, mọi trường đều có chú thích; dữ liệu demo có sẵn máy và lượt chấm của tháng này cùng tháng trước.
Yêu cầu
- Odoo 20.0, bản Community hoặc Enterprise, trên máy chủ riêng hoặc Odoo.sh. Odoo Online (SaaS) không cho cài ứng dụng bên thứ ba.
- Ứng dụng Chấm công (được cài cùng).
- Không phải cài thêm gì bằng pip: thư viện giao tiếp (pyzk) đã nằm sẵn trong mô-đun.
- Máy ZKTeco, hoặc máy thương hiệu khác dựa trên ZKTeco: trang ứng dụng trên App Store liệt kê các máy đã kiểm thử và các máy khách hàng xác nhận chạy tốt. Nếu còn băn khoăn, hãy thử máy của bạn với bản demo miễn phí trước.
Cài đặt
- Vào Ứng dụng và bỏ bộ lọc Ứng dụng.
- Tìm to_attendance_device (hoặc Biometric Attendance).
- Bấm Kích hoạt.
Vai trò và phân quyền
Phân quyền tại Thiết lập > Người dùng & Công ty > Người dùng, mục Chấm công.
| Ai | Được làm gì | Quyền |
|---|---|---|
| Quản trị chấm công | Cài đặt máy, ghép người dùng, tính lại chấm công, xem lệnh gửi máy ADMS. Kèm sẵn quyền Quản lý máy chấm công. | Quản trị viên |
| Cán bộ chấm công | Theo dõi lượt chấm và chấm công, dùng các báo cáo (cán bộ chỉ quản lý một số nhân viên thì chỉ thấy những nhân viên đó). | Người phụ trách: Quản lý chấm công |
| Nhân viên | Chấm công trên máy. Xem chấm công của chính mình. | (người dùng nội bộ) |
Chọn cách kết nối máy
| Tình huống của bạn | TCP/UDP | ADMS |
|---|---|---|
| Odoo chạy tại văn phòng, cùng mạng với máy | Nên dùng | Dùng được |
| Odoo chạy trên cloud (Odoo.sh, máy chủ thuê), máy đặt ở văn phòng | Cần router văn phòng chuyển tiếp cổng, và IP tĩnh hoặc tên miền động (DDNS) | Nên dùng: không phải mở gì |
| Nhiều văn phòng, một Odoo | Mỗi văn phòng chuyển tiếp một cổng | Nên dùng |
| Lượt chấm phải hiện ngay | Tải về mỗi 30 phút, hoặc khi bấm tải | Mỗi lượt chấm được gửi ngay khi chấm |
| Máy đời cũ không có chức năng ADMS | Cách duy nhất | Không dùng được |
Cài đặt một máy chấm công
- Tạo vị trí đặt máy: Chấm công > Cấu hình > Vị trí máy. Nhập tên (Cổng chính), địa điểm làm việc, và quan trọng nhất là múi giờ: máy lưu giờ địa phương, Odoo đọc giờ đó theo múi giờ này.
- Vào Chấm công > Máy chấm công > Máy chấm công và bấm Mới.
- Nhập tên, Giao thức và Vị trí:
- TCP/UDP: IP / tên miền mà Odoo dùng để tới máy, Cổng (4370 nếu chưa đổi trên máy), và Mật khẩu nếu trên máy có đặt khoá giao tiếp (Comm Key).
- ADMS: Số sê-ri của máy (trên máy: Menu > System Info > Device Info).
- Lưu. Form mở ra với trợ lý cài đặt: làm theo năm bước, mỗi bước tự đánh dấu khi xong.
Bước 1 - Kết nối tới máy
TCP/UDP: bấm Kiểm tra kết nối. Nút dùng được ngay khi máy còn ở trạng thái nháp. Nếu lỗi, xem mục Xử lý sự cố.
ADMS: trên máy, mở Menu > COMM. > Cloud Server Setting và nhập các thông số mà trợ lý hiển thị, lấy từ địa chỉ của Odoo:
- Server Mode: ADMS
- Enable Domain Name: ON khi Odoo được truy cập bằng tên miền (hr.example.com), OFF khi dùng địa chỉ IP
- Server Address: tên miền hoặc địa chỉ IP của Odoo
- Server Port: 443 với HTTPS, 80 với HTTP, hoặc cổng của Odoo (8069) với máy chủ nội bộ
- HTTPS: ON khi địa chỉ Odoo bắt đầu bằng https (máy không có tuỳ chọn HTTPS: xem mục Máy ADMS qua Internet bên dưới)
- Proxy Server: OFF
Trong vòng một phút máy gọi tới Odoo, bước này chuyển sang màu xanh và máy hiển thị Trực tuyến trên bảng máy.
Bước 2 - Xác nhận máy
Bấm Xác nhận. Odoo tải lượt chấm của máy TCP/UDP đã xác nhận mỗi 30 phút, và nhận dữ liệu của máy ADMS đã xác nhận. Máy ở trạng thái Nháp không được động tới.
Bước 3 - Đọc thông tin máy
Bấm Lấy thông tin máy: Odoo đọc dòng máy, phiên bản firmware, số sê-ri và hãng. Máy ADMS gửi các thông tin này ở lần hỏi lệnh kế tiếp.
Bước 4 - Ghép người dùng trên máy với nhân viên
Một lượt chấm chỉ được tính cho nhân viên khi người dùng trên máy đã chấm được ghép với nhân viên đó.
- Máy mới, chưa có dữ liệu: bấm Đưa nhân viên lên máy. Nhân viên trở thành người dùng trên máy theo Mã số Thẻ của họ (nhân viên chưa có sẽ được cấp Mã số Thẻ mới), kèm mẫu vân tay và khuôn mặt mà Odoo đã có từ máy khác. Nhân viên chấm được ngay, không phải đăng ký lại.
- Máy đang dùng: bấm Tải người dùng về, rồi Ghép nhân viên. Odoo ghép mỗi người dùng với một nhân viên theo thứ tự độ tin cậy: Số ID của người dùng trên máy trùng Mã số Thẻ của nhân viên, rồi trùng tên, rồi trùng tên không dấu, rồi trùng phần đầu của tên (máy cắt bớt tên dài). Tên trùng với nhiều nhân viên sẽ được để lại cho bạn: mở Chấm công > Máy chấm công > Người dùng trên máy, lọc Chưa ghép với nhân viên, và chọn nhân viên bằng tay.
Bước này chuyển xanh khi mọi người dùng trên máy đã được ghép. Nếu muốn tạo nhân viên cho những người dùng chưa ghép được, đánh dấu Tạo nhân viên khi ghép ở tab Thiết lập kỹ thuật.
Bước 5 - Nhận những lượt chấm đầu tiên
Chấm vào và chấm ra thử trên máy. Máy ADMS gửi lượt chấm ngay; với máy TCP/UDP, bấm Tải lượt chấm về. Lượt chấm hiện ở Chấm công > Máy chấm công > Lượt chấm công, và thành bản ghi chấm công trong vòng 30 phút (hoặc ngay lập tức với Đồng bộ sang chấm công trong menu hành động của lượt chấm).
Quy tắc vào và ra
Mỗi lượt chấm mang một trạng thái chấm, là mã mà máy gán cho lượt chấm: 0 Vào, 1 Ra, 2 Ra nghỉ giữa giờ, 3 Vào lại sau nghỉ, 4 Vào tăng ca, 5 Ra tăng ca, và 255 khi máy không có trạng thái nào. Tab Mã trạng thái chấm công của máy liệt kê các mã máy dùng; Chấm công > Cấu hình > Trạng thái chấm định nghĩa mỗi mã là chấm vào hay chấm ra, và thuộc hoạt động chấm công nào (làm việc bình thường, tăng ca, nghỉ giữa giờ). Mỗi hoạt động có các bản ghi chấm công riêng.
Tab Chấm vào / Chấm ra của máy quy định cách lượt chấm thành chấm công:
- Theo trạng thái chấm của máy: trạng thái quyết định. Dành cho máy có phím Check-in / Check-out, hoặc máy tự gán trạng thái theo khung giờ.
- Luân phiên vào / ra: dành cho máy không gửi trạng thái dùng được, tức là hầu hết máy khuôn mặt và mọi máy ở chế độ Access Control: lượt chấm đầu tiên của nhân viên là chấm vào, lượt kế tiếp là chấm ra, cứ thế xen kẽ, đều tính là làm việc bình thường. Form sẽ cảnh báo khi các lượt chấm gần đây của máy đều là chấm vào: hãy chuyển máy sang chế độ này.
- Bỏ qua lượt chấm lặp trong vòng (chế độ Luân phiên, mặc định 2 phút): cùng một lần quét bị lặp không phải là chấm ra.
- Ca dài nhất (mặc định 16 giờ): bản ghi chấm công vẫn còn mở sau ngần ấy giờ kể từ giờ vào là quên chấm ra. Lượt chấm vào kế tiếp mở một bản ghi chấm công mới (không còn bị mất), lượt chấm ra kế tiếp không đóng bản ghi bị quên (nếu đóng sẽ dài quá một ngày), còn bản ghi bị quên vẫn để mở cho nhân sự bổ sung. Đặt 0 để tắt quy tắc này.
Sau khi đổi các quy tắc này, hoặc sau khi ghép muộn một người dùng với nhân viên, dùng Chấm công > Máy chấm công > Tính lại chấm công: các bản ghi chấm công do máy tạo trong khoảng thời gian chọn sẽ bị xoá rồi tạo lại từ lượt chấm, theo quy tắc hiện tại. Các chỉnh sửa bằng tay trên những bản ghi này sẽ mất; bản ghi đã được quản lý duyệt thì không bao giờ bị động tới.
Check-out tự động của Odoo (Chấm công > Cấu hình > Cài đặt) đóng các bản ghi còn mở vào cuối ngày. Khi giờ ra thật của máy về sau đó, giờ ra thật sẽ thay cho giờ ra tự động.
Giám sát máy chấm công
Chấm công > Máy chấm công > Máy chấm công mở ra bảng các máy:
- Trực tuyến: vừa có liên lạc với máy. Máy ADMS gọi Odoo vài giây một lần; máy TCP/UDP trả lời lượt tải dữ liệu mỗi 30 phút.
- Mất kết nối: không có liên lạc trong 10 phút (máy ADMS) hoặc hai lượt tải (máy TCP/UDP), hoặc lần thử kết nối gần nhất bị lỗi. Form hiển thị lỗi. Khi bật Cảnh báo mất kết nối (tab Thiết lập kỹ thuật), Kỹ thuật viên của máy nhận một hoạt động Máy mất kết nối, hoạt động này tự đánh dấu hoàn thành khi máy kết nối lại.
- Chưa kết nối: máy chủ chưa từng liên lạc được với máy.
Mỗi thẻ còn đếm số người dùng trên máy, số nhân viên đã ghép, số người dùng chưa ghép với nhân viên (lượt chấm của họ không thành chấm công) và số lượt chấm trong ngày.
Odoo không gọi được máy ADMS: những gì Odoo yêu cầu máy (gửi danh sách người dùng, đưa người dùng và mẫu sinh trắc lên máy, khởi động lại) được xếp hàng ở Chấm công > Máy chấm công > Lệnh gửi máy, máy nhận lệnh ở lần hỏi kế tiếp và trả kết quả.
Báo cáo
Mọi báo cáo đọc chấm công từ tất cả các nguồn (máy chấm công, ki-ốt, systray, nhập tay), so với lịch làm việc của từng nhân viên, đã trừ nghỉ phép và ngày lễ. Lịch có giờ cố định (08:00 - 12:00, 13:00 - 17:00) cho biết ai đi muộn hay về sớm; lịch tính theo số giờ mỗi ngày, hoặc lịch linh hoạt, thì chỉ tính số giờ.
Chấm công > Báo cáo > Hôm nay: bảng chấm công trong ngày theo trạng thái: Đi muộn, Đang làm việc, Chưa chấm vào...
Chấm công > Báo cáo > Chấm công theo ngày: chọn khoảng thời gian, phòng ban hoặc nhân viên, và thời gian cho phép (mặc định 5 phút: chấm vào lúc 08:04 vẫn là đúng giờ). Chỉ người dùng trên máy giữ lại các nhân viên chấm công bằng máy (bỏ đánh dấu để xem tất cả). Phân tích liệt kê từng ngày của từng nhân viên: giờ vào theo lịch và giờ theo lịch, giờ vào, giờ ra, giờ làm, số phút đi muộn và về sớm, và trạng thái: Đúng giờ, Đi muộn, Về sớm, Đi muộn và về sớm, Thiếu giờ ra, Vắng mặt, Nghỉ phép / Ngày lễ, Làm ngày nghỉ. Báo cáo mở sẵn bộ lọc các trường hợp cần xem (Cần xem xét); chế độ pivot và biểu đồ giúp so sánh giữa nhân viên và giữa các ngày.
Chế độ biểu đồ, nhóm theo Nhân viên và Trạng thái, cho thấy ai hay đi muộn, về sớm hay quên chấm ra nhất:
In bảng chấm công tháng (cùng hộp thoại): nhân viên theo từng ngày của kỳ trên khổ A4 ngang, mỗi ngày một ký hiệu (✓ đúng giờ, L đi muộn, E về sớm, A vắng mặt, M thiếu giờ ra, P nghỉ phép hoặc ngày lễ, X làm ngày nghỉ), kèm các cột tổng và chỗ ký, dùng để chốt công tháng và tính lương.
Chấm công > Báo cáo > Lượt chấm công từ máy: lượt chấm theo ngày, máy, nhân viên hoặc trạng thái chấm.
Máy ADMS qua Internet
Odoo.sh và máy chủ thuê: dùng tên miền của Odoo, Enable Domain Name ON, cổng 443 và HTTPS ON.
Máy không có HTTPS chỉ gọi được địa chỉ HTTP thường. Hãy phục vụ đường dẫn /iclock/ qua HTTP, không chuyển hướng sang HTTPS. Ví dụ với nginx đứng trước Odoo:
location /iclock/ { proxy_pass http://127.0.0.1:8069; proxy_set_header Host $host; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; }đặt trong khối server lắng nghe cổng 80, trước dòng chuyển hướng sang HTTPS.
Máy chủ có nhiều cơ sở dữ liệu: máy không gửi tên cơ sở dữ liệu. Hãy chạy Odoo với bộ lọc cơ sở dữ liệu chọn đúng cơ sở dữ liệu này cho địa chỉ mà máy gọi (dbfilter = ^%d$ với mỗi cơ sở dữ liệu một tên miền, hoặc db_name). Trợ lý cài đặt sẽ cảnh báo khi cần.
Giới hạn địa chỉ được phép đẩy dữ liệu: đặt tham số hệ thống to_attendance_device.allowed_ips (Thiết lập > Kỹ thuật > Tham số hệ thống) bằng các địa chỉ IP công cộng hoặc dải mạng của văn phòng, cách nhau bởi dấu phẩy (203.0.113.10, 198.51.100.0/24). Để trống: chấp nhận mọi địa chỉ.
Odoo nhận biết máy theo Số sê-ri, và chỉ nhận dữ liệu khi máy đã xác nhận.
Tác vụ định kỳ
- Máy chấm công: Tự động tải lượt chấm về (mỗi 30 phút): tải lượt chấm của các máy TCP/UDP đã xác nhận.
- Lượt chấm công: Đồng bộ sang chấm công (mỗi 30 phút): chuyển lượt chấm mới thành chấm công.
- Máy chấm công: Kiểm tra kết nối của các máy (mỗi 10 phút): đánh dấu máy im lặng là mất kết nối và tạo cảnh báo.
- Máy chấm công: Xóa lệnh gửi máy đã cũ (mỗi ngày): xoá lệnh gửi máy ADMS cũ hơn 180 ngày.
Đổi tần suất tại Thiết lập > Kỹ thuật > Tác vụ định kỳ (chế độ nhà phát triển).
Xử lý sự cố
| Hiện tượng | Cách xử lý |
|---|---|
| Could not connect to the machine ... timed out (TCP/UDP) | Odoo không tới được IP và cổng. Với máy chủ cloud: cấu hình router văn phòng chuyển tiếp cổng (4370) tới máy, và dùng IP công cộng hoặc tên miền động của văn phòng. Trên máy, kiểm tra IP, mặt nạ mạng và cổng mặc định (Menu > COMM. > Ethernet). Hoặc chuyển sang ADMS. |
| Connection Unauthorized, hoặc không có phản hồi dù mạng vẫn thông | Trên máy có đặt khoá giao tiếp (Comm Key): nhập khoá đó vào Mật khẩu. Với máy đời cũ, thử UDP thay cho TCP. |
| [Errno 32] Broken pipe hoặc quá thời gian chờ khi tải nhiều lượt chấm | Giảm TCP Max-Size (hoặc UDP Max-Size) ở tab Thiết lập kỹ thuật (chế độ nhà phát triển). Bật Tự động xoá lượt chấm trên máy để máy giữ ít lượt chấm hơn. |
| Máy ADMS mãi ở trạng thái Chưa kết nối | Đối chiếu các thông số đã nhập trên máy với trợ lý cài đặt, và đọc các cảnh báo của trợ lý (Odoo dùng địa chỉ nội bộ, nhiều cơ sở dữ liệu, thiếu số sê-ri). Từ mạng của máy phải mở được địa chỉ của Odoo: thử mở bằng trình duyệt trên một máy tính trong văn phòng. Máy không có HTTPS cần /iclock/ chạy qua HTTP. |
| Lượt chấm đã về nhưng không có bản ghi chấm công | Mở Lượt chấm công, lọc Người dùng chưa ghép: ghép những người dùng này với nhân viên, rồi Tính lại chấm công. Lọc Đồng bộ thất bại để thấy các lượt chấm mà Odoo đã bỏ qua sau ba lần thử: phần trao đổi (chatter) của máy ghi lý do. |
| Mọi lượt chấm của máy khuôn mặt đều là chấm vào, không ai chấm ra | Máy không gửi trạng thái chấm: đặt Chấm vào / Chấm ra của máy là Luân phiên vào / ra, rồi Tính lại chấm công của khoảng thời gian đó. |
| Giờ chấm bị lệch vài tiếng | Múi giờ của vị trí máy bị sai, hoặc đồng hồ của máy bị sai: sửa lại, rồi Tính lại chấm công (lượt chấm đã tải về vẫn giữ giờ sai; nếu cần, nhập giờ đúng bằng tay). |
| Email của máy báo unknown attendance status code | Máy dùng một mã trạng thái chấm mà Odoo chưa biết: thêm mã đó vào Trạng thái chấm và vào tab Mã trạng thái chấm công của máy. |
| Máy báo Mất kết nối dù vẫn chạy bình thường | Máy ADMS đặt Delay (khoảng cách giữa hai lần hỏi lệnh) quá dài có thể im lặng giữa hai lần hỏi: giữ Delay dưới vài phút. Máy TCP/UDP chỉ được liên lạc bởi tác vụ tải dữ liệu: kiểm tra tác vụ này còn hoạt động. |
Câu hỏi thường gặp
Máy của tôi có dùng được không? Dùng được với máy ZKTeco và nhiều thương hiệu dựa trên ZKTeco (Ronald Jack, eSSL, và các hãng khác dùng cùng giao thức): trang ứng dụng trên App Store liệt kê các máy đã kiểm thử và các máy khách hàng xác nhận chạy tốt. Máy có menu ADMS hoặc Cloud Server dùng được chế độ ADMS.
Vân tay, khuôn mặt, thẻ, lòng bàn tay? Mô-đun đọc lượt chấm bất kể nhân viên xác thực bằng cách nào, và chép mẫu vân tay, khuôn mặt giữa các máy.
Dùng nhiều máy ở nhiều văn phòng, nhiều quốc gia được không? Được: mỗi nơi một vị trí máy với múi giờ riêng, số lượng máy không giới hạn.
Mất Internet thì sao? Máy giữ lượt chấm và gửi lên (ADMS) hoặc cho tải về (TCP/UDP) khi có kết nối trở lại. Không mất dữ liệu.
Có tính tăng ca và lương không? Mô-đun tạo ra dữ liệu chấm công sạch. Odoo tính tăng ca từ đó bằng các quy tắc thời gian của ứng dụng Chấm công; các ứng dụng tính lương đọc dữ liệu chấm công này.
Nhân viên có chấm công bằng điện thoại hay ki-ốt được nữa không? Được: mọi nguồn chấm công dùng song song, và báo cáo tính tất cả.
Giới hạn
- Máy phải là máy ZKTeco hoặc dùng giao thức của ZKTeco (kết nối TCP/UDP, hoặc ADMS). Các hãng có giao thức riêng (Hikvision ISAPI, Suprema BioStar, Anviz) không được hỗ trợ.
- Máy phải ở chế độ Time Attendance, hoặc chế độ Access Control kèm quy tắc Luân phiên.
- Mẫu khuôn mặt của dòng máy này không phải lúc nào cũng dùng được trên dòng máy khác: khi dùng lẫn nhiều dòng máy, hãy đăng ký lại khuôn mặt.
- Không sửa được chính lượt chấm: đó là bản ghi những gì máy đã gửi. Hãy sửa bản ghi chấm công.
Hỗ trợ
Tài liệu này và các chú thích trong ứng dụng đã bao quát việc cài đặt và sử dụng hằng ngày. Nếu máy vẫn không kết nối được, hoặc có câu hỏi mà tài liệu chưa trả lời, hãy gửi yêu cầu tại https://viindoo.com/vi/ticket/team/8 kèm dòng máy, phiên bản firmware và lỗi hiển thị trên form máy.
Phần mềm này và các tệp liên kết ("Phần mềm") được sử dụng (chạy, tuỳ biến, chạy sau khi được tuỳ biến) chỉ khi bạn mua được giấy phép có hiệu lực từ tác giả, điển hình như qua các Ứng dụng Odoo, hoặc trong trường hợp bạn nhận được thoả thuận bằng văn bản từ tác giả của Phần mềm (chi tiết tại tệp COPYRIGHT).
Bạn có thể phát triển các phân hệ Odoo có sử dụng Phần mềm như một Thư viện (thường là phụ thuộc vào, nhập vào và sử dụng nguồn của nó) nhưng không sao chéo bất kỳ mã nguồn hay tài liệu nào thuộc Phần mềm. Bạn có thể phân phối những phân hệ này theo giấy phép mà bạn lựa chọn, miễn sao nội dung giấy phép đó tương tích với điều khoản của Giấy phép Phần mềm Độc quyền Odoo (ví dụ: LGPL, MIT hay bất kỳ loại giấy phép phần mềm độc quyền nào tương tự vậy).
Nghiêm cấm phát hành, phân phối, cấp phép lại hoặc bán bản sao của Phần mềm hoặc bản sao Phần mềm đã được sửa đổi.
Thông báo bản quyền và chấp thuận nêu trên buộc phải được bao gồm trong tất cả các bản sao hoặc các phần quan trọng của Phần mềm.
PHẦN MỀM ĐƯỢC CUNG CẤP "NGUYÊN TRẠNG", KHÔNG BẢO ĐẢM DƯỚI BẤT KỲ HÌNH THỨC NÀO, ĐƯỢC THỂ HIỆN RÕ RÀNG HOẶC NGỤ Ý, KHÔNG GIỚI HẠN ĐẢM BẢO VỀ CÁC BẢO ĐẢM NGỤ Ý VỀ KHẢ NĂNG THƯƠNG MẠI, PHÙ HỢP VỚI MỤC ĐÍCH CỤ THỂ VÀ KHÔNG VI PHẠM. TRONG MỌI TRƯỜNG HỢP SẼ KHÔNG CÓ TÁC GIẢ HOẶC CHỦ SỞ HỮU BẢN QUYỀN NÀO CHỊU TRÁCH NHIỆM VỀ BẤT KỲ KHIẾU NẠI, THIỆT HẠI HOẶC TRÁCH NHIỆM PHÁP LÝ KHÁC NÀO TRONG PHẠM VI HỢP ĐỒNG, CÁC THIỆT HẠI HOẶC CÁCH KHÁC, PHÁT SINH TỪ, NGOÀI HOẶC CÓ LIÊN KẾT VỚI PHẦN MỀM HOẶC VIỆC SỬ DỤNG HOẶC KINH DOANH KHÁC TẠI PHẦN MỀM.