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