Refund/detail(o2o)

来自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"                                   
       }

注:错误编码