全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试

查询卖家收到的退款列表


接口地址: http://api.vv-tool.com/tool/erps/egetreceive


接口介绍: 查询卖家收到的退款列表


请求方式: POST


返回格式: JSON


接口收费: 联系客服


频率限制: 10 次/秒


请求头参数

参数 类型 必选 示例
Authorization string 授权 access_token Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx

请使用新的生成 token 接口 点击查看详情

请求参数

参数 类型 必选 描述
shop_id Number 店铺 id
fields String[] 需要返回的字段。目前支持有:refund_id, tid, title, buyer_nick, seller_nick, total_fee, status, created, refund_fee, oid, good_status, company_name, sid, payment, reason, desc, has_good_return, modified, order_status,refund_phase
status String 退款状态,默认查询所有退款状态的数据,除了默认值外每次只能查询一种状态。WAIT_SELLER_AGREE(买家已经申请退款,等待卖家同意) WAIT_BUYER_RETURN_GOODS(卖家已经同意退款,等待买家退货) WAIT_SELLER_CONFIRM_GOODS(买家已经退货,等待卖家确认收货) SELLER_REFUSE_BUYER(卖家拒绝退款) CLOSED(退款关闭) SUCCESS(退款成功)
buyer_nick String 买家昵称
type String 交易类型列表,一次查询多种类型可用半角逗号分隔,默认同时查询 guarantee_trade, auto_delivery 这两种类型的数据,查看可选值
start_modified Date 查询修改时间开始。格式: yyyy-MM-dd HH:mm:ss
end_modified Date 查询修改时间结束。格式: yyyy-MM-dd HH:mm:ss
page_no Number 页码。取值范围:大于零的整数; 默认值:1
page_size Number 每页条数。取值范围:大于零的整数; 默认值:40;最大值:100
use_has_next Boolean 是否启用 has_next 的分页方式,如果指定 true,则返回的结果中不包含总记录数,但是会新增一个是否存在下一页的的字段,通过此种方式获取增量退款,接口调用成功率在原有的基础上有所提升。
ouid String 系统自动生成
vvtype Number 2 高级版(必须填 2,不填默认是 2)

请求示例

请求代码示例

cURL请求代码示例

PHP请求代码示例


JAVA请求代码示例


响应参数

