基础 qianmi.cloudshop.d2c.apply.return（云商城-买家申请退货）

云商城申请退货
 用户授权类型
 公共参数
请求地址:
环境 HTTP请求地址 HTTPS请求地址
正式环境 http://gw.api.qianmi.com/api https://api.qianmi.com/api
系统级请求参数:
名称 类型 是否必须 描述
methodString 必须 API接口名称
access_tokenString 可选 用户登录授权以后，QMOP颁发给应用的授权信息，详细介绍请点击这里，当前API的用户授权类型标明："需要授权"，则此参数必传，"不需要授权"，则此参数不需要传。
formatString 必须 指定响应格式,目前支持格式为json
appKeyString 必须 分配给应用的AppKey
vString 必须 API协议版本，当前可选值:1.1
signString 必须 API输入参数签名结果
timestampString 必须 请求时间戳,时区为GMT+8(北京时间)，格式:"yyyy-MM-dd HH:mm:ss",例如"2012-12-20 10:20:35"，开放平台允许客户端请求的最大时间误差为10分钟
 业务参数
名称 类型 是否必须 示例值 默认值 描述
tidString 必须 TC20092315580587904367 订单编号，仅支持线上订单
seller_codeString 必须 A5187698 卖家编号
seller_nameString 可选 卖家店铺名称
mobileString 可选 卖家手机号码
buyer_idString 必须 U5r3tc6fu4o1ugf 买家编号
buyer_nameString 可选 买家名称
reasonString 可选 退款原因
problemString 可选 退款原因
voucherString 可选 上传凭证
apply_refund_priceString 必须 13.80 退款金额
apply_return_item_listString 必须 [{"oid":"O20092315580587951497", "item_num": 1}] 退货商品
 请求示例
 响应参数
名称 类型 示例值 描述
apply_order ApplyOrder
 响应示例

JSON数据格式：

 异常示例

JSON数据格式：

 {
    "errorToken": "@@$-ERROR_TOKEN$-@@",
    "code": "33",
    "message": "非法的参数",
    "solution": "请查看根据服务接口对参数格式的要求",
    "subErrors": {
      "subError": [{
          "code": "isv.invalid-paramete:XXXX",
          "message": "参数XXXX无效，格式不对、非法值、越界等"
        }]
  }
 错误码
错误码 错误描述 解决方案
isc.qianmi-cloudshop-d2c-apply-return-service-error:01042024退货商品JSON转化错误检查退款商品的json字符串
isc.qianmi-cloudshop-d2c-apply-return-service-error:01042002没有此操作权限检查买家和订单的关系
isc.qianmi-cloudshop-d2c-apply-return-service-error:01042001订单不存在检查订单编号
isc.qianmi-cloudshop-d2c-apply-return-service-error:01042028订单已不能退货或退款
isc.qianmi-cloudshop-d2c-apply-return-service-error:01042029退货商品不在订单中检查退货商品是否和订单中的商品对应
isc.qianmi-cloudshop-d2c-apply-return-service-error:01042030商品已全部退货不能再退了检查商品是否已全部退货
isc.qianmi-cloudshop-d2c-apply-return-service-error:01042031商品参数不正确检查商品的oid或则item_num是否符合要求
 FAQ