請假管理

涵蓋請假單的申請、查詢及假別時數等,包括:請假資料查詢、適用假勤項目查詢、假勤剩餘時數查詢、請假單寫入、批次請假單寫入。

取得員工請假主檔

post
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,              //修改_日期
},
Authorizations
Body
CO_IDintegerRequired

公司ID

LEAVE_STARTstring | dateRequired

請假起始日

LEAVE_ENDstring | dateRequired

請假結束日

LEAVEITEM_IDintegerRequired

假勤項目ID

EMP_IDintegerRequired

員工ID

Responses
200
成功 ``` { code: 200, data: [emp_leave, emp_leave, ...] } ```
post
POST /api/am/emp_leave HTTP/1.1
Host: 
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

取得員工請假日檔

post
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,            //修改_日期
},
Authorizations
Body
CO_IDintegerRequired

公司ID

LEAVE_STARTstring | dateRequired

請假起始日

LEAVE_ENDstring | dateRequired

請假結束日

LEAVEITEM_IDintegerRequired

假勤項目ID

EMP_IDintegerRequired

員工ID

Responses
200
成功 ``` { code: 200, data: [emp_leave_daily, emp_leave_daily, ...] } ```
post
POST /api/am/emp_leave/daily HTTP/1.1
Host: 
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

取得某員工適用假勤項目

post
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,              //使用狀態
},
Authorizations
Body
CO_IDintegerRequired

公司ID

EMP_IDintegerRequired

員工ID

Responses
200
成功 ``` { code: 200, data: [leaveitems, leaveitems, ...], } ```
post
POST /api/wf/wf010/leaveitems HTTP/1.1
Host: 
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 27

{
  "CO_ID": 13,
  "EMP_ID": 41669
}

No content

取得某員工某假勤項目事件發生日

post
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,     //事件發生日組合說明
},
Authorizations
Body
CO_IDintegerRequired

公司ID

LEAVEITEM_IDintegerRequired

假勤項目ID

EMP_IDintegerRequired

員工ID

LEAVE_STARTdateOptional

請假起始日期

EMP_LEAVE_IDintegerOptional

員工請假主檔ID

Responses
200
成功 ``` { code: 200, data: [leaveEvent, leaveEvent, ...], } ```
post
POST /api/wf/wf010/leaveEvent HTTP/1.1
Host: 
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

得到請假時數計算資訊

post
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,          //請假當時假勤單位
},
Authorizations
Body
CO_IDintegerRequired

公司ID

EMP_IDintegerRequired

員工ID

LEAVEITEM_IDintegerRequired

假勤項目ID

LEAVE_STARTstring | dateRequired

請假起始時間

LEAVE_ENDstring | dateRequired

請假結束時間

Responses
200
成功 ``` { code: 200, data: [leaveTime, leaveTime, ...], } ```
post
POST /api/wf/wf010/leaveTime HTTP/1.1
Host: 
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

取得員工單一假勤剩餘時數

post
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,//剩餘次數(含在途)
},
Authorizations
Body
CO_IDintegerRequired

公司ID

EMP_IDintegerRequired

員工ID

LEAVEITEM_IDintegerRequired

假勤項目ID

LEAVE_STARTstring | dateRequired

請假起始時間

LEAVE_ENDstring | dateRequired

請假結束時間

EMP_LEAVE_EVENT_IDintegerRequired

事件發生日ID

EVENT_DATEstring | dateRequired

事件發生日

EMP_LEAVE_IDintegerRequired

請假主檔ID

Responses
200
成功 ``` { code: 200, data: {getUsed}, } ```
post
POST /api/wf/wf010/getUsed HTTP/1.1
Host: 
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

取得員工年度剩餘假勤列表

post
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,     //基準日可申請(包含在途)
},
Authorizations
Body
CO_IDintegerRequired

公司ID

EMP_IDintegerRequired

員工ID

LEAVE_YEARintegerRequired

年度

BASE_DATEstring | dateOptional

基準日

Responses
200
成功`{ code: 200, data: [Remain, ...] }`
post
POST /api/wf/wf010/getRemainLeave HTTP/1.1
Host: 
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 44

{
  "CO_ID": 9,
  "EMP_ID": 43573,
  "LEAVE_YEAR": 2023
}

No content

假勤檢查

post
checkLeave = {
  "LEAVE_VALUE": number,        //假勤時數
  "LEAVE_VALUE_UNIT": string,   //假勤時數單位
},
Authorizations
Body
CO_IDintegerRequired

公司ID

EMP_IDintegerRequired

員工ID

LEAVEITEM_IDintegerRequired

假勤項目ID

LEAVE_STARTstring | dateRequired

請假起始時間

LEAVE_ENDstring | dateRequired

請假結束時間

EMP_LEAVE_EVENT_IDintegerRequired

事件發生日ID

EVENT_DATEstring | dateRequired

事件發生日

EVENT_DESCstringRequired

事件發生日說明

AGENT_IDSstringRequired

