全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试
查询退款单列表(卖家视角)
接口地址: http://api.vv-tool.com/tool/erps/1688order-refund-list
接口介绍: 查询退款单列表(卖家视角)
必须用户授权 : 需要用户的授权,才能拿到被授权的数据
请求方式: POST
返回格式: JSON
接口收费: 联系运营
频率限制: 10 次/秒
请求头参数
参数 | 类型 | 必选 | 值 | 示例 |
---|---|---|---|---|
Authorization | string | 是 | 授权 access_token | Bearer 1798c6aadec33d1bc2f5b707f1049aefeaawf |
请求参数
参数 | 类型 | 必选 | 描述 |
---|---|---|---|
shop_id | string | 是 | 店铺 id |
order_id | int | 否 | 订单 Id |
apply_start_time | string | 否 | 退款申请时间(起始) |
apply_end_time | string | 否 | 退款申请时间(截止) |
refund_status_set | java.util.Set | 否 | 退款状态列表 |
buyer_member_id | string | 否 | 买家 memberId |
buyer_login_id | string | 否 | 买家 loginId |
current_page_num | int | 否 | 查询页码,起始页码为 0 |
page_size | int | 否 | 页大小 |
logistics_no | string | 否 | 退货运单号 |
modify_start_time | string | 否 | 退款修改时间(起始) |
modify_end_time | string | 否 | 退款修改时间(截止) |
dipsute_type | int | 否 | 1:售中退款,2:售后退款;0:所有退款单 |
请求示例
{
'order_id': 179087886005498520
}
请求代码示例
cURL请求代码示例
curl --location --request POST 'http://api.vv-tool.com/tool/erps/1688modify_order_price' --header 'Authorization: Bearer 1798c6aadec33d1bc2f5b707f1049aefeaawf' --header 'Content-Type: application/json' --data-raw '{
'order_id': 1111204496116440,
'carriage': 200,
'entry_discounts': [
{
'id': 1111204496116440,
'discount': 20
}
]
}'
PHP请求代码示例
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'http://api.vv-tool.com/tool/erps/1688modify_order_price',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS =>'{
'order_id': 1111204496116440,
'carriage': 200,
'entry_discounts': [
{
'id': 1111204496116440,
'discount': 20
}
]
}',
CURLOPT_HTTPHEADER => array(
'Authorization: Bearer 1798c6aadec33d1bc2f5b707f1049aefeaawf'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
JAVA请求代码示例
OkHttpClient client = new OkHttpClient().newBuilder()
.build();
MediaType mediaType = MediaType.parse('application/json');
RequestBody body = RequestBody.create(mediaType, '{
'order_id': 1111204496116440,
'carriage': 200,
'entry_discounts': [
{
'id': 1111204496116440,
'discount': 20
}
]
}');
Request request = new Request.Builder()
.url('http://api.vv-tool.com/tool/erps/1688modify_order_price')
.method('POST', body)
.addHeader('Authorization', 'Bearer 1798c6aadec33d1bc2f5b707f1049aefeaawf')
.addHeader('Content-Type', 'application/json')
.build();
Response response = client.newCall(request).execute();
响应参数
名称 | 类型 | 描述 |
---|---|---|
code | int | 返回状态码 |
msg | string | 返回码描述 |
msec | int | 接口执行时间 |
time | int | 接口返回时间 |
data | object | 数据信息 |
--op_order_refund_models | array | 退款单列表 |
----aftersale_agree_timeout | bool | 售后超时标记 |
----aftersale_auto_disburse | bool | 售后自动打款 |
----alipay_payment_id | string | 支付宝交易号 |
----apply_carriage | int | 运费的申请退款金额,单位:分 |
----apply_expect | int | 买家原始输入的退款金额(可以为空) |
----apply_payment | int | 买家申请退款金额,单位:分 |
----apply_reason | string | 申请原因 |
----apply_reason_id | int | 申请原因 ID |
----apply_sub_reason | string | 二级退款原因 |
----apply_sub_reason_id | int | 二级退款原因 Id |
----asyn_err_code | string | |
----asyn_sub_err_code | string | |
----buyer_alipay_id | string | 买家支付宝 ID |
----buyer_logistics_name | string | 买家退货物流公司名 |
----buyer_member_id | string | 买家会员 ID |
----buyer_send_goods | bool | 买家是否已经发货(如果有退货的流程) |
----buyer_user_id | int | 买家阿里帐号 ID(包括淘宝帐号 Id) |
----can_refund_payment | int | 最大能够退款金额,单位:分 |
----crm_modify_refund | bool | 是否小二修改过退款单 |
----disburse_channel | string | 极速到账打款渠道 |
----dispute_request | int | 售后退款要求 |
----dispute_type | int | 纠纷类型:售中退款 售后退款,默认为售中退款 |
----ext_info | object | 扩展信息 |
----freight_bill | string | 运单号 |
----frozen_fund | long | 实际冻结账户金额,单位:分 |
----gmt_apply | string | 申请退款时间 |
----gmt_completed | string | 完成时间 |
----gmt_create | string | 创建时间 |
----gmt_freezed | string | 该退款单超时冻结开始时间 |
----gmt_modified | string | 修改时间 |
----gmt_time_out | string | 该退款单超时完成的时间期限 |
----goods_received | bool | 买家是否已收到货 |
----goods_status | int | 1:买家未收到货 2:买家已收到货 3:买家已退货 |
----id | int | 退款单编号 |
----instant_refund_type | string | 极速到账退款类型 |
----insufficient_account | bool | 交易 4.0 退款余额不足 |
----insufficient_bail | bool | 极速到账退款保证金不足 |
----new_refund_return | bool | 是否新流程创建的退款退货 |
----only_refund | bool | 是否仅退款 |
----order_entry_count_map | object | 子订单退货数量 |
----order_entry_id_list | array | 退款单包含的订单明细,时间逆序排列 |
----order_id | int | 退款单对应的订单编号 |
----prepaid_balance | int | 极速退款垫资金额,该值不为空时,只代表该退款单可以走垫资流程,但不代表一定垫资成功 |
----product_name | string | 产品名称(退款单关联订单明细的货品名称) |
----refund_carriage | int | 运费的实际退款金额,单位:分 |
----refund_goods | bool | 是否要求退货 |
----refund_id | string | 退款单逻辑主键 |
----refund_payment | int | 实际退款金额,单位:分 |
----reject_reason | string | 卖家拒绝原因 |
----reject_reason_id | int | 卖家拒绝原因 Id |
----reject_times | int | 退款单被拒绝的次数 |
----seller_alipay_id | string | 卖家支付宝 ID |
----seller_delay_disburse | bool | 是否卖家延迟打款,即安全退款 |
----seller_member_id | string | 卖家会员 ID |
----seller_mobile | string | 收货人手机 |
----seller_real_name | string | 收货人姓名 |
----seller_receive_address | string | 买家退货时卖家收货地址 |
----seller_tel | string | 收货人电话 |
----seller_user_id | int | 卖家阿里帐号 ID(包括淘宝帐号 Id) |
----status | string | 退款状态 |
----support_new_steppay | bool | 是否支持交易 4.0 |
----task_status | string | 工单子状态,没有流到 CRM 创建工单时为空 |
----time_out_freeze | bool | 是否超时系统冻结,true 代表冻结,false 代表不冻结 |
----time_out_operate_type | string | 超时后执行的动作 |
----trade_type_str | string | 交易类型,用来替换枚举类型的 tradeType |
----refund_operation_list | array | 操作记录列表 |
------after_operate_status | string | 操作后的退款状态 |
------before_operate_status | string | 操作前的退款状态 |
------close_refund_step_id | long | 分阶段订单正向操作关闭退款时的阶段 ID |
------crm_modify_refund | bool | 是否小二修改过退款单 |
------discription | string | 描述、说明 |
string | 联系人 EMAIL | |
------freight_bill | string | 运单号 |
------gmt_create | string | 创建时间 |
------gmt_modified | string | 修改时间 |
------id | int | 主键,退款操作记录流水号 |
------message_status | int | 凭证状态,1:正常 2:后台小二屏蔽 |
------mobile | string | 联系人手机 |
------msg_type | int | 留言类型 3:小二留言给买家和卖家 4:给买家的留言 5:给卖家的留言 7:cbu 的普通留言等同于淘宝的 1 |
------operate_remark | string | 操作备注 |
------operate_type_int | int | 操作类型 取代 operateType |
------operator_id | string | 操作者-memberID |
------operator_login_id | string | 操作者-loginID |
------operator_role_id | int | 操作者角色名称 买家 卖家 系统 |
------operator_user_id | int | 操作者-userID |
------phone | string | 联系人电话 |
------refund_address | string | 退货地址 |
------refund_id | string | 退款记录 ID |
------reject_reason | string | 卖家拒绝退款原因 |
------vouchers | array | 凭证图片地址 |
------logistics_company | object | 物流公司详情 |
--------company_name | string | 快递公司名 |
--------company_no | string | 物流公司编号 |
--------company_phone | string | 物流公司服务电话 |
--------gmt_create | string | 创建时间 |
--------gmt_modified | string | 修改时间 |
--------id | int | ID |
--------spelling | string | 全拼 |
--------support_print | bool | 是否支持打印 |
----buyer_login_id | string | 买家 LoginId |
----seller_login_id | string | 卖家 LoginId |
----total_count | int | 符合条件总的记录条数 |
----current_page_num | int | 查询的当前页码 |
--withholding_money | int | 该接口扣费金额(点券) |
返回数据
{
'code': 0,
'msg': '操作成功',
'msec': 1469,
'time': 1617270403,
'data': {
'op_order_refund_models': [
{
'alipay_payment_id': '2018061421001008760569923894',
'apply_carriage': 0,
'apply_payment': 1,
'apply_reason': '不想买了,已与卖家协商一致',
'apply_reason_id': 20028,
'apply_sub_reason_id': -1,
'buyer_member_id': 'b2b-1624961198',
'buyer_user_id': 1624961198,
'can_refund_payment': 1,
'dispute_request': 3,
'dispute_type': 1,
'ext_info': {
'exmrf': '1',
'ttid': '2',
'reason': '20028',
'applytextid': 'null',
'new_refund': 'rp2',
'biz_code': 'cbu.general.refund',
'last_order': '0',
'selleragreedrefundfee': '1',
'oldreasonid': '20028',
'b2bsellerm_id': 'b2b-1623492085',
'sellerbatch': 'true',
'item_buy_amount': '0',
'b2bbuyerm_id': 'b2b-1624961198',
'ability': '1',
'selleraudit': '0',
'eetraceid': '0ab2dbd215300798520175927d07d3',
'oltf': '0',
'op_role': 'timeout',
'applyinitrefundfee': '1',
'is_virtual': '0',
'logistics_company_id': '-1',
'item_price': '0',
'intercept_status': '0',
'refund_from': '2',
'restart_for_xiaoer': '1',
'app_name': 'tosp-aftersales',
'abnormaldisputestatus': '0',
'pay_mode': 'alipay',
'workflow_name': 'cbureturnandrefund',
'sgr': '1',
'enfunddetail': '1',
'bgmtc': '2018-06-14 14: 20: 21'
},
'frozen_fund': -1,
'gmt_apply': '20180622141034000+0800',
'gmt_completed': '20180702141113000+0800',
'gmt_create': '20180622141034000+0800',
'gmt_modified': '20180702141113000+0800',
'goods_status': 2,
'id': 10426553019961198,
'order_id': 177681528398969820,
'product_name': '短袖撞色领保罗衫定做纯棉广告衫定制印字logo刺绣男现货批发 白色/橙领 s等3种',
'refund_carriage': 0,
'refund_id': 'tq10426553019961198',
'refund_payment': 1,
'reject_reason_id': 0,
'reject_times': 0,
'seller_member_id': 'b2b-1623492085',
'seller_user_id': 1623492085,
'status': 'refundclose'
}
],
'total_count': 1,
'current_page_num': 0
}
}
响应代码
代码 | 代码描述 | 解决方案 |
---|---|---|
0 | 成功 | |
100 | 请求参数错误 | 检查您的请求参数是否正确 |
101 | 请求超时,请重试 | 检查您的网络情况或者联系客服解决 |
103 | 旺旺账号不存在 | 检查您输入的旺旺号是否正确 |
200 | 系统错误,请联系客服 | 检查您的接口地址填写是否正确,其他问题联系客服解决 |
202 | 系统错误,请稍后再试 | 稍后重试,或者联系对接群 |
203 | 暂不支持当前接口 | |
204 | 请求异常:无该接口权限,请前往官网开通正式接口。 | 前往官网开通该接口权限 |
204 | 请求异常:API 调用次数不足,请前往网站兑换次数。 | 前往官网充值该接口调用次数 |
302 | 未授权店铺 | 根据返回链接进行扫码授权 |