出差管理

處理員工出差申請與相關資料查詢，包括：出差資料查詢、出差單寫入。

取得員工出差資料

post

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

Authorizations

Body

CO_IDintegerRequired

公司ID

BIZ_STARTstring | dateRequired

出差起始時間

BIZ_ENDstring | dateRequired

出差結束時間

EMP_IDintegerOptional

員工ID

LIMITintegerOptional

筆數限制

Responses

200

成功

{
  code: 200,
  data: {empBiz},
}

No content

401

認證失敗 (請更新 accessToken 再試一次)

403

權限不足

440

參數錯誤 (請檢查 parameters 或 request body 的欄位、格式是否完整及正確)

499

DB錯誤 { code: 499, msg: string }

500

系統異常 { code: 500, msg: string }

post

HTTPcURLJavaScriptPython

POST /api/am/emp_biz HTTP/1.1
Host: 104demotest-api-server.hrmax.104.com.tw
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 74

{
  "CO_ID": 1,
  "BIZ_START": "2024-01-01",
  "BIZ_END": "2024-01-10",
  "EMP_ID": 31886
}

案例1案例2案例3

No content

取得出差合計單位數

post

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: '部分或全部的出差時間已擔任其他同仁的職務代理人'

Authorizations

Body

CO_IDintegerRequired

公司ID

EMP_IDintegerRequired

員工ID

BIZ_STARTstringRequired

出差起始時間字串 YYYY/MM/DD HH:mm

BIZ_ENDstringRequired

出差結束時間字串 YYYY/MM/DD HH:mm

Responses

200

成功

{
  code: 200,
  data: { leaveTime },
}

No content

401

認證失敗 (請更新 accessToken 再試一次)

403

權限不足

440

參數錯誤 (請檢查 parameters 或 request body 的欄位、格式是否完整及正確)

490

失敗

{
  code: 490,
  msg: string,   // 失敗原因
}

499

DB錯誤 { code: 499, msg: string }

500

系統異常 { code: 500, msg: string }

post

HTTPcURLJavaScriptPython

POST /api/wf/wf100/leaveTime HTTP/1.1
Host: 104demotest-api-server.hrmax.104.com.tw
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 127

"{\n  \"CO_ID\": 475,\n  \"EMP_ID\": 125468,\n  \"BIZ_START\": \"2024/04/08 08:00\",\n  \"BIZ_END\": \"2024/04/12 18:25\"\n}\n"

No content

出差單檢查

post

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 編輯模式為必填

Authorizations

Body

BIZ_PROPERTY_IDnumberOptional

出差性質 ID

BIZ_DATETIMEstring[] · min: 2, · max: 2,Optional

出差申請日期時間起迄的字串 YYYY/MM/DD HH:mm

AGENT_IDnumberOptional

職務代理人 ID

BIZ_TRANS_IDSstringOptional

交通工具 IDS

BIZ_TODO_IDSstringOptional

委辦事項 IDS

REQUEST_TYPEintegerOptional

申請類型 { 1:整體出差行程 2:詳細出差行程 }

BIZ_AREA_IDnumberOptional

出差地點 ID

REASONstring · max: 300Optional

出差原因

EMP_BIZ_IDintegerOptional

出差主檔id

WF_NOstringOptional

WORKFLOW 表單編號

WF_RESULTintegerOptional

表單狀態 { 1:在途中 2:已核准 }

Responses

200

成功

No content

401

認證失敗 (請更新 accessToken 再試一次)

403

權限不足

440

參數錯誤 (請檢查 parameters 或 request body 的欄位、格式是否完整及正確)

490

失敗

{
  code: 490,
  msg: string,   // 失敗原因
}

499

DB錯誤 { code: 499, msg: string }

500

系統異常 { code: 500, msg: string }

post

HTTPcURLJavaScriptPython

POST /api/wf/wf100/checkBiz HTTP/1.1
Host: 104demotest-api-server.hrmax.104.com.tw
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 474

