薪資發放作業

用於查詢最終的薪資計算結果，並可新增臨時的加扣項，包括：計薪資料查詢、加扣項寫入。

取得員工每月計薪結果-主檔

post

emp_salary = {
  "SALARY_CLOSE_ID": number,  //薪資結檔主檔_ID
  "CLOSE_NAME":string,        //結檔名稱
  "CO_ID": number,            //公司_ID
  "EMP_ID": number,           //員工_ID
  "SALARY_PAYCAT": number,    //發放種類
  "JOB_MONTH":date,           //計薪年月
  "PAY_DATE":date,            //發放日期
  "TAX_MONTH":date,           //所得年月
  "INC_AMOUNT": number,       //加項總額
  "DEC_AMOUNT": number,       //扣項總額
  "NET_AMOUNT": number,       //實發金額
  "SNO_ID": number,           //公司扣繳統編_ID
  "DEPT1_ID": number,         //部門1_ID
  "DEPT2_ID": number,         //部門2_ID
  "DEPT3_ID": number,         //部門3_ID
  "DEPT4_ID": number,         //部門4_ID
  "DEPT5_ID": number,         //部門5_ID
  "JOB_ID": number,           //職位
  "GRADE_ID": number,         //職等
  "LEVEL_ID": number,         //職級
  "IDENTITY_ID": number,      //身份類別
  "EMPLOYEE_TYPE": number,    //直/間接員工
  "RESPOBILITY": number,      //責任區分
  "HEADCOUNT_STATUS": number, //編制狀態
  "AREA_ID": number,          //工作區域
  "SITE_ID": number,          //工作地點
  "FACTORY_ID": number,       //廠別
},

Authorizations

Body

CO_IDintegerRequired

公司ID

TYPEintegerRequired

抓取條件方式

S_YMstring | dateRequired

年月起

E_YMstring | dateRequired

年月起

EMP_IDintegerRequired

員工ID

Responses

200

成功

{
  code: 200,
  data: [emp_salary, emp_salary, ...],
}

No content

401

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

403

權限不足

440

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

500

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

post

HTTPcURLJavaScriptPython

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

{
  "CO_ID": 13,
  "TYPE": 1,
  "S_YM": "2022/01",
  "E_YM": "2022/02",
  "EMP_ID": "37137"
}

案例1案例2

No content

取得員工每月計薪結果-明細

post

emp_salary_detail = {
  "CO_ID": number,              //公司_ID
  "EMP_ID": number,             //員工_ID
  "SALARY_CLOSE_ID": number,    //薪資結檔主檔_ID
  "SALARY_PAYCAT": number,      //發放種類
  "CLOSE_NAME":string,          //結檔名稱
  "PAY_DATE":date,              //發放日期
  "JOB_MONTH":date,             //計薪年月
  "TAX_MONTH":date,             //所得年月
  "SALARY_ITEM_ID": number,     //薪資科目_ID
  "SALARY_ITEM_AMOUNT": number, //金額(台幣)
  "NOTE":string,                //備註
},

Authorizations

Body

CO_IDintegerRequired

公司ID

TYPEintegerRequired

抓取條件方式

S_YMstring | dateRequired

年月起

E_YMstring | dateRequired

年月起

EMP_IDintegerRequired

員工ID

Responses

200

成功

{
  code: 200,
  data: [emp_salary_detail, emp_salary_detail, ...],
}

No content

401

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

403

權限不足

440

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

500

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

post

HTTPcURLJavaScriptPython

POST /api/pb/emp_salary/detail HTTP/1.1
Host: 104demotest-api-server.hrmax.104.com.tw
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 72

{
  "CO_ID": 13,
  "TYPE": 1,
  "S_YM": "2022/01",
  "E_YM": "2022/02",
  "EMP_ID": "37137"
}

案例1案例2

No content

加扣項檢查

post

checkSalary_item = {
  "Code": number,        //訊息代號
  "Description": string,   //訊息內容
},

Authorizations

Body

CO_IDintegerRequired

公司ID

EMP_IDintegerRequired

員工ID

SALARY_ITEM_IDintegerRequired

薪資科目檔_ID

S_DATEstring | dateRequired

加扣日期區間起

E_DATEstring | dateRequired

加扣日期區間迄

IS_NO_ENDintegerRequired

是否無截止日(1:是、0:否)

INCDEC_AMOUNTnumberRequired

加扣金額(依據幣別允許小數點不同)

CURRENCYstringRequired

幣別代碼

NOTEstringRequired

備註

Responses

200

成功

{
  code: 200,
  data: {salary_item},
}

No content

401

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

403

權限不足

440

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

490

失敗

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

500

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

post

HTTPcURLJavaScriptPython

POST /api/pb/salary_item/check HTTP/1.1
Host: 104demotest-api-server.hrmax.104.com.tw
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 154

{
  "CO_ID": 9,
  "EMP_ID": 125424,
  "SALARY_ITEM_ID": 822,
  "S_DATE": "2023-06-01",
  "E_DATE": "2023-06-01",
  "IS_NO_END": 0,
  "INCDEC_AMOUNT": 5000,
  "CURRENCY": "TWD",
  "NOTE": ""
}

No content

加扣項寫入

post

insertSalary_item = {
   "INCDEC_EMP_ID": number,         //寫入成功的加扣項主檔ID
},

Authorizations

Body

CO_IDintegerRequired

公司ID

EMP_IDintegerRequired

員工ID

SALARY_ITEM_IDintegerRequired

薪資科目檔_ID

S_DATEstring | dateRequired

加扣日期區間起

E_DATEstring | dateRequired

加扣日期區間迄

IS_NO_ENDintegerRequired

是否無截止日(1:是、0:否)

INCDEC_AMOUNTnumberRequired

加扣金額(依據幣別允許小數點不同)

CURRENCYstringRequired

幣別代碼

NOTEstringRequired

備註

Responses

200

成功

{
  code: 200,
  data: {insertSalary_item},
}

No content

401

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

403

權限不足

440

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

490

失敗

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

500

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

post

HTTPcURLJavaScriptPython

POST /api/pb/salary_item/insert HTTP/1.1
Host: 104demotest-api-server.hrmax.104.com.tw
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 161

{
  "CO_ID": 1,
  "EMP_ID": 31513,
  "SALARY_ITEM_ID": 13752,
  "S_DATE": "2023-06-01",
  "E_DATE": "2023-06-01",
  "IS_NO_END": 0,
  "INCDEC_AMOUNT": 5000,
  "CURRENCY": "TWD",
  "NOTE": "堃堃"
}

No content