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.exchangegoods.query 查询换货信息
¥免费

批量查询换货信息

公共参数
请求参数
名称 类型 是否必须 示例值 描述
pageNoStringY1页码
pageSizeStringY15每页条数
startModifiedStringN2000-01-01 00:00:00换货修改开始时间;换货开始时间和换货结束时间成对出现
endModifiedStringN2000-01-01 00:00:00换货修改结束时间;换货开始时间和换货结束时间成对出现
changeApplyIdsStringN
changeApplyIdStringN192038483728917换货请求号;换货时间和换货请求号二选一必填
changeStatusStringN1换货状态,具体包括:换货待处理(1), 待买家修改(2), 待买家寄货(3), 换货关闭(7), 换货成功(8), 待商家发新货(4), 待买家收货(6)
响应参数
名称 类型 示例值 描述
returnFlagStringY响应结果
dataString
changeListString
changeApplyIdString100928374827283749换货请求号
orderNoString4362718293订单编号
customerString小二买家昵称
commodityNameString红色商品原单商品名称
commodityCodeString10029384原单商品编码
saleqtyString10原单交易数量
changeTypeString1换货类型 1 货未发;2 货已发
applyComplainString1客服介入标识 0 未介入 ; 1 介入
specialShapedString0换同型异型 0 换同型 ; 1 换异型
changeCommodityCodeString43271823换货商品编码
changeCommodityNameString蓝色商品名称换货商品名称
changeSaleqtyString1换货数量
customerAddressString江苏南京**街道**号买家换货收货地址
customerPhonenumString137****8888买家换货联系方式
customerConsigneeString张三买家换货收件人名称
changeReasonString质量问题换货原因
changeDescString尺码小了换货说明
imageUrlStringhttp://*****.jpg;http://*****.jpg换货图片(多图片;号分割)
applyTimeString2000-01-01 00:00:00换货申请时间
operateTimeString2000-01-01 00:00:00换货修改时间
changeStatusString2换货状态值[换货待处理(1), 待买家修改(2), 待买家寄货(3), 换货关闭(7), 换货成功(8), 待商家发新货(4), 待买家收货(6)]
changeStatusValueString待商家发新货换货状态值描述(换货待处理, 待买家修改, 待买家寄货, 换货关闭, 换货成功, 待商家发新货, 待买家收货)
statusPassTimeString2000-01-01 00:00:00超时时间
expressCompanycodeStringYTO买家发货物流公司编码
expressCompanynameString圆通买家发货物流公司名称
expressnoString677290***7720买家发货物流单号
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                
<sn_request>
  <sn_body>
    <queryExchangegoods>
      <changeApplyIds>
        <changeApplyId>192038483728917</changeApplyId>
      </changeApplyIds>
      <pageNo>1</pageNo>
      <startModified>2000-01-01 00:00:00</startModified>
      <pageSize>15</pageSize>
      <changeStatus>1</changeStatus>
      <endModified>2000-01-01 00:00:00</endModified>
    </queryExchangegoods>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "queryExchangegoods": {
        "changeApplyIds": [
          {
            "changeApplyId": "192038483728917"
          }
        ],
        "pageNo": "1",
        "startModified": "2000-01-01 00:00:00",
        "pageSize": "15",
        "changeStatus": "1",
        "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>
    <queryExchangegoods>
      <returnFlag>Y</returnFlag>
      <data>
        <changeList>
          <statusPassTime>2000-01-01 00:00:00</statusPassTime>
          <changeApplyId>100928374827283749</changeApplyId>
          <changeSaleqty>1</changeSaleqty>
          <changeDesc>尺码小了</changeDesc>
          <operateTime>2000-01-01 00:00:00</operateTime>
          <changeCommodityName>蓝色商品名称</changeCommodityName>
          <customerPhonenum>137****8888</customerPhonenum>
          <changeCommodityCode>43271823</changeCommodityCode>
          <imageUrl>http://*****.jpg;http://*****.jpg</imageUrl>
          <commodityCode>10029384</commodityCode>
          <customerConsignee>张三</customerConsignee>
          <expressCompanycode>YTO</expressCompanycode>
          <saleqty>10</saleqty>
          <applyTime>2000-01-01 00:00:00</applyTime>
          <customerAddress>江苏南京**街道**号</customerAddress>
          <orderNo>4362718293</orderNo>
          <changeReason>质量问题</changeReason>
          <expressno>677290***7720</expressno>
          <changeType>1</changeType>
          <applyComplain>1</applyComplain>
          <changeStatus>2</changeStatus>
          <changeStatusValue>待商家发新货</changeStatusValue>
          <expressCompanyname>圆通</expressCompanyname>
          <commodityName>红色商品</commodityName>
          <customer>小二</customer>
          <specialShaped>0</specialShaped>
        </changeList>
      </data>
    </queryExchangegoods>
  </sn_body>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_head": {
      "totalSize": "1",
      "pageTotal": "1",
      "pageNo": "1",
      "returnMessage": "biz.handler.data-get:success"
    },
    "sn_body": {
      "queryExchangegoods": [
        {
          "returnFlag": "Y",
          "data": {
            "changeList": [
              {
                "statusPassTime": "2000-01-01 00:00:00",
                "changeApplyId": "100928374827283749",
                "changeSaleqty": "1",
                "changeDesc": "尺码小了",
                "operateTime": "2000-01-01 00:00:00",
                "changeCommodityName": "蓝色商品名称",
                "customerPhonenum": "137****8888",
                "changeCommodityCode": "43271823",
                "imageUrl": "http://*****.jpg;http://*****.jpg",
                "commodityCode": "10029384",
                "customerConsignee": "张三",
                "expressCompanycode": "YTO",
                "saleqty": "10",
                "applyTime": "2000-01-01 00:00:00",
                "customerAddress": "江苏南京**街道**号",
                "orderNo": "4362718293",
                "changeReason": "质量问题",
                "expressno": "677290***7720",
                "changeType": "1",
                "applyComplain": "1",
                "changeStatus": "2",
                "changeStatusValue": "待商家发新货",
                "expressCompanyname": "圆通",
                "commodityName": "红色商品",
                "customer": "小二",
                "specialShaped": "0"
              }
            ]
          }
        }
      ]
    }
  }
}
			
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

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