{
  "CO_ID": 475,
  "EMP_ID": 125468,
  "AGENT_ID": 125473,
  "BIZ_PROPERTY_ID": 4374,
  "BIZ_DATETIME": [
    "2024/04/11 08:00",
    "2024/04/11 17:00"
  ],
  "BIZ_TRANS_IDS": "4362,4364",
  "BIZ_TODO_IDS": "3618,3619",
  "BIZ_AREA_ID": 11799,
  "REASON": "業務推廣",
  "FILES": [
    {
      "fileUUID": "71e20a8cd4a814fdf84b82f8aa019e32",
      "fileName": "業務推廣明細.xlsx",
      "fileSize": 15934,
      "fileMime": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
      "isTmp": 1
    }
  ],
  "REQUEST_TYPE": 1,
  "WF_NO": "WF00001",
  "WF_RESULT": 1
}

整體出差行程詳細出差行程

No content

出差單申請

post

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 編輯模式為必填        

Authorizations

Body

BIZ_PROPERTY_IDnumberOptional

出差性質 ID

BIZ_DATETIMEstring[] · min: 2, · max: 2,Optional

出差申請日期時間起迄的字串 YYYY/MM/DD HH:mm

AGENT_IDnumberOptional

職務代理人 ID

BIZ_TRANS_IDSstringOptional

交通工具 IDS

BIZ_TODO_IDSstringOptional

委辦事項 IDS

REQUEST_TYPEintegerOptional

申請類型 { 1:整體出差行程 2:詳細出差行程 }

BIZ_AREA_IDnumberOptional

出差地點 ID

REASONstring · max: 300Optional

出差原因

EMP_BIZ_IDintegerOptional

出差主檔id

WF_NOstringOptional

WORKFLOW 表單編號

WF_RESULTintegerOptional

表單狀態 { 1:在途中 2:已核准 }

Responses

201

申請成功 (等待人員簽核中...)

No content

401

認證失敗 (請更新 accessToken 再試一次)

403

權限不足

440

參數錯誤 (請檢查 parameters 或 request body 的欄位、格式是否完整及正確)

490

失敗

{
  code: 490,
  msg: string,   // 失敗原因
}

498

{ code: 498, msg: '伺服器錯誤' }

499

DB錯誤 { code: 499, msg: string }

500

系統異常 { code: 500, msg: string }

post

HTTPcURLJavaScriptPython

POST /api/wf/wf100/insertBiz HTTP/1.1
Host: 104demotest-api-server.hrmax.104.com.tw
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 479

{
  "CO_ID": 475,
  "EMP_ID": 125468,
  "BIZ_PROPERTY_ID": 4374,
  "AGENT_ID": 125473,
  "BIZ_DATETIME": [
    "2024/04/11 08:00",
    "2024/04/11 17:00"
  ],
  "BIZ_TRANS_IDS": "4362,4364",
  "BIZ_TODO_IDS": "3618,3619,3620",
  "BIZ_AREA_ID": 11799,
  "REASON": "業務推廣",
  "FILES": [
    {
      "fileUUID": "71e20a8cd4a814fdf84b82f8aa019e32",
      "fileName": "業務推廣明細.xlsx",
      "fileSize": 15934,
      "fileMime": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
      "isTmp": 1
    }
  ],
  "REQUEST_TYPE": 1,
  "WF_NO": "WF00001",
  "WF_RESULT": 1
}

整體出差行程詳細出差行程

No content

出差單刪除

post

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

Authorizations

Body

CO_IDintegerRequired

公司ID

EMP_IDintegerRequired

員工ID

EMP_BIZ_IDintegerRequired

出差主檔ID

Responses

200

成功

{
  code: 200
}

No content

401

認證失敗 (請更新 accessToken 再試一次)

403

權限不足

440

參數錯誤 (請檢查 parameters 或 request body 的欄位、格式是否完整及正確)

490

失敗

{
  code: 490,
  msg: string,   // 失敗原因
}

499

DB錯誤 { code: 499, msg: string }

500

系統異常 { code: 500, msg: string }

post

HTTPcURLJavaScriptPython

POST /api/wf/wf100/deleteBiz HTTP/1.1
Host: 104demotest-api-server.hrmax.104.com.tw
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 46

{
  "CO_ID": 475,
  "EMP_ID": 125468,
  "EMP_BIZ_ID": 233
}

No content