工资报表详情
接口说明: 返回当前公司输入的年月份(202301)的当月所有薪酬报表信息。包括全数据、部门汇总、成本拆分、工资报表、年终奖报表、薪酬异动、人工成本、网银数据、个税报表(工资)、个税报表(劳务费)、管理形式汇总 等所有归档报表中的报表信息。 还有其他返回值如 当前归档报表所有报表已加密的Id信息，报表归档时间，名称等信息 更新的工资项信息，批量更新员工的工资数据。 返回员工ID和部门ID。
注:部门名称转换为部门ID返回，员工姓名转换为员工ID返回。
请求方式:POST（HTTPS）
请求地址:https://api.xinrenxinshi.com/v5/payroll/report/detail/v2
请求Header:
| key | value |
|---|---|
| access_token | 获取的access_token的实际值 |
Query参数:
| key | value |
|---|---|
| sign | 签名值 |
Body参数:
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| reportId | String | Y | 查询的报表ID |
| subReportId | String | N | 查询的子报表ID |
| flowStatus | List<String> | N | 审批状态 -1:未发起（包含撤销）0:审批中 1:通过 2:驳回 不传的话默认查询查询所有数据，如果传了状态，则返回对接状态的数据。 |
| allPassed | Integer | N | allPassed 是否需要所有的工资报表都审核通过了才返回数据 0:否 1:是 如果当月开启了工资审批，并且传的值为1的情况下，则最新归档的所有工资组中的报表有一个未审核通过则不返回数据。 |
| timestamp | Long | Y | 请求时间戳（精确到毫秒） |
返回结果:
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| errcode | Integer | Y | 错误码枚举值 |
| errmsg | String | Y | 错误码对应描述信息 |
| data | PayrollReportArchiveDetailResponse | Y | 返回值 |
PayrollReportArchiveDetailResponse
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| totalRow | Integer | Y | 当前报表包含的记录数 |
| archiveTime | String | Y | 当前报表归档完成时间 |
| reportName | String | Y | 当前报表名称 |
| reportHeadList | List<String> | Y | 当前报表的报表头信息列表 |
| reportDetailList | List<String> | Y | 当前报表的所有数据信息列表 |
Tips:
- reportHeadList 是数据报表的表头信息
- reportDetailList 是当前报表的所有数据信息列表，外层List为多条记录列表，内层List为单条记录的信息，数据顺序依次参照报表头List次序
- 如果subReportId为空，表示获取reportId的工资列表详情，否则正确输入reportId和subReportId，返回reportId下子工资项列表subReportId的详情数据
- 接口支持获取指定审批状态的工资报表数据。如果需要获取审批通过的工资报表数据，则flowStatus传1即可。如果需要保证所有的工资报表数据都审核通过了才返回数据，但凡有一个没有审核通过，就不返回数据，则allPassed传1即可。
- 当只传flowStatus参数时，按照状态审批对返回数据进行筛选。当只传allPassed参数时，如果allPassed=0，则返回所有数据，如果allPassed=1，则返回所有审核通过的数据。如果同时传了flowStatus和allPassed，并且allPassed=1，则返回所有审核通过的数据
请求示例(HTTPS):
https://api.xinrenxinshi.com/v5/payroll/report/detail/v2?sign=7omyqoNIY5QPWKCyQM3Q7Hk8mNQ=
请求Body示例:
{
"reportId": "81ba8b7e7e624b7cafedcb6f1103bdbf",
"subReportId": "134d1845da3f4d45a8aee92a38e662fa",
"timestamp": 1606219446007
}
SDK请求示例(java):
PayrollReportArchiveDetailV2Request request = new PayrollReportArchiveDetailV2Request(access_token());
request.setReportId("81ba8b7e7e624b7cafedcb6f1103bdbf");
request.setSubReportId("134d1845da3f4d45a8aee92a38e662fa");
OpenapiResponse<PayrollReportArchiveDetailResponse> reportArchiveDetail = XrxsPayrollService.getReportArchiveDetailV2(request);
响应示例:
{
"errcode": 0,
"errmsg": "成功",
"data": {
"reportDetailList": [
[
"2a64530be71d4c6fa5e4cc0728f62547",
"19252526969",
"居民工资",
"正式",
"7000",
"7000",
"0",
"0",
"0",
"0",
"",
"",
""
],
[
"abb5bcd3169849aa8b7008e5dde5d124",
"19400235449",
"居民工资",
"正式",
"10000",
"10000",
"0",
"0",
"0",
"0",
"",
"",
""
],
[
"2ce97ceb56094cad8248790113b3a1d7",
"19002393231",
"居民工资",
"正式",
"8000",
"8000",
"0",
"0",
"0",
"0",
"",
"",
""
],
[
"【合计】",
"",
"",
"",
"",
"25000",
"0",
"0",
"0",
"0",
"",
"",
""
]
],
"archiveTime": "2020-11-24 19:42:53",
"totalRow": 4,
"reportHeadList": [
"姓名",
"手机",
"计税方式",
"聘用形式",
"最新基本工资基数",
"最新工资基数合计",
"社保个人",
"社保补缴个人",
"公积金个人",
"公积金补缴个人",
"薪酬结构",
"发薪月数",
"固浮比（%）"
],
"reportName": "工资信息表"
}
}