# 請假管理 涵蓋請假單的申請、查詢及假別時數等，包括：請假資料查詢、適用假勤項目查詢、假勤剩餘時數查詢、請假單寫入、批次請假單寫入。 ## 取得員工請假主檔 > \`\`\`\ > 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, //修改\_日期\ > },\ > \`\`\`
````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_leave":{"post":{"tags":["請假管理"],"summary":"取得員工請假主檔","description":"```\nemp_leave = {\n \"EMP_LEAVE_ID\": number, //ID\n \"CO_ID\": number, //公司_ID\n \"EMP_ID\": number, //員工_ID\n \"LEAVEITEM_ID\": number, //假勤項目_ID\n \"EMP_LEAVE_EVENT_ID\": number, //事件發生日_ID\n \"LEAVE_START\":date, //請假起始時間\n \"LEAVE_END\":date, //請假結束時間\n \"LEAVE_VALUE\": number, //合計扣假請假數\n \"DED_VALUE\": number, //合計扣除分鐘數\n \"CANCEL_VALUE\": number, //合計銷假數\n \"UNIT\":string, //請假當時假勤單位\n \"REASON\":string, //請假原因\n \"AGENT_IDS\":string, //職務代理人_IDS\n \"FILES\":string, //附件\n \"NOTE\":string, //備註\n \"LEAVE_SOURCE\": number, //資料來源\n \"WF_NO\":string, //WORKFLOW 表單編號\n \"WF_RESULT\": number, //表單狀態\n \"WF_SIGN_TIME\":date, //簽核完成時間\n \"C_DATETIME\":date, //新增_日期\n \"E_DATETIME\":date, //修改_日期\n},\n```\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["CO_ID","LEAVE_START","LEAVE_END","LEAVEITEM_ID","EMP_ID"],"properties":{"CO_ID":{"type":"integer","description":"公司ID"},"LEAVE_START":{"type":["string","date"],"description":"請假起始日"},"LEAVE_END":{"type":["string","date"],"description":"請假結束日"},"LEAVEITEM_ID":{"type":"integer","description":"假勤項目ID"},"EMP_ID":{"type":"integer","description":"員工ID"}}}}}},"responses":{"200":{"description":"成功\n```\n{\n code: 200, \n data: [emp_leave, emp_leave, ...]\n}\n```\n"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"440":{"$ref":"#/components/responses/440"},"500":{"$ref":"#/components/responses/500"}}}}}} ```` ## 取得員工請假日檔 > \`\`\`\ > 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, //修改\_日期\ > },\ > \`\`\`
````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_leave/daily":{"post":{"tags":["請假管理"],"summary":"取得員工請假日檔","description":"```\nemp_leave_daily = {\n \"EMP_LEAVE_ID\": number, //請假主檔_ID\n \"CO_ID\": number, //公司_ID\n \"EMP_ID\": number, //員工_ID\n \"LEAVEITEM_ID\": number, //假勤項目_ID\n \"LEAVE_DATE\":date, //請假歸屬日期\n \"LEAVE_DATE_SEQ\": number, //請假歸屬日期分段\n \"WORKTIME_START\":date, //應上班時間起\n \"WORKTIME_END\":date, //應上班時間迄\n \"LEAVED_START\":date, //請假起始時間\n \"LEAVED_END\":date, //請假結束時間\n \"LEAVE_MINS\": number, //請假分鐘數\n \"DED_MINS\": number, //扣除分鐘數\n \"CANCEL_MINS\": number, //銷假分鐘數\n \"DED_DETAIL\":string, //扣除休息時間明細\n \"UNIT\":string, //請假當時假勤單位\n \"DAY_TO_HOUR\": number, //一天換小時\n \"SHIFT_TYPE\": number, //員工班別屬性\n \"SHIFT_ID\": number, //員工班別_ID\n \"CALENDAR_BASIC_ID\": number, //員工行事曆_ID\n \"CALENDAR_LEAVE_ID\": number, //員工行事曆類別_ID\n \"CAL_STATUS\": number, //結算狀態\n \"SALARY_CLOSE_ID\": number, //薪資結檔主檔_ID\n \"C_DATETIME\":date, //新增_日期\n \"E_DATETIME\":date, //修改_日期\n},\n```\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["CO_ID","LEAVE_START","LEAVE_END","LEAVEITEM_ID","EMP_ID"],"properties":{"CO_ID":{"type":"integer","description":"公司ID"},"LEAVE_START":{"type":["string","date"],"description":"請假起始日"},"LEAVE_END":{"type":["string","date"],"description":"請假結束日"},"LEAVEITEM_ID":{"type":"integer","description":"假勤項目ID"},"EMP_ID":{"type":"integer","description":"員工ID"}}}}}},"responses":{"200":{"description":"成功\n```\n{\n code: 200, \n data: [emp_leave_daily, emp_leave_daily, ...]\n}\n```\n"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"440":{"$ref":"#/components/responses/440"},"500":{"$ref":"#/components/responses/500"}}}}}} ```` ## 取得某員工適用假勤項目 > \`\`\`\ > 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, //使用狀態\ > },\ > \`\`\`
````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/wf010/leaveitems":{"post":{"tags":["請假管理"],"summary":"取得某員工適用假勤項目","description":"```\nleaveitems = {\n \"LEAVEITEM_ID\":number, //假勤項目_ID\n \"CO_ID\": number, //公司_ID\n \"LEAVEITEM_CODE\":string, //假勤項目代碼\n \"LEAVEITEM_NAME\":string, //假勤項目名稱\n \"LEAVEITEM_NAME_JSON\":boject, //假勤項目名稱_JSON\n \"LEAVEITEM_DESC\":string, //假勤項目說明\n \"LEAVEITEM_DESC_JSON\":boject, //假勤項目說明_JSON\n \"SPECIFIC_CODE\":string, //特定代碼\n \"PERIOD_TYPE\":string, //計算期間(種類)\n \"UNIT\":string, //假勤單位\n \"UNIT_VALUE\":number, //假勤單位(數值)\n \"BASE004\":number, //職務代理人必填\n \"BASE005\":number, //請假原因必填\n \"BASE006\":number, //附件必填\n \"BASE012\":number, //假勤說明顯示\n \"SORT_ORDER\":number, //排序\n \"IS_ACT\":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: [leaveitems, leaveitems, ...],\n}\n```\n"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"440":{"$ref":"#/components/responses/440"},"500":{"$ref":"#/components/responses/500"}}}}}} ```` ## 取得某員工某假勤項目事件發生日 > \`\`\`\ > 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, //事件發生日組合說明\ > },\ > \`\`\`
````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/wf010/leaveEvent":{"post":{"tags":["請假管理"],"summary":"取得某員工某假勤項目事件發生日","description":"```\nleaveEvent = {\n \"EMP_LEAVE_EVENT_ID\":number, //事件發生日_ID\n \"CO_ID\":number, //公司_ID\n \"EMP_ID\":number, //員工_ID\n \"LEAVEITEM_ID\":number, //假勤項目_ID\n \"EVENT_DATE\":date, //事件發生日\n \"EVENT_DESC\":string, //事件發生日說明\n \"ALLOW_SDATE\":date, //可休期間起\n \"ALLOW_EDATE\":date, //可休期間迄\n \"EVENT_FULL_DESC\":string, //事件發生日組合說明\n},\n```\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["CO_ID","LEAVEITEM_ID","EMP_ID"],"properties":{"CO_ID":{"type":"integer","description":"公司ID"},"LEAVEITEM_ID":{"type":"integer","description":"假勤項目ID"},"EMP_ID":{"type":"integer","description":"員工ID"},"LEAVE_START":{"type":"date","description":"請假起始日期"},"EMP_LEAVE_ID":{"type":"integer","description":"員工請假主檔ID"}}}}}},"responses":{"200":{"description":"成功\n```\n{\n code: 200,\n data: [leaveEvent, leaveEvent, ...],\n}\n```\n"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"440":{"$ref":"#/components/responses/440"},"500":{"$ref":"#/components/responses/500"}}}}}} ```` ## 得到請假時數計算資訊 > \`\`\`\ > 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, //請假當時假勤單位\ > },\ > \`\`\`
````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/wf010/leaveTime":{"post":{"tags":["請假管理"],"summary":"得到請假時數計算資訊","description":"```\nleaveTime = {\n \"CO_ID\":number, //公司_ID\n \"EMP_ID\":number, //員工_ID\n \"LEAVEITEM_ID\":number, //假勤項目_ID\n \"LEAVE_START\":date, //請假起始時間\n \"LEAVE_END\":date, //請假結束時間\n \"LEAVE_VALUE\":number, //合計扣假請假數\n \"LEAVE_MINS\":number, //合計扣假請假分鐘數\n \"DED_VALUE\":number, //合計扣除分鐘數\n \"UNIT\":string, //請假當時假勤單位\n},\n```\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["CO_ID","EMP_ID","LEAVEITEM_ID","LEAVE_START","LEAVE_END"],"properties":{"CO_ID":{"type":"integer","description":"公司ID"},"EMP_ID":{"type":"integer","description":"員工ID"},"LEAVEITEM_ID":{"type":"integer","description":"假勤項目ID"},"LEAVE_START":{"type":["string","date"],"description":"請假起始時間"},"LEAVE_END":{"type":["string","date"],"description":"請假結束時間"}}}}}},"responses":{"200":{"description":"成功\n```\n{\n code: 200,\n data: [leaveTime, leaveTime, ...],\n}\n```\n"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"440":{"$ref":"#/components/responses/440"},"500":{"$ref":"#/components/responses/500"}}}}}} ```` ## 取得員工單一假勤剩餘時數 > \`\`\`\ > 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,//剩餘次數(含在途)\ > },\ > \`\`\`
````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/wf010/getUsed":{"post":{"tags":["請假管理"],"summary":"取得員工單一假勤剩餘時數","description":"```\ngetUsed = {\n \"EMP_ID\":number,//員工_ID\n \"LEAVEITEM_ID\":number,//假勤項目_ID\n \"UNIT\":string,//假勤單位\n \"LEAVE_VALUE\":number,//可休\n \"USE_VALUE\":number,//已休\n \"REMAIN_VALUE\":number,//剩餘(不含在途)\n \"ONWAY_REMAIN_VALUE\":number,//剩餘(含在途)\n \"LIMIT_TIMES\":number,//可休次數\n \"USE_TIMES\":number,//已休次數\n \"REMAIN_TIMES\":number,//剩餘次數(不含在途)\n \"ONWAY_REMAIN_TIMES\":number,//剩餘次數(含在途)\n},\n```\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["CO_ID","EMP_ID","LEAVEITEM_ID","LEAVE_START","LEAVE_END","EMP_LEAVE_EVENT_ID","EVENT_DATE","EMP_LEAVE_ID"],"properties":{"CO_ID":{"type":"integer","description":"公司ID"},"EMP_ID":{"type":"integer","description":"員工ID"},"LEAVEITEM_ID":{"type":"integer","description":"假勤項目ID"},"LEAVE_START":{"type":["string","date"],"description":"請假起始時間"},"LEAVE_END":{"type":["string","date"],"description":"請假結束時間"},"EMP_LEAVE_EVENT_ID":{"type":"integer","description":"事件發生日ID"},"EVENT_DATE":{"type":["string","date"],"description":"事件發生日"},"EMP_LEAVE_ID":{"type":"integer","description":"請假主檔ID"}}}}}},"responses":{"200":{"description":"成功\n```\n{\n code: 200,\n data: {getUsed},\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"}}}}}} ```` ## 取得員工年度剩餘假勤列表 > \`\`\`\ > 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, //基準日可申請(包含在途)\ > },\ > \`\`\`
````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/wf010/getRemainLeave":{"post":{"tags":["請假管理"],"summary":"取得員工年度剩餘假勤列表","description":"```\nRemain = {\n \"EMP_ID\": number, //員工_ID\n \"LEAVE_KIND\": string, //假勤類型\n \"LEAVEITEM_ID\": number, //假勤項目_ID\n \"EMP_LEAVE_EVENT_ID\"?: number | null,//事件發生日_ID\n \"LEAVEITEM_NAME\": string, //假勤名稱\n \"LEAVE_START\": date, //可休期間起\n \"LEAVE_END\": date, //可休期間迄\n \"LEAVE_RULE\": string, //可休規則\n \"LEAVE_USED\": string, //已休(不包含在途)\n \"LEAVE_USED_PLUS_ONWAY\": string, //已休(包含在途)\n \"LEAVE_REMAIN\": string, //剩餘(不包含在途)\n \"LEAVE_ONWAY\": string, //簽核中\n \"LEAVE_REST\": string, //基準日可申請(包含在途)\n},\n```\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["CO_ID","EMP_ID","LEAVE_YEAR"],"properties":{"CO_ID":{"type":"integer","description":"公司ID"},"EMP_ID":{"type":"integer","description":"員工ID"},"LEAVE_YEAR":{"type":"integer","description":"年度"},"BASE_DATE":{"type":["string","date"],"description":"基準日"}}}}}},"responses":{"200":{"description":"成功`{ code: 200, data: [Remain, ...] }`"},"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"}}}}}} ```` ## 假勤檢查 > \`\`\`\ > checkLeave = {\ > "LEAVE\_VALUE": number, //假勤時數\ > "LEAVE\_VALUE\_UNIT": 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/wf010/checkLeave":{"post":{"tags":["請假管理"],"summary":"假勤檢查","description":"```\ncheckLeave = {\n \"LEAVE_VALUE\": number, //假勤時數\n \"LEAVE_VALUE_UNIT\": string, //假勤時數單位\n},\n```\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["CO_ID","EMP_ID","LEAVEITEM_ID","LEAVE_START","LEAVE_END","EMP_LEAVE_EVENT_ID","EVENT_DATE","EVENT_DESC","AGENT_IDS","REASON","FILES","NOTE","EMP_LEAVE_ID"],"properties":{"CO_ID":{"type":"integer","description":"公司ID"},"EMP_ID":{"type":"integer","description":"員工ID"},"LEAVEITEM_ID":{"type":"integer","description":"假勤項目ID"},"LEAVE_START":{"type":["string","date"],"description":"請假起始時間"},"LEAVE_END":{"type":["string","date"],"description":"請假結束時間"},"EMP_LEAVE_EVENT_ID":{"type":"integer","description":"事件發生日ID"},"EVENT_DATE":{"type":["string","date"],"description":"事件發生日"},"EVENT_DESC":{"type":"string","description":"事件發生日說明"},"AGENT_IDS":{"type":"string","description":"請假代理人_IDS"},"REASON":{"type":"string","description":"請假原因"},"FILES":{"type":"array","description":"附件"},"NOTE":{"type":"string","description":"備註"},"EMP_LEAVE_ID":{"type":"integer","description":"請假主檔id"}}}}}},"responses":{"200":{"description":"成功\n```\n{\n code: 200,\n data: {checkLeave},\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"}}}}}} ```` ## 假勤寫入 > \`\`\`\ > insertLeave = {\ > "EMP\_LEAVE\_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/wf010/insertLeave":{"post":{"tags":["請假管理"],"summary":"假勤寫入","description":"```\ninsertLeave = {\n \"EMP_LEAVE_ID\": number, //寫入成功的假勤主檔ID\n},\n```\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["CO_ID","EMP_ID","LEAVEITEM_ID","LEAVE_START","LEAVE_END","EMP_LEAVE_EVENT_ID","EVENT_DATE","EVENT_DESC","AGENT_IDS","REASON","FILES","NOTE","EMP_LEAVE_ID","WF_NO","WF_RESULT"],"properties":{"CO_ID":{"type":"integer","description":"公司ID"},"EMP_ID":{"type":"integer","description":"員工ID"},"LEAVEITEM_ID":{"type":"integer","description":"假勤項目ID"},"LEAVE_START":{"type":["string","date"],"description":"請假起始時間"},"LEAVE_END":{"type":["string","date"],"description":"請假結束時間"},"EMP_LEAVE_EVENT_ID":{"type":"integer","description":"事件發生日ID"},"EVENT_DATE":{"type":["string","date"],"description":"事件發生日"},"EVENT_DESC":{"type":"string","description":"事件發生日說明"},"AGENT_IDS":{"type":"string","description":"請假代理人_IDS"},"REASON":{"type":"string","description":"請假原因"},"FILES":{"type":"array","description":"附件"},"NOTE":{"type":"string","description":"備註"},"EMP_LEAVE_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: {insertLeave},\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"}}}}}} ```` ## 假勤刪除列表 > \`\`\`\ > deleteLeaveList = {\ > "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/wf010/deleteLeaveList":{"post":{"tags":["請假管理"],"summary":"假勤刪除列表","description":"```\ndeleteLeaveList = {\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: {deleteLeaveList},\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"}}}}}} ```` ## 假勤刪除檢查 > \`\`\`\ > checkDeleteLeave = {\ > "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/wf010/checkDeleteLeave":{"post":{"tags":["請假管理"],"summary":"假勤刪除檢查","description":"```\ncheckDeleteLeave = {\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_LEAVE_ID"],"properties":{"CO_ID":{"type":"integer","description":"公司ID"},"EMP_ID":{"type":"integer","description":"員工ID"},"EMP_LEAVE_ID":{"type":"integer","description":"請假主檔ID"}}}}}},"responses":{"200":{"description":"成功\n```\n{\n code: 200,\n data: [checkDeleteLeave, checkDeleteLeave, ...],\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"}}}}}} ```` ## 假勤刪除 > \`\`\`\ > deleteLeave = {\ > "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/wf010/deleteLeave":{"post":{"tags":["請假管理"],"summary":"假勤刪除","description":"```\ndeleteLeave = {\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_LEAVE_ID"],"properties":{"CO_ID":{"type":"integer","description":"公司ID"},"EMP_ID":{"type":"integer","description":"員工ID"},"EMP_LEAVE_ID":{"type":"integer","description":"請假主檔ID"}}}}}},"responses":{"200":{"description":"成功\n```\n{\n code: 200,\n data: [deleteLeave, deleteLeave, ...],\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"}}}}}} ```` ## POST /api/wf/wf011/batchLeaveNew > 批次請假單新增 ```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/wf011/batchLeaveNew":{"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"},"LEAVE_DATA":{"type":"array","description":"員工請假資料","item":{"type":"object","properties":{"EMP_ID":{"type":"number"},"LEAVEITEM_ID":{"type":"number"},"LEAVE_START":{"type":"datetime"},"LEAVE_END":{"type":"datetime"},"AGENT_IDS":{"type":"string"},"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/wf011/batchLeaveSign > 批次請假單簽核完成 ```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/wf011/batchLeaveSign":{"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/wf011/batchLeaveDelete > 批次請假單刪除 ```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/wf011/batchLeaveDelete":{"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"}}}}}} ``` ## 取得某員工適用假勤項目(排除事件發生日) > \`\`\`\ > 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, //使用狀態\ > },\ > \`\`\`
````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/wf011/batchLeaveitems":{"post":{"tags":["請假管理"],"summary":"取得某員工適用假勤項目(排除事件發生日)","description":"```\nleaveitems = {\n \"LEAVEITEM_ID\":number, //假勤項目_ID\n \"CO_ID\": number, //公司_ID\n \"LEAVEITEM_CODE\":string, //假勤項目代碼\n \"LEAVEITEM_NAME\":string, //假勤項目名稱\n \"LEAVEITEM_NAME_JSON\":boject, //假勤項目名稱_JSON\n \"LEAVEITEM_DESC\":string, //假勤項目說明\n \"LEAVEITEM_DESC_JSON\":boject, //假勤項目說明_JSON\n \"SPECIFIC_CODE\":string, //特定代碼\n \"PERIOD_TYPE\":string, //計算期間(種類)\n \"UNIT\":string, //假勤單位\n \"UNIT_VALUE\":number, //假勤單位(數值)\n \"BASE004\":number, //職務代理人必填\n \"BASE005\":number, //請假原因必填\n \"BASE006\":number, //附件必填\n \"BASE012\":number, //假勤說明顯示\n \"SORT_ORDER\":number, //排序\n \"IS_ACT\":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: [leaveitems, leaveitems, ...],\n}\n```\n"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"440":{"$ref":"#/components/responses/440"},"500":{"$ref":"#/components/responses/500"}}}}}} ```` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://104ha-docs.gitbook.io/104-ha-openapi/clients/104-hr-max/qing-jia-guan-li.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.