退出
热词搜索：
API接口目录

电商能力输出-小店业务

价格API
物流API
订单API
营销API
售后API
异常码自查工具
suning.onlinestore.applyrefund.create 小店订单退换货申请接口
￥免费

小店订单退换货申请接口【此接口只允许截单前整单退，退部分行或截单后可以联系门店操作退】

公共参数
请求参数
名称 类型 是否必须 示例值 描述
orderIdStringY12312312312平台订单号
orderPortStringN01申请终端，01-app客户端、02-小程序
applyTypeStringY01申请退换货类型，01退货
operateTimeStringY20180412153723操作时间
retReasonCodeStringY030退货原因编码，枚举值，线下提供
reasonNameStringY消费者不想要了退货原因编码对应的描述信息，线下提供
reasonDesStringN买多了退货原因个人描述
pictureURLStringNwww.baidu.com;www.baidu.com;www.baidu.com图片URL【最多支持3张】
orderItemIdListStringN
orderItemIdStringY121212212122平台订单行号
响应参数
名称 类型 示例值 描述
orderIdString12312312312平台订单号
resultFlagStringY/N成功标记
resultCodeStringPGXD_SH1_006结果编码值
resultMsgString截单前请整单退结果原因描述
returnQuestIdString110001000392172701退货请求号
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                <sn_request>
  <sn_body>
    <createOtoapplyrefund>
      <applyType>01</applyType>
      <reasonName>消费者不想要了</reasonName>
      <orderItemIdList>
        <orderItemId>121212212122</orderItemId>
      </orderItemIdList>
      <orderId>12312312312</orderId>
      <operateTime>20180412153723</operateTime>
      <pictureURL>www.baidu.com;www.baidu.com;www.baidu.com</pictureURL>
      <reasonDes>买多了</reasonDes>
      <orderPort>01</orderPort>
      <retReasonCode>030</retReasonCode>
    </createOtoapplyrefund>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "createOtoapplyrefund": {
        "applyType": "01",
        "reasonName": "消费者不想要了",
        "orderItemIdList": [
          {
            "orderItemId": "121212212122"
          }
        ],
        "orderId": "12312312312",
        "operateTime": "20180412153723",
        "pictureURL": "www.baidu.com;www.baidu.com;www.baidu.com",
        "reasonDes": "买多了",
        "orderPort": "01",
        "retReasonCode": "030"
      }
    }
  }
}
响应示例
  • XML示例
  • JSON示例
复制全部代码 
                              <sn_responseContent>
  <sn_body>
    <createOtoapplyrefund>
      <orderId>12312312312</orderId>
      <resultCode>PGXD_SH1_006</resultCode>
      <resultFlag>Y/N</resultFlag>
      <returnQuestId>110001000392172701</returnQuestId>
      <resultMsg>截单前请整单退</resultMsg>
    </createOtoapplyrefund>
  </sn_body>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_body": {
      "createOtoapplyrefund": {
        "orderId": "12312312312",
        "resultCode": "PGXD_SH1_006",
        "resultFlag": "Y/N",
        "returnQuestId": "110001000392172701",
        "resultMsg": "截单前请整单退"
      }
    }
  }
}
异常示例
  • XML示例
  • JSON示例
复制全部代码 

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
业务异常码
异常码 错误描述 解决方案
biz.onlinestore.createapplyrefund.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.onlinestore.createapplyrefund.enumeration-error:* 参数的可选值错误 请检查此参数的值,*号表示参数字段名
isp.sys.service.unavailable.pangu 服务不可用 请联系苏宁技术人员
biz.onlinestore.createapplyrefund.invalid-biz:100 未查询到平台配置信息 请联系苏宁业务人员
biz.onlinestore.createapplyrefund.invalid-biz:101 内部系统异常:%s 请联系苏宁业务人员
公共异常码
API工具
API TOOLS 在线测试工具异常码查询工具SDK调用示例SDK下载
FAQ