Skip to content
On this page

8.1 退换货申请

接口说明:

MethodURLContentType
POSTapi/restful/refund/applyapplication/json

请求入参说明:

参数类型说明是否必须长度描述
apply_codestring非必须200退换货申请编号(默认可不填,返回值会生成返回)
order_idstring必须50退货对应订单编号
apply_typestring非必须2退换货申请类型(4=退货,5=换货) ,不填写默认是退货
skusjson非必须[{"sku":商品编号, "num":商品数量, "price”:价格,"ext1":"现金","ext2":"积分"}]skus字段为null则表示整单退。price 表示含税单价,和订单中的一致。
apply_timestring非必须0退换货申请时间(2017-12-18 09:22:07)
apply_reasonstring非必须200退换货原因
apply_namestring非必须50退换货联系人(默认订单收货人),不为空时收货人相关信息字段信息必填
apply_mobilestring非必须50退换货联系手机(默认订单收货人手机)
apply_telephonestring非必须50退换货联系固定电话
apply_emailstring非必须50退货人电子邮件
pickup_waystring非必须10上门取件、第三方物流(上门=1,第三方=2)默认上门取件
province_codestring非必须11退货人省份编码(默认订单中的编码)
city_codestring非必须11退货人城市编码(默认订单中的编码)
county_codestring非必须11退货人区县编码(默认订单中的地址)
town_codestring非必须11退货人乡镇编码
addressstring非必须300地址(默认订单中的地址)
full_addressstring非必须300退货人详细地址(默认订单中的地址)例如 1_10_100_1000
extendsjson非必须[{"ColumnName":"扩展信息名称", "ColumnRemark":"扩展信息备注", "ColumnValue”:"扩展信息值"}]

返回结果说明:

参数参数说明描述
apply_codestring退货申请单编码

请求参数示例:

json
{
    "apply_code":"",
    "skus": [{
        "sku": "201027",
        "num": 10,
        "price": 21.15
    }, {
        "sku": "201030",
        "num": 20,
        "price": 48.6
    }],
    "order_id": "PO001",
    "apply_type": "4",
    "apply_time": "2017-12-18 14:11:48",
    "apply_reason": "产品发错",
    "pickup_way": "1",
    "address": "上海市XX区XX号",
    ,
	"extends" : [{
			"ColumnName" : "DepartmentName",
			"ColumnRemark" : "下单部门",
			"ColumnValue" : "采购部"
		}
	]
}

返回数据示例:

json
{
    "success": true,
    "errormsg ": "",
    "requestId ": "9245fe4a-d402-451c-b9ed-9c1a04247482",
    "errorcode": 0,
    "result": {
        " apply_code ": "RO001"
    }
}