退货服务接口

接口列表

接口名称	接口描述
app.refund.goodsList	获取退货订单商品列表
app.refund.submit	提交退货申请
app.refund.detail	退货详情
app.refund.setexpress	保存快递信息

接口描述

1、获取退货订单商品列表(app.refund.goodsList)

请求参数

Param Name	Param Type	Required	Param Value	Desc
method	String	true	app.refund.goodsList	请求方法
uid	int	true	7893817	用户ID
order_code	long	true	1613656852	订单号

响应内容

{
    "code": 200,
    "data": {
        "coupon_amount": "0.00",
        "goods_list": [
            {
                "color_name": "蓝色",
                "goods_id": 355897,
                "goods_image": "http://img10.static.yhbimg.com/goodsimg/2015/10/29/12/01c9c05a2170996e86f5c1f7ed32e48ac7.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80",
                "goods_type": "ordinary",
                "goods_type_id": 1,
                "hasShoes": 0,
                "last_price": "149.00",
                "product_id": 275357,
                "product_name": "Life•After Life X The Simpsons 辛普森一家刺绣牛津纺衬衫",
                "product_skc": 280039,
                "product_skn": 51153138,
                "product_sku": 894428,
                "size_name": "M"
            }
        ],
        "return_amount_info": "",
        "return_amount_mode": [
            {
                "id": 1,
                "is_default": "Y",
                "name": "原卡返还"
            }
        ],
        "return_reason": [
            {
                "id": 3,
                "name": "不喜欢"
            },
            {
                "id": 2,
                "name": "性价比不高"
            },
            {
                "id": 11,
                "name": "价格变化"
            },
            {
                "id": 4,
                "name": "质量瑕疵"
            },
            {
                "id": 1,
                "name": "尺寸不合适"
            },
            {
                "id": 7,
                "name": "商品有色差"
            },
            {
                "id": 8,
                "name": "图片与实物不符"
            },
            {
                "id": 6,
                "name": "发错货"
            },
            {
                "id": 5,
                "name": "快递延迟"
            }
        ],
        "yoho_coin_num": "0.00"
    },
    "md5": "72879cfb65bcd2705e4283d2f5dc1a30",
    "message": "Refund goods list"
}

2、提交退货申请(app.refund.submit)

请求参数

Param Name	Param Type	Required	Param Value	Desc
method	String	true	app.refund.submit	请求方法
order_code	long	true	1512253171	订单号
uid	int	true	8040274	用户ID
area_code	String	false	" " (默认值为空)	地区编号
goods	String(json数组)	true	[{"goods_type":"1","last_price":"18.00","product_skc":"83007","product_skn":"51001899","product_sku":"307528","remark":" ","returned_reason":1}]	退货商品
payment	String(json对象)	true	{"alipay_account":" ","alipay_name":" ","area_code":"320115","bank_card":" ","bank_name":" ","city":" ","payee_name":" ","province":" ","remark":" ","return_amount_mode":"1"}	退款设置

响应内容

{
    "code": 200,
    "message": "退货申请成功",
    "data": {
        "apply_id": "428135"
    },
    "md5": "2d4a86d3d308cf8cbdd9870ebd61a3a4"
}

响应内容描述

Param Name	Param Type	Desc
apply_id	String	退货申请ID

3、退货详情(app.refund.detail)

请求参数

Param Name	Param Type	Required	Param Value	Desc
method	String	true	app.refund.detail	请求方法
id	int	true	428106	退货申请ID
uid	int	true	362719	用户ID

响应内容

{
    "code": 200,
    "message": "退货详情",
    "data": {
        "source_order_code": "1513540278",
        "use_yoho_coin_num": null,
        "status": "20",
        "status_name": "商品寄回",
        "statusList": [
            {
                "name": "提交申请",
                "act": "Y"
            },
            {
                "name": "审核通过",
                "act": "Y"
            },
            {
                "name": "商品寄回",
                "act": "Y"
            },
            {
                "name": "商品入库",
                "act": "N"
            },
            {
                "name": "退款完成",
                "act": "N"
            }
        ],
        "create_time": "2015-11-23 20:20:12",
        "return_amount_mode_name": "YOHO币",
        "return_amount_mode": "4",
        "return_yoho_coin": "0",
        "goods_list": [
            {
                "product_skn": "51146548",
                "product_name": "我是可爱的小秋秋，james，蔡!",
                "goods_image": "?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/90",
                "size_name": null,
                "color_name": null,
                "sales_price": null,
                "reason": "1",
                "remark": "",
                "reason_name": "尺寸不合适",
                "evidence_images": [],
                "goods_type": "ordinary"
            }
        ],
        "notice": {
            "id": 20,
            "title": "商品寄回物流信息",
            "express_company": "南京ems",
            "express_number": "44323566"
        },
        "return_amount": "125.00",
        "return_coupon_amount": "0.00",
        "express_number": "44323566",
        "return_amount_total": "125.00",
        "return_amount_info": "",
        "return_amount_mode_info": []
    },
    "md5": "6fa464cf72538ad2c25fa24d20dcdd20"
}

}

4、保存快递信息(app.refund.setexpress)

请求参数

Param Name	Param Type	Required	Param Value	Desc
method	String	true	app.refund.setexpress	请求方法
id	int	true	428120	退货申请ID
uid	int	true	362729	用户ID
express_company	String	true	南京ems	快递公司名称
express_number	String	true	44323575	快递单号
express_id	int	true	2	快递公司ID

响应内容

{
  "code": 200,
  "message": "快递单号设置成功",
  "data": [],
  "md5": "93311f762194b751872601b67fad53f7"
}
or
{
  "code": 412,
  "message": "没有找到该退货申请"
}