# 代理人設定

查詢簽核流程或職務上的代理人，包括：簽核代理人查詢、職務代理人查詢。

## 取得簽核代理人資訊

> \`\`\`\
> agentSignItem = {\
> &#x20; "AGENT\_SIGN\_ID": number,          //簽核代理人設定\_ID\
> &#x20; "CO\_ID": number,                  //公司\_ID\
> &#x20; "EMP\_ID": number,                 //員工\_ID\
> &#x20; "EMP\_NO": string,                 //員工編號\
> &#x20; "AGENT\_SIGN\_EMP\_ID": number,      //代理人員工\_ID\
> &#x20; "AGENT\_SIGN\_EMP\_NO": string,      //代理人員工編號\
> &#x20; "AGENT\_SIGN\_EMP\_NAME": string,    //代理人姓名\
> &#x20; "AGENT\_STIME": date,              //代理起始時間\
> &#x20; "AGENT\_ETIME": date,              //代理迄止時間\
> &#x20; "FORM\_CODE": string,              //簽核表單代號\
> &#x20; "FORMSET\_NAME": string,           //公司表單名稱\
> &#x20; "IS\_ACT": number,                 //使用狀態        \
> &#x20; "E\_EMP\_ID": number,               //修改\_員工\_ID                  \
> &#x20; "E\_EMP\_NO": string,               //修改\_員工編號   \
> &#x20; "E\_DATETIME": date,               //修改\_日期  \
> },\
> \`\`\`<br>

````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/getAgentSign":{"post":{"tags":["代理人設定"],"summary":"取得簽核代理人資訊","description":"```\nagentSignItem = {\n  \"AGENT_SIGN_ID\": number,          //簽核代理人設定_ID\n  \"CO_ID\": number,                  //公司_ID\n  \"EMP_ID\": number,                 //員工_ID\n  \"EMP_NO\": string,                 //員工編號\n  \"AGENT_SIGN_EMP_ID\": number,      //代理人員工_ID\n  \"AGENT_SIGN_EMP_NO\": string,      //代理人員工編號\n  \"AGENT_SIGN_EMP_NAME\": string,    //代理人姓名\n  \"AGENT_STIME\": date,              //代理起始時間\n  \"AGENT_ETIME\": date,              //代理迄止時間\n  \"FORM_CODE\": string,              //簽核表單代號\n  \"FORMSET_NAME\": string,           //公司表單名稱\n  \"IS_ACT\": number,                 //使用狀態        \n  \"E_EMP_ID\": number,               //修改_員工_ID                  \n  \"E_EMP_NO\": string,               //修改_員工編號   \n  \"E_DATETIME\": date,               //修改_日期  \n},\n```\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["CO_ID"],"properties":{"CO_ID":{"type":"integer","description":"公司ID"},"EMP_ID":{"type":"integer","description":"員工ID"},"LIMIT":{"type":"integer","description":"筆數限制"}}}}}},"responses":{"200":{"description":"成功\n```\n{\n  code: 200,\n  data: [agentSignItem, agentSignItem, ...],\n}\n```\n"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"440":{"$ref":"#/components/responses/440"},"500":{"$ref":"#/components/responses/500"}}}}}}
````

## 批次取得員工職務代理人清單

> \`\`\`\
> agents = {\
> &#x20; "EMP\_ID": number,       //員工\_ID\
> , "AGENT\_EMP\_ID": number, //代理人員工\_ID\
> , "CO\_ID": number,        //代理人公司\_ID\
> , "EMP\_NO": string,       //代理人員工編號\
> , "EMP\_NAME": string,     //代理人員工姓名\
> , "EMP\_EN\_NAME": string,  //代理人英文姓名\
> , "DEPT1\_ID": number,     //代理人部門1\_ID\
> , "DEPT1\_CODE": string,   //代理人部門1\
> , "DEPT1\_NAME": string,   //代理人部門1名稱\
> , "DEPT2\_ID": number,     //代理人部門2\_ID\
> , "DEPT2\_CODE": string,   //代理人部門2\
> , "DEPT2\_NAME": string,   //代理人部門2名稱\
> , "DEPT3\_ID": number,     //代理人部門3\_ID\
> , "DEPT3\_CODE": string,   //代理人部門3\
> , "DEPT3\_NAME": string,   //代理人部門3名稱\
> , "DEPT4\_ID": number,     //代理人部門4\_ID\
> , "DEPT4\_CODE": string,   //代理人部門4\
> , "DEPT4\_NAME": string,   //代理人部門4名稱\
> , "DEPT5\_ID": number,     //代理人部門5\_ID\
> , "DEPT5\_CODE": string,   //代理人部門5\
> , "DEPT5\_NAME": string,   //代理人部門5名稱\
> , "JOB\_ID": number,       //代理人職位\_ID\
> , "JOB\_CODE": string,     //代理人職位\
> , "JOB\_NAME": string,     //代理人職位名稱\
> , "WORK\_STATUS": number,  //代理人在職狀況\
> , "HIRE\_DATE":date,       //代理人到職日期\
> },\
> \`\`\`<br>

````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/getBatchAgents":{"post":{"tags":["代理人設定"],"summary":"批次取得員工職務代理人清單","description":"```\nagents = {\n  \"EMP_ID\": number,       //員工_ID\n, \"AGENT_EMP_ID\": number, //代理人員工_ID\n, \"CO_ID\": number,        //代理人公司_ID\n, \"EMP_NO\": string,       //代理人員工編號\n, \"EMP_NAME\": string,     //代理人員工姓名\n, \"EMP_EN_NAME\": string,  //代理人英文姓名\n, \"DEPT1_ID\": number,     //代理人部門1_ID\n, \"DEPT1_CODE\": string,   //代理人部門1\n, \"DEPT1_NAME\": string,   //代理人部門1名稱\n, \"DEPT2_ID\": number,     //代理人部門2_ID\n, \"DEPT2_CODE\": string,   //代理人部門2\n, \"DEPT2_NAME\": string,   //代理人部門2名稱\n, \"DEPT3_ID\": number,     //代理人部門3_ID\n, \"DEPT3_CODE\": string,   //代理人部門3\n, \"DEPT3_NAME\": string,   //代理人部門3名稱\n, \"DEPT4_ID\": number,     //代理人部門4_ID\n, \"DEPT4_CODE\": string,   //代理人部門4\n, \"DEPT4_NAME\": string,   //代理人部門4名稱\n, \"DEPT5_ID\": number,     //代理人部門5_ID\n, \"DEPT5_CODE\": string,   //代理人部門5\n, \"DEPT5_NAME\": string,   //代理人部門5名稱\n, \"JOB_ID\": number,       //代理人職位_ID\n, \"JOB_CODE\": string,     //代理人職位\n, \"JOB_NAME\": string,     //代理人職位名稱\n, \"WORK_STATUS\": number,  //代理人在職狀況\n, \"HIRE_DATE\":date,       //代理人到職日期\n},\n```\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["CO_ID"],"properties":{"CO_ID":{"type":"integer","description":"公司ID"},"EMP_ID":{"type":"integer","description":"員工ID"},"LIMIT":{"type":"integer","description":"員工資料筆數限制"},"TOP":{"type":"integer","description":"每個員工最多取幾筆代理人資料"}}}}}},"responses":{"200":{"description":"成功\n```\n{\n  code: 200,\n  data: [agents, agents, ...],\n}\n```\n"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"440":{"$ref":"#/components/responses/440"},"500":{"$ref":"#/components/responses/500"}}}}}}
````

## 取得員工職務代理人清單

> \`\`\`\
> agents = {\
> &#x20; "EMP\_ID": number,       //員工\_ID\
> , "AGENT\_EMP\_ID": number, //代理人員工\_ID\
> , "CO\_ID": number,        //代理人公司\_ID\
> , "EMP\_NO": string,       //代理人員工編號\
> , "EMP\_NAME": string,     //代理人員工姓名\
> , "EMP\_EN\_NAME": string,  //代理人英文姓名\
> , "DEPT1\_ID": number,     //代理人部門1\_ID\
> , "DEPT1\_CODE": string,   //代理人部門1\
> , "DEPT1\_NAME": string,   //代理人部門1名稱\
> , "DEPT2\_ID": number,     //代理人部門2\_ID\
> , "DEPT2\_CODE": string,   //代理人部門2\
> , "DEPT2\_NAME": string,   //代理人部門2名稱\
> , "DEPT3\_ID": number,     //代理人部門3\_ID\
> , "DEPT3\_CODE": string,   //代理人部門3\
> , "DEPT3\_NAME": string,   //代理人部門3名稱\
> , "DEPT4\_ID": number,     //代理人部門4\_ID\
> , "DEPT4\_CODE": string,   //代理人部門4\
> , "DEPT4\_NAME": string,   //代理人部門4名稱\
> , "DEPT5\_ID": number,     //代理人部門5\_ID\
> , "DEPT5\_CODE": string,   //代理人部門5\
> , "DEPT5\_NAME": string,   //代理人部門5名稱\
> , "JOB\_ID": number,       //代理人職位\_ID\
> , "JOB\_CODE": string,     //代理人職位\
> , "JOB\_NAME": string,     //代理人職位名稱\
> , "WORK\_STATUS": number,  //代理人在職狀況\
> , "HIRE\_DATE":date,       //代理人到職日期\
> },\
> \`\`\`<br>

````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/agents":{"post":{"tags":["代理人設定"],"summary":"取得員工職務代理人清單","description":"```\nagents = {\n  \"EMP_ID\": number,       //員工_ID\n, \"AGENT_EMP_ID\": number, //代理人員工_ID\n, \"CO_ID\": number,        //代理人公司_ID\n, \"EMP_NO\": string,       //代理人員工編號\n, \"EMP_NAME\": string,     //代理人員工姓名\n, \"EMP_EN_NAME\": string,  //代理人英文姓名\n, \"DEPT1_ID\": number,     //代理人部門1_ID\n, \"DEPT1_CODE\": string,   //代理人部門1\n, \"DEPT1_NAME\": string,   //代理人部門1名稱\n, \"DEPT2_ID\": number,     //代理人部門2_ID\n, \"DEPT2_CODE\": string,   //代理人部門2\n, \"DEPT2_NAME\": string,   //代理人部門2名稱\n, \"DEPT3_ID\": number,     //代理人部門3_ID\n, \"DEPT3_CODE\": string,   //代理人部門3\n, \"DEPT3_NAME\": string,   //代理人部門3名稱\n, \"DEPT4_ID\": number,     //代理人部門4_ID\n, \"DEPT4_CODE\": string,   //代理人部門4\n, \"DEPT4_NAME\": string,   //代理人部門4名稱\n, \"DEPT5_ID\": number,     //代理人部門5_ID\n, \"DEPT5_CODE\": string,   //代理人部門5\n, \"DEPT5_NAME\": string,   //代理人部門5名稱\n, \"JOB_ID\": number,       //代理人職位_ID\n, \"JOB_CODE\": string,     //代理人職位\n, \"JOB_NAME\": string,     //代理人職位名稱\n, \"WORK_STATUS\": number,  //代理人在職狀況\n, \"HIRE_DATE\":date,       //代理人到職日期\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"},"LEAVE_START":{"type":["string","date"],"description":"請假起始時間"},"LEAVE_END":{"type":["string","date"],"description":"請假結束時間"}}}}}},"responses":{"200":{"description":"成功\n```\n{\n  code: 200,\n  data: [agents, agents, ...],\n}\n```\n"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"440":{"$ref":"#/components/responses/440"},"500":{"$ref":"#/components/responses/500"}}}}}}
````

## 取得職務代理人是否必填

> \`\`\`\
> businessTrip = {\
> &#x20; "BASE004": number,        // 職務代理人是否必填 { 0:非必填 1:必填 }\
> },\
> \`\`\`<br>

````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/wf100/businessTrip":{"post":{"tags":["代理人設定"],"summary":"取得職務代理人是否必填","description":"```\nbusinessTrip = {\n  \"BASE004\": number,        // 職務代理人是否必填 { 0:非必填 1:必填 }\n},\n```\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["CO_ID"],"properties":{"CO_ID":{"type":"integer","description":"公司ID"}}}}}},"responses":{"200":{"description":"成功\n```\n{\n  code: 200,\n  data: { businessTrip },\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"}}}}}}
````
