全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试
退款单列表查看（卖家视角）
接口地址： http://api.vv-tool.com/tool/erps/refundgetList
接口介绍： 退款单列表查看（卖家视角）
必须用户授权 : 需要用户的授权，才能拿到被授权的数据
请求方式： POST
返回格式： JSON
接口收费： 联系运营
频率限制： 10 次/秒
请求头参数
| 参数 | 类型 | 必选 | 值 | 示例 |
|---|---|---|---|---|
| Authorization | string | 是 | 授权 access_token | Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx |
请求参数
| 名称 | 类型 | 是否必须 | 描述 | 示例值 |
|---|---|---|---|---|
| shop_id | string | 是 | 店铺 id | 123456 |
| statusList | String[] | 否 | 状态列表，CREATE：等待买家付款；PAID：买家已付款；CONSIGN：卖家已发货；TRADE_SUCCESS：交易成功；TRADE_CLOSE：交易关闭 | ["PAID"] |
| sourceTradeIdList | Long[] | 否 | 交易主单 id 集合 | [12333333] |
| refundStatusList | String[] | 否 | 退款状态：REFUND_WAIT_SELLER_AGREE：退款待处理；REFUND_WAIT_BUYER_RETURN_GOODS：待买家发货；REFUND_WAIT_SELLER_CONFIRM_GOODS：等待商家收货；REFUND_CLOSED：退款关闭；REFUND_SUCCESS：退款成功；REFUND_SELLER_REFUSE_BUYER：已拒绝退款；REFUND_WAIT_BUYER_CONFIRM_REDO_SEND_GOODS：等待买家确认重新邮寄的货物；REFUND_WAIT_SELLER_CONFIRM_RETURN_ADDRESS：等待卖家确认退货地址；REFUND_NO_REFUND：没有申请退款；REFUND_ACTIVE_REFUND：有活动的退款；REFUND_END：退款结束；WAIT_SELLER_CONSIGN_GOOGDS：卖家确认收货，等待卖家发货；EXCHANGE_TRANSFORM_TO_REFUND：换货关闭，转退货退款；WAIT_SELLER_AND_BYER_CONFIRM_GOODS：卖家已发货，等待卖家和买家确认收货；POST_FEE_DISPUTE_WAIT_ACTIVATE：邮费单已创建，待激活 | ["REFUND_WAIT_SELLER_AGREE"] |
| refundApplyTimeStart | Long | 否 | 退款申请时间左区间 | 退款申请时间左区间 |
| refundApplyTimeEnd | Long | 否 | 退款申请时间右区间 | 退款申请时间右区间 |
| disputeTypeList | String[] | 是 | 退款类型集合：DISPUTE_IN_SELL_REFUND：售中退款；DISPUTE_AFTER_SELL_REFUND：售后退款 | ["DISPUTE_IN_SELL_REFUND","DISPUTE_AFTER_SELL_REFUND"] |
| auctionIdList | String[] | 否 | 商品 id 集合 | ["1234"] |
| currentPage | String | 是 | 当前页，起始页为 1 | 1 |
| pageSize | String | 是 | 每页返回条数 | 20 |
请求示例
请求代码示例
cURL请求代码示例
PHP请求代码示例
JAVA请求代码示例
响应参数
| 名称 | 类型 | 描述 | 示例值 |
|---|---|---|---|
| result | message:alibaba.cbu.panama.order.client.model.PageResult | 1 | 1 |
| data | message:alibaba.cbu.panama.order.client.model.PanamaSubOrderModel[] | 退款单列表 | [] |
| actualTotalfee | java.lang.Long | 总费用 | 总费用 |
| address | java.lang.String | 详细地址 | 详细地址 |
| area | java.lang.String | 地区 | 地区 |
| auctionId | java.lang.Long | 商品 id | 商品 id |
| auctionPicturl | java.lang.String | 商品图片 | 商品图片 |
| auctionPrice | java.lang.Long | 单价，单位：分 | 单价 |
| auctionTitle | java.lang.String | 商品标题 | 商品标题 |
| buyAmount | java.lang.Integer | 购买数量 | 购买数量 |
| buyerId | java.lang.String | 买家 id | 买家 id |
| buyerMemo | java.lang.String | 买家留言 | 买家留言 |
| buyerNick | java.lang.String | 买家昵称 | 买家昵称 |
| cangType | java.lang.String | 仓发类型，CNC：菜鸟仓；SJC：商家仓 | SJC |
| city | java.lang.String | 市 | 市 |
| companyCode | java.lang.String | 发货物流公司编码 | 发货物流公司编码 |
| companyName | java.lang.String | 发货物流公司 | 发货物流公司 |
| country | java.lang.String | 国家 | 国家 |
| deliveryTime | java.util.Date | 出库时间 | 出库时间 |
| divisionCode | java.lang.String | 区域 code | 区域 code |
| fullName | java.lang.String | 收货人姓名 | 收货人姓名 |
| gmtCreate | java.util.Date | 创建时间 | 创建时间 |
| gmtModified | java.util.Date | 修改时间 | 修改时间 |
| mailNo | java.lang.String | 发货单号 | 发货单号 |
| mainRefundStatus | java.lang.String | 主单退款状态 | 主单退款状态 |
| mobilephone | java.lang.String | 收货人手机号 | 收货人手机号 |
| outerIdSku | java.lang.String | 商家编码 | 商家编码 |
| payTime | java.util.Date | 支付时间 | 支付时间 |
| phone | java.lang.String | 电话 | 电话 |
| postfee | java.lang.Long | 运费 | 运费 |
| prov | java.lang.String | 省份 | 省份 |
| refundStatus | java.lang.String | 退款状态，REFUND_WAIT_SELLER_AGREE：退款待处理；REFUND_WAIT_BUYER_RETURN_GOODS：待买家发货；REFUND_WAIT_SELLER_CONFIRM_GOODS：等待商家收货；REFUND_CLOSED：退款关闭；REFUND_SUCCESS：退款成功；REFUND_SELLER_REFUSE_BUYER：已拒绝退款；REFUND_WAIT_BUYER_CONFIRM_REDO_SEND_GOODS：等待买家确认重新邮寄的货物；REFUND_WAIT_SELLER_CONFIRM_RETURN_ADDRESS：等待卖家确认退货地址；REFUND_NO_REFUND：没有申请退款；REFUND_ACTIVE_REFUND：有活动的退款；REFUND_END：退款结束；WAIT_SELLER_CONSIGN_GOOGDS：卖家确认收货，等待卖家发货；EXCHANGE_TRANSFORM_TO_REFUND：换货关闭，转退货退款；WAIT_SELLER_AND_BYER_CONFIRM_GOODS：卖家已发货，等待卖家和买家确认收货；POST_FEE_DISPUTE_WAIT_ACTIVATE：邮费单已创建，待激活 | REFUND_END |
| sourceTradeGmtCreate | java.util.Date | 交易单下单时间 | 交易单下单时间 |
| sourceTradeId | java.lang.Long | 交易主单 | 交易主单 |
| sourceTradeSubId | java.lang.Long | 交易子单 | 交易子单 |
| status | java.lang.String | 状态，CREATE：等待买家付款；PAID：买家已付款；CONSIGN：卖家已发货；TRADE_SUCCESS：交易成功；TRADE_CLOSE：交易关闭 | TRADE_CLOSE |
| storeCode | java.lang.String | 仓库编码 | 仓库编码 |
| subActualTotalfee | java.lang.Long | 子单分摊总金额 | 子单分摊总金额 |
| subConsignStatus | java.lang.String | 子单发货状态 | 子单发货状态 |
| subPostfee | java.lang.Long | 子单分摊运费 | 子单分摊运费 |
| supplyId | java.lang.String | 供应商 id | 供应商 id |
| supplyName | java.lang.String | 供应商 name | 供应商 name |
| town | java.lang.String | 镇 | 镇 |
| refundInfo | message:alibaba.cbu.panama.order.client.model.RefundInfo | 退款信息 | {} |
| errorCode | java.lang.String | 错误码 | 错误码 |
| errorMessage | java.lang.String | 错误描述 | 错误描述 |
| pageNo | int | 当前页数 | 1 |
| pageSize | int | 每页返回条数 | 10 |
| success | boolean | 是否成功 | true |
| total | int | 总数 | 10 |
| withholding_money | int | 11 | 该接口扣费金额（点券） |
返回数据
{
"code": 0,
"msg": "操作成功",
"msec": 1460,
"time": 1617273033,
"data": {
"withholding_money": 1,
}
}
响应代码
| 代码 | 代码描述 | 解决方案 |
|---|---|---|
| 0 | 成功 | |
| 100 | 请求参数错误 | 检查您的请求参数是否正确 |
| 101 | 请求超时，请重试 | 检查您的网络情况或者联系客服解决 |
| 103 | 旺旺账号不存在 | 检查您输入的旺旺号是否正确 |
| 200 | 系统错误，请联系客服 | 检查您的接口地址填写是否正确，其他问题联系客服解决 |
| 203 | 暂不支持当前接口 | |
| 204 | 请求异常：无该接口权限，请前往官网开通正式接口。 | 前往官网开通该接口权限 |
| 204 | 请求异常：API 调用次数不足，请前往网站兑换次数。 | 前往官网充值该接口调用次数 |
| 302 | 未授权店铺 | 根据返回链接进行扫码授权 |
| 401 | 身份凭证无效 | 在请求头中添加 access_token |