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