全部
淘宝
拼多多
抖音
京东
快手
当当
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 描述、说明
------email 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 未授权店铺 根据返回链接进行扫码授权