退出
热词搜索：
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.refundinformation.query 查询单笔退款信息
￥免费

查询单笔退款信息

公共参数
请求参数
名称 类型 是否必须 示例值 描述
returnApplyIdStringY100000028374823退款单号
响应参数
名称 类型 示例值 描述
returnFlagStringY响应结果（Y代表成功，N代表失败）
dataString
returnApplyIdString100000223235231退款单号
orderNoString59090001订单编号
customerString23344买家账号
commodityNameString商品名称商品名称
commodityCodeString10002223苏宁商品编码
supplierCommodityCodeString238923商家商品编码
returnTypeString2退货类型 2货未发退货、3货已发未收退货、4货已收退货
onlyRefundString0是否仅退款 0 退货退款 1 仅退款
applyComplainString0客服介入标识 0 未介入 ； 1 介入
ctrFlagString1是否换转退订单 0 否；1 是
returnMoneyString111退款金额
dealMoneyString111交易金额
returnReasonString退款原因退款原因
returnDescString退款说明退款说明
applyTimeString2001-11-4 10:40:59退款申请时间
operateTimeString2001-11-4 10:40:59退款修改时间
statusPassTimeString2010-11-4 19:41:37倒计时时间
returnStatusValueString1退款状态 1：退款待处理；2：已拒绝退款；3 待买家发货；4 待商家收货；5 退款失败；6 退款处理中；7 退款关闭；8 退款成功；
returnStatusDescString退款待处理退款状态描述 1：退款待处理；2：已拒绝退款；3 待买家发货；4 待商家收货；5 退款失败；6 退款处理中；7 退款关闭；8 退款成功；
expressCompanyCodeStringYTO消费者退货物流公司编码
expressNoString602022221消费者退货物流单号
orderLineNumberString1002220101011OMS行号
refundModeString00退款方式【00 其他；02 商户批量退款；03 商户关联退款；04 系统超期退款；05 客服退款；06 商家邀请免审退款；07 售后策略退款；08 小额免审退（货未发平台规则）】
returnNumString1.00000退货数量
orderSourceString0订单来源(0:苏宁/1:抖音/2:天猫)
saleqtyString1.00000销售数量
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                
<sn_request>
  <sn_body>
    <queryRefundinformation>
      <returnApplyId>100000028374823</returnApplyId>
    </queryRefundinformation>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "queryRefundinformation": {
        "returnApplyId": "100000028374823"
      }
    }
  }
}
响应示例
  • XML示例
  • JSON示例
复制全部代码 
                              
<sn_responseContent>
  <sn_body>
    <queryRefundinformation>
      <returnFlag>Y</returnFlag>
      <data>
        <statusPassTime>2010-11-4 19:41:37</statusPassTime>
        <expressNo>602022221</expressNo>
        <operateTime>2001-11-4 10:40:59</operateTime>
        <expressCompanyCode>YTO</expressCompanyCode>
        <returnDesc>退款说明</returnDesc>
        <ctrFlag>1</ctrFlag>
        <supplierCommodityCode>238923</supplierCommodityCode>
        <returnApplyId>100000223235231</returnApplyId>
        <returnReason>退款原因</returnReason>
        <commodityCode>10002223</commodityCode>
        <returnMoney>111</returnMoney>
        <saleqty>1.00000</saleqty>
        <applyTime>2001-11-4 10:40:59</applyTime>
        <orderSource>0</orderSource>
        <orderNo>59090001</orderNo>
        <returnStatusValue>1</returnStatusValue>
        <applyComplain>0</applyComplain>
        <returnStatusDesc>退款待处理</returnStatusDesc>
        <returnNum>1.00000</returnNum>
        <onlyRefund>0</onlyRefund>
        <refundMode>00</refundMode>
        <orderLineNumber>1002220101011</orderLineNumber>
        <returnType>2</returnType>
        <customer>23344</customer>
        <commodityName>商品名称</commodityName>
        <dealMoney>111</dealMoney>
      </data>
    </queryRefundinformation>
  </sn_body>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_body": {
      "queryRefundinformation": {
        "returnFlag": "Y",
        "data": [
          {
            "statusPassTime": "2010-11-4 19:41:37",
            "expressNo": "602022221",
            "operateTime": "2001-11-4 10:40:59",
            "expressCompanyCode": "YTO",
            "returnDesc": "退款说明",
            "ctrFlag": "1",
            "supplierCommodityCode": "238923",
            "returnApplyId": "100000223235231",
            "returnReason": "退款原因",
            "commodityCode": "10002223",
            "returnMoney": "111",
            "saleqty": "1.00000",
            "applyTime": "2001-11-4 10:40:59",
            "orderSource": "0",
            "orderNo": "59090001",
            "returnStatusValue": "1",
            "applyComplain": "0",
            "returnStatusDesc": "退款待处理",
            "returnNum": "1.00000",
            "onlyRefund": "0",
            "refundMode": "00",
            "orderLineNumber": "1002220101011",
            "returnType": "2",
            "customer": "23344",
            "commodityName": "商品名称",
            "dealMoney": "111"
          }
        ]
      }
    }
  }
}
异常示例
  • XML示例
  • JSON示例
复制全部代码 

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
业务异常码
异常码 错误描述 解决方案
biz.custom.queryrefundinformation.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.custom.queryrefundinformation.length-overlong:* 参数的值超过规定长度 请检查此参数的值,*号表示参数字段名
biz.handler.data-get:no-result 查询没结果 请检查查询参数
isp.sys.service.unavailable.moms 服务不可用 请联系苏宁技术人员
公共异常码
API工具
API TOOLS 在线测试工具异常码查询工具SDK调用示例SDK下载
FAQ