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.returngoods.query 退货退款查询服务
¥免费

退货退款查询服务

公共参数
请求参数
名称 类型 是否必须 示例值 描述
endTimeStringY2017-10-20 00:00:00查询交易创建结束时间。格式:yyyy-MM-dd HH:mm:ss
startTimeStringY2017-10-20 00:00:00查询交易创建开始时间。格式:yyyy-MM-dd HH:mm:ss
pageNoStringN1分页页码
pageSizeStringN10每页数量
响应参数
名称 类型 示例值 描述
applyTimeString2017-10-21 11:02:35申请时间
dealMoneyString188.00采购订单金额
distributourCodeString2321312分销商编码
efundCodeStringrefundCode采购订单退货单号
expressCompanyCodeStringA01物流公司代码
expressNoString3342131231物流公司运单号
orderCodeString2000532010采购订单号
productCodeString102609934苏宁商品编码
productNameStringPPTV55寸电视商品名称
refundtypeString1表示退货、2表示仅退款退货退款类型
resellerNameString苏宁软件开发技术有限公司分销商名称
returnMoneyString188.00实际退款金额
returnReasonString发票问题退货原因
returntypeString空、1表示货未发、2表示货已发未收、3表示货已收退货发货状态
statusDescString1-退款待处理; 2-已拒绝退款 ; 3-待买家发货 ; 4-待商家收货 ; 5-退款失败; 6-退款处理中 ; 7-退款关闭 ; 8-退款成功;C030-申请退货订单状态
statusPassTimeString2017-10-21 11:02:35倒计时时间
cmmdtyCodeString100000148产品编码
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                <sn_request>
  <sn_body>
    <queryReturngoods>
      <pageNo>1</pageNo>
      <pageSize>10</pageSize>
      <startTime>2017-10-20 00:00:00</startTime>
      <endTime>2017-10-20 00:00:00</endTime>
    </queryReturngoods>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "queryReturngoods": {
        "pageNo": "1",
        "pageSize": "10",
        "startTime": "2017-10-20 00:00:00",
        "endTime": "2017-10-20 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>
    <queryReturngoods>
      <refundtype>1表示退货、2表示仅退款</refundtype>
      <statusDesc>1-退款待处理; 2-已拒绝退款 ; 3-待买家发货 ; 4-待商家收货 ; 5-退款失败; 6-退款处理中 ; 7-退款关闭 ; 8-退款成功;C030-申请退货</statusDesc>
      <statusPassTime>2017-10-21 11:02:35</statusPassTime>
      <distributourCode>2321312</distributourCode>
      <expressNo>3342131231</expressNo>
      <resellerName>苏宁软件开发技术有限公司</resellerName>
      <cmmdtyCode>100000148</cmmdtyCode>
      <expressCompanyCode>A01</expressCompanyCode>
      <returntype>空、1表示货未发、2表示货已发未收、3表示货已收</returntype>
      <productName>PPTV55寸电视</productName>
      <efundCode>refundCode</efundCode>
      <productCode>102609934</productCode>
      <returnReason>发票问题</returnReason>
      <returnMoney>188.00</returnMoney>
      <orderCode>2000532010</orderCode>
      <applyTime>2017-10-21 11:02:35</applyTime>
      <dealMoney>188.00</dealMoney>
    </queryReturngoods>
  </sn_body>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_head": {
      "totalSize": "1",
      "pageTotal": "1",
      "pageNo": "1",
      "returnMessage": "biz.handler.data-get:success"
    },
    "sn_body": {
      "queryReturngoods": [
        {
          "refundtype": "1表示退货、2表示仅退款",
          "statusDesc": "1-退款待处理; 2-已拒绝退款 ; 3-待买家发货 ; 4-待商家收货 ; 5-退款失败; 6-退款处理中 ; 7-退款关闭 ; 8-退款成功;C030-申请退货",
          "statusPassTime": "2017-10-21 11:02:35",
          "distributourCode": "2321312",
          "expressNo": "3342131231",
          "resellerName": "苏宁软件开发技术有限公司",
          "cmmdtyCode": "100000148",
          "expressCompanyCode": "A01",
          "returntype": "空、1表示货未发、2表示货已发未收、3表示货已收",
          "productName": "PPTV55寸电视",
          "efundCode": "refundCode",
          "productCode": "102609934",
          "returnReason": "发票问题",
          "returnMoney": "188.00",
          "orderCode": "2000532010",
          "applyTime": "2017-10-21 11:02:35",
          "dealMoney": "188.00"
        }
      ]
    }
  }
}
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

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