# 加班管理
涵蓋各類加班單的申請與查詢，包括：加班資料查詢、加班單寫入、預先加班單寫入、批次加班單寫入。
## 取得員工加班主檔
> \`\`\`\
> emp\_ot = {\
> "EMP\_OT\_ID": number, //ID\
> "CO\_ID": number, //公司\_ID\
> "EMP\_ID": number, //員工\_ID\
> "OT\_START":date, //加班申請起始時間\
> "OT\_END":date, //加班申請結束時間\
> "OT\_DATE":date, //加班歸屬日期\
> "REASON":string, //加班原因\
> "UNIT":string, //加班當時單位\
> "OT\_VALUE": number, //合計加班數\
> "DED\_MINS": number, //合計扣除分鐘數\
> "PAY\_VALUE": number, //合計支領加班費\
> "CL\_VALUE": number, //合計支領補休\
> "FILES\_UUID":string, //附件\
> "NOTE":string, //備註\
> "OT\_SOURCE": number, //資料來源\
> "WF\_NO":string, //WORKFLOW 表單編號\
> "WF\_RESULT": number, //表單狀態\
> "WF\_SIGN\_TIME":date, //簽核完成時間\
> "CAL\_STATUS": number, //結算狀態\
> "SALARY\_CLOSE\_ID": number, //薪資結檔主檔\_ID\
> "CALENDAR\_LEAVE\_ID": number, //員工行事曆類別\_ID\
> "OT\_COEF\_JSON": array, //折現倍率JSON\
> "C\_DATETIME":date, //新增\_日期\
> "E\_DATETIME":date, //修改\_日期\
> },\
> \`\`\`
````json
{"openapi":"3.0.0","tags":[{"name":"加班管理","description":"涵蓋各類加班單的申請與查詢，包括：加班資料查詢、加班單寫入、預先加班單寫入、批次加班單寫入。"}],"servers":[{"url":"https://104demotest-api-server.hrmax.104.com.tw"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"responses":{"401":{"description":"認證失敗 (請更新 accessToken 再試一次)"},"403":{"description":"權限不足"},"440":{"description":"參數錯誤 (請檢查 parameters 或 request body 的欄位、格式是否完整及正確)"},"500":{"description":"系統異常 `{ code: 500, msg: string }`"}}},"paths":{"/api/am/emp_ot":{"post":{"tags":["加班管理"],"summary":"取得員工加班主檔","description":"```\nemp_ot = {\n \"EMP_OT_ID\": number, //ID\n \"CO_ID\": number, //公司_ID\n \"EMP_ID\": number, //員工_ID\n \"OT_START\":date, //加班申請起始時間\n \"OT_END\":date, //加班申請結束時間\n \"OT_DATE\":date, //加班歸屬日期\n \"REASON\":string, //加班原因\n \"UNIT\":string, //加班當時單位\n \"OT_VALUE\": number, //合計加班數\n \"DED_MINS\": number, //合計扣除分鐘數\n \"PAY_VALUE\": number, //合計支領加班費\n \"CL_VALUE\": number, //合計支領補休\n \"FILES_UUID\":string, //附件\n \"NOTE\":string, //備註\n \"OT_SOURCE\": number, //資料來源\n \"WF_NO\":string, //WORKFLOW 表單編號\n \"WF_RESULT\": number, //表單狀態\n \"WF_SIGN_TIME\":date, //簽核完成時間\n \"CAL_STATUS\": number, //結算狀態\n \"SALARY_CLOSE_ID\": number, //薪資結檔主檔_ID\n \"CALENDAR_LEAVE_ID\": number, //員工行事曆類別_ID\n \"OT_COEF_JSON\": array, //折現倍率JSON\n \"C_DATETIME\":date, //新增_日期\n \"E_DATETIME\":date, //修改_日期\n},\n```\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["CO_ID","OT_SDATE","OT_EDATE","EMP_ID"],"properties":{"CO_ID":{"type":"integer","description":"公司ID"},"OT_SDATE":{"type":["string","date"],"description":"加班起始日"},"OT_EDATE":{"type":["string","date"],"description":"加班結束日"},"EMP_ID":{"type":"integer","description":"員工ID"}}}}}},"responses":{"200":{"description":"成功\n```\n{\n code: 200, \n data: [emp_ot, emp_ot, ...]\n}\n```\n"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"440":{"$ref":"#/components/responses/440"},"500":{"$ref":"#/components/responses/500"}}}}}}
````
## 加班檢查
> \`\`\`\
> checkOt = {\
> "OT\_VALUE": number, //加班時數\
> "OT\_VALUE\_UNIT": string, //加班時數單位\
> "OT\_MINS": integer, //加班分鐘數\
> },\
> \`\`\`
````json
{"openapi":"3.0.0","tags":[{"name":"加班管理","description":"涵蓋各類加班單的申請與查詢，包括：加班資料查詢、加班單寫入、預先加班單寫入、批次加班單寫入。"}],"servers":[{"url":"https://104demotest-api-server.hrmax.104.com.tw"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"responses":{"401":{"description":"認證失敗 (請更新 accessToken 再試一次)"},"403":{"description":"權限不足"},"440":{"description":"參數錯誤 (請檢查 parameters 或 request body 的欄位、格式是否完整及正確)"},"500":{"description":"系統異常 `{ code: 500, msg: string }`"}}},"paths":{"/api/wf/wf020/checkOt":{"post":{"tags":["加班管理"],"summary":"加班檢查","description":"```\ncheckOt = {\n \"OT_VALUE\": number, //加班時數\n \"OT_VALUE_UNIT\": string, //加班時數單位\n \"OT_MINS\": integer, //加班分鐘數\n},\n```\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["CO_ID","EMP_ID","OT_SDATE","OT_EDATE","PAY_TYPE","REASON","FILES","NOTE","EMP_OT_ID","EMP_PREOT_ID"],"properties":{"CO_ID":{"type":"integer","description":"公司ID"},"EMP_ID":{"type":"integer","description":"員工ID"},"OT_SDATE":{"type":["string","date"],"description":"加班起始時間"},"OT_EDATE":{"type":["string","date"],"description":"加班結束時間"},"PAY_TYPE":{"type":"string","description":"加班支領方式"},"REASON":{"type":"string","description":"加班原因"},"FILES":{"type":"array","description":"附件"},"NOTE":{"type":"string","description":"備註"},"EMP_OT_ID":{"type":"integer","description":"加班主檔id"},"EMP_PREOT_ID":{"type":"integer","description":"預先加班主檔id"}}}}}},"responses":{"200":{"description":"成功\n```\n{\n code: 200,\n data: {checkOt},\n}\n```\n"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"440":{"$ref":"#/components/responses/440"},"490":{"description":"失敗\n```\n{\n code: 490,\n msg: string, // 失敗原因\n}\n```\n"},"500":{"$ref":"#/components/responses/500"}}}}}}
````
## 加班寫入
> \`\`\`\
> insertOt = {\
> "EMP\_OT\_ID": number, //寫入成功的加班主檔ID\
> },\
> \`\`\`
````json
{"openapi":"3.0.0","tags":[{"name":"加班管理","description":"涵蓋各類加班單的申請與查詢，包括：加班資料查詢、加班單寫入、預先加班單寫入、批次加班單寫入。"}],"servers":[{"url":"https://104demotest-api-server.hrmax.104.com.tw"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"responses":{"401":{"description":"認證失敗 (請更新 accessToken 再試一次)"},"403":{"description":"權限不足"},"440":{"description":"參數錯誤 (請檢查 parameters 或 request body 的欄位、格式是否完整及正確)"},"499":{"description":"DB錯誤 `{ code: 499, msg: string }`"},"500":{"description":"系統異常 `{ code: 500, msg: string }`"}}},"paths":{"/api/wf/wf020/insertOt":{"post":{"tags":["加班管理"],"summary":"加班寫入","description":"```\ninsertOt = {\n \"EMP_OT_ID\": number, //寫入成功的加班主檔ID\n},\n```\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["CO_ID","EMP_ID","OT_SDATE","OT_EDATE","PAY_TYPE","REASON","FILES","NOTE","EMP_OT_ID","WF_NO","WF_RESULT","EMP_PREOT_ID"],"properties":{"CO_ID":{"type":"integer","description":"公司ID"},"EMP_ID":{"type":"integer","description":"員工ID"},"OT_SDATE":{"type":["string","date"],"description":"加班起始時間"},"OT_EDATE":{"type":["string","date"],"description":"加班結束時間"},"PAY_TYPE":{"type":"string","description":"加班支領方式"},"REASON":{"type":"string","description":"加班原因"},"FILES":{"type":"array","description":"附件"},"NOTE":{"type":"string","description":"備註"},"EMP_OT_ID":{"type":"integer","description":"加班主檔id"},"WF_NO":{"type":"string","description":"WORKFLOW 表單編號"},"WF_RESULT":{"type":"integer","description":"表單狀態"},"EMP_PREOT_ID":{"type":"integer","description":"預先加班主檔id"}}}}}},"responses":{"200":{"description":"成功\n```\n{\n code: 200,\n data: {insertOt},\n}\n```\n"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"440":{"$ref":"#/components/responses/440"},"490":{"description":"失敗\n```\n{\n code: 490,\n msg: string, // 失敗原因\n}\n```\n"},"499":{"$ref":"#/components/responses/499"},"500":{"$ref":"#/components/responses/500"}}}}}}
````
## 加班刪除列表
> \`\`\`\
> deleteOtList = {\
> "CO\_ID": number, //公司\_ID\
> "EMP\_ID": number, //員工\_ID\
> },\
> \`\`\`
````json
{"openapi":"3.0.0","tags":[{"name":"加班管理","description":"涵蓋各類加班單的申請與查詢，包括：加班資料查詢、加班單寫入、預先加班單寫入、批次加班單寫入。"}],"servers":[{"url":"https://104demotest-api-server.hrmax.104.com.tw"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"responses":{"401":{"description":"認證失敗 (請更新 accessToken 再試一次)"},"403":{"description":"權限不足"},"440":{"description":"參數錯誤 (請檢查 parameters 或 request body 的欄位、格式是否完整及正確)"},"499":{"description":"DB錯誤 `{ code: 499, msg: string }`"},"500":{"description":"系統異常 `{ code: 500, msg: string }`"}}},"paths":{"/api/wf/wf020/deleteOtList":{"post":{"tags":["加班管理"],"summary":"加班刪除列表","description":"```\ndeleteOtList = {\n \"CO_ID\": number, //公司_ID\n \"EMP_ID\": number, //員工_ID\n},\n```\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["CO_ID","EMP_ID"],"properties":{"CO_ID":{"type":"integer","description":"公司ID"},"EMP_ID":{"type":"integer","description":"員工ID"}}}}}},"responses":{"200":{"description":"成功\n```\n{\n code: 200,\n data: {deleteOtList},\n}\n```\n"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"440":{"$ref":"#/components/responses/440"},"499":{"$ref":"#/components/responses/499"},"500":{"$ref":"#/components/responses/500"}}}}}}
````
## 加班刪除檢查
> \`\`\`\
> checkDeleteOt = {\
> "RETURN\_CODE": number, //回傳訊息代號\
> "RETURN\_MSG": string, //回傳訊息\
> },\
> \`\`\`
````json
{"openapi":"3.0.0","tags":[{"name":"加班管理","description":"涵蓋各類加班單的申請與查詢，包括：加班資料查詢、加班單寫入、預先加班單寫入、批次加班單寫入。"}],"servers":[{"url":"https://104demotest-api-server.hrmax.104.com.tw"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"responses":{"401":{"description":"認證失敗 (請更新 accessToken 再試一次)"},"403":{"description":"權限不足"},"440":{"description":"參數錯誤 (請檢查 parameters 或 request body 的欄位、格式是否完整及正確)"},"500":{"description":"系統異常 `{ code: 500, msg: string }`"}}},"paths":{"/api/wf/wf020/checkDeleteOt":{"post":{"tags":["加班管理"],"summary":"加班刪除檢查","description":"```\ncheckDeleteOt = {\n \"RETURN_CODE\": number, //回傳訊息代號\n \"RETURN_MSG\": string, //回傳訊息\n},\n```\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["CO_ID","EMP_ID","EMP_OT_ID"],"properties":{"CO_ID":{"type":"integer","description":"公司ID"},"EMP_ID":{"type":"integer","description":"員工ID"},"EMP_OT_ID":{"type":"integer","description":"加班主檔id"}}}}}},"responses":{"200":{"description":"成功\n```\n{\n code: 200,\n data: [checkDeleteOt, checkDeleteOt, ...],\n}\n```\n"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"440":{"$ref":"#/components/responses/440"},"490":{"description":"失敗\n```\n{\n code: 490,\n msg: string, // 失敗原因\n}\n```\n"},"500":{"$ref":"#/components/responses/500"}}}}}}
````
## 加班刪除
> \`\`\`\
> deleteOt = {\
> "RETURN\_CODE": number, //回傳訊息代號\
> "RETURN\_MSG": string, //回傳訊息\
> },\
> \`\`\`
````json
{"openapi":"3.0.0","tags":[{"name":"加班管理","description":"涵蓋各類加班單的申請與查詢，包括：加班資料查詢、加班單寫入、預先加班單寫入、批次加班單寫入。"}],"servers":[{"url":"https://104demotest-api-server.hrmax.104.com.tw"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"responses":{"401":{"description":"認證失敗 (請更新 accessToken 再試一次)"},"403":{"description":"權限不足"},"440":{"description":"參數錯誤 (請檢查 parameters 或 request body 的欄位、格式是否完整及正確)"},"499":{"description":"DB錯誤 `{ code: 499, msg: string }`"},"500":{"description":"系統異常 `{ code: 500, msg: string }`"}}},"paths":{"/api/wf/wf020/deleteOt":{"post":{"tags":["加班管理"],"summary":"加班刪除","description":"```\ndeleteOt = {\n \"RETURN_CODE\": number, //回傳訊息代號\n \"RETURN_MSG\": string, //回傳訊息\n},\n```\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["CO_ID","EMP_ID","EMP_OT_ID"],"properties":{"CO_ID":{"type":"integer","description":"公司ID"},"EMP_ID":{"type":"integer","description":"員工ID"},"EMP_OT_ID":{"type":"integer","description":"加班主檔id"}}}}}},"responses":{"200":{"description":"成功\n```\n{\n code: 200,\n data: [deleteOt, deleteOt, ...],\n}\n```\n"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"440":{"$ref":"#/components/responses/440"},"490":{"description":"失敗\n```\n{\n code: 490,\n msg: string, // 失敗原因\n}\n```\n"},"499":{"$ref":"#/components/responses/499"},"500":{"$ref":"#/components/responses/500"}}}}}}
````
## 取得剩餘加班時數
> \`\`\`\
> otTime = {\
> "OT\_VALUE": number, //加班時數\
> "OT\_VALUE\_UNIT": string, //加班時數單位\
> "OT\_MINS": integer, //加班分鐘數\
> "OT\_REASON": number, //加班原因是否必填\
> },\
> \`\`\`
````json
{"openapi":"3.0.0","tags":[{"name":"加班管理","description":"涵蓋各類加班單的申請與查詢，包括：加班資料查詢、加班單寫入、預先加班單寫入、批次加班單寫入。"}],"servers":[{"url":"https://104demotest-api-server.hrmax.104.com.tw"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"responses":{"401":{"description":"認證失敗 (請更新 accessToken 再試一次)"},"403":{"description":"權限不足"},"440":{"description":"參數錯誤 (請檢查 parameters 或 request body 的欄位、格式是否完整及正確)"},"500":{"description":"系統異常 `{ code: 500, msg: string }`"}}},"paths":{"/api/wf/wf020/otTime":{"post":{"tags":["加班管理"],"summary":"取得剩餘加班時數","description":"```\notTime = {\n \"OT_VALUE\": number, //加班時數\n \"OT_VALUE_UNIT\": string, //加班時數單位\n \"OT_MINS\": integer, //加班分鐘數\n \"OT_REASON\": number, //加班原因是否必填\n},\n```\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["CO_ID","EMP_ID","OT_SDATE","OT_EDATE"],"properties":{"CO_ID":{"type":"integer","description":"公司ID"},"EMP_ID":{"type":"integer","description":"員工ID"},"OT_SDATE":{"type":["string","date"],"description":"加班起始時間"},"OT_EDATE":{"type":["string","date"],"description":"加班結束時間"}}}}}},"responses":{"200":{"description":"成功\n```\n{\n code: 200,\n data: {otTime},\n}\n```\n"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"440":{"$ref":"#/components/responses/440"},"490":{"description":"失敗\n```\n{\n code: 490,\n msg: string, // 失敗原因\n}\n```\n"},"500":{"$ref":"#/components/responses/500"}}}}}}
````
## 預先加班檢查
> \`\`\`\
> checkPreOt = {\
> "OT\_VALUE": number, //預先加班時數\
> "OT\_VALUE\_UNIT": string, //預先加班時數單位\
> "OT\_MINS": integer, //預先加班分鐘數\
> },\
> \`\`\`
````json
{"openapi":"3.0.0","tags":[{"name":"加班管理","description":"涵蓋各類加班單的申請與查詢，包括：加班資料查詢、加班單寫入、預先加班單寫入、批次加班單寫入。"}],"servers":[{"url":"https://104demotest-api-server.hrmax.104.com.tw"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"responses":{"401":{"description":"認證失敗 (請更新 accessToken 再試一次)"},"403":{"description":"權限不足"},"440":{"description":"參數錯誤 (請檢查 parameters 或 request body 的欄位、格式是否完整及正確)"},"500":{"description":"系統異常 `{ code: 500, msg: string }`"}}},"paths":{"/api/wf/wf022/checkPreOt":{"post":{"tags":["加班管理"],"summary":"預先加班檢查","description":"```\ncheckPreOt = {\n \"OT_VALUE\": number, //預先加班時數\n \"OT_VALUE_UNIT\": string, //預先加班時數單位\n \"OT_MINS\": integer, //預先加班分鐘數\n},\n```\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["CO_ID","EMP_ID","OT_SDATE","OT_EDATE","PAY_TYPE","REASON","FILES","NOTE","EMP_OT_ID"],"properties":{"CO_ID":{"type":"integer","description":"公司ID"},"EMP_ID":{"type":"integer","description":"員工ID"},"OT_SDATE":{"type":["string","date"],"description":"預先加班起始時間"},"OT_EDATE":{"type":["string","date"],"description":"預先加班結束時間"},"PAY_TYPE":{"type":"string","description":"預先加班支領方式"},"REASON":{"type":"string","description":"預先加班原因"},"FILES":{"type":"array","description":"附件"},"NOTE":{"type":"string","description":"備註"},"EMP_PREOT_ID":{"type":"integer","description":"預先加班主檔id"}}}}}},"responses":{"200":{"description":"成功\n```\n{\n code: 200,\n data: {checkPreOt},\n}\n```\n"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"440":{"$ref":"#/components/responses/440"},"490":{"description":"失敗\n```\n{\n code: 490,\n msg: string, // 失敗原因\n}\n```\n"},"500":{"$ref":"#/components/responses/500"}}}}}}
````
## 預先加班寫入
> \`\`\`\
> insertPreOt = {\
> "EMP\_PREOT\_ID": number, //寫入成功的預先加班主檔ID\
> },\
> \`\`\`
````json
{"openapi":"3.0.0","tags":[{"name":"加班管理","description":"涵蓋各類加班單的申請與查詢，包括：加班資料查詢、加班單寫入、預先加班單寫入、批次加班單寫入。"}],"servers":[{"url":"https://104demotest-api-server.hrmax.104.com.tw"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"responses":{"401":{"description":"認證失敗 (請更新 accessToken 再試一次)"},"403":{"description":"權限不足"},"440":{"description":"參數錯誤 (請檢查 parameters 或 request body 的欄位、格式是否完整及正確)"},"499":{"description":"DB錯誤 `{ code: 499, msg: string }`"},"500":{"description":"系統異常 `{ code: 500, msg: string }`"}}},"paths":{"/api/wf/wf022/insertPreOt":{"post":{"tags":["加班管理"],"summary":"預先加班寫入","description":"```\ninsertPreOt = {\n \"EMP_PREOT_ID\": number, //寫入成功的預先加班主檔ID\n},\n```\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["CO_ID","EMP_ID","OT_SDATE","OT_EDATE","PAY_TYPE","REASON","FILES","NOTE","EMP_PREOT_ID","WF_NO","WF_RESULT"],"properties":{"CO_ID":{"type":"integer","description":"公司ID"},"EMP_ID":{"type":"integer","description":"員工ID"},"OT_SDATE":{"type":["string","date"],"description":"預先加班起始時間"},"OT_EDATE":{"type":["string","date"],"description":"預先加班結束時間"},"PAY_TYPE":{"type":"string","description":"預先加班支領方式"},"REASON":{"type":"string","description":"預先加班原因"},"FILES":{"type":"array","description":"附件"},"NOTE":{"type":"string","description":"備註"},"EMP_PREOT_ID":{"type":"integer","description":"預先加班主檔id"},"WF_NO":{"type":"string","description":"WORKFLOW 表單編號"},"WF_RESULT":{"type":"integer","description":"表單狀態"}}}}}},"responses":{"200":{"description":"成功\n```\n{\n code: 200,\n data: {insertPreOt},\n}\n```\n"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"440":{"$ref":"#/components/responses/440"},"490":{"description":"失敗\n```\n{\n code: 490,\n msg: string, // 失敗原因\n}\n```\n"},"499":{"$ref":"#/components/responses/499"},"500":{"$ref":"#/components/responses/500"}}}}}}
````
## 預先加班刪除檢查
> \`\`\`\
> checkDeletePreOt = {\
> "RETURN\_CODE": number, //回傳訊息代號\
> "RETURN\_MSG": string, //回傳訊息\
> },\
> \`\`\`
````json
{"openapi":"3.0.0","tags":[{"name":"加班管理","description":"涵蓋各類加班單的申請與查詢，包括：加班資料查詢、加班單寫入、預先加班單寫入、批次加班單寫入。"}],"servers":[{"url":"https://104demotest-api-server.hrmax.104.com.tw"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"responses":{"401":{"description":"認證失敗 (請更新 accessToken 再試一次)"},"403":{"description":"權限不足"},"440":{"description":"參數錯誤 (請檢查 parameters 或 request body 的欄位、格式是否完整及正確)"},"500":{"description":"系統異常 `{ code: 500, msg: string }`"}}},"paths":{"/api/wf/wf022/checkDeletePreOt":{"post":{"tags":["加班管理"],"summary":"預先加班刪除檢查","description":"```\ncheckDeletePreOt = {\n \"RETURN_CODE\": number, //回傳訊息代號\n \"RETURN_MSG\": string, //回傳訊息\n},\n```\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["CO_ID","EMP_ID","EMP_PREOT_ID"],"properties":{"CO_ID":{"type":"integer","description":"公司ID"},"EMP_ID":{"type":"integer","description":"員工ID"},"EMP_PREOT_ID":{"type":"integer","description":"預先加班主檔id"}}}}}},"responses":{"200":{"description":"成功\n```\n{\n code: 200,\n data: [checkDeletePreOt, checkDeletePreOt, ...],\n}\n```\n"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"440":{"$ref":"#/components/responses/440"},"490":{"description":"失敗\n```\n{\n code: 490,\n msg: string, // 失敗原因\n}\n```\n"},"500":{"$ref":"#/components/responses/500"}}}}}}
````
## 預先加班刪除
> \`\`\`\
> deletePreOt = {\
> "RETURN\_CODE": number, //回傳訊息代號\
> "RETURN\_MSG": string, //回傳訊息\
> },\
> \`\`\`
````json
{"openapi":"3.0.0","tags":[{"name":"加班管理","description":"涵蓋各類加班單的申請與查詢，包括：加班資料查詢、加班單寫入、預先加班單寫入、批次加班單寫入。"}],"servers":[{"url":"https://104demotest-api-server.hrmax.104.com.tw"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"responses":{"401":{"description":"認證失敗 (請更新 accessToken 再試一次)"},"403":{"description":"權限不足"},"440":{"description":"參數錯誤 (請檢查 parameters 或 request body 的欄位、格式是否完整及正確)"},"499":{"description":"DB錯誤 `{ code: 499, msg: string }`"},"500":{"description":"系統異常 `{ code: 500, msg: string }`"}}},"paths":{"/api/wf/wf022/deletePreOt":{"post":{"tags":["加班管理"],"summary":"預先加班刪除","description":"```\ndeletePreOt = {\n \"RETURN_CODE\": number, //回傳訊息代號\n \"RETURN_MSG\": string, //回傳訊息\n},\n```\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["CO_ID","EMP_ID","EMP_PREOT_ID"],"properties":{"CO_ID":{"type":"integer","description":"公司ID"},"EMP_ID":{"type":"integer","description":"員工ID"},"EMP_PREOT_ID":{"type":"integer","description":"預先加班主檔id"}}}}}},"responses":{"200":{"description":"成功\n```\n{\n code: 200,\n data: [deletePreOt, deletePreOt, ...],\n}\n```\n"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"440":{"$ref":"#/components/responses/440"},"490":{"description":"失敗\n```\n{\n code: 490,\n msg: string, // 失敗原因\n}\n```\n"},"499":{"$ref":"#/components/responses/499"},"500":{"$ref":"#/components/responses/500"}}}}}}
````
## 取得預先加班單列表
> \`\`\`\
> preOtList = {\
> "EM\_PPREOT\_ID": number, //預先加班ID\
> "CO\_ID": number, //公司\_ID\
> "EMP\_ID": number, //員工\_ID\
> "OT\_START": string, //加班開始\
> "OT\_END": string, //加班結束\
> "UNIT": string, //單位\
> "OT\_VALUE": number, //加班時數\
> },\
> \`\`\`
````json
{"openapi":"3.0.0","tags":[{"name":"加班管理","description":"涵蓋各類加班單的申請與查詢，包括：加班資料查詢、加班單寫入、預先加班單寫入、批次加班單寫入。"}],"servers":[{"url":"https://104demotest-api-server.hrmax.104.com.tw"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"responses":{"401":{"description":"認證失敗 (請更新 accessToken 再試一次)"},"403":{"description":"權限不足"},"440":{"description":"參數錯誤 (請檢查 parameters 或 request body 的欄位、格式是否完整及正確)"},"500":{"description":"系統異常 `{ code: 500, msg: string }`"}}},"paths":{"/api/wf/wf022/preOtList":{"post":{"tags":["加班管理"],"summary":"取得預先加班單列表","description":"```\npreOtList = {\n \"EM_PPREOT_ID\": number, //預先加班ID\n \"CO_ID\": number, //公司_ID\n \"EMP_ID\": number, //員工_ID\n \"OT_START\": string, //加班開始\n \"OT_END\": string, //加班結束\n \"UNIT\": string, //單位\n \"OT_VALUE\": number, //加班時數\n},\n```\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["CO_ID","EMP_ID"],"properties":{"CO_ID":{"type":"integer","description":"公司ID"},"EMP_ID":{"type":"integer","description":"員工ID"}}}}}},"responses":{"200":{"description":"成功\n```\n{\n code: 200,\n data: {preOtList},\n}\n```\n"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"440":{"$ref":"#/components/responses/440"},"490":{"description":"失敗\n```\n{\n code: 490,\n msg: string, // 失敗原因\n}\n```\n"},"500":{"$ref":"#/components/responses/500"}}}}}}
````
## 取得剩餘預先加班時數
> \`\`\`\
> otTime = {\
> "OT\_VALUE": number, //加班時數\
> "OT\_VALUE\_UNIT": string, //加班時數單位\
> "OT\_MINS": integer, //加班分鐘數\
> "OT\_REASON": number, //加班原因是否必填\
> },\
> \`\`\`
````json
{"openapi":"3.0.0","tags":[{"name":"加班管理","description":"涵蓋各類加班單的申請與查詢，包括：加班資料查詢、加班單寫入、預先加班單寫入、批次加班單寫入。"}],"servers":[{"url":"https://104demotest-api-server.hrmax.104.com.tw"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"responses":{"401":{"description":"認證失敗 (請更新 accessToken 再試一次)"},"403":{"description":"權限不足"},"440":{"description":"參數錯誤 (請檢查 parameters 或 request body 的欄位、格式是否完整及正確)"},"500":{"description":"系統異常 `{ code: 500, msg: string }`"}}},"paths":{"/api/wf/wf022/preOtTime":{"post":{"tags":["加班管理"],"summary":"取得剩餘預先加班時數","description":"```\notTime = {\n \"OT_VALUE\": number, //加班時數\n \"OT_VALUE_UNIT\": string, //加班時數單位\n \"OT_MINS\": integer, //加班分鐘數\n \"OT_REASON\": number, //加班原因是否必填\n},\n```\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["CO_ID","EMP_ID","OT_SDATE","OT_EDATE"],"properties":{"CO_ID":{"type":"integer","description":"公司ID"},"EMP_ID":{"type":"integer","description":"員工ID"},"OT_SDATE":{"type":["string","date"],"description":"加班起始時間"},"OT_EDATE":{"type":["string","date"],"description":"加班結束時間"}}}}}},"responses":{"200":{"description":"成功\n```\n{\n code: 200,\n data: {otTime},\n}\n```\n"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"440":{"$ref":"#/components/responses/440"},"490":{"description":"失敗\n```\n{\n code: 490,\n msg: string, // 失敗原因\n}\n```\n"},"500":{"$ref":"#/components/responses/500"}}}}}}
````
## 預先加班刪除列表
> \`\`\`\
> deletePreOtList = {\
> "CO\_ID": number, //公司\_ID\
> "EMP\_ID": number, //員工\_ID\
> },\
> \`\`\`
````json
{"openapi":"3.0.0","tags":[{"name":"加班管理","description":"涵蓋各類加班單的申請與查詢，包括：加班資料查詢、加班單寫入、預先加班單寫入、批次加班單寫入。"}],"servers":[{"url":"https://104demotest-api-server.hrmax.104.com.tw"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"responses":{"401":{"description":"認證失敗 (請更新 accessToken 再試一次)"},"403":{"description":"權限不足"},"440":{"description":"參數錯誤 (請檢查 parameters 或 request body 的欄位、格式是否完整及正確)"},"499":{"description":"DB錯誤 `{ code: 499, msg: string }`"},"500":{"description":"系統異常 `{ code: 500, msg: string }`"}}},"paths":{"/api/wf/wf022/deletePreOtList":{"post":{"tags":["加班管理"],"summary":"預先加班刪除列表","description":"```\ndeletePreOtList = {\n \"CO_ID\": number, //公司_ID\n \"EMP_ID\": number, //員工_ID\n},\n```\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["CO_ID","EMP_ID"],"properties":{"CO_ID":{"type":"integer","description":"公司ID"},"EMP_ID":{"type":"integer","description":"員工ID"}}}}}},"responses":{"200":{"description":"成功\n```\n{\n code: 200,\n data: {deletePreOtList},\n}\n```\n"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"440":{"$ref":"#/components/responses/440"},"499":{"$ref":"#/components/responses/499"},"500":{"$ref":"#/components/responses/500"}}}}}}
````
## POST /api/wf/wf021/batchOtNew
> 批次加班單新增
```json
{"openapi":"3.0.0","tags":[{"name":"加班管理","description":"涵蓋各類加班單的申請與查詢，包括：加班資料查詢、加班單寫入、預先加班單寫入、批次加班單寫入。"}],"servers":[{"url":"https://104demotest-api-server.hrmax.104.com.tw"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"responses":{"401":{"description":"認證失敗 (請更新 accessToken 再試一次)"},"403":{"description":"權限不足"},"440":{"description":"參數錯誤 (請檢查 parameters 或 request body 的欄位、格式是否完整及正確)"},"499":{"description":"DB錯誤 `{ code: 499, msg: string }`"},"500":{"description":"系統異常 `{ code: 500, msg: string }`"}}},"paths":{"/api/wf/wf021/batchOtNew":{"post":{"tags":["加班管理"],"summary":"批次加班單新增","requestBody":{"require":true,"content":{"application/json":{"schema":{"type":"object","properties":{"CO_ID":{"type":"number","description":"公司_ID"},"SESSION_KEY":{"type":"string","description":"執行階段的KEY"},"OT_DATA":{"type":"array","description":"員工加班資料","item":{"type":"object","properties":{"EMP_ID":{"type":"number"},"OT_START":{"type":"datetime"},"OT_END":{"type":"datetime"},"PAY_TYPE":{"type":"number"},"IS_MEAL":{"type":"number"},"IS_CARDMATCH":{"type":"number"},"REASON":{"type":"string"}}}},"FILES":{"type":"array","description":"附件","items":{"type":"object","properties":{"fileUUID":{"type":"string","description":"file uuid"},"fileName":{"type":"string","description":"file name"},"fileSize":{"type":"number","description":"file size"},"fileMime":{"type":"string","description":"file mime"},"isTmp":{"type":"number","description":"是否暫存"}}}},"WF_NO":{"type":"string","description":"WORKFLOW 表單編號"}}}}}},"responses":{"200":{"description":"更新成功"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"440":{"$ref":"#/components/responses/440"},"490":{"description":"SESSION_KEY 不可重複"},"491":{"description":"加班檢查異常 `{ code: 491, msg?: string }`"},"492":{"description":"附件寫入錯誤"},"499":{"$ref":"#/components/responses/499"},"500":{"$ref":"#/components/responses/500"}}}}}}
```
## POST /api/wf/wf021/batchOtSign
> 批次加班單簽核完成
```json
{"openapi":"3.0.0","tags":[{"name":"加班管理","description":"涵蓋各類加班單的申請與查詢，包括：加班資料查詢、加班單寫入、預先加班單寫入、批次加班單寫入。"}],"servers":[{"url":"https://104demotest-api-server.hrmax.104.com.tw"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"responses":{"401":{"description":"認證失敗 (請更新 accessToken 再試一次)"},"403":{"description":"權限不足"},"440":{"description":"參數錯誤 (請檢查 parameters 或 request body 的欄位、格式是否完整及正確)"},"499":{"description":"DB錯誤 `{ code: 499, msg: string }`"},"500":{"description":"系統異常 `{ code: 500, msg: string }`"}}},"paths":{"/api/wf/wf021/batchOtSign":{"post":{"tags":["加班管理"],"summary":"批次加班單簽核完成","requestBody":{"require":true,"content":{"application/json":{"schema":{"type":"object","properties":{"CO_ID":{"type":"number","description":"公司_ID"},"SESSION_KEY":{"type":"string","description":"執行階段的KEY"},"WF_NO":{"type":"string","description":"WORKFLOW 表單編號"}}}}}},"responses":{"200":{"description":"更新成功"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"440":{"$ref":"#/components/responses/440"},"490":{"description":"加班檢查異常 `{ code: 490, msg?: string }`"},"499":{"$ref":"#/components/responses/499"},"500":{"$ref":"#/components/responses/500"}}}}}}
```
## POST /api/wf/wf021/batchOtDelete
> 批次加班單刪除
```json
{"openapi":"3.0.0","tags":[{"name":"加班管理","description":"涵蓋各類加班單的申請與查詢，包括：加班資料查詢、加班單寫入、預先加班單寫入、批次加班單寫入。"}],"servers":[{"url":"https://104demotest-api-server.hrmax.104.com.tw"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"responses":{"401":{"description":"認證失敗 (請更新 accessToken 再試一次)"},"403":{"description":"權限不足"},"440":{"description":"參數錯誤 (請檢查 parameters 或 request body 的欄位、格式是否完整及正確)"},"499":{"description":"DB錯誤 `{ code: 499, msg: string }`"},"500":{"description":"系統異常 `{ code: 500, msg: string }`"}}},"paths":{"/api/wf/wf021/batchOtDelete":{"post":{"tags":["加班管理"],"summary":"批次加班單刪除","requestBody":{"require":true,"content":{"application/json":{"schema":{"type":"object","properties":{"CO_ID":{"type":"number","description":"公司_ID"},"SESSION_KEY":{"type":"string","description":"執行階段的KEY"},"WF_NO":{"type":"string","description":"WORKFLOW 表單編號"}}}}}},"responses":{"200":{"description":"更新成功"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"440":{"$ref":"#/components/responses/440"},"490":{"description":"批次加班單刪除失敗"},"499":{"$ref":"#/components/responses/499"},"500":{"$ref":"#/components/responses/500"}}}}}}
```