未结清账单-售后订单列表接口

提供获取用户未结清账单对应的售后订单列表能力，支持分页查询，可获取售后订单的详细信息、客户信息及发货区域映射等相关数据。

适用场景

查询用户未结清账单所关联的售后订单信息

了解未结清账单对应的售后订单的退款额度、完成时间等情况

接口类型

POST

请求频率限制

默认频率：以平台配额为准

请求说明

请求URL

正式环境：https://www.westmonth.com/openapi/quotaPeriod/getQuotaRefundOrders
测试环境：https://testing.westmonth.com/openapi/quotaPeriod/getQuotaRefundOrders

请求参数

Header参数

参数名	类型	必填	示例值	说明
Authorization	string	是	authorization	身份验证Token
Content-Type	string	是	application/json	建议固定传此值

Body参数

根字段

参数名	类型	必填	默认值	可选值	说明
page	integer	是	-	-	当前页码
page_size	integer	是	-	-	每页展示数量
customer_id	integer	否	-	-	客户ID
customer_uid	string	否	-	-	客户UID
customer_name	string	否	-	-	客户名称

响应字段说明

成功响应（HTTP 200）

根字段

字段	类型	说明
code	integer	请求状态code
msg	string	请求状态描述
data	object	返回数据对象

data对象字段

字段	类型	说明
list	array	售后订单列表
total	integer	售后订单数量
quota_customer	object	客户主数据
delivery_region_type_formats	object	发货区域映射

list数组字段

字段	类型	说明
id	integer	售后订单id
after_sale_no	string	售后单号
order_no	string	订单编号
quota	string	退款额度
complate_at	string	售后完成时间
order_status	string	订单状态
customer_id	integer	客户id
customer_uid	string	客户uid
customer_name	string	客户名称
salesperson_name	null	对接业务员
ended_at	string	账单截至时间
delivery_region_type	integer	发货区域（1国内；2海外）
after_sale_id	integer	售后id
refunded_quota_format	string	退款额度-格式化
ended_at_format	string	账单截至时间-格式化

quota_customer对象字段

字段	类型	说明
customer_id	integer	客户id
customer_uid	string	客户uid
customer_name	string	客户名称

delivery_region_type_formats对象字段

字段	类型	说明
1	string	国内（发货区域类型为1时的说明）
2	string	海外（发货区域类型为2时的说明）

调用示例

URL请求

请求示例

{
  "page": 1,
  "page_size": 30
}

成功返回示例

{
    "code": 0,
    "msg": "",
    "data": {
        "list": [],
        "total": 0,
        "quota_customer": {
            "customer_id": 880,
            "customer_uid": "WM202405271201537338",
            "customer_name": "1"
        },
        "delivery_region_type_formats": {
            "1": "国内",
            "2": "海外"
        }
    }
}

失败返回示例

{
    "code": 3,
    "msg": "授权无效 authorization timestamp error",
    "data": []
}

错误处理

公共错误码

HTTP status code	错误码	错误信息	描述

常见问题

版本历史

版本	日期	修改说明
v1.0	2025-07-09	初始版本

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "code": 0,
    "msg": "",
    "data": {
        "list": [
            {
                "id": 5779,
                "after_sale_no": "AS202505131341015369",
                "order_no": "BXY2505121055197",
                "quota": "45.00",
                "complate_at": "2025-05-13 18:18:35",
                "order_status": "failed",
                "customer_id": 38551,
                "customer_uid": "WM202505121005308861",
                "customer_name": "国内个人客户",
                "salesperson_name": null,
                "ended_at": "2025-05-31 23:59:59",
                "delivery_region_type": 1,
                "after_sale_id": 33,
                "refunded_quota_format": "￥45.00",
                "ended_at_format": "2025-05-31"
            }
        ],
        "total": 5,
        "quota_customer": {
            "customer_id": 38551,
            "customer_uid": "WM202505121005308861",
            "customer_name": "国内个人客户"
        },
        "delivery_region_type_formats": {
            "1": "国内",
            "2": "海外"
        }
    }
}

未结清账单-售后订单列表

未结清账单-售后订单列表接口#

适用场景#

接口类型#

请求频率限制#

请求说明#

请求参数#

Header参数#

Body参数#

响应字段说明#

调用示例#

URL请求#

请求示例#

成功返回示例#

失败返回示例#

错误处理#

常见问题#

版本历史#

请求参数

请求示例代码

返回响应

未结清账单-售后订单列表接口

适用场景

接口类型

请求频率限制

请求说明

请求参数

Header参数

Body参数

响应字段说明

调用示例

URL请求

请求示例

成功返回示例

失败返回示例

错误处理

常见问题

版本历史