Apollo HRM - Giải pháp tích hợp tự động hóa dữ liệu nhân sự

Kết nối API, tự động đồng bộ biến động nhân sự giữa các hệ thống

Từ tuyển dụng, nhận việc, chấm công đến tính lương, Apollo HRM cung cấp API mở giúp dữ liệu tổ chức, chấm công và lương tự động chuyển vào ERP, hệ thống tài chính, kiểm soát ra vào và các công cụ cộng tác - HR không còn phải nhập dữ liệu trùng lặp hay chốt sổ lương thủ công, cấp quản lý luôn nắm được dữ liệu nhân lực chính xác theo thời gian thực.

Vì sao cần tích hợp API

Những công việc nhân sự này, bạn có đang xử lý thủ công không?

Khi dữ liệu nhân sự bị khóa riêng trong từng hệ thống, HR phải mất thời gian chuyển dữ liệu qua lại, trong khi cấp quản lý lại không thể xem số liệu theo thời gian thực.
Nhập dữ liệu trùng lặp

Cùng một nhân viên mới nhưng tuyển dụng, HR, ERP đều phải nhập dữ liệu riêng

Dữ liệu phải sao chép dán đi dán lại nhiều lần, khó tránh khỏi sai sót và thiếu sót, độ chính xác giảm đáng kể.

Chốt sổ lương thủ công

Báo cáo lương hằng tháng phải nhập thủ công vào hệ thống tài chính

HR xuất file Excel, bộ phận tài chính lại phải nhập từng dòng – việc chốt sổ cuối tháng tốn nhiều thời gian, công sức và dễ xảy ra sai sót khi đối chiếu.

Rủi ro an ninh thông tin

Nhân viên đã nghỉ việc nhưng tài khoản IT và quyền ra vào vẫn chưa bị khóa

Thay đổi nhân sự không được đồng bộ đến các hệ thống liên quan, tạo ra lỗ hổng an ninh thông tin và rủi ro kiểm toán khó nhận biết.

Module API

Ba module cốt lõi, bao phủ toàn bộ dữ liệu nhân sự

Từ tổ chức nhân sự, chấm công đến tiền lương – một bộ API mở kết nối tất cả các hệ thống liên quan.
24

API Tổ chức nhân sự

Foundation (FD)

Đồng bộ hai chiều cơ cấu tổ chức, dữ liệu nhân viên, đơn thay đổi nhân sự, dữ liệu biệt phái – hỗ trợ tích hợp với ERP / SSO / BPM
17

API Chấm công

Attendance (PT)

Nhập/xuất dữ liệu quẹt thẻ, nghỉ phép, tăng ca, công tác, lịch làm việc – tích hợp với hệ thống kiểm soát ra vào, xếp ca và lịch
8

API Tiền lương

Payroll (PY)

Xuất bảng lương, chi tiết bảo hiểm lao động, bảo hiểm y tế, quỹ hưu trí – kết nối trực tiếp với hệ thống tài chính để tự động hạch toán, chốt sổ cuối tháng không cần thao tác thủ công

Các trường hợp tích hợp thành công

Nếu bạn muốn tích hợp thêm hệ thống khác, hãy liên hệ để trao đổi về nhu cầu hệ thống của bạn

Tình huống tích hợp

Tìm tình huống tự động hóa phù hợp với quy trình HR của bạn

Từ tuyển dụng đến nghỉ việc, từ chấm công đến tính lương - kết hợp các API để liên kết toàn bộ quy trình nhân sự

Quản trị tổ chức và nhân sự

Biến cơ cấu tổ chức thành nguồn dữ liệu nhân sự duy nhất cho tất cả các hệ thống liên quan

Tổ chức nhân sự

Đồng bộ cơ cấu tổ chức và cấp bậc ký duyệt của doanh nghiệp sang ERP / BPM

Thông qua Foundation Client Out API, sơ đồ tổ chức và cấp bậc quản lý mới nhất được đẩy theo thời gian thực sang hệ thống ERP, BPM hoặc SSO, đảm bảo luồng ký duyệt tự động cập nhật sau mỗi lần thay đổi nhân sự mà HR không cần thông báo thủ công cho IT.

Tổ chức nhân sự

Sự kiện thay đổi nhân sự tự động kích hoạt cập nhật ở các hệ thống liên quan

Khi phát hiện đơn thay đổi nhân sự như nhận việc, chuyển bộ phận hoặc nghỉ việc, hệ thống tự động kích hoạt mở/khóa tài khoản IT, điều chỉnh quyền ra vào và thay đổi vai trò hệ thống – giúp mọi thay đổi nhân sự thực sự đạt được “một thao tác, đồng bộ toàn hệ thống”.

Tổ chức nhân sự

