# 出差管理 處理員工出差申請與相關資料查詢，包括：出差資料查詢、出差單寫入。 ## 取得員工出差資料 > \`\`\`\ > empBiz = {\ > "EMP\_BIZ\_ID": number, //員工出差資料檔\_ID\ > "EMP\_BIZ\_TRIP\_ID": number, //員工出差行程明細檔\_ID\ > "CO\_ID": number, //公司\_ID\ > "EMP\_ID": number, //員工\_ID\ > "EMP\_NO": string, //員工編號\ > "BIZ\_PROPERTY\_ID": number, //出差性質\_ID\ > "AGENT\_ID": number, //職務代理人\_ID\ > "BIZ\_START": date, //出差起始時間\ > "BIZ\_END": date, //出差結束時間\ > "BIZ\_VALUE": number, //合計出差時數\ > "UNIT": string, //出差時數單位\ > "REQUEST\_TYPE": number, //申請類型 1:單點出差 2:多停點出差\ > "BIZ\_AREA\_ID": number, //出差地點\_ID\ > "BIZ\_TRANS\_IDS": string, //交通工具\_IDS\ > "BIZ\_TODO\_IDS": string, //委辦事項\_IDS\ > "REASON": string, //出差原因\ > "FILES": array, //附件\ > "BIZ\_SOURCE": number, //資料來源 1:資料輸入 2:資料匯入 6:電子表單 7:介接\ > "WF\_NO":string, //WORKFLOW 表單編號\ > "WF\_RESULT": number, //表單狀態 1:在途中 2:已核准\ > "WF\_SIGN\_TIME": date, //簽核完成時間\ > "IS\_ALL\_CANCEL": number, //是否完全銷假 0:否 1:是\ > "E\_EMP\_ID": number, //修改\_員工\_ID \ > "E\_EMP\_NO": string, //修改\_員工編號\ > "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 的欄位、格式是否完整及正確)"},"499":{"description":"DB錯誤 `{ code: 499, msg: string }`"},"500":{"description":"系統異常 `{ code: 500, msg: string }`"}}},"paths":{"/api/am/emp_biz":{"post":{"tags":["出差管理"],"summary":"取得員工出差資料","description":"```\nempBiz = {\n \"EMP_BIZ_ID\": number, //員工出差資料檔_ID\n \"EMP_BIZ_TRIP_ID\": number, //員工出差行程明細檔_ID\n \"CO_ID\": number, //公司_ID\n \"EMP_ID\": number, //員工_ID\n \"EMP_NO\": string, //員工編號\n \"BIZ_PROPERTY_ID\": number, //出差性質_ID\n \"AGENT_ID\": number, //職務代理人_ID\n \"BIZ_START\": date, //出差起始時間\n \"BIZ_END\": date, //出差結束時間\n \"BIZ_VALUE\": number, //合計出差時數\n \"UNIT\": string, //出差時數單位\n \"REQUEST_TYPE\": number, //申請類型 1:單點出差 2:多停點出差\n \"BIZ_AREA_ID\": number, //出差地點_ID\n \"BIZ_TRANS_IDS\": string, //交通工具_IDS\n \"BIZ_TODO_IDS\": string, //委辦事項_IDS\n \"REASON\": string, //出差原因\n \"FILES\": array, //附件\n \"BIZ_SOURCE\": number, //資料來源 1:資料輸入 2:資料匯入 6:電子表單 7:介接\n \"WF_NO\":string, //WORKFLOW 表單編號\n \"WF_RESULT\": number, //表單狀態 1:在途中 2:已核准\n \"WF_SIGN_TIME\": date, //簽核完成時間\n \"IS_ALL_CANCEL\": number, //是否完全銷假 0:否 1:是\n \"E_EMP_ID\": number, //修改_員工_ID \n \"E_EMP_NO\": string, //修改_員工編號\n \"C_DATETIME\": date, //新增_日期\n \"E_DATETIME\": date, //修改_日期\n},\n```\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["CO_ID","BIZ_START","BIZ_END"],"properties":{"CO_ID":{"type":"integer","description":"公司ID"},"BIZ_START":{"type":["string","date"],"description":"出差起始時間"},"BIZ_END":{"type":["string","date"],"description":"出差結束時間"},"EMP_ID":{"type":"integer","description":"員工ID"},"LIMIT":{"type":"integer","description":"筆數限制"}}}}}},"responses":{"200":{"description":"成功\n```\n{\n code: 200,\n data: {empBiz},\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"}}}}}} ```` ## 取得出差合計單位數 > \`\`\`\ > leaveTime = {\ > CO\_ID: number, //公司\_ID\ > EMP\_ID: number, //員工\_ID\ > LEAVE\_VALUE: number, //合計出差單位數\ > LEAVE\_MINS: number, //合計出差分鐘數\ > DED\_VALUE: number, //合計扣除分鐘數\ > UNIT: string, //出差單位\ > RULE: string, //規則\ > MSG: string, //錯誤訊息(RULE為，warning時顯示提示訊息, error時則顯示錯誤訊息)\ > }\ > \ > 檢查代理期間可請假\ > RULE: 'warning' (提示訊息)\ > MSG: '部分或全部的出差時間已擔任其他同仁的職務代理人'\ > \ > RULE: 'error' (錯誤訊息)\ > MSG: '部分或全部的出差時間已擔任其他同仁的職務代理人'\ > \ > \`\`\`
````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/leaveTime":{"post":{"tags":["出差管理"],"summary":"取得出差合計單位數","description":"```\nleaveTime = {\n CO_ID: number, //公司_ID\n EMP_ID: number, //員工_ID\n LEAVE_VALUE: number, //合計出差單位數\n LEAVE_MINS: number, //合計出差分鐘數\n DED_VALUE: number, //合計扣除分鐘數\n UNIT: string, //出差單位\n RULE: string, //規則\n MSG: string, //錯誤訊息(RULE為，warning時顯示提示訊息, error時則顯示錯誤訊息)\n}\n\n檢查代理期間可請假\nRULE: 'warning' (提示訊息)\nMSG: '部分或全部的出差時間已擔任其他同仁的職務代理人'\n\nRULE: 'error' (錯誤訊息)\nMSG: '部分或全部的出差時間已擔任其他同仁的職務代理人'\n\n```\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["CO_ID","EMP_ID","BIZ_START","BIZ_END"],"properties":{"CO_ID":{"type":"integer","description":"公司ID"},"EMP_ID":{"type":"integer","description":"員工ID"},"BIZ_START":{"type":"string","description":"出差起始時間字串 YYYY/MM/DD HH:mm"},"BIZ_END":{"type":"string","description":"出差結束時間字串 YYYY/MM/DD HH:mm"}}}}}},"responses":{"200":{"description":"成功\n```\n{\n code: 200,\n data: { leaveTime },\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"}}}}}} ```` ## 出差單檢查 > requestBody 的 REQUEST\_TYPE 說明\ > \`\`\`\ > 1、若REQUEST\_TYPE為1(整體出差行程)，bizTrips為\[]，需求欄位:\ > BIZ\_PROPERTY\_ID、AGENT\_ID、BIZ\_DATETIME、BIZ\_TRANS\_IDS、\ > BIZ\_TODO\_IDS、BIZ\_AREA\_ID、REASON、REQUEST\_TYPE\ > \ > 2、若REQUEST\_TYPE為2(詳細出差行程)，需求欄位:\ > BIZ\_PROPERTY\_ID、AGENT\_ID、BIZ\_DATETIME、BIZ\_TRANS\_IDS、\ > BIZ\_TODO\_IDS、REQUEST\_TYPE、BIZ\_TRIPS \ > \ > EMP\_BIZ\_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/wf100/checkBiz":{"post":{"tags":["出差管理"],"summary":"出差單檢查","description":"requestBody 的 REQUEST_TYPE 說明\n```\n1、若REQUEST_TYPE為1(整體出差行程)，bizTrips為[]，需求欄位:\n BIZ_PROPERTY_ID、AGENT_ID、BIZ_DATETIME、BIZ_TRANS_IDS、\n BIZ_TODO_IDS、BIZ_AREA_ID、REASON、REQUEST_TYPE\n\n2、若REQUEST_TYPE為2(詳細出差行程)，需求欄位:\n BIZ_PROPERTY_ID、AGENT_ID、BIZ_DATETIME、BIZ_TRANS_IDS、\n BIZ_TODO_IDS、REQUEST_TYPE、BIZ_TRIPS \n\nEMP_BIZ_ID 編輯模式為必填\n```\n","requestBody":{"require":true,"content":{"application/json":{"schema":{"type":"object","properties":{"BIZ_PROPERTY_ID":{"type":"number","description":"出差性質 ID"},"BIZ_DATETIME":{"type":"array","minLength":"2,","maxLength":"2,","items":{"type":"string","description":"出差申請日期時間起迄的字串 YYYY/MM/DD HH:mm"}},"AGENT_ID":{"type":"number","description":"職務代理人 ID"},"BIZ_TRANS_IDS":{"type":"string","description":"交通工具 IDS"},"BIZ_TODO_IDS":{"type":"string","description":"委辦事項 IDS"},"REQUEST_TYPE":{"type":"integer","description":"申請類型 { 1:整體出差行程 2:詳細出差行程 }"},"BIZ_AREA_ID":{"type":"number","description":"出差地點 ID"},"REASON":{"type":"string","maxLength":300,"description":"出差原因"},"BIZ_TRIPS":{"type":"array","description":"詳細出差行程","items":{"type":"object","properties":{"TRIP_AREA_ID":{"type":"number","description":"該行程出差地點 ID"},"TRIP_DATETIME":{"type":"array","minLength":"2,","maxLength":"2,","items":{"type":"string","description":"該行程出差申請日期時間起迄的字串 YYYY/MM/DD HH:mm"}},"TRIP_REASON":{"type":"string","maxLength":300,"description":"該行程出差原因"},"SEQ":{"type":"integer","description":"第幾段行程"}}}},"FILES":{"type":"array","description":"附件，塞入 /api/file/attach 取得的物件(funCode為wf100)","items":{"type":"object","properties":{"fileUUID":{"type":"string"},"fileName":{"type":"string"},"fileSize":{"type":"number"},"fileMime":{"type":"string"},"isTmp":{"type":"integer"}}}},"EMP_BIZ_ID":{"type":"integer","description":"出差主檔id"},"WF_NO":{"type":"string","description":"WORKFLOW 表單編號"},"WF_RESULT":{"type":"integer","description":"表單狀態 { 1:在途中 2:已核准 }"}}}}}},"responses":{"200":{"description":"成功"},"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"}}}}}} ```` ## 出差單申請 > requestBody 的 REQUEST\_TYPE 說明\ > \`\`\`\ > 1、若REQUEST\_TYPE為1(整體出差行程)，bizTrips為\[]，需求欄位:\ > BIZ\_PROPERTY\_ID、AGENT\_ID、BIZ\_DATETIME、BIZ\_TRANS\_IDS、\ > BIZ\_TODO\_IDS、BIZ\_AREA\_ID、REASON、REQUEST\_TYPE、WF\_NO、WF\_RESULT\ > \ > 2、若REQUEST\_TYPE為2(詳細出差行程)，需求欄位:\ > BIZ\_PROPERTY\_ID、AGENT\_ID、BIZ\_DATETIME、BIZ\_TRANS\_IDS、\ > BIZ\_TODO\_IDS、REQUEST\_TYPE、BIZ\_TRIPS、WF\_NO、WF\_RESULT\ > \ > EMP\_BIZ\_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/wf100/insertBiz":{"post":{"tags":["出差管理"],"summary":"出差單申請","description":"requestBody 的 REQUEST_TYPE 說明\n```\n1、若REQUEST_TYPE為1(整體出差行程)，bizTrips為[]，需求欄位:\n BIZ_PROPERTY_ID、AGENT_ID、BIZ_DATETIME、BIZ_TRANS_IDS、\n BIZ_TODO_IDS、BIZ_AREA_ID、REASON、REQUEST_TYPE、WF_NO、WF_RESULT\n\n2、若REQUEST_TYPE為2(詳細出差行程)，需求欄位:\n BIZ_PROPERTY_ID、AGENT_ID、BIZ_DATETIME、BIZ_TRANS_IDS、\n BIZ_TODO_IDS、REQUEST_TYPE、BIZ_TRIPS、WF_NO、WF_RESULT\n\nEMP_BIZ_ID 編輯模式為必填 \n```\n","requestBody":{"require":true,"content":{"application/json":{"schema":{"type":"object","properties":{"BIZ_PROPERTY_ID":{"type":"number","description":"出差性質 ID"},"BIZ_DATETIME":{"type":"array","minLength":"2,","maxLength":"2,","items":{"type":"string","description":"出差申請日期時間起迄的字串 YYYY/MM/DD HH:mm"}},"AGENT_ID":{"type":"number","description":"職務代理人 ID"},"BIZ_TRANS_IDS":{"type":"string","description":"交通工具 IDS"},"BIZ_TODO_IDS":{"type":"string","description":"委辦事項 IDS"},"REQUEST_TYPE":{"type":"integer","description":"申請類型 { 1:整體出差行程 2:詳細出差行程 }"},"BIZ_AREA_ID":{"type":"number","description":"出差地點 ID"},"REASON":{"type":"string","maxLength":300,"description":"出差原因"},"BIZ_TRIPS":{"type":"array","description":"詳細出差行程","items":{"type":"object","properties":{"TRIP_AREA_ID":{"type":"number","description":"該行程出差地點 ID"},"TRIP_DATETIME":{"type":"array","minLength":"2,","maxLength":"2,","items":{"type":"string","description":"該行程出差申請日期時間起迄的字串 YYYY/MM/DD HH:mm"}},"TRIP_REASON":{"type":"string","maxLength":300,"description":"該行程出差原因"},"SEQ":{"type":"integer","description":"第幾段行程"}}}},"FILES":{"type":"array","description":"附件，塞入 /api/file/attach 取得的物件(funCode為wf100)","items":{"type":"object","properties":{"fileUUID":{"type":"string"},"fileName":{"type":"string"},"fileSize":{"type":"number"},"fileMime":{"type":"string"},"isTmp":{"type":"integer"}}}},"EMP_BIZ_ID":{"type":"integer","description":"出差主檔id"},"WF_NO":{"type":"string","description":"WORKFLOW 表單編號"},"WF_RESULT":{"type":"integer","description":"表單狀態 { 1:在途中 2:已核准 }"}}}}}},"responses":{"201":{"description":"申請成功 (等待人員簽核中...)"},"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"},"498":{"description":"`{ code: 498, msg: '伺服器錯誤' }`"},"499":{"$ref":"#/components/responses/499"},"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/wf100/deleteBiz":{"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_BIZ_ID"],"properties":{"CO_ID":{"type":"integer","description":"公司ID"},"EMP_ID":{"type":"integer","description":"員工ID"},"EMP_BIZ_ID":{"type":"integer","description":"出差主檔ID"}}}}}},"responses":{"200":{"description":"成功\n```\n{\n code: 200\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"}}}}}} ```` --- # 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/chu-chai-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.