FIN-010 个体户结算报表查询

POST

https://getway.upfreework.com/openapi/v1/proprietor/settlement/page

按季度分页查询个体户结算报表。

appId 绑定	能查到的范围
企业	当前企业
代理商	该代理商名下的全部企业。多家企业的报表会在同一个结果集里返回，使用行里的 companyId 进行区分

报表的两条性质：

季度结束次日 08:00 由定时任务自动生成，当季查不到。

晚到账的钱不会丢，它会落到下一个季度的报表里。

关于完税证明 taxProofUrls和报税金额taxAmount：一个报表行可以挂多个证明（运营多次追加即累加），故为数组；报税金额和完税证明由运营在后台上传，上传时机不确定，报表刚生成时通常还没有，拿到空数组不代表以后也没有；运营删除后该地址不再出现。

名称、日期类字段均为生成时快照，个体户资料后续变更不回溯。

请求参数

Authorization

Header 参数

Body 参数application/json必填

示例

按季度查询

{
    "page": 1,
    "size": 10,
    "quarterCode": "2026Q3"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

示例 1示例 2

curl --location 'https://getway.upfreework.com/openapi/v1/proprietor/settlement/page' \
--header 'appId;' \
--header 'appSign;' \
--header 'timeStamp;' \
--header 'sign;' \
--header 'Content-Type: application/json' \
--data '{
    "page": 1,
    "size": 10,
    "quarterCode": "2026Q3"
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "code": 0,
    "message": "成功",
    "context": {
        "data": [
            {
                "reportId": 10086,
                "companyId": 1743889921536,
                "quarterCode": "2026Q2",
                "quarterLabel": "26年2季度",
                "proprietorName": "杭州张三日用百货商行",
                "legalName": "张三",
                "serverName": "某某人力资源服务商",
                "registrationDate": "2025-03-12",
                "cancellationDate": null,
                "receivedAmount": 158000.0,
                "taxAmount": null,
                "taxProofUrls": [
                    "https://oss.example.com/proof/2026Q2-a.jpg",
                    "https://oss.example.com/proof/2026Q2-b.pdf"
                ]
            }
        ],
        "total": 1
    }
}

修改于 2026-09-10 02:12:43

FIN-009-到账金额算税接口

ACC-001-企业创建申请