1. 获取项目的工资表明细

开放平台2.0-项目-获取项目的工资表明细

注意

如果接口需要提供auth-token，你需要通过轻筑开放平台创建应用来获取appid和secret，然后通过appid和secret来获取接口访问凭证auth-token。
如果需要获取当前用户的使用信息，授权确保你能获取到qzcode，然后通过网页授权接口获取相关信息。

1.1. 基本信息

概况	内容
接口地址	/api/open/v2/labor/project/listPageForSalaryFormDetail
请求方法	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	是	分页每页数据条数
uuid	string	是	工资表主键 id

1.3. 响应数据

欠发金额 = 应发金额 - 实发金额

响应数据中 code, msg, data 为默认字段，所有字段如下表所示：

字段	类型	是否必填	描述
code	number	是	返回码
msg	string	是	返回消息
data	object	是	返回数据
total	number	是	总条数
pages	number	是	总页数
size	number	是	当前页数据条数
isLastPage	boolean	是	是否最后一页
pageSize	number	是	每页条数
isFirstPage	boolean	是	是否第一页
pageNum	number	是	页码
totalPayAmountTotal	number	是	应发金额合计
finalPayingAmountTotal	number	是	实发金额合计
actualAmountTotal	number	是	实得金额合计
attendanceDaysTotal	number	是	出勤天数合计
list	array	是	人员明细
date	string	是	账期
startDate	string	是	工作起始日期
endDate	string	是	工作结束日期
settlementIntervalDate	string	是	工作时间
rosterName	string	是	姓名
identityNumber	string	是	证件号
idType	string	是	证件类型
companyName	string	是	填报组织
accountBankName	string	否	开户行名称
accountBankNumber	string	否	卡号
attendanceDays	number	是	出勤天数
attendanceDaily	array	是	出勤明细
date	string	是	日期
hasAttendanceRecord	number	是	是否出勤：0-未出勤，1-已出勤
salaryFormUuid	string	是	工资表 uuid
salaryFormDetailUuid	string	是	工资表明细 uuid
totalPayAmount	number	是	应发金额
finalPayingAmount	number	是	实发金额
borrowingsAndAdvancesAmount	number	是	借支预支金额
remittingAmount	number	是	代缴款
withholdingAmount	number	是	代扣款
actualAmount	number	是	实得金额
isExcesPrompt	boolean	是	是否超额
leaveFlag	number	是	工资支付月离场：0-否，1-是

响应数据结构如下所示：

{
    "code": 0,
    "msg": "成功",
    "data": {
        "attendanceDaysTotal": 3,
        "awaitFlag": 1,
        "totalPayAmountTotal": "17000.00",
        "pageSize": 1,
        "finalPayingAmountTotal": "14000.00",
        "list": [
            {
                "date": "2024-08",
                "endDate": "2024-08-31",
                "companyName": "物产中大集团股份有限公司/班组1",
                "accountBankNumber": "389138905445",
                "accountBankName": "中国银行",
                "salaryFormUuid": "14b09c8499fe475b817ddeaf40fedb39",
                "borrowingsAndAdvancesAmount": "1000.00",
                "settlementIntervalDate": "2024-08-01~2024-08-31",
                "identityNumber": "513437200009055037",
                "finalPayingAmount": "6000.00",
                "idType": "居民身份证",
                "withholdingAmount": "1000.00",
                "actualAmount": "3000.00",
                "salaryFormDetailUuid": "e255773db1524d04aeb69f71c99cbcd1",
                "rosterName": "阿汝友者",
                "attendanceDays": 3,
                "totalPayAmount": "8000.00",
                "isExcesPrompt": false,
                "remittingAmount": "1000.00",
                "attendanceDaily": [
                    {
                        "date": "2024-08-01",
                        "hasAttendanceRecord": 0
                    },
                    {
                        "date": "2024-08-12",
                        "hasAttendanceRecord": 1
                    }
                ],
                "leaveFlag": 0,
                "remarks": "-",
                "startDate": "2024-08-01"
            }
        ],
        "pageNum": 1,
        "total": 95,
        "pages": 95,
        "size": 1,
        "isLastPage": false,
        "actualAmountTotal": "8000.00",
        "isFirstPage": true,
        "showBankNumberFlag": 0
    }
}

1.4. 错误码

当返回数据中的 code 不为 0 时，为错误返回。其中errCode为详细的错误码。

获取项目的工资表明细