名称 类型 示例值 描述
total_results Number 100 搜索到的退款信息总数
has_next Boolean true 是否存在下一页
refunds Refund [] 搜索到的退款信息列表
--refund_id String 83477 退款单号
--tid Number 2231884277 淘宝交易单号
--oid Number 2231884277 子订单号。如果是单笔交易 oid 会等于 tid
--total_fee String 10.00 交易总金额。精确到 2 位小数;单位:元。如:200.07,表示:200 元 7 分
--buyer_nick String tbtest561 买家昵称
--seller_nick String tbtest869 卖家昵称
--created Date 2000-01-01 00:00:00 退款申请时间。格式:yyyy-MM-dd HH:mm:ss
--modified Date 2000-01-01 00:00:00 更新时间。格式:yyyy-MM-dd HH:mm:ss
--order_status String BUYER_RECEIVED 退款对应的订单交易状态。可选值 TRADE_NO_CREATE_PAY(没有创建支付宝交易) WAIT_BUYER_PAY(等待买家付款) WAIT_SELLER_SEND_GOODS(等待卖家发货,即:买家已付款) WAIT_BUYER_CONFIRM_GOODS(等待买家确认收货,即:卖家已发货) TRADE_BUYER_SIGNED(买家已签收,货到付款专用) TRADE_FINISHED(交易成功) TRADE_CLOSED(交易关闭) TRADE_CLOSED_BY_TAOBAO(交易被淘宝关闭) ALL_WAIT_PAY(包含:WAIT_BUYER_PAY、TRADE_NO_CREATE_PAY) ALL_CLOSED(包含:TRADE_CLOSED、TRADE_CLOSED_BY_TAOBAO) 取自"http://open.taobao.com/dev/index.php/%E4%BA%A4%E6%98%93%E7%8A%B6%E6%80%81"
--status String SUCCESS 退款状态。可选值 WAIT_SELLER_AGREE(买家已经申请退款,等待卖家同意) WAIT_BUYER_RETURN_GOODS(卖家已经同意退款,等待买家退货) WAIT_SELLER_CONFIRM_GOODS(买家已经退货,等待卖家确认收货) SELLER_REFUSE_BUYER(卖家拒绝退款) CLOSED(退款关闭) SUCCESS(退款成功)
--good_status String BUYER_RECEIVED 货物状态。可选值 BUYER_NOT_RECEIVED (买家未收到货) BUYER_RECEIVED (买家已收到货) BUYER_RETURNED_GOODS (买家已退货)
--has_good_return Boolean true 买家是否需要退货。可选值:true(是),false(否)
--refund_fee String 10.00 退还金额(退还给买家的金额)。精确到 2 位小数;单位:元。如:200.07,表示:200 元 7 分
--payment String 200.07 支付给卖家的金额(交易总金额-退还给买家的金额)。精确到 2 位小数;单位:元。如:200.07,表示:200 元 7 分
--reason String 退还邮费 退款原因
--desc String hello world 退款说明
--title String 天堂伞龙井茶 商品标题
--num Number 1 商品购买数量
--company_name String 申通快递 物流公司名称
--sid String 123456789 退货运单号
--refund_phase String onsale 退款阶段,可选值:onsale/aftersale
--refund_version Number 1411375308927 退款版本号(时间戳)
--sku String 30004447689 颜色分类:军绿色;尺码:XS
--attribute String {"key1":"value1", "key2":"value2"} 退款扩展属性
--outer_id String ISBN-001 商品外部商家编码
--operation_contraint String refund_onweb 退款约束,可选值:cannot_refuse(不允许操作),refund_onweb(需要到网页版操作)
--ouid String iuwekjhffd ouid
withholding_money Number 该接口扣费金额(点券)

返回数据

{"code": 0, "msg": "操作成功", "msec": 1469, "time": 1617270403, "data": {"withholding_money": 1,"refunds_receive_get_response": {"total_results": 100, "has_next": true, "refunds": {"refund": [{"refund_id": "83477", "tid": 2231884277, "oid": 2231884277, "total_fee": "10.00", "buyer_nick": "tbtest561", "seller_nick": "tbtest869", "created": "2000-01-01 00:00:00", "modified": "2000-01-01 00:00:00", "order_status": "BUYER_RECEIVED", "status": "SUCCESS", "good_status": "BUYER_RECEIVED", "has_good_return": true, "refund_fee": "10.00", "payment": "200.07", "reason": "退还邮费", "desc": "hello world", "title": "天堂伞龙井茶", "num": 1, "company_name": "申通快递", "sid": "123456789", "refund_phase": "onsale", "refund_version": 1411375308927, "sku": "30004447689|颜色分类:军绿色;尺码:XS", "attribute": "{"key1":"value1", "key2":"value2"}", "outer_id": "ISBN-001", "operation_contraint": "refund_onweb", "ouid": "iuwekjhffd"}]}}}}

响应代码

代码 代码描述 解决方案
0 成功
100 请求参数错误 检查您的请求参数是否正确
101 请求超时,请重试 检查您的网络情况或者联系客服解决
103 旺旺账号不存在 检查您输入的旺旺号是否正确
200 系统错误,请联系客服 检查您的接口地址填写是否正确,其他问题联系客服解决
203 暂不支持当前接口
204 请求异常:无该接口权限,请前往官网开通正式接口。 前往官网开通该接口权限
204 请求异常:API 调用次数不足,请前往网站兑换次数。 前往官网充值该接口调用次数
302 未授权店铺 根据返回链接进行扫码授权