查询订单列表

分页查询当前企业的 LTC 订单，支持按订单、商品、员工、状态、购买方、组织和创建时间筛选。

购买方筛选规则：contact 必须使用 buyer_id；external_user 必须使用 buyer_ext_id；购买方标识必须与 buyer_type 配套。所有未声明 query 字段和重复的标量 query 参数都会被拒绝。

错误码

错误码	含义
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,
        "orders": [
            {
                "order_id": "240052097",
                "order_number": "OPENAPI-ORDER-001",
                "amount": "1.00",
                "order_status": "unpaid",
                "audit_status": "unsubmitted",
                "audit_node_number": null,
                "buyer": {
                    "type": "contact",
                    "id": "100136400",
                    "ext_id": null,
                    "name": "示例联系人",
                    "avatar": null,
                    "corp_name": null,
                    "display_state": "active"
                },
                "staff": {
                    "ext_id": "SuMao",
                    "name": "示例员工",
                    "avatar": null,
                    "display_state": "active"
                },
                "organization": {
                    "id": "100105842",
                    "ext_id": null,
                    "name": "示例组织",
                    "display_state": "active"
                },
                "goods_list": [
                    {
                        "goods_id": "100097608",
                        "sku_id": "100096943",
                        "name": "示例商品",
                        "spec_param": {
                            "default": "ltc_default_spec"
                        },
                        "count": 1,
                        "fix_price": "1.00",
                        "discount": 100,
                        "amount": "1.00"
                    }
                ],
                "returned_money": "0.00",
                "source": "WTRWE",
                "remark": "OpenAPI 创建订单示例",
                "created_at": 1785395107000,
                "updated_at": 1785395107000
            }
        ]
    }
}

错误码#

请求参数

请求示例代码

返回响应

错误码