ECJiaWiki:Api:refund/detail

来自ECJiaWiki
跳转至： 导航、 搜索

应用场景

 退款详情

接口名称

 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 "496_thumb_G_1441648759859.png" 小图
      └ 小图 thumb 是 String "496_G_1441648759272.png" 缩略图
      └ 原图 url 是 String "496_G_1441648759880.png" 原图

成功举例如下

{
    "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"                                   
       }

注:错误编码

取自“https://ecjia.com/wiki/index.php?title=ECJiaWiki:Api:refund/detail&oldid=31221”