未结清账期-账单列表
外部-测试环境
https://testing.westmonth.com
外部-测试环境
https://testing.westmonth.com
POST
/openapi/quotaPeriod/getQuotaUnSettlePeriods
未结清账期-账单列表接口
适用场景
接口类型
请求频率限制
请求说明
https://www.westmonth.com/openapi/quotaPeriod/getQuotaUnSettlePeriods测试环境：
https://testing.westmonth.com/openapi/quotaPeriod/getQuotaUnSettlePeriods请求参数
Header参数
| 参数名 | 类型 | 必填 | 示例值 | 说明 |
|---|---|---|---|---|
| Authorization | string | 是 | authorization | 身份验证Token |
| Content-Type | string | 是 | application/json | 建议固定传此值 |
Body参数
| 参数名 | 类型 | 必填 | 默认值 | 可选值 | 说明 |
|---|---|---|---|---|---|
| page | integer | 是 | 1 | - | 当前页码 |
| page_size | integer | 是 | 20 | - | 每页展示数量 |
| customer_id | integer | 否 | - | - | 客户ID |
| customer_uid | string | 否 | - | - | 客户UID |
| customer_name | string | 否 | - | - | 客户名称 |
响应字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
| code | integer | 请求状态码 |
| msg | string | 请求说明 |
| data | object | 返回数据对象 |
| 字段 | 类型 | 说明 |
|---|---|---|
| list | array | 账单账期列表 |
| total | integer | 数据总数 |
| quota_customer | object | 客户主数据 |
| payee_list | object | 收款账号类型列表 |
| 字段 | 类型 | 说明 |
|---|---|---|
| id | integer | 账期id |
| delivery_region_type | integer | 发货区域（1国内，2海外） |
| num | integer | 期数 |
| ended_at | string | 本期账单周期开始日期 |
| started_at | string | 本期账单周期结束日期 |
| end_delayed_at | string | 本期逾期日期（本期结束时间 + 还款期限） |
| status | string | 账期状态（running：进行中；arrived：待生成账单；bill_auditing：账单审核中；bill_confirmed：账单已生成；unpaid：待还款；done：全部结清） |
| sale_amount | string | 消费金额 |
| after_sale_amount | string | 售后金额 |
| settled_amount | string | 已结清金额 |
| received_amount | string | 已收金额 |
| currency_list | array | - |
| quotax_bill_id | - | 账单id |
| sale_amount_format | string | 消费金额（格式化） |
| after_sale_amount_format | string | 售后金额（格式化） |
| probably_amount | number | 待还金额 |
| probably_amount_format | string | 待还金额（格式化） |
| settled_amount_format | string | 已结清金额（格式化） |
| received_amount_format | string | 已收金额（格式化） |
| adjust_amount | integer | 调整金额 |
| adjust_amount_format | string | 调整金额（格式化） |
| receivable_amount | string | 应收金额 |
| receivable_amount_format | string | 应收金额（格式化） |
| total_amount | string | 剩余应还金额 |
| total_amount_format | string | 剩余应还金额（格式化） |
| 字段 | 类型 | 说明 |
|---|---|---|
| customer_id | integer | 客户id |
| customer_uid | string | 客户uid |
| customer_name | string | 客户名称 |
| 字段 | 类型 | 说明 |
|---|---|---|
| 万里汇 | array | 万里汇收款账号列表 |
| 储蓄卡 | array | 储蓄卡收款账号列表 |
| 派安盈 | array | 派安盈收款账号列表 |
| 微信 | array | 微信收款账号列表 |
| 支付宝 | array | 支付宝收款账号列表 |
| 其他 | array | 其他类型收款账号列表 |
| 银行账户 | array | 银行账户收款账号列表 |
| 字段 | 类型 | 说明 |
|---|---|---|
| no | integer | 收款账号No |
| platform_name | string | 收款方式 |
| account | string | 账户 |
| account_name | string | 账户名称 |
| channel | string | 渠道类型（1688线下、阿里巴巴、独立站、分销商、义务等） |
| bank_name | string | 开户行 |
| body_type | integer | 主体类型（1公户、2个人账户） |
| owner_name | string | 持卡人 |
| body_type_format | string | 主体类型格式化 |
调用示例
URL请求
请求示例
{
"page": 1,
"page_size": 30
}成功返回示例
{
"code": 0,
"msg": "",
"data": {
"list": [],
"total": 0,
"quota_customer": {
"customer_id": 880,
"customer_uid": "WM202405271201537338",
"customer_name": "1"
},
"payee_list": {
"万里汇": [
{
"no": 10001,
"platform_name": "万里汇",
"account": "XXXX",
"account_name": "XXXX",
"channel": "分销商，独立站",
"bank_name": "XXXX",
"body_type": 1,
"owner_name": "广东省西之月科技有限公司",
"body_type_format": "公户"
}
],
"储蓄卡": [
{
"no": 10008,
"platform_name": "储蓄卡",
"account": "XXXX",
"account_name": "XXXX",
"channel": "义乌，独立站，1688线下",
"bank_name": "汇丰银行",
"body_type": 2,
"owner_name": "XXXX",
"body_type_format": "个人账户"
}
],
"派安盈": [
{
"no": 10010,
"platform_name": "派安盈",
"account": "XXXX",
"account_name": "XXXX,
"channel": "1688线下",
"bank_name": "",
"body_type": 1,
"owner_name": "XXXX",
"body_type_format": "公户"
}
],
"微信": [
{
"no": 10011,
"platform_name": "微信",
"account": "XXXX",
"account_name": "广东省西之月科技有限公司",
"channel": "义乌，独立站，1688线下",
"bank_name": "",
"body_type": 1,
"owner_name": "广东省西之月科技有限公司",
"body_type_format": "公户"
}
],
"支付宝": [
{
"no": 10013,
"platform_name": "支付宝",
"account": "XXXX",
"account_name": "广东省西之月科技有限公司",
"channel": "义乌，独立站，1688线下",
"bank_name": "",
"body_type": 1,
"owner_name": "广东省西之月科技有限公司",
"body_type_format": "公户"
}
],
"其他": [
{
"no": 10024,
"platform_name": "其他",
"account": "其他",
"account_name": "其他",
"channel": "其他",
"bank_name": "其他",
"body_type": 0,
"owner_name": "其他",
"body_type_format": "其他"
}
],
"银行账户": [
{
"no": 10021,
"platform_name": "银行账户",
"account": "XXXX",
"account_name": "广东省西之月科技有限公司",
"channel": "独立站",
"bank_name": "中信银行股份有限公司汕头分行",
"body_type": 1,
"owner_name": "广东省西之月科技有限公司",
"body_type_format": "公户"
}
],
"pingpong": [
{
"no": 10020,
"platform_name": "pingpong",
"account": "XXXX",
"account_name": "XXXX",
"channel": "独立站",
"bank_name": "",
"body_type": 1,
"owner_name": "西之月香港有限公司",
"body_type_format": "公户"
}
]
}
}
}失败返回示例
{
"code": 3,
"msg": "授权无效 authorization timestamp error",
"data": []
}错误处理
| HTTP status code | 错误码 | 错误信息 | 描述 |
|---|
常见问题
版本历史
| 版本 | 日期 | 修改说明 |
|---|---|---|
| v1.0 | 2025-07-09 | 初始版本 |
请求参数
Header 参数
Body 参数application/json
请求示例代码
返回响应
修改于 2026-02-24 03:28:34