工资报表
接口说明:该接口获取历史归档工资当前月的所有报表信息，返回查询年月份所有已归档的报表信息(不包含事业部信息，暂不提供事业部工资报表查询接口)
请求方式:POST（HTTPS）
请求地址:https://api.xinrenxinshi.com/v5/payroll/report/list
请求Header:
| key | value |
|---|---|
| access_token | 获取的access_token的实际值 |
Query参数:
| key | value |
|---|---|
| sign | 签名值 |
Body参数:
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| yearmo | String | Y | 时间格式:yyyyMM；例如:201901 |
| timestamp | Long | Y | 请求时间戳（精确到毫秒） |
返回结果:
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| errcode | Integer | Y | 错误码枚举值 |
| errmsg | String | Y | 错误码对应描述信息 |
| data | PayrollReportArchivesResponse | Y | 返回值 |
PayrollReportArchivesResponse
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| yearmo | String | Y | 查询年月份,时间格式:yyyyMM；例如:201901 |
| archiveId | String | Y | 归档报表ID |
| archiveTime | String | Y | 报表归档完成时间 |
| archiveName | String | Y | 归档报表名称 |
| archiveReportList | List<PayrollReportArchiveBase> | Y | 所有归档报表信息 |
PayrollReportArchiveBase
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| reportId | String | Y | 报表ID |
| subReportId | String | N | 子报表ID |
| reportName | String | Y | 报表名称 |
Tips:
- 返回的数据都是归档工资报表的信息值，可根据报表信息，调用查看详情数据接口查看详情数据
- archiveReportList包含多个PayrollReportArchiveBase信息，每一个PayrollReportArchiveBase 都是一个不同的历史归档的工资报表
请求示例(HTTPS):
https://api.xinrenxinshi.com/v5/payroll/report/list?sign=cwyzXRxvXDiGetbidkMvHYJ7TVI%3D
请求Body示例:
{
"yearmo": "202011",
"timestamp": 1606218238286
}
SDK请求示例(java):
PayrollReportArchivesRequest request = new PayrollReportArchivesRequest(access_token);
request.setYearmo("202011");
OpenapiResponse<PayrollReportArchivesResponse> reportArchives = XrxsPayrollService.getReportArchives(request);
响应示例:
{
"errcode": 0,
"errmsg": "成功",
"data": {
"archiveTime": "2020-11-24 19:42:53",
"archiveName": "11月薪酬报表",
"yearmo": "202011",
"archiveReportList": [
{
"reportId": "81ba8b7e7e624b7cafedcb6f1103bdbf",
"subReportId": "",
"reportName": "全数据"
},
{
"reportId": "3e7b815a81014c6282be95427d4cf25d",
"subReportId": "",
"reportName": "部门汇总"
},
{
"reportId": "7635bb55dc384e67ba29e9e43e6f6678",
"subReportId": "",
"reportName": "成本拆分"
},
{
"reportId": "8a23b63f2a1a46c9a50e2ffbe2e5f6f5",
"subReportId": "",
"reportName": "人员信息表"
},
{
"reportId": "81ba8b7e7e624b7cafedcb6f1103bdbf",
"subReportId": "134d1845da3f4d45a8aee92a38e662fa",
"reportName": "工资信息表"
},
{
"reportId": "81ba8b7e7e624b7cafedcb6f1103bdbf",
"subReportId": "161878edf2b74678a0d03a8d3ec3b677",
"reportName": "工资报表"
},
{
"reportId": "81ba8b7e7e624b7cafedcb6f1103bdbf",
"subReportId": "b2f5bee212b942c095e6545fbd8faee2",
"reportName": "年终奖报表"
},
{
"reportId": "81ba8b7e7e624b7cafedcb6f1103bdbf",
"subReportId": "d7db13f73db14347b6a34ff4cf5ac63c",
"reportName": "调薪异动"
},
{
"reportId": "81ba8b7e7e624b7cafedcb6f1103bdbf",
"subReportId": "646e583702684c76ad742bf75db9a0b5",
"reportName": "人工成本"
},
{
"reportId": "81ba8b7e7e624b7cafedcb6f1103bdbf",
"subReportId": "1adae1f919e04362b473edeae613be8f",
"reportName": "网银数据"
},
{
"reportId": "81ba8b7e7e624b7cafedcb6f1103bdbf",
"subReportId": "cd7b22800148404687ececadddd3ec4a",
"reportName": "人员信息表"
},
{
"reportId": "81ba8b7e7e624b7cafedcb6f1103bdbf",
"subReportId": "ffd6c8844d1945b2b0d8f51456aa2c68",
"reportName": "正常工资薪金所得"
},
{
"reportId": "81ba8b7e7e624b7cafedcb6f1103bdbf",
"subReportId": "101571bf0de8416484843bab72563d17",
"reportName": "管理形式汇总"
},
{
"reportId": "81ba8b7e7e624b7cafedcb6f1103bdbf",
"subReportId": "9e587186c6fa4a8783791a29343f8f13",
"reportName": "劳务报酬所得（一般）"
},
{
"reportId": "81ba8b7e7e624b7cafedcb6f1103bdbf",
"subReportId": "95bd3acc1dd2455fade3cfc7db86a47a",
"reportName": "劳务报酬所得（其他连续劳务）"
},
{
"reportId": "81ba8b7e7e624b7cafedcb6f1103bdbf",
"subReportId": "eed092d8d4044783a2ecc1d8e012d85f",
"reportName": "外籍人员正常工资薪金"
},
{
"reportId": "81ba8b7e7e624b7cafedcb6f1103bdbf",
"subReportId": "914a958bf16249de970048a2fe0686b6",
"reportName": "外籍人劳务报酬所得"
},
{
"reportId": "81ba8b7e7e624b7cafedcb6f1103bdbf",
"subReportId": "29a6c7e4a17e4bad86710cb4470d88cb",
"reportName": "全年一次性奖金收入"
},
{
"reportId": "81ba8b7e7e624b7cafedcb6f1103bdbf",
"subReportId": "7e0b23d6c0f747e5939e2d7cb6864bf6",
"reportName": "解除劳动合同一次性补偿金"
},
{
"reportId": "81ba8b7e7e624b7cafedcb6f1103bdbf",
"subReportId": "b4334efaa3d7411b9e29d56c30a2273a",
"reportName": "减免事项附表（居民）"
},
{
"reportId": "81ba8b7e7e624b7cafedcb6f1103bdbf",
"subReportId": "62260bd83b1b48da96323eea3d3a0079",
"reportName": "商业健康保险附表"
},
{
"reportId": "81ba8b7e7e624b7cafedcb6f1103bdbf",
"subReportId": "f50e18d62a2a44aca8fbd0c868f69160",
"reportName": "税延养老保险附表"
},
{
"reportId": "81ba8b7e7e624b7cafedcb6f1103bdbf",
"subReportId": "647a7bc862f4483d8e2d2e40ab278bcd",
"reportName": "减免事项附表（非居民）"
},
{
"reportId": "81ba8b7e7e624b7cafedcb6f1103bdbf",
"subReportId": "8bbb14bba0324f7c89b51d917e2dc630",
"reportName": "合计"
}
],
"archiveId": "2ca490c32b164b75bfc72d903caf5cfb"
}
}