1. 获取项目的工资表
开放平台2.0-项目-获取项目的工资表
注意
- 如果接口需要提供auth-token，你需要通过轻筑开放平台创建应用来获取appid和secret，然后通过appid和secret来获取接口访问凭证auth-token。
- 如果需要获取当前用户的使用信息，授权确保你能获取到qzcode，然后通过
网页授权接口获取相关信息。
1.1. 基本信息
| 概况 | 内容 |
|---|---|
| 接口地址 | /api/open/v2/labor/project/listPageForSalaryForm |
| 请求方法 | POST |
| 请求数据类型 | JSON |
| 响应数据类型 | JSON |
1.2. 请求数据
1.2.1. 请求头（request-header）
请求头除了默认的参数还需要添加如下请求头参数：
| 字段 | 描述 |
|---|---|
| auth-token | 接口访问凭据，你可以通过平台下发的appid和secret获取凭据 |
| Content-Type | application/json;charset=UTF-8 |
1.2.2. 请求体（request-body）
startDate 和 endDate 均传值，参数才起作用，只传其中单个值，查询结果为项目所有账期的数据
| 字段 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| projectUuid | string | 是 | 项目id |
| pageNum | number | 是 | 分页码 |
| pageSize | number | 是 | 分页每页数据条数 |
| date | string | 否 | 账期（yyyy-MM）（传 date 值会忽略startDate、endDate） |
| startDate | string | 否 | 起始账期（yyyy-MM）（账期起始月份，仅当date 不传值时，生效） |
| endDate | string | 否 | 结束账期（yyyy-MM）（账期结束月份，仅当date 不传值时，生效） |
1.3. 响应数据
响应数据中 code, msg, data 为默认字段，所有字段如下表所示：
| 字段 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| code | number | 是 | 返回码 |
| msg | string | 是 | 返回消息 |
| data | array | 是 | 返回数据 |
| uuid | string | 是 | 工资表主键 id |
| orgnationUuid | string | 是 | 组织机构 id |
| orgnationName | string | 是 | 组织机构名称 |
| provideAmount | string | 是 | 应发金额 |
| paidAmount | string | 是 | 实发金额 |
| confirmedAmount | string | 是 | 确认发放金额 |
| year | string | 是 | 账期-年 |
| month | string | 是 | 账期-月 |
| state | number | 是 | 工资表状态 |
| stateValue | string | 否 | 工资表状态描述 |
| attachments | array | 是 | 附件列表 |
| uuid | string | 是 | 附件 id |
| fileName | string | 是 | 附件文件名 |
| fileUrl | string | 是 | 附件存储链接 |
响应数据结构如下所示：
{
"code": 0,
"msg": "成功",
"data":
[
{
"attachments":
[
{
"fileName": "分包企业农民工工资发放明细确认表.pdf",
"createTime": 1678863142237,
"companyName": "國2有限公司",
"fileUrl": "https://qingzhu-test.obs.cn-east-3.myhuaweicloud.com/laborSalaryAttachment_1373c2ef26b0436d899d1d6c502d4e8a.pdf?AccessKeyId=KZMZP7KJBOBNPXXONCQW&Expires=1698304798&Signature=Xdtls5Nse0JB4Kx205TMlmWAyBU%3D",
"uuid": "45d43f7f7bc64f489280957df751e482"
}
],
"provideAmount": "88890000216157.31",
"confirmedAmount": "784377380379",
"orgnationUuid": "971046b1bb15425e82117e75260ba508",
"createTime": 1678850670511,
"orgnationName": "國2有限公司",
"paidAmount": "784377396423",
"uuid": "b64e741b77d44ffdb9ee11c6c4c3705d",
"year": "2024",
"month": "04",
"state": 9,
"stateValue": "已通过"
}
]
}
1.4. 错误码
当返回数据中的 code 不为 0 时，为错误返回。其中errCode为详细的错误码。