API接口目录

平台业务

商品API
价格API
库存API
销售准备API
交易API
退货退款API(新)
财务API
店铺API
物流API
促销API
分销API
发票API
招商API
换货API
互动营销API
退货退款API
客服API
平台营销API
风控API
会员通API
账房API
财务记账API
异常码自查工具
suning.custom.returnorder.get 单笔退货查询接口(新)
¥免费

根据订单号单笔获取退货详情的接口,老接口停止维护,后续优化在新接口中进行

公共参数
请求参数
名称 类型 是否必须 示例值 描述
orderCodeStringY4511680451B2C订单号
响应参数
名称 类型 示例值 描述
orderCodeString10044284025订单号
itemNoString00060006908601订单行号
productCodeString121298437苏宁商品编码
customerString18001596123买家帐号
dealMoneyString11.11交易金额
returnMoneyString11.11退款金额
dealTimeString2018-06-06 11:11:11交易时间
applyTimeString2018-06-06 11:11:11申请时间
countDownTimeString2018-06-06 11:11:11倒计时时间
returnReasonString收到商品破损退款原因
returnReasonCodeStringC5退款原因编码
expressCompanyCodeString111111物流公司代码
expressNoString4511680451运单号
returnTypeString2货未发退货 3货已发未收退货 4货已收退货货物状态
refundTypeString空表示退货 1表示仅退款退款类型
returnStatusValueString1退款待处理;2已拒绝退款;3待买家发货;4待商家收货;5退款失败;6退款处理中;退款关闭;8退款成功;98进行中的订单;99已完结的订单退款状态值
commodityNameString海尔TF读卡器11商品名称
complainStatusString0未介入 1已介入客服介入状态
statusDescString与returnstatusvalue值对应;1退款待处理;2已拒绝退款;3待买家发货;4待商家收货;5退款失败;6退款处理中;退款关闭;8退款成功;98进行中的订单;99已完结的订单退款状态描述
operateButtonString1同意退款; 2拒绝退款; 3同意退货; 4拒绝退货; 5货已收到,同意退款; 6确认收货; 7跳转发货; 无操作不传; 多个字段分号;分隔可操作项
orderTypeString00普通C订单 21 虚拟卡直冲订单 22虚拟卡卡密订单 23云仓4PS订单订单类型
btcItemNoString4511680451销售订单行号
operateTimeString2018-06-06 11:11:11操作时间
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                
<sn_request>
  <sn_body>
    <getReturnorder>
      <orderCode>4511680451</orderCode>
    </getReturnorder>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "getReturnorder": {
        "orderCode": "4511680451"
      }
    }
  }
}
			
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              
<sn_responseContent>
  <sn_body>
    <getReturnorder>
      <orderType>00普通C订单 21 虚拟卡直冲订单 22虚拟卡卡密订单 23云仓4PS订单</orderType>
      <btcItemNo>4511680451</btcItemNo>
      <returnStatusValue>1退款待处理;2已拒绝退款;3待买家发货;4待商家收货;5退款失败;6退款处理中;退款关闭;8退款成功;98进行中的订单;99已完结的订单</returnStatusValue>
      <statusDesc>与returnstatusvalue值对应;1退款待处理;2已拒绝退款;3待买家发货;4待商家收货;5退款失败;6退款处理中;退款关闭;8退款成功;98进行中的订单;99已完结的订单</statusDesc>
      <expressNo>4511680451</expressNo>
      <returnReasonCode>C5</returnReasonCode>
      <operateTime>2018-06-06 11:11:11</operateTime>
      <expressCompanyCode>111111</expressCompanyCode>
      <itemNo>00060006908601</itemNo>
      <countDownTime>2018-06-06 11:11:11</countDownTime>
      <complainStatus>0未介入 1已介入</complainStatus>
      <refundType>空表示退货 1表示仅退款</refundType>
      <dealTime>2018-06-06 11:11:11</dealTime>
      <productCode>121298437</productCode>
      <returnReason>收到商品破损</returnReason>
      <returnMoney>11.11</returnMoney>
      <orderCode>10044284025</orderCode>
      <applyTime>2018-06-06 11:11:11</applyTime>
      <returnType>2货未发退货 3货已发未收退货 4货已收退货</returnType>
      <commodityName>海尔TF读卡器11</commodityName>
      <customer>18001596123</customer>
      <dealMoney>11.11</dealMoney>
      <operateButton>1同意退款; 2拒绝退款; 3同意退货; 4拒绝退货; 5货已收到,同意退款; 6确认收货; 7跳转发货; 无操作不传; 多个字段分号;分隔</operateButton>
    </getReturnorder>
  </sn_body>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_body": {
      "getReturnorder": [
        {
          "orderType": "00普通C订单 21 虚拟卡直冲订单 22虚拟卡卡密订单 23云仓4PS订单",
          "btcItemNo": "4511680451",
          "returnStatusValue": "1退款待处理;2已拒绝退款;3待买家发货;4待商家收货;5退款失败;6退款处理中;退款关闭;8退款成功;98进行中的订单;99已完结的订单",
          "statusDesc": "与returnstatusvalue值对应;1退款待处理;2已拒绝退款;3待买家发货;4待商家收货;5退款失败;6退款处理中;退款关闭;8退款成功;98进行中的订单;99已完结的订单",
          "expressNo": "4511680451",
          "returnReasonCode": "C5",
          "operateTime": "2018-06-06 11:11:11",
          "expressCompanyCode": "111111",
          "itemNo": "00060006908601",
          "countDownTime": "2018-06-06 11:11:11",
          "complainStatus": "0未介入 1已介入",
          "refundType": "空表示退货 1表示仅退款",
          "dealTime": "2018-06-06 11:11:11",
          "productCode": "121298437",
          "returnReason": "收到商品破损",
          "returnMoney": "11.11",
          "orderCode": "10044284025",
          "applyTime": "2018-06-06 11:11:11",
          "returnType": "2货未发退货 3货已发未收退货 4货已收退货",
          "commodityName": "海尔TF读卡器11",
          "customer": "18001596123",
          "dealMoney": "11.11",
          "operateButton": "1同意退款; 2拒绝退款; 3同意退货; 4拒绝退货; 5货已收到,同意退款; 6确认收货; 7跳转发货; 无操作不传; 多个字段分号;分隔"
        }
      ]
    }
  }
}
			
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
biz.custom.getreturnorder.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.handler.data-get:no-result 查询没结果 请检查查询参数
isp.sys.service.unavailable.moms 服务不可用 请联系苏宁技术人员
公共异常码
API工具
FAQ