公司工资项配置
接口说明: 该接口获取公司的工资项配置信息，返回当前公司所有可编辑的工资项， 排除未启用的工资项、带有自定义公式的工资项
请求方式:POST（HTTPS）
请求地址:https://api.xinrenxinshi.com/v5/payroll/setting
请求Header:
| key | value |
|---|---|
| access_token | 获取的access_token的实际值 |
Query参数:
| key | value |
|---|---|
| sign | 签名值 |
Body参数:
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| timestamp | Long | Y | 请求时间戳（精确到毫秒） |
返回结果:
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| errcode | Integer | Y | 错误码枚举值 |
| errmsg | String | Y | 错误码对应描述信息 |
| data | PayrollSettingResponse | Y | 返回值 |
PayrollSettingResponse
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| adjust | List<PayrollAdjustField> | Y | 调整项列表 |
| bonus | List<PayrollBonusField> | Y | 奖金项列表 |
| cost | List<PayrollCostField> | Y | 成本项列表 |
| other | List<PayrollOtherField> | Y | 其他项列表 |
PayrollAdjustField
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| id | String | Y | 调整项id |
| lifeCycle | Integer | Y | 发放周期，0-次月延用，1-次月清零 |
| name | String | Y | 字段名称 |
| taxMode | Integer | Y | 计税方式，0-税前发放，1-税后发放 |
PayrollBonusField
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| id | String | Y | 奖金项id |
| lifeCycle | Integer | Y | 发放周期，0-次月延用，1-次月清零 |
| name | String | Y | 字段名称 |
| taxMode | Integer | Y | 计税方式，0-税前发放，1-税后发放 |
PayrollCostField
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| id | String | Y | 成本项id |
| lifeCycle | Integer | Y | 发放周期，0-次月延用，1-次月清零 |
| name | String | Y | 字段名称 |
PayrollOtherField
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| id | String | Y | 其他项id |
| lifeCycle | Integer | Y | 发放周期，0-次月延用，1-次月清零 |
| name | String | Y | 字段名称 |
| type | String | Y | 字段类型， 0-单行文本， 1-多行文本， 2-日期， 3-选项， 7-城市， 8-数值， |
| dataSource | List<String> | Y | 如果字段是选项类型的话，则datasource为选项可选值 |
Tips:
- 返回的数据都是可编辑的工资项，排除未启用的工资项、带有自定义公式的工资项
请求示例(HTTPS):
https://api.xinrenxinshi.com/v5/payroll/setting?sign=7omyqoNIY5QPWKCyQM3Q7Hk8mNQ=
请求Body示例:
{
"timestamp": 1606274895856
}
SDK请求示例(java):
PayrollSettingRequest request = new PayrollSettingRequest(access_token);
OpenapiResponse<PayrollSettingResponse> setting = XrxsPayrollService.getSetting(request);
响应示例:
{
"errcode":0,
"errmsg":"成功",
"data":{
"other":[
{
"id":"e16efe5d969a44dca216940eedd548f9",
"lifeCycle":0,
"name":"薪酬结构",
"type":0,
"dataSource":null
},
{
"id":"f231a9fa2fba48d3be6c199e663bd91f",
"lifeCycle":0,
"name":"多行文本",
"type":0,
"dataSource":null
},
{
"id":"23d962fc7be144bf9c6a5a9606172fa6",
"lifeCycle":0,
"name":"单行文本",
"type":0,
"dataSource":null
},
{
"id":"06c39d5998614d91af6ac4e5d6738392",
"lifeCycle":0,
"name":"地区",
"type":7,
"dataSource":null
},
{
"id":"1ba5cd0b0b264c86997f945b0de0711c",
"lifeCycle":0,
"name":"日期类型",
"type":2,
"dataSource":null
},
{
"id":"1ce38a5158a4498f98b2ab1ed5b30208",
"lifeCycle":0,
"name":"选项类型",
"type":3,
"dataSource":[
"自定义选项",
"自定义选项1"
]
},
{
"id":"05d3a4b445f3450ab37c98b721fde495",
"lifeCycle":0,
"name":"发薪月数",
"type":0,
"dataSource":null
},
{
"id":"6009830fed40473394a0f7d82e7fa60e",
"lifeCycle":0,
"name":"固浮比（%）",
"type":0,
"dataSource":null
},
{
"id":"f248ac7531b1431fab07c7ec1e30a38a",
"lifeCycle":1,
"name":"11111",
"type":8,
"dataSource":null
}
],
"cost":[
{
"id":"1266417",
"lifeCycle":1,
"name":"企业年金"
},
{
"id":"1266419",
"lifeCycle":1,
"name":"工会经费"
},
{
"id":"1266421",
"lifeCycle":1,
"name":"体检费"
}
],
"bonus":[
{
"id":"2050451",
"lifeCycle":1,
"name":"绩效奖金",
"taxMode":0
},
{
"id":"2050453",
"lifeCycle":1,
"name":"季度奖金",
"taxMode":0
},
{
"id":"2050455",
"lifeCycle":1,
"name":"销售奖金",
"taxMode":0
}
],
"adjust":[
{
"id":"888365",
"lifeCycle":1,
"name":"税前补发／扣款",
"taxMode":0
},
{
"id":"888366",
"lifeCycle":1,
"name":"税后补发／扣款",
"taxMode":1
}
]
}
}