API接口文档／2.7 订单退换货服务／2.7.1 订单退换货申请服务

2.7.1 订单退换货申请服务

该接口支持客户进行订单退货申请，业务场景为订单已完成签收后才可以进行退货

请求方式/参数格式
POST/JSON

请求URL
https://域名/returnorder

请求入参说明

参数名称	必填	类型	长度	示例值
token	是	String	100	授权接口获取的access token
order_id	是	String	50	订单编号
skus	是	Array		数组对象，退货详情
└sku	是	String	50	商品编码
└num	是	int		商品数量
└price	是	number		价格
type	是	int		退换货类型：4退货
desc	是	String	2000	售后问题描述
contact_detail	是	Object		采购人信息
└customer_contact_name	是	String	100	采购人名称
└customer_mobile_phone	是	String	50	采购人电话
└customer_tel	是	String	50	采购人手机
return_area	是	Object		地址信息
└return_province	是	String	30	退货人省份编号
└return_city	是	String	30	退货人市编号
└return_county	是	String	30	退货人区/县编号
└return_place	是	String	100	退货人地址

返回结果

名称	类型	必填	备注
success	boolean	是	true\|false，根据该字段判断接口是否调用成功，若为false，则解析error_response字段查看具体失败原因
result	Object	是	数据对象，数据节点
└order_id	String	是	订单编号
└order_service_id	String	是	退换货的服务号id
└type	int	是	4：退货
└skus	Array	是	数组对象，退换货详情
└└sku	String	是	商品编码
└└num	int	是	数量
└└price	number	是	价格

错误码

错误码	错误描述	解决方案
ERR-001000	退换货出错
ERR-001002	商品找不到
ERR-001003	售后问题描述不能为空
ERR-001004	采购人信息不能为空
ERR-001005	地址信息不能为空
ERR-001006	联系人信息不能为空
ERR-001007	采购人手机号信息不能为空
ERR-001008	采购人联系电话信息不能为空
ERR-001009	省信息不能为空
ERR-001010	市信息不能为空
ERR-001011	区信息不能为空
ERR-001012	详细地址信息不能为空
ERR-001013	退换货无法与订单匹配
ERR-001014	采购人信息不是JSON格式
ERR-001015	地址信息不是JSON格式

请求示例

{
  "token": "3fd5f04b-9f4c-4be0-8ea2-31f912314181",
  "order_id": "LINK20190808340000002",
  "skus": [
    {
      "price": 12.6,
      "num": 4,
      "sku": "10302373"
    },
    {
      "price": 34.4,
      "num": "8",
      "sku": "10302370"
    },
    {
      "price": 7,
      "num": 2,
      "sku": "10302374"
    }
  ],
  "type": 4,
  "desc": "return goodslalal",
  "contact_detail": {
    "customer_contact_name": "华中科技大学网上商城",
    "customer_mobile_phone": "18820925287",
    "customer_tel": "18820925287"
  },
  "return_area": {
    "return_province": "1",
    "return_city": "61",
    "return_county": "72",
    "return_place": "华中科技大学网上商城 "
  }
}

返回示例

{
  "result": {
    "skus": [
      {
        "price": "12.6",
        "num": "4",
        "sku": "10302373"
      },
      {
        "price": "34.4",
        "num": "8",
        "sku": "10302370"
      },
      {
        "price": "7",
        "num": "2",
        "sku": "10302374"
      }
    ],
    "order_service_id": "RTN6569859400578629632",
    "type": 4,
    "order_id": "LINK20190821340000004"
  },
  "success": true
}