全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试
查询退款单详情-根据退款单 ID
接口地址: http://api.vv-tool.com/tool/erps/1688id-order-refund
接口介绍: 查询退款单详情-根据退款单 ID
必须用户授权 : 需要用户的授权,才能拿到被授权的数据
请求方式: POST
返回格式: JSON
接口收费: 联系运营
频率限制: 10 次/秒
请求头参数
参数 | 类型 | 必选 | 值 | 示例 |
---|---|---|---|---|
Authorization | string | 是 | 授权 access_token | Bearer 1798c6aadec33d1bc2f5b707f1049aefeaawf |
请求参数
参数 | 类型 | 必选 | 描述 |
---|---|---|---|
shop_id | string | 是 | 店铺 id |
refund_id | string | 是 | 退款单业务主键 TQ+ID |
need_time_out_info | bool | 否 | 需要退款单的超时信息 |
need_order_refund_operation | bool | 否 | 需要退款单伴随的所有退款操作信息 |
请求示例
{
'refund_id': 'TQ865149372**61198',
'need_time_out_info': true,
'need_order_refund_operation': true
}
请求代码示例
cURL请求代码示例
curl --location --request POST 'http://api.vv-tool.com/tool/erps/1688id-order-refund' --header 'Authorization: Bearer 1798c6aadec33d1bc2f5b707f1049aefeaawf' --data-raw '{
'refund_id': 'TQ865149372**61198',
'need_time_out_info': true,
'need_order_refund_operation': true
}'
PHP请求代码示例
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'http://api.vv-tool.com/tool/erps/1688id-order-refund',
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 =>'{
'refund_id': 'TQ865149372**61198',
'need_time_out_info': true,
'need_order_refund_operation': true
}',
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('text/plain');
RequestBody body = RequestBody.create(mediaType, '{
'refund_id': 'TQ865149372**61198',
'need_time_out_info': true,
'need_order_refund_operation': true
}');
Request request = new Request.Builder()
.url('http://api.vv-tool.com/tool/erps/1688id-order-refund')
.method('POST', body)
.addHeader('Authorization', 'Bearer 1798c6aadec33d1bc2f5b707f1049aefeaawf')
.build();
Response response = client.newCall(request).execute();
响应参数
名称 | 类型 | 描述 |
---|---|---|
code | int | 返回状态码 |
msg | string | 返回码描述 |
msec | int | 接口执行时间 |
time | int | 接口返回时间 |
data | object | 数据信息 |
--op_order_refund_model_detail | object | 退款模型 |
----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 |
--withholding_money | int | 该接口扣费金额(点券) |
返回数据
{
'code': 0,
'msg': '操作成功',
'msec': 1469,
'time': 1617270403,
'data': {
'op_order_refund_model_detail': {
'alipay_payment_id': '2018042321001008760555342267',
'apply_carriage': 0,
'apply_payment': 1,
'apply_reason': '颜色/图案/款式不符',
'apply_reason_id': 20021,
'apply_sub_reason_id': 0,
'buyer_logistics_name': '其他',
'buyer_member_id': 'b2b-1624961198',
'buyer_send_goods': true,
'buyer_user_id': 1624961198,
'can_refund_payment': 1,
'crm_modify_refund': false,
'dispute_request': 3,
'dispute_type': 1,
'ext_info': {
'exmrf': '1',
'ttid': '2',
'prepaid_failure': 'querybuyercreditlevelfail',
'paylock': 'seller',
'reason': '20021',
'applytextid': 'null',
'new_refund': 'rp2',
'biz_code': 'cbu.general.refund',
'dispute_trade_status': '4',
'last_order': '0',
'selleragreedrefundfee': '1',
'oldreasonid': '20021',
'sync': '0',
'b2bsellerm_id': 'b2b-1623492085',
'sellerbatch': 'true',
'item_buy_amount': '0',
'b2bbuyerm_id': 'b2b-1624961198',
'ability': '1',
'refund_post_fee': '0',
'selleraudit': '0',
'eetraceid': '0b802ca915244768332374685efa19',
'oltf': '1',
'op_role': 'user',
'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',
'seller_do_refund_nick': 'alitestforisv01',
'bgmtc': '2018-04-23 09: 48: 12'
},
'freight_bill': '12345134135435234',
'frozen_fund': -1,
'gmt_apply': '20180423171116000+0800',
'gmt_completed': '20180423174713000+0800',
'gmt_create': '20180423171116000+0800',
'gmt_modified': '20180423174714000+0800',
'goods_received': true,
'goods_status': 3,
'id': 8651493722961198,
'new_refund_return': true,
'only_refund': false,
'order_entry_count_map': {
'151267031009969811': 2
},
'order_entry_id_list': [151267031009969811],
'order_id': 151267031008969811,
'product_name': '欧洲站2018新款宽松显瘦烫金印花字母老鹰短袖t恤打底裤套装女潮',
'refund_carriage': 0,
'refund_goods': true,
'refund_id': 'tq8651493722961198',
'refund_payment': 1,
'reject_reason_id': 0,
'reject_times': 0,
'seller_delay_disburse': false,
'seller_member_id': 'b2b-1623492085',
'seller_mobile': '19926555555',
'seller_real_name': '琳琳',
'seller_receive_address': '山东 聊城 解决了交流交流链接连接',
'seller_user_id': 1623492085,
'status': 'refundsuccess',
'support_new_steppay': true,
'time_out_freeze': false,
'trade_type_str': '50060',
'refund_operation_list': [{
'after_operate_status': 'waitsellerreceive',
'before_operate_status': 'waitsellerreceive',
'close_refund_step_id': 0,
'crm_modify_refund': false,
'discription': '卖家同意退货退款协议,退货退款成功',
'gmt_create': '20180423174714000+0800',
'gmt_modified': '20180423174714000+0800',
'id': 50027795018,
'message_status': 3,
'msg_type': 7,
'operate_remark': '退款成功',
'operate_type_int': 8,
'operator_login_id': 'alitestforisv01',
'operator_role_id': 2,
'operator_user_id': 1623492085,
'refund_id': 'tq8651493722961198'
},
{
'after_operate_status': 'waitbuyersend',
'before_operate_status': 'waitbuyersend',
'close_refund_step_id': 0,
'crm_modify_refund': false,
'discription': '买家声明退货,等待卖家确认。|物流公司:其他|物流单号:12345134135435234|说明:asdada|',
'gmt_create': '20180423174651000+0800',
'gmt_modified': '20180423174651000+0800',
'id': 50027571423,
'message_status': 3,
'msg_type': 7,
'operate_remark': '买家退货',
'operate_type_int': 10,
'operator_login_id': 'alitestforisv02',
'operator_role_id': 1,
'operator_user_id': 1624961198,
'refund_id': 'tq8651493722961198'
},
{
'after_operate_status': 'waitselleragree',
'before_operate_status': 'waitselleragree',
'close_refund_step_id': 0,
'crm_modify_refund': false,
'discription': '卖家确认收货地址:琳琳,
19926555555,
山东 聊城 解决了交流交流链接连接',
'gmt_create': '20180423174544000+0800',
'gmt_modified': '20180423174544000+0800',
'id': 49967844797,
'message_status': 3,
'msg_type': 7,
'operate_remark': '确认收货地址',
'operate_type_int': 19,
'operator_login_id': 'alitestforisv01',
'operator_role_id': 2,
'operator_user_id': 1623492085,
'refund_id': 'tq8651493722961198'
},
{
'close_refund_step_id': 0,
'crm_modify_refund': false,
'discription': '退款诉求:退货退款|申请原因:颜色/图案/款式不符|货品情况:已收到货|退款货品金额:0.01|退款运费金额:0.00|退款说明:asdad',
'gmt_create': '20180423171116000+0800',
'gmt_modified': '20180423171116000+0800',
'id': 49962356896,
'message_status': 3,
'msg_type': 7,
'operate_remark': '买家申请退款协议,等待卖家确认',
'operate_type_int': 1,
'operator_login_id': 'alitestforisv02',
'operator_role_id': 1,
'operator_user_id': 1624961198,
'refund_id': 'tq8651493722961198'
}],
'buyer_login_id': 'alitestforisv02',
'seller_login_id': 'alitestforisv01'
}
}
}
响应代码
代码 | 代码描述 | 解决方案 |
---|---|---|
0 | 成功 | |
100 | 请求参数错误 | 检查您的请求参数是否正确 |
101 | 请求超时,请重试 | 检查您的网络情况或者联系客服解决 |
103 | 旺旺账号不存在 | 检查您输入的旺旺号是否正确 |
200 | 系统错误,请联系客服 | 检查您的接口地址填写是否正确,其他问题联系客服解决 |
202 | 系统错误,请稍后再试 | 稍后重试,或者联系对接群 |
203 | 暂不支持当前接口 | |
204 | 请求异常:无该接口权限,请前往官网开通正式接口。 | 前往官网开通该接口权限 |
204 | 请求异常:API 调用次数不足,请前往网站兑换次数。 | 前往官网充值该接口调用次数 |
302 | 未授权店铺 | 根据返回链接进行扫码授权 |