請假代理人_IDS

REASONstringRequired

請假原因

FILESarrayRequired

附件

NOTEstringRequired

備註

EMP_LEAVE_IDintegerRequired

請假主檔id

Responses
200
成功 ``` { code: 200, data: {checkLeave}, } ```
post
POST /api/wf/wf010/checkLeave HTTP/1.1
Host: 
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

假勤寫入

post
insertLeave = {
  "EMP_LEAVE_ID": number,         //寫入成功的假勤主檔ID
},
Authorizations
Body
CO_IDintegerRequired

公司ID

EMP_IDintegerRequired

員工ID

LEAVEITEM_IDintegerRequired

假勤項目ID

LEAVE_STARTstring | dateRequired

請假起始時間

LEAVE_ENDstring | dateRequired

請假結束時間

EMP_LEAVE_EVENT_IDintegerRequired

事件發生日ID

EVENT_DATEstring | dateRequired

事件發生日

EVENT_DESCstringRequired

事件發生日說明

AGENT_IDSstringRequired

請假代理人_IDS

REASONstringRequired

請假原因

FILESarrayRequired

附件

NOTEstringRequired

備註

EMP_LEAVE_IDintegerRequired

請假主檔id

WF_NOstringRequired

WORKFLOW 表單編號

WF_RESULTintegerRequired

表單狀態

Responses
200
成功 ``` { code: 200, data: {insertLeave}, } ```
post
POST /api/wf/wf010/insertLeave HTTP/1.1
Host: 
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

假勤刪除列表

post
deleteLeaveList = {
  "CO_ID": number,         //公司_ID
  "EMP_ID": number,        //員工_ID
},
Authorizations
Body
CO_IDintegerRequired

公司ID

EMP_IDintegerRequired

員工ID

Responses
200
成功 ``` { code: 200, data: {deleteLeaveList}, } ```
post
POST /api/wf/wf010/deleteLeaveList HTTP/1.1
Host: 
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 26

{
  "CO_ID": 1,
  "EMP_ID": 31886
}

No content

假勤刪除檢查

post
checkDeleteLeave = {
  "RETURN_CODE": number,  //回傳訊息代號
  "RETURN_MSG": string,   //回傳訊息
},
Authorizations
Body
CO_IDintegerRequired

公司ID

EMP_IDintegerRequired

員工ID

EMP_LEAVE_IDintegerRequired

請假主檔ID

Responses
200
成功 ``` { code: 200, data: [checkDeleteLeave, checkDeleteLeave, ...], } ```
post
POST /api/wf/wf010/checkDeleteLeave HTTP/1.1
Host: 
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 48

{
  "CO_ID": 13,
  "EMP_ID": 34461,
  "EMP_LEAVE_ID": 17177
}

No content

假勤刪除

post
deleteLeave = {
  "RETURN_CODE": number,  //回傳訊息代號
  "RETURN_MSG": string,   //回傳訊息
},
Authorizations
Body
CO_IDintegerRequired

公司ID

EMP_IDintegerRequired

員工ID

EMP_LEAVE_IDintegerRequired

請假主檔ID

Responses
200
成功 ``` { code: 200, data: [deleteLeave, deleteLeave, ...], } ```
post
POST /api/wf/wf010/deleteLeave HTTP/1.1
Host: 
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 46

{
  "CO_ID": 1,
  "EMP_ID": 31885,
  "EMP_LEAVE_ID": 2322
}

No content

批次請假單新增

post
Authorizations
Body
CO_IDnumberOptional

公司_ID

SESSION_KEYstringOptional

執行階段的KEY

LEAVE_DATAarrayOptional

員工請假資料

WF_NOstringOptional

WORKFLOW 表單編號

Responses
200
更新成功
post
POST /api/wf/wf011/batchLeaveNew HTTP/1.1
Host: 
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

批次請假單簽核完成

post
Authorizations
Body
CO_IDnumberOptional

公司_ID

SESSION_KEYstringOptional

執行階段的KEY

WF_NOstringOptional

WORKFLOW 表單編號

Responses
200
更新成功
post
POST /api/wf/wf011/batchLeaveSign HTTP/1.1
Host: 
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

批次請假單刪除

post
Authorizations
Body
CO_IDnumberOptional

公司_ID

SESSION_KEYstringOptional

執行階段的KEY

WF_NOstringOptional

WORKFLOW 表單編號

Responses
200
更新成功
post
POST /api/wf/wf011/batchLeaveDelete HTTP/1.1
Host: 
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

取得某員工適用假勤項目(排除事件發生日)

post
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,              //使用狀態
},
Authorizations
Body
CO_IDintegerRequired

公司ID

EMP_IDintegerRequired

員工ID

Responses
200
成功 ``` { code: 200, data: [leaveitems, leaveitems, ...], } ```
post
POST /api/wf/wf011/batchLeaveitems HTTP/1.1
Host: 
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 27

{
  "CO_ID": 13,
  "EMP_ID": 41669
}

No content