ECJiaWiki:Api:refund/detail
跳到导航
跳到搜索
目录
应用场景
退款详情
接口名称
refund/detail
请求参数
字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
---|---|---|---|---|---|
token请求凭证 | token | 是 | String | 79218f8e710fc755a222de45f43c3fd969b87972 | 调用接口凭证 |
退款申请编号 | refund_sn | 是 | string | 退款申请编号 |
举例如下
{
"token" : "d122e3c72332c5af12a71d77c9f1462f5901d276",
"refund_sn" : "36547896231456"
}
返回参数
字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
---|---|---|---|---|---|
返回状态码 | status | 是 | Array() | {"succeed" : 1} | 返回请求接口后的数据,succeed为1代表成功,0则为失败,失败后则返回error_code(错误code)及error_desc(错误说明) |
返回信息 | data | 是 | data字典 | 请求接口提供的返回信息 | |
└ 订单编号 | order_sn | 是 | string | 到家1.27新增 | 订单编号 |
└ 售后申请编号 | refund_sn | 是 | string | 售后申请编号 | |
└ 店铺联系方式 | store_service_phone | 是 | string | 店铺联系方式 | |
└ 售后申请类型 | refund_type | 是 | string | 售后申请类型(refund仅退款,return退货退款) | |
└ 售后申请类型(中文) | label_refund_type | 是 | string | 售后申请类型(仅退款,退货退款) | |
└ 售后申请状态 | status | 是 | string | 售后申请状态(uncheck待审核,agree同意,canceled已取消,refused拒绝) | |
└ 售后申请状态(中文) | label_status | 是 | string | 售后申请状态(待审核,同意,已取消,拒绝) | |
└ 退款状态 | refund_status | 是 | string | 退款状态(await_check待审核,checked已审核,refunded已退款) | |
└ 售后申请状态(中文) | label_refund_status | 是 | string | 售后申请状态(待审核,已审核,已退款) | |
└ 退商品金额 | refund_goods_amount | 是 | String | 退商品金额 | |
└ 退配送费 | refund_shipping_fee | 是 | String | 退配送费 | |
└ 退发票费 | refund_inv_tax | 是 | String | 退发票费 | |
└ 退积分 | refund_integral | 是 | String | 退积分 | |
└ 退总金额 | refund_total_amount | 是 | String | 退总金额 | |
└ 原因id | reason_id | 是 | String | 原因id | |
└ 原因 | reason | 是 | String | 原因 | |
└ 退款问题描述 | refund_desc | 是 | String | 退款问题描述 | |
└ 用户地址 | user_address | 是 | String | 用户地址 | |
└ 商家拒绝原因 | refused_reasons | 是 | array | 商家拒绝原因 | |
└ 原因id | reason_id | 是 | int | 原因id | |
└ 原因名称 | reason_name | 是 | string | 原因名称 | |
└ 售后图片 | return_images | 是 | array | 售后图片 | |
└ 可用的退货返还方式 | return_way_list | 否(商家同意且提供返还方式时返) | array | 可用的退货返还方式 | |
└ 退货返还方式名称 | return_way_name | 是 | string | 退货返还方式名称 | |
└ 退货返还方式code | return_way_code | 是 | string | 退货返还方式code | |
└ 取件地址 | pickup_address | 是 | string | 取件地址 | |
└ 取件联系人 | contact_name | 是 | string | 取件联系人 | |
└ 取件联系人手机 | contact_phone | 是 | string | 取件联系人手机 | |
└ 取件时间段 | expect_pickup_date | 否(上门取件方式有) | expect_pickup_date字典 | 取件时间段 | |
└ 取件日期 | dates | 否 | array | 取件日期 | |
└ 时间 | times | 否 | array | 时间 | |
└ 开始时间 | start_time | 否 | string | 开始时间 | |
└ 结束时间 | end_time | 否 | string | 结束时间 | |
└ 用户所选的返还方式信息 | selected_returnway_info | 否(有选返还方式时返回) | selected_returnway_info字典 | 用户所选的返还方式信息 | |
└ 用户所选的返还方式code | return_way_code | 是 | string | 用户所选的返还方式code(home上门取件,express自选快递,shop到店退货) | |
└ 用户所选的返还方式 | return_way_name | 是 | string | 用户所选的退货返还方式(上门取件,自选快递,到店退货) | |
└ 联系电话 | contact_phone | 是 | string | 联系电话 | |
└ 取件地址 | pickup_address | 是(用户选了上门取件时返) | string | 取件地址 | |
└ 期望取件时间 | expect_pickup_time | 是(用户选了上门取件时返) | string | 期望取件时间 | |
└ 联系人 | contact_name | 是(用户选了上门取件时返) | string | 联系人 | |
└ 收件人地址 | recipient_address | 是(用户选了自选快递时返) | string | 收件人地址 | |
└ 收件人 | recipients | 是(用户选了自选快递时返) | string | 收件人 | |
└ 快递名称 | shipping_name | 是(用户选了自选快递时返) | string | 快递名称 | |
└ 快递单号 | shipping_name | 是(用户选了自选快递时返) | string | 快递单号 | |
└ 店铺地址 | store_address | 是(用户选了到店退货时返) | string | 店铺地址 | |
└ 店铺名称 | store_name | 是(用户选了到店退货时返) | string | 店铺名称 | |
└ 退款进度日志 | refund_logs | 是 | Array | 退款进度日志 | |
└ 退款进度说明 | log_description | 是 | String | 退款进度说明 | |
└ 处理时间 | formatted_action_time | 是 | String | 处理时间 | |
└ 当前状态(中文) | label_status | 是 | String | 当前状态(待审核,同意,已取消,拒绝退款) | |
└ 商品信息 | goods_list | 是 | Array | 商品信息 | |
└ 商品id | goods_id | 是 | Int | 商品id | |
└ 商品名 | name | 是 | String | 商品名 | |
└ 商品价格 | goods_price | 是 | String | 商品价格 | |
└ 商品价格(格式化) | formated_goods_price | 是 | String | 商品价格 | |
└ 商品属性 | goods_attr | 是 | string | 商品属性 | |
└ 商品数量 | goods_number | 是 | Int | 2 | 商品数量 |
└ 图片信息 | img | 是 | img字典 | 图片信息 | |
└ 小图 | small | 是 | String | "![]() |
小图 |
└ 小图 | thumb | 是 | String | "![]() |
缩略图 |
└ 原图 | url | 是 | String | "![]() |
原图 |
成功举例如下
{
"data": {
"order_sn":"2017101717124", //1.27新增
"refund_sn": "65432198756423",
"store_service_phone":"4001-021-758",
"status":"uncheck",
"refund_type": "refund",
"label_refund_type": "仅退款",
"refund_status": "await_check",
"label_refund_status": "待审核",
"refund_goods_amount": "¥100.00",
"refund_shipping_fee": 0,
"refund_inv_tax":"¥0.00",
"refund_integral":0,
"refund_total_amount": "¥95.00",
"reason_id":1,
"reason":"商品质量问题",
"refund_desc":"商品质量太差",
"user_address":"长风公园",
"refused_reasons": [
{
"reason_id": 91,
"reason_name": "暂时不想购买了"
},
{
"reason_id": 92,
"reason_name": "信息填写有误,重新购买"
},
{
"reason_id": 93,
"reason_name": "外表损伤(包装,商品等)"
},
{
"reason_id": 94,
"reason_name": "商品质量问题"
},
{
"reason_id": 95,
"reason_name": "发错货"
},
{
"reason_id": 96,
"reason_name": "未在时效内送达"
},
{
"reason_id": 97,
"reason_name": "服务态度问题"
}
],
"return_images": [
"https://cityo2o.ecjia.com/content/uploads/images/201610/goods_img/1075_P_1477612303654.jpg",
"https://cityo2o.ecjia.com/content/uploads/images/201610/goods_img/1075_P_1477612303654.jpg"
],
"return_way_list":[
{
"return_way_code":"home",
"return_way_name":"上门取件",
"pickup_address":"上海火车站",
"contact_name":"张三",
"contact_phone":"13468678174",
"expect_pickup_date": [{
"dates":[
"2018-01-22",
"2018-01-23",
"2018-01-24",
"2018-01-25",
"2018-01-26",
"2018-01-27",
"2018-01-28"
],
"times": [
{
"start_time": "13:00",
"end_time": "15:00"
},
{
"start_time": "16:00",
"end_time": "18:00"
},
{
"start_time": "19:00",
"end_time": "21:00"
}
]
}]
},
{
"return_way_code":"shop",
"return_way_name":"到店退货",
"store_name":"宅鲜配",
"store_service_phone":"4001-021-758",
"store_address":"上海市普陀区长风街道中山北路3553号伸大厦301室"
},
{
"return_way_code":"express",
"return_way_name":"自选快递",
"recipients":"张三",
"contact_phone":"13468678174",
"recipient_address":"上海市普陀区长风街道中山北路3553号伸大厦301室"
}
],
"selected_returnway_info":{
"return_way_code":"home",
"return_way_name":"上门取件",
"pickup_address":"上海市普陀区长风街道中山北路3553号伸大厦301室",
"expect_pickup_time":"2018-01-2 09:00-12:00",
"contact_name":"张三",
"contact_phone":"4001-021-758"
}
"refund_logs" : [{
"log_description" : "您的服务单已申请成功!",
"formatted_action_time" : "2017-01-09 12:12:12",
"label_status":"待审核"
}],
"goods_list": [
{
"goods_id": "1146",
"name": "大瀛 盐水鸭 1.0kg(生)",
"goods_price":"30.00",
"formated_goods_price":"¥30.00",
"goods_attr": "规格:5粒[-3]",
"goods_number":2,
"img": {
"small": "https://cityo2o.ecjia.com/content/uploads/images/201611/thumb_img/1146_G_1478114722282.jpg",
"thumb": "https://cityo2o.ecjia.com/content/uploads/images/201611/goods_img/1146_G_1478114722282.jpg",
"url": "https://cityo2o.ecjia.com/content/uploads/images/201611/source_img/1146_G_1478114722282.jpg"
}
}
]
},
"status": {
"succeed": 1
}
}
自选快递时selected_returnway_info字典返回
"selected_returnway_info":{
"return_way_code":"express",
"return_way_name":"自选快递",
"recipient_address":"上海市普陀区长风街道中山北路3553号伸大厦301室",
"recipients":"张三",
"contact_phone":"4001-021-758",
"shipping_name":"圆通速递",
"shipping_sn":"98765412365"
}
到店退货selected_returnway_info字典返回
"selected_returnway_info":{
"return_way_code":"shop",
"return_way_name":"到店退货",
"store_address":"上海市普陀区长风街道中山北路3553号伸大厦301室",
"store_name":"宅鲜配",
"contact_phone":"4001-021-758"
}
注:错误编码