Nhập trực tiếp dữ liệu nhân viên mới từ hệ thống tuyển dụng, loại bỏ việc nhập dữ liệu trùng lặp

Sau khi hoàn tất tuyển dụng, hệ thống tuyển dụng đẩy trực tiếp dữ liệu nhân viên sang Apollo HRM qua Hire API – HR không còn phải sao chép dán thủ công, độ chính xác của dữ liệu nhận việc được nâng cao đáng kể.

Tổ chức nhân sự
Chấm công
Tiền lương

Tự động hóa quy trình tuyển dụng lại nhân viên cũ - khôi phục thâm niên và dữ liệu lịch sử chỉ với một thao tác

Khi cựu nhân viên quay lại làm việc, Foundation Hire API sẽ khôi phục hồ sơ nhân sự gốc, đồng thời kết nối với thâm niên trong Attendance và mức lương cơ bản trong Payroll – HR không cần xây dựng lại dữ liệu từ đầu, quy trình tuyển dụng lại được hoàn tất trong một bước.

Quản lý tài chính và chi phí

Xóa bỏ rào cản dữ liệu giữa chi phí nhân lực và hệ thống tài chính

Tổ chức nhân sự
Tiền lương

Chi phí nhân lực tự động khớp với trung tâm chi phí trên ERP, hạch toán tài chính không còn chênh lệch

Kết hợp trường trung tâm chi phí của tổ chức với API bảng lương, giúp hệ thống tài chính tự động phân bổ chi phí lương theo trung tâm chi phí của từng phòng ban – đến ngày chốt sổ không còn cần tổng hợp báo cáo thủ công.

Tiền lương

Dữ liệu kế toán lương tự động chuyển sang hệ thống tài chính, loại bỏ thao tác thủ công khi chốt sổ cuối tháng

API xuất chi tiết lương và bảo hiểm hằng tháng cung cấp dữ liệu chi phí có cấu trúc (gồm bảo hiểm lao động, bảo hiểm y tế, quỹ hưu trí), đưa trực tiếp vào hệ thống tài chính để ghi sổ – quy trình chốt sổ cuối tháng rút ngắn từ nửa ngày xuống còn vài phút.

Tổ chức nhân sự
Chấm công
Tiền lương

Tùy chỉnh cách tính thưởng, đẩy ngược kết quả về hệ thống theo chế độ lương thưởng riêng của công ty bạn

Xuất dữ liệu nhân viên và chấm công qua Foundation API và PT (Attendance) API, tự tính toán theo logic thưởng, hiệu suất hoặc chia lợi nhuận riêng của công ty bạn, sau đó đẩy kết quả trở lại Apollo để quyết toán qua Payroll API – hỗ trợ đầy đủ các chế độ lương thưởng tùy chỉnh.

Tổ chức nhân sự
Tiền lương

Bảng điều khiển chi phí nhân lực theo phòng ban theo thời gian thực, cấp quản lý luôn nắm rõ tình hình

Kết hợp trung tâm chi phí tổ chức trong Foundation với API chi phí lương trong Payroll, đẩy dữ liệu chi phí nhân lực sang bảng điều khiển BI hoặc ERP – cấp quản lý và ban lãnh đạo không cần chờ báo cáo hằng tháng mà có thể xem ngay tình hình và xu hướng nhân lực của từng phòng ban theo thời gian thực.

Tích hợp chấm công và lịch làm việc

Giúp dữ liệu chấm công luân chuyển tự do giữa các công cụ cộng tác

Chấm công

Dữ liệu nghỉ phép của nhân viên tự động đồng bộ sang Google Calendar / Microsoft Teams Calendar

Lấy dữ liệu nghỉ phép qua Attendance Client Out API, sau đó ghi vào lịch nhóm bằng Google Calendar API hoặc Microsoft Graph API, giúp toàn bộ lịch làm việc và tình trạng nghỉ phép của nhân viên được thể hiện rõ ràng, dễ theo dõi.

Chấm công

Tích hợp dữ liệu từ nhiều hệ thống kiểm soát ra vào khác nhau, chấm công được tính toán thống nhất trên Apollo HRM

Dữ liệu quẹt thẻ chấm công từ nhiều nguồn khác nhau như hệ thống kiểm soát ra vào, máy chấm công tại nhà máy, chấm công di động… được nhập hàng loạt qua Attendance Client In API, để Apollo tính toán chấm công thống nhất, thay thế cho việc tính toán rời rạc trước đây.

Chấm công

Tự động tạo hồ sơ biệt phái và công tác, tính toán chấm công không bỏ sót

Khi nhân viên kinh doanh làm việc bên ngoài hoặc đi công tác, hệ thống công tác sẽ nhập hàng loạt dữ liệu công tác qua API – Apollo HRM tự động bổ sung bản ghi chấm công, đảm bảo việc tính toán chấm công đầy đủ và chính xác mà HR không cần bổ sung thủ công.

