請假管理
涵蓋請假單的申請、查詢及假別時數等,包括:請假資料查詢、適用假勤項目查詢、假勤剩餘時數查詢、請假單寫入、批次請假單寫入。
emp_leave = {
"EMP_LEAVE_ID": number, //ID
"CO_ID": number, //公司_ID
"EMP_ID": number, //員工_ID
"LEAVEITEM_ID": number, //假勤項目_ID
"EMP_LEAVE_EVENT_ID": number, //事件發生日_ID
"LEAVE_START":date, //請假起始時間
"LEAVE_END":date, //請假結束時間
"LEAVE_VALUE": number, //合計扣假請假數
"DED_VALUE": number, //合計扣除分鐘數
"CANCEL_VALUE": number, //合計銷假數
"UNIT":string, //請假當時假勤單位
"REASON":string, //請假原因
"AGENT_IDS":string, //職務代理人_IDS
"FILES":string, //附件
"NOTE":string, //備註
"LEAVE_SOURCE": number, //資料來源
"WF_NO":string, //WORKFLOW 表單編號
"WF_RESULT": number, //表單狀態
"WF_SIGN_TIME":date, //簽核完成時間
"C_DATETIME":date, //新增_日期
"E_DATETIME":date, //修改_日期
},
公司ID
請假起始日
請假結束日
假勤項目ID
員工ID
成功
{
code: 200,
data: [emp_leave, emp_leave, ...]
}
No content
認證失敗 (請更新 accessToken 再試一次)
權限不足
參數錯誤 (請檢查 parameters 或 request body 的欄位、格式是否完整及正確)
系統異常 { code: 500, msg: string }
POST /api/am/emp_leave HTTP/1.1
Host: 104demotest-api-server.hrmax.104.com.tw
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 98
{
"CO_ID": 13,
"LEAVE_START": "2019/10/01",
"LEAVE_END": "2019/12/31",
"LEAVEITEM_ID": 566,
"EMP_ID": 33389
}
No content
emp_leave_daily = {
"EMP_LEAVE_ID": number, //請假主檔_ID
"CO_ID": number, //公司_ID
"EMP_ID": number, //員工_ID
"LEAVEITEM_ID": number, //假勤項目_ID
"LEAVE_DATE":date, //請假歸屬日期
"LEAVE_DATE_SEQ": number, //請假歸屬日期分段
"WORKTIME_START":date, //應上班時間起
"WORKTIME_END":date, //應上班時間迄
"LEAVED_START":date, //請假起始時間
"LEAVED_END":date, //請假結束時間
"LEAVE_MINS": number, //請假分鐘數
"DED_MINS": number, //扣除分鐘數
"CANCEL_MINS": number, //銷假分鐘數
"DED_DETAIL":string, //扣除休息時間明細
"UNIT":string, //請假當時假勤單位
"DAY_TO_HOUR": number, //一天換小時
"SHIFT_TYPE": number, //員工班別屬性
"SHIFT_ID": number, //員工班別_ID
"CALENDAR_BASIC_ID": number, //員工行事曆_ID
"CALENDAR_LEAVE_ID": number, //員工行事曆類別_ID
"CAL_STATUS": number, //結算狀態
"SALARY_CLOSE_ID": number, //薪資結檔主檔_ID
"C_DATETIME":date, //新增_日期
"E_DATETIME":date, //修改_日期
},
公司ID
請假起始日
請假結束日
假勤項目ID
員工ID
成功
{
code: 200,
data: [emp_leave_daily, emp_leave_daily, ...]
}
No content
認證失敗 (請更新 accessToken 再試一次)
權限不足
參數錯誤 (請檢查 parameters 或 request body 的欄位、格式是否完整及正確)
系統異常 { code: 500, msg: string }
POST /api/am/emp_leave/daily HTTP/1.1
Host: 104demotest-api-server.hrmax.104.com.tw
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 98
{
"CO_ID": 13,
"LEAVE_START": "2019/10/06",
"LEAVE_END": "2019/10/08",
"LEAVEITEM_ID": 570,
"EMP_ID": 33546
}
No content
leaveitems = {
"LEAVEITEM_ID":number, //假勤項目_ID
"CO_ID": number, //公司_ID
"LEAVEITEM_CODE":string, //假勤項目代碼
"LEAVEITEM_NAME":string, //假勤項目名稱
"LEAVEITEM_NAME_JSON":boject, //假勤項目名稱_JSON
"LEAVEITEM_DESC":string, //假勤項目說明
"LEAVEITEM_DESC_JSON":boject, //假勤項目說明_JSON
"SPECIFIC_CODE":string, //特定代碼
"PERIOD_TYPE":string, //計算期間(種類)
"UNIT":string, //假勤單位
"UNIT_VALUE":number, //假勤單位(數值)
"BASE004":number, //職務代理人必填
"BASE005":number, //請假原因必填
"BASE006":number, //附件必填
"BASE012":number, //假勤說明顯示
"SORT_ORDER":number, //排序
"IS_ACT":number, //使用狀態
},
公司ID
員工ID
成功
{
code: 200,
data: [leaveitems, leaveitems, ...],
}
No content
認證失敗 (請更新 accessToken 再試一次)
權限不足
參數錯誤 (請檢查 parameters 或 request body 的欄位、格式是否完整及正確)
系統異常 { code: 500, msg: string }
POST /api/wf/wf010/leaveitems HTTP/1.1
Host: 104demotest-api-server.hrmax.104.com.tw
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 27
{
"CO_ID": 13,
"EMP_ID": 41669
}
No content
leaveEvent = {
"EMP_LEAVE_EVENT_ID":number, //事件發生日_ID
"CO_ID":number, //公司_ID
"EMP_ID":number, //員工_ID
"LEAVEITEM_ID":number, //假勤項目_ID
"EVENT_DATE":date, //事件發生日
"EVENT_DESC":string, //事件發生日說明
"ALLOW_SDATE":date, //可休期間起
"ALLOW_EDATE":date, //可休期間迄
"EVENT_FULL_DESC":string, //事件發生日組合說明
},
公司ID
假勤項目ID
員工ID
請假起始日期
員工請假主檔ID
成功
{
code: 200,
data: [leaveEvent, leaveEvent, ...],
}
No content
認證失敗 (請更新 accessToken 再試一次)
權限不足
參數錯誤 (請檢查 parameters 或 request body 的欄位、格式是否完整及正確)
系統異常 { code: 500, msg: string }
POST /api/wf/wf010/leaveEvent HTTP/1.1
Host: 104demotest-api-server.hrmax.104.com.tw
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 73
{
"CO_ID": 13,
"LEAVEITEM_ID": 571,
"EMP_ID": 33557,
"LEAVE_START": "2023/09/05"
}
No content
leaveTime = {
"CO_ID":number, //公司_ID
"EMP_ID":number, //員工_ID
"LEAVEITEM_ID":number, //假勤項目_ID
"LEAVE_START":date, //請假起始時間
"LEAVE_END":date, //請假結束時間
"LEAVE_VALUE":number, //合計扣假請假數
"LEAVE_MINS":number, //合計扣假請假分鐘數
"DED_VALUE":number, //合計扣除分鐘數
"UNIT":string, //請假當時假勤單位
},
公司ID
員工ID
假勤項目ID
請假起始時間
請假結束時間
成功
{
code: 200,
data: [leaveTime, leaveTime, ...],
}
No content
認證失敗 (請更新 accessToken 再試一次)
權限不足
參數錯誤 (請檢查 parameters 或 request body 的欄位、格式是否完整及正確)
系統異常 { code: 500, msg: string }
POST /api/wf/wf010/leaveTime HTTP/1.1
Host: 104demotest-api-server.hrmax.104.com.tw
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 110
{
"CO_ID": 13,
"EMP_ID": 34461,
"LEAVEITEM_ID": 570,
"LEAVE_START": "2022/01/01 10:00",
"LEAVE_END": "2022/01/31 18:00"
}
No content
getUsed = {
"EMP_ID":number,//員工_ID
"LEAVEITEM_ID":number,//假勤項目_ID
"UNIT":string,//假勤單位
"LEAVE_VALUE":number,//可休
"USE_VALUE":number,//已休
"REMAIN_VALUE":number,//剩餘(不含在途)
"ONWAY_REMAIN_VALUE":number,//剩餘(含在途)
"LIMIT_TIMES":number,//可休次數
"USE_TIMES":number,//已休次數
"REMAIN_TIMES":number,//剩餘次數(不含在途)
"ONWAY_REMAIN_TIMES":number,//剩餘次數(含在途)
},
公司ID
員工ID
假勤項目ID
請假起始時間
請假結束時間
事件發生日ID
事件發生日
請假主檔ID
成功
{
code: 200,
data: {getUsed},
}
No content
認證失敗 (請更新 accessToken 再試一次)
權限不足
參數錯誤 (請檢查 parameters 或 request body 的欄位、格式是否完整及正確)
失敗
{
code: 490,
msg: string, // 失敗原因
}
系統異常 { code: 500, msg: string }
POST /api/wf/wf010/getUsed HTTP/1.1
Host: 104demotest-api-server.hrmax.104.com.tw
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 175
{
"CO_ID": 9,
"EMP_ID": 43573,
"LEAVEITEM_ID": 443,
"LEAVE_START": "2022/08/23 09:00",
"LEAVE_END": "2022/08/23 18:00",
"EMP_LEAVE_EVENT_ID": 0,
"EVENT_DATE": "2022/08/22",
"EMP_LEAVE_ID": 0
}
No content
Remain = {
"EMP_ID": number, //員工_ID
"LEAVE_KIND": string, //假勤類型
"LEAVEITEM_ID": number, //假勤項目_ID
"EMP_LEAVE_EVENT_ID"?: number | null,//事件發生日_ID
"LEAVEITEM_NAME": string, //假勤名稱
"LEAVE_START": date, //可休期間起
"LEAVE_END": date, //可休期間迄
"LEAVE_RULE": string, //可休規則
"LEAVE_USED": string, //已休(不包含在途)
"LEAVE_USED_PLUS_ONWAY": string, //已休(包含在途)
"LEAVE_REMAIN": string, //剩餘(不包含在途)
"LEAVE_ONWAY": string, //簽核中
"LEAVE_REST": string, //基準日可申請(包含在途)
},
公司ID
員工ID
年度
基準日
成功{ code: 200, data: [Remain, ...] }
No content
認證失敗 (請更新 accessToken 再試一次)
權限不足
參數錯誤 (請檢查 parameters 或 request body 的欄位、格式是否完整及正確)
沒有符合查詢條件的資料,請放寬條件重新查詢
{
code: 490,
msg: string, // 失敗原因
}
系統異常 { code: 500, msg: string }
POST /api/wf/wf010/getRemainLeave HTTP/1.1
Host: 104demotest-api-server.hrmax.104.com.tw
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 44
{
"CO_ID": 9,
"EMP_ID": 43573,
"LEAVE_YEAR": 2023
}
No content
checkLeave = {
"LEAVE_VALUE": number, //假勤時數
"LEAVE_VALUE_UNIT": string, //假勤時數單位
},
公司ID
員工ID
假勤項目ID
請假起始時間
請假結束時間
事件發生日ID
事件發生日
事件發生日說明
請假代理人_IDS
請假原因
附件
備註
請假主檔id
成功
{
code: 200,
data: {checkLeave},
}
No content
認證失敗 (請更新 accessToken 再試一次)
權限不足
參數錯誤 (請檢查 parameters 或 request body 的欄位、格式是否完整及正確)
失敗
{
code: 490,
msg: string, // 失敗原因
}
系統異常 { code: 500, msg: string }
POST /api/wf/wf010/checkLeave HTTP/1.1
Host: 104demotest-api-server.hrmax.104.com.tw
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 413
{
"CO_ID": 1,
"EMP_ID": 31886,
"LEAVEITEM_ID": 28,
"LEAVE_START": "2022-08-24 08:00",
"LEAVE_END": "2022-08-24 17:00",
"EMP_LEAVE_EVENT_ID": 0,
"EVENT_DATE": "",
"EVENT_DESC": "",
"AGENT_IDS": "",
"REASON": "",
"FILES": [
{
"fileUUID": "8af4a96fe4cd36309632daae4ec3e38f",
"fileName": "API 功能畫面.docx",
"fileSize": 319795,
"fileMime": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
"isTmp": 1
}
],
"EMP_LEAVE_ID": 0
}
No content
insertLeave = {
"EMP_LEAVE_ID": number, //寫入成功的假勤主檔ID
},
公司ID
員工ID
假勤項目ID
請假起始時間
請假結束時間
事件發生日ID
事件發生日
事件發生日說明
請假代理人_IDS
請假原因
附件
備註
請假主檔id
WORKFLOW 表單編號
表單狀態
成功
{
code: 200,
data: {insertLeave},
}
No content
認證失敗 (請更新 accessToken 再試一次)
權限不足
參數錯誤 (請檢查 parameters 或 request body 的欄位、格式是否完整及正確)
失敗
{
code: 490,
msg: string, // 失敗原因
}
DB錯誤 { code: 499, msg: string }
系統異常 { code: 500, msg: string }
POST /api/wf/wf010/insertLeave HTTP/1.1
Host: 104demotest-api-server.hrmax.104.com.tw
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 483
{
"CO_ID": 1,
"EMP_ID": 31886,
"LEAVEITEM_ID": 28,
"LEAVE_START": "2022-08-24 08:00",
"LEAVE_END": "2022-08-24 17:00",
"EMP_LEAVE_EVENT_ID": 0,
"EVENT_DATE": "",
"EVENT_DESC": "",
"AGENT_IDS": "",
"REASON": "這是原因",
"FILES": [
{
"fileUUID": "f6a4f78f687e0ff62329d991b0cc8839",
"fileName": "API 功能畫面.docx",
"fileSize": 319795,
"fileMime": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
"isTmp": 1
}
],
"NOTE": "這是備註",
"EMP_LEAVE_ID": 0,
"WF_NO": "API11223344",
"WF_RESULT": 1
}
No content
deleteLeaveList = {
"CO_ID": number, //公司_ID
"EMP_ID": number, //員工_ID
},
公司ID
員工ID
成功
{
code: 200,
data: {deleteLeaveList},
}
No content
認證失敗 (請更新 accessToken 再試一次)
權限不足
參數錯誤 (請檢查 parameters 或 request body 的欄位、格式是否完整及正確)
DB錯誤 { code: 499, msg: string }
系統異常 { code: 500, msg: string }
POST /api/wf/wf010/deleteLeaveList HTTP/1.1
Host: 104demotest-api-server.hrmax.104.com.tw
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 26
{
"CO_ID": 1,
"EMP_ID": 31886
}
No content
checkDeleteLeave = {
"RETURN_CODE": number, //回傳訊息代號
"RETURN_MSG": string, //回傳訊息
},
公司ID
員工ID
請假主檔ID
成功
{
code: 200,
data: [checkDeleteLeave, checkDeleteLeave, ...],
}
No content
認證失敗 (請更新 accessToken 再試一次)
權限不足
參數錯誤 (請檢查 parameters 或 request body 的欄位、格式是否完整及正確)
失敗
{
code: 490,
msg: string, // 失敗原因
}
系統異常 { code: 500, msg: string }
POST /api/wf/wf010/checkDeleteLeave HTTP/1.1
Host: 104demotest-api-server.hrmax.104.com.tw
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 48
{
"CO_ID": 13,
"EMP_ID": 34461,
"EMP_LEAVE_ID": 17177
}
No content
deleteLeave = {
"RETURN_CODE": number, //回傳訊息代號
"RETURN_MSG": string, //回傳訊息
},
公司ID
員工ID
請假主檔ID
成功
{
code: 200,
data: [deleteLeave, deleteLeave, ...],
}
No content
認證失敗 (請更新 accessToken 再試一次)
權限不足
參數錯誤 (請檢查 parameters 或 request body 的欄位、格式是否完整及正確)
失敗
{
code: 490,
msg: string, // 失敗原因
}
DB錯誤 { code: 499, msg: string }
系統異常 { code: 500, msg: string }
POST /api/wf/wf010/deleteLeave HTTP/1.1
Host: 104demotest-api-server.hrmax.104.com.tw
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 46
{
"CO_ID": 1,
"EMP_ID": 31885,
"EMP_LEAVE_ID": 2322
}
No content
公司_ID
執行階段的KEY
員工請假資料
WORKFLOW 表單編號
更新成功
No content
認證失敗 (請更新 accessToken 再試一次)
權限不足
參數錯誤 (請檢查 parameters 或 request body 的欄位、格式是否完整及正確)
SESSION_KEY 不可重複
假勤檢查異常 { code: 491, msg?: string }
附件寫入錯誤
DB錯誤 { code: 499, msg: string }
系統異常 { code: 500, msg: string }
POST /api/wf/wf011/batchLeaveNew HTTP/1.1
Host: 104demotest-api-server.hrmax.104.com.tw
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 830
"{\n \"CO_ID\": 9,\n \"SESSION_KEY\": \"e61609d0-0e73-11ee-b46d-0050569652a6\",\n \"LEAVE_DATA\": [\n {\n \"EMP_ID\": 125266,\n \"LEAVEITEM_ID\": 401,\n \"LEAVE_START\": \"2023/05/02 09:00\",\n \"LEAVE_END\": \"2023/05/02 18:00\",\n \"AGENT_IDS\": \"4,124455\",\n \"REASON\": \"XXXXXXXXXXXXX\"\n },\n {\n \"EMP_ID\": 124460,\n \"LEAVEITEM_ID\": 401,\n \"LEAVE_START\": \"2023/05/02 09:00\",\n \"LEAVE_END\": \"2023/05/02 18:00\",\n \"AGENT_IDS\": \"30363,125424\",\n \"REASON\": \"YYYYYYYYYYYYY\"\n }\n ],\n \"FILES\": [\n {\n \"fileUUID\": \"e3f5c661c08e29a901a61bd1efceecb2\",\n \"fileName\": \"1.png\",\n \"fileSize\": 74506,\n \"fileMime\": \"image/png\",\n \"isTmp\": 1\n }\n ],\n \"WF_NO\": \"WF10123456789\"\n}\n"
No content
公司_ID
執行階段的KEY
WORKFLOW 表單編號
更新成功
No content
認證失敗 (請更新 accessToken 再試一次)
權限不足
參數錯誤 (請檢查 parameters 或 request body 的欄位、格式是否完整及正確)
假勤檢查異常 { code: 490, msg?: string }
DB錯誤 { code: 499, msg: string }
系統異常 { code: 500, msg: string }
POST /api/wf/wf011/batchLeaveSign HTTP/1.1
Host: 104demotest-api-server.hrmax.104.com.tw
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 119
"{\n \"CO_ID\": 9,\n \"SESSION_KEY\": \"e61609d0-0e73-11ee-b46d-0050569652a6\",\n \"WF_NO\": \"WF10123456789\"\n}\n"
No content
公司_ID
執行階段的KEY
WORKFLOW 表單編號
更新成功
No content
認證失敗 (請更新 accessToken 再試一次)
權限不足
參數錯誤 (請檢查 parameters 或 request body 的欄位、格式是否完整及正確)
批次請假單刪除失敗
DB錯誤 { code: 499, msg: string }
系統異常 { code: 500, msg: string }
POST /api/wf/wf011/batchLeaveDelete HTTP/1.1
Host: 104demotest-api-server.hrmax.104.com.tw
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 119
"{\n \"CO_ID\": 9,\n \"SESSION_KEY\": \"e61609d0-0e73-11ee-b46d-0050569652a6\",\n \"WF_NO\": \"WF10123456789\"\n}\n"
No content
leaveitems = {
"LEAVEITEM_ID":number, //假勤項目_ID
"CO_ID": number, //公司_ID
"LEAVEITEM_CODE":string, //假勤項目代碼
"LEAVEITEM_NAME":string, //假勤項目名稱
"LEAVEITEM_NAME_JSON":boject, //假勤項目名稱_JSON
"LEAVEITEM_DESC":string, //假勤項目說明
"LEAVEITEM_DESC_JSON":boject, //假勤項目說明_JSON
"SPECIFIC_CODE":string, //特定代碼
"PERIOD_TYPE":string, //計算期間(種類)
"UNIT":string, //假勤單位
"UNIT_VALUE":number, //假勤單位(數值)
"BASE004":number, //職務代理人必填
"BASE005":number, //請假原因必填
"BASE006":number, //附件必填
"BASE012":number, //假勤說明顯示
"SORT_ORDER":number, //排序
"IS_ACT":number, //使用狀態
},
公司ID
員工ID
成功
{
code: 200,
data: [leaveitems, leaveitems, ...],
}
No content
認證失敗 (請更新 accessToken 再試一次)
權限不足
參數錯誤 (請檢查 parameters 或 request body 的欄位、格式是否完整及正確)
系統異常 { code: 500, msg: string }
POST /api/wf/wf011/batchLeaveitems HTTP/1.1
Host: 104demotest-api-server.hrmax.104.com.tw
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 27
{
"CO_ID": 13,
"EMP_ID": 41669
}
No content