退出
热词搜索： 订单API 接口 查询退款订单 6五四三二一 appkey
API接口目录

平台业务

商品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.refundlistinformation.query 批量查询退款列表
￥免费

批量查询退款列表

公共参数
请求参数
名称 类型 是否必须 示例值 描述
pageNoStringN1页码
pageSizeStringN10每页条数
startModifiedStringY2000-01-01 00:00:00退款修改开始时间
endModifiedStringY2000-01-01 00:00:00退款修改结束时间
returnStatusStringN1退款状态，具体包括：退款待处理(1), 待买家修改(2), 待买家发货(3), 待商家收货(4),退款失败(4), 退款处理中(6), 退款关闭(7), 退款成功(8)
响应参数
名称 类型 示例值 描述
returnFlagStringY响应结果 Y代表成功，N代表失败
returnListString
returnApplyIdString10000000729011232退款单号
orderNoString509177290订单编号
customerString177290买家账号
commodityNameString商品名称商品名称
commodityCodeString17729000苏宁商品编码
supplierCommodityCodeString22-dd-001商家商品编码
returnTypeString2退货类型 2货未发退货、3货已发未收退货、4货已收退货
onlyRefundString1是否仅退款 0 退货退款 1 仅退款
applyComplainString1客服介入标识 0 未介入 ； 1 介入
ctrFlagString1是否换转退订单 0 否；1 是
returnMoneyString111退款金额
dealMoneyString111交易金额
returnReasonString不要了退款原因
returnDescString不合适退款说明
applyTimeString2000-10-10 10:10:10退款申请时间
operateTimeString2010-10-10 10:10:10退款修改时间
statusPassTimeString2010-10-10 10:10:10倒计时时间
returnStatusValueString1退款状态 1：退款待处理；2：已拒绝退款；3 待买家发货；4 待商家收货；5 退款失败；6 退款处理中；7 退款关闭；8 退款成功；
returnStatusDescString退款待处理退款状态描述 1：退款待处理；2：已拒绝退款；3 待买家发货；4 待商家收货；5 退款失败；6 退款处理中；7 退款关闭；8 退款成功；
expressCompanyCodeStringYTO消费者退货物流公司编码
expressNoString6032111消费者退货物流单号
orderLineNumberString1002220101011OMS行号
refundModeString00退款方式【00 其他；02 商户批量退款；03 商户关联退款；04 系统超期退款；05 客服退款；06 商家邀请免审退款；07 售后策略退款；08 小额免审退（货未发平台规则）】
returnNumString1.00000退货数量
orderSourceString0订单来源(0:苏宁/1:抖音/2:天猫)
saleqtyString1.00000销售数量
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                <sn_request>
  <sn_body>
    <queryRefundlistinformation>
      <pageNo>1</pageNo>
      <startModified>2000-01-01 00:00:00</startModified>
      <returnStatus>1</returnStatus>
      <pageSize>10</pageSize>
      <endModified>2000-01-01 00:00:00</endModified>
    </queryRefundlistinformation>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "queryRefundlistinformation": {
        "pageNo": "1",
        "startModified": "2000-01-01 00:00:00",
        "returnStatus": "1",
        "pageSize": "10",
        "endModified": "2000-01-01 00:00:00"
      }
    }
  }
}
响应示例
  • XML示例
  • JSON示例
复制全部代码 
                              <sn_responseContent>
  <sn_head>
    <totalSize>1</totalSize>
    <pageTotal>1</pageTotal>
    <pageNo>1</pageNo>
    <returnMessage>biz.handler.data-get:success</returnMessage>
  </sn_head>
  <sn_body>
    <queryRefundlistinformation>
      <returnFlag>Y</returnFlag>
      <returnList>
        <statusPassTime>2010-10-10 10:10:10</statusPassTime>
        <expressNo>6032111</expressNo>
        <operateTime>2010-10-10 10:10:10</operateTime>
        <expressCompanyCode>YTO</expressCompanyCode>
        <returnDesc>不合适</returnDesc>
        <ctrFlag>1</ctrFlag>
        <supplierCommodityCode>22-dd-001</supplierCommodityCode>
        <returnApplyId>10000000729011232</returnApplyId>
        <returnReason>不要了</returnReason>
        <commodityCode>17729000</commodityCode>
        <returnMoney>111</returnMoney>
        <saleqty>1.00000</saleqty>
        <applyTime>2000-10-10 10:10:10</applyTime>
        <orderSource>0</orderSource>
        <orderNo>509177290</orderNo>
        <returnStatusValue>1</returnStatusValue>
        <applyComplain>1</applyComplain>
        <returnStatusDesc>退款待处理</returnStatusDesc>
        <returnNum>1.00000</returnNum>
        <onlyRefund>1</onlyRefund>
        <refundMode>00</refundMode>
        <orderLineNumber>1002220101011</orderLineNumber>
        <returnType>2</returnType>
        <customer>177290</customer>
        <commodityName>商品名称</commodityName>
        <dealMoney>111</dealMoney>
      </returnList>
    </queryRefundlistinformation>
  </sn_body>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_head": {
      "totalSize": "1",
      "pageTotal": "1",
      "pageNo": "1",
      "returnMessage": "biz.handler.data-get:success"
    },
    "sn_body": {
      "queryRefundlistinformation": [
        {
          "returnFlag": "Y",
          "returnList": [
            {
              "statusPassTime": "2010-10-10 10:10:10",
              "expressNo": "6032111",
              "operateTime": "2010-10-10 10:10:10",
              "expressCompanyCode": "YTO",
              "returnDesc": "不合适",
              "ctrFlag": "1",
              "supplierCommodityCode": "22-dd-001",
              "returnApplyId": "10000000729011232",
              "returnReason": "不要了",
              "commodityCode": "17729000",
              "returnMoney": "111",
              "saleqty": "1.00000",
              "applyTime": "2000-10-10 10:10:10",
              "orderSource": "0",
              "orderNo": "509177290",
              "returnStatusValue": "1",
              "applyComplain": "1",
              "returnStatusDesc": "退款待处理",
              "returnNum": "1.00000",
              "onlyRefund": "1",
              "refundMode": "00",
              "orderLineNumber": "1002220101011",
              "returnType": "2",
              "customer": "177290",
              "commodityName": "商品名称",
              "dealMoney": "111"
            }
          ]
        }
      ]
    }
  }
}
异常示例
  • XML示例
  • JSON示例
复制全部代码 

  
  	API异常码
  	异常码中文描述
  

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