查询回款单列表

分页查询当前企业的 LTC 回款单，支持按业务编号、关联订单、客户、员工、审批状态、金额、回款时间、关联状态和付款方筛选。

客户筛选规则与订单列表一致：contact 使用 buyer_id，external_user 使用 buyer_ext_id，并必须与 buyer_type 配套。

错误码

错误码	含义
10001	access_token 未设置、错误或过期
10045	limit 超过最大值 50
10046	offset 非法或超出范围
10047	limit 不是正整数
10048	时间参数不是 10 位秒级或 13 位毫秒级时间戳
10049	参数格式、组合、枚举或请求体校验失败
22401	企业未开通对应的 LTC OpenAPI 能力
22403	订单、商品、回款等资源不存在或不属于当前企业
22414	LTC 服务暂不可用
22415	LTC 内部处理异常或响应不符合契约
22416	LTC 服务契约版本不受支持

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

HTTP 状态通常为 200，请以 errcode 判断业务结果。errcode=0 表示成功。

Bodyapplication/json

示例

{
    "errcode": 0,
    "errmsg": "ok",
    "data": {
        "total_count": 1,
        "has_more": false,
        "limit": 20,
        "offset": 0,
        "returned_money": [
            {
                "returned_money_id": "1592417885008389569",
                "returned_union_id": "2855649157133113273",
                "customer": {
                    "type": "external_user",
                    "id": "7000848688",
                    "ext_id": "wmXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
                    "name": "示例客户",
                    "avatar": null,
                    "corp_name": null,
                    "display_state": "active"
                },
                "staff": {
                    "ext_id": "SuMao",
                    "name": "示例员工",
                    "avatar": null,
                    "display_state": "active"
                },
                "organization": {
                    "id": "100105831",
                    "ext_id": null,
                    "name": "示例组织",
                    "display_state": "active"
                },
                "amount": "100.00",
                "audit_status": "passed",
                "audit_status_name": "审核通过",
                "returned_time": 1769702400000,
                "relation_order_status": true,
                "auditor_staff_name": "示例审批人",
                "payer": "示例付款方",
                "returned_money_way": "银行转账",
                "remark": "",
                "created_at": 1769674789000,
                "updated_at": 1769674789000
            }
        ]
    }
}

错误码#

请求参数

请求示例代码

返回响应

错误码