從招募、到職、考勤到薪資結算，Apollo HRM 開放 API 讓組織、出勤、薪資資料 自動流進 ERP、財務、門禁與協作工具——HR 告別重複建檔與手工月結， 決策者隨時掌握正確的人力數據。
為什麼需要 API 整合
當人事資料被鎖在各自的系統裡，HR 花時間反覆搬資料，決策者卻看不到即時數字。
資料反覆複製貼上，錯字與遺漏難以避免，正確率大打折扣。
HR 匯出 Excel、財務再逐筆 key 入，月結耗時費力，對帳過程也容易出錯。
人事異動沒同步到下游系統，形成看不見的資安漏洞與稽核風險。
API 模組
從組織人事、考勤到薪資，一套開放 API 串起所有下游系統。
Foundation (FD)
組織架構、人員資料、異動單、派駐資料雙向同步，支援 ERP / SSO / BPM 整合串接
Attendance (PT)
打卡、請假、加班、公出、班表資料匯入匯出，整合門禁、排班與行事曆系統
Payroll (PY)
薪資發放清冊、勞保健保勞退明細匯出，直接對接財務系統自動過帳，月結零手工
整合情境
從招募到離職、從打卡到薪資結算，透過 API 組合串起完整人事流程
讓組織架構成為所有下游系統的唯一人事數據源頭
透過 Foundation Client Out API，將最新組織樹與主管層級即時推送至 ERP、BPM 或 SSO 系統，確保簽核路徑在人事異動後自動更新，無需 HR 手動通知 IT。
偵測到職、調職、離職異動單後，自動觸發 IT 帳號開通或關閉、門禁權限調整、系統角色變更，讓人員異動真正做到「一次操作，全系統同步」。
招募完成後，招募系統透過 Hire 匯入 API 直接推送人員資料至 Apollo HRM，HR 不再需要手動複製貼上，入職資料正確率大幅提升。
前員工再次入職時，透過 Foundation Hire API 帶回原始人事檔案，並串接 Attendance 年資與 Payroll 薪資基準，HR 不需從零重建資料，離職再僱用流程一次到位。
打通人力成本與財務系統之間的數據壁壘
結合組織成本中心欄位與薪資發放清冊 API，讓財務系統自動將薪資費用拆分對應至各部門成本中心，月結日再不需人工彙整報表。
匯出每月薪資保險明細 API 提供結構化費用數據（含勞保、健保、勞退），直接供財務系統入帳，月結流程從半天縮短至分鐘。
透過 Foundation 與 PT 考勤 API 匯出人員與出勤資料，依貴公司獨有的獎金、績效或分紅邏輯自行運算後，再將結果透過 Payroll API 回拋 Apollo 結算，完整支援客製化薪酬設計制度。
結合 Foundation 組織成本中心與 Payroll 薪資費用 API，將人力成本推送至 BI 或 ERP 儀表板，主管與經營層免等月報，即時看見各部門人力投入與趨勢。
讓考勤數據在各協作工具間自由流動
透過 Attendance Client Out API 取得請假紀錄，以 Google Calendar API 或 Microsoft Graph API 寫入團隊行事曆，讓全員排班與請假狀態一目瞭然。
將門禁系統、工廠打卡機、行動打卡等多元來源的打卡資料，透過 Attendance Client In API 批次匯入，由 Apollo 統一核算出勤，取代分散計算。
業務同仁外勤或出差時，由差旅系統透過 API 批次匯入公出出差資料，Apollo HRM 自動補上出勤記錄，考勤核算完整正確，HR 零手動補登。
透過 Attendance Client Out API 定時取出缺卡、遲到與異常打卡紀錄，串接 Teams / Slack / LINE 主動通報當事人與主管，出勤問題當天處理，月結不必回頭補登。
如何整合
Apollo HRM API 採用 OAuth 2.0 標準，輕鬆嵌入現有技術棧
申請 API 憑證（Client ID / Client Secret）後，透過標準 OAuth 2.0 Client Credentials 流程取得 Bearer
Token， 即可呼叫所有已訂閱的 Apollo HRM API 端點，支援 Pilot 與 Production 雙環境。
核心價值是「流程自動化」與「消滅隱形人工成本」。
透過標準 API，企業能將 MAYOHR 與現有的 ERP、BPM（簽核系統）打通。這意味著所有組織異動、排班、請假與薪資調整數據都將在系統間自動流轉，徹底終結跨系統重複手動登打與人工對帳的日常, 達到零行政失誤。
我們提供高達 50+ 支標準 API，全方位覆蓋員工在企業內的三大核心生命週期：
所有 API 請求皆須於 Request Header 強制帶入企業專屬的 API Key（例如 hrmlicense），並全程透過 HTTPS TLS 加密傳輸。確保每一筆敏感數據都在最安全的環境內運作。
完全支援。MAYOHR 的 API 架構原生具備國際化設計：
| 階段 | 步驟說明 | 預估時程 |
|---|---|---|
| 1. 網上填寫申請表或致電查詢 | 業務員回覆確認需要，經審核通過後，即獲得 API 文件。 | 3 - 5 個工作天 |
| 2. 沙盒開發 | 企業 RD 團隊對照線上互動式文件，於 Sandbox 測試環境（Pilot）進行 API 欄位對接與商務邏輯驗證。 | 1 ~ 2 週 (視企業 IT 開發資源而定) |
| 3. 驗證上線 | 將 Sandbox 成功串接的 API 複製到正式環境，經薪資驗算正確後即可上線。 | 1 ~ 2 週 (視企業 IT 開發資源而定) |
我們提供與正式環境完全隔離、但系統規格一致的測試環境，讓客戶獨立進行開發，環境名稱與 endpoint 舉例如下：
我們專為高頻、高容錯情境設計了 IsPartialSuccess（部分成功）檢核機制。在呼叫考勤打卡或請假匯入等批次 API 時，您可以傳入控制參數：
OMandPA 是「全量覆蓋」 API： 通常是初次導入時使用。
EmployeeChangeContent是「增量異動單」API： 適用於日常人事異動（如新進、調薪、調部門）。它只會針對傳入的指定員工建立異動單。
我們採用 HTTP Status Code 搭配「自定義業務錯誤碼（Business Code）」的雙軌設計：
比較常見的是補登過去月份的加班或請假。
實務上，很多企業會在月底關帳後，才陸續補送上個月的加班、請假、調班等修正資料。這時如果系統已經完成薪資結算，該期間通常會進入鎖定狀態，避免已結算完畢的薪水被改寫。所以研發團隊需要留意HRM的管理員介面目前處於那個狀態。