Chấm công

Chấm công bất thường được thông báo ngay cho cấp trên - quên chấm công, đi trễ không còn phải chờ đến cuối tháng mới phát hiện

Attendance Client Out API định kỳ lấy ra các bản ghi quên chấm công, đi trễ và chấm công bất thường, kết nối với Teams / Slack / LINE để chủ động thông báo cho nhân viên và cấp trên – vấn đề chấm công được xử lý ngay trong ngày, không cần bổ sung lại khi chốt sổ cuối tháng.

Cách tích hợp

Kiến trúc tích hợp chuẩn hóa, kết nối mọi hệ thống chỉ trong ba bước

Apollo HRM API sử dụng chuẩn OAuth 2.0, dễ dàng tích hợp vào hệ thống công nghệ hiện có của bạn

API-icon-01
Hệ thống của quý công ty
ERP · Tài chính · Tuyển dụng · Xếp ca · Kiểm soát ra vào · Công cụ cộng tác
API-icon-02
Apollo API Gateway
Xác thực OAuth 2.0
Giới hạn tần suất (Rate Limit)
Nhật ký kiểm toán
API-icon-03
Apollo HRM
Foundation · Attendance
Payroll
Sau khi đăng ký thông tin xác thực API (Client ID / Client Secret), bạn có thể lấy Bearer Token theo quy trình chuẩn OAuth 2.0 Client Credentials, từ đó gọi được tất cả các endpoint API của Apollo HRM mà bạn đã đăng ký, hỗ trợ cả hai môi trường Pilot và Production.

FAQ

Dành cho người ra quyết định và HR

Giá trị cốt lõi nằm ở "tự động hóa quy trình" và "loại bỏ chi phí nhân công ẩn".

Thông qua API chuẩn, doanh nghiệp có thể kết nối MAYOHR với ERP, BPM (hệ thống ký duyệt) hiện có. Điều này có nghĩa là mọi dữ liệu về thay đổi tổ chức, xếp ca, nghỉ phép và điều chỉnh lương sẽ tự động luân chuyển giữa các hệ thống, chấm dứt hoàn toàn việc nhập liệu thủ công trùng lặp và đối chiếu sổ sách thủ công giữa các hệ thống, đạt mục tiêu không sai sót hành chính.

Chúng tôi cung cấp hơn 49 API chuẩn, bao phủ toàn diện ba vòng đời cốt lõi của nhân viên trong doanh nghiệp:

  1. Tổ chức và nhân sự (Foundation): Hỗ trợ đồng bộ nhân viên mới, nghỉ việc, thay đổi chức danh và phòng ban.
  2. Chấm công và xếp ca (Attendance): Hỗ trợ nhập dữ liệu từ máy chấm công hoặc ứng dụng chấm công bên ngoài, có thể nhập hàng loạt lịch xếp ca, kể cả đơn công tác và đơn xin nghỉ phép đã được duyệt qua hệ thống khác, đồng bộ vào engine chấm công để tính giờ công.
  3. Lương và phúc lợi (Payroll): Hỗ trợ nhập hàng loạt các khoản cộng/trừ không cố định được tính từ hệ thống bên ngoài trước khi chốt lương (như thưởng dự án, phụ cấp đi lại, tiền phép năm chưa nghỉ), và sau khi chốt sổ sẽ chuyển an toàn chi tiết bảng lương về hệ thống tài chính ERP để hạch toán.

Mọi yêu cầu API đều bắt buộc phải gửi kèm API Key riêng của doanh nghiệp (ví dụ hrmlicense) trong Request Header, và toàn bộ quá trình truyền tải đều được mã hóa qua HTTPS TLS, đảm bảo mọi dữ liệu nhạy cảm được vận hành trong môi trường an toàn nhất.

Hoàn toàn hỗ trợ. Kiến trúc API của MAYOHR được thiết kế quốc tế hóa ngay từ đầu:

  • Hỗ trợ đa ngôn ngữ: API hỗ trợ nhiều ngôn ngữ (bao gồm zh-tw tiếng Trung phồn thể, zh-cn tiếng Trung giản thể, en-us tiếng Anh, vi tiếng Việt), có thể trả về dữ liệu tổ chức và nhân sự theo đúng ngôn ngữ dựa trên tham số ngôn ngữ trong request header.
  • Tự động chuyển đổi múi giờ: Đối với API chấm công và nghỉ phép, hệ thống hỗ trợ cơ chế "chuyển đổi múi giờ (TimeZone)".
Giai đoạn Mô tả các bước Thời gian dự kiến
1. Điền đơn đăng ký trực tuyến hoặc gọi điện tư vấn Nhân viên kinh doanh xác nhận nhu cầu, sau khi được phê duyệt sẽ nhận tài liệu API. 3–5 ngày làm việc
2. Phát triển trên Sandbox Đội ngũ RD của doanh nghiệp đối chiếu tài liệu tương tác trực tuyến, thực hiện kết nối trường dữ liệu API và kiểm tra logic nghiệp vụ trên môi trường thử nghiệm Sandbox (Pilot). 1–2 tuần
(tùy theo nguồn lực phát triển IT của doanh nghiệp)
3. Xác nhận và triển khai chính thức Sao chép các API đã kết nối thành công trên Sandbox sang môi trường chính thức, sau khi xác minh tính chính xác của việc tính lương thì có thể đưa vào vận hành. 1–2 tuần
(tùy theo nguồn lực phát triển IT của doanh nghiệp)

Dành cho đội ngũ phát triển (RD)

Chúng tôi cung cấp môi trường thử nghiệm hoàn toàn tách biệt với môi trường chính thức nhưng có thông số kỹ thuật giống hệt, giúp khách hàng phát triển độc lập. Ví dụ về tên môi trường và endpoint như sau:

  • Tên miền môi trường thử nghiệm (Pilot):
    • Module lương: pre-py-be.hr.com
  • Tên miền môi trường chính thức (Production):
    • Tổ chức nhân sự: linkup-be.hr.com

Chúng tôi đã thiết kế riêng cơ chế kiểm tra IsPartialSuccess (thành công một phần) cho các tình huống tần suất cao, cần khả năng chịu lỗi tốt. Khi gọi các API hàng loạt như nhập chấm công hoặc nghỉ phép, bạn có thể truyền tham số điều khiển:

  • IsPartialSuccess = 0 (mặc định): Chế độ kiểm tra nghiêm ngặt. Chỉ cần một dòng dữ liệu trong lô bị lỗi định dạng hoặc logic, hệ thống sẽ từ chối ghi và trả lại toàn bộ lô.
  • IsPartialSuccess = 1: Chế độ chịu lỗi linh hoạt. Dữ liệu đúng định dạng sẽ được ghi thành công ngay; dữ liệu sai định dạng sẽ bị loại trừ, đồng thời phản hồi HTTP 200 sẽ trả về chính xác ErrorCount và ErrorReport kèm chỉ số (Index) của dữ liệu lỗi. *Vui lòng tham khảo tài liệu API để biết chi tiết

OMandPA là API "ghi đè toàn bộ": thường dùng khi triển khai lần đầu.

EmployeeChangeContent là API "đơn thay đổi theo phần tăng thêm": áp dụng cho các thay đổi nhân sự hằng ngày (như nhân viên mới, điều chỉnh lương, chuyển phòng ban). API này chỉ tạo đơn thay đổi cho những nhân viên được chỉ định trong dữ liệu truyền vào.

Chúng tôi áp dụng thiết kế song song giữa HTTP Status Code và "mã lỗi nghiệp vụ tùy chỉnh (Business Code)":

  • Mã trạng thái HTTP chuẩn: 200 (yêu cầu thành công), 400 (lỗi tham số/xác thực thất bại), 401/403 (khóa hrmlicense không hợp lệ hoặc không có quyền module), 500 (lỗi ngoài dự kiến của máy chủ).
  • Mã lỗi nghiệp vụ tùy chỉnh: Khi xác thực logic nghiệp vụ thất bại (HTTP 200 hoặc 400), phản hồi JSON sẽ chứa mã nghiệp vụ (như CM01 lỗi xác thực trường dữ liệu, CM04 vi phạm logic nghiệp vụ chấm công...) cùng mảng Errors. Ví dụ: "Details": ["Đã có bản ghi chấm công vào ca trong ngày"] hoặc "message": "Không tìm thấy đơn thay đổi lương tương ứng với mã nhân viên A0066", giúp hệ thống của bạn dễ dàng triển khai xử lý ngoại lệ (Exception Handling) tự động.

Tình huống phổ biến nhất là bổ sung dữ liệu tăng ca hoặc nghỉ phép của các tháng trước.

Trên thực tế, nhiều doanh nghiệp chỉ gửi bổ sung dữ liệu điều chỉnh về tăng ca, nghỉ phép, đổi ca của tháng trước sau khi đã chốt sổ cuối tháng. Lúc này, nếu hệ thống đã hoàn tất tính lương cho kỳ đó, giai đoạn này thường sẽ chuyển sang trạng thái khóa để tránh việc lương đã được quyết toán bị chỉnh sửa lại. Vì vậy, đội ngũ phát triển cần lưu ý trạng thái hiện tại của giao diện quản trị trên HRM.

Hãy cùng bắt đầu thay đổi

Xây dựng quản trị nhân sự hiệu quả hơn, thúc đẩy doanh nghiệp tăng trưởng bền vững
MAYO CONTACT FORM (VN)