API接口目录

苏宁有货业务

有货买家商品API
有货买家价格库存API
有货买家订单API
有货买家物流API
有货买家售后API
有货买家其他API
有货卖家商品API
家乐福供货平台API
异常码自查工具
suning.sngoods.querymessage.query 消息查询接口
¥免费

有货消息查询接口,用于获取商品状态、商品价格、订单行状态等类型的变更消息

公共参数
请求参数
名称 类型 是否必须 示例值 描述
msgTypeStringY消息类型1-商品状态变更消息 2-商品价格变动消息 3-订单行状态变动消息 4-地址变更消息
pageNoStringY10页码
pageSizeStringY20每页条数
响应参数
名称 类型 示例值 描述
msgTypeString1消息类型
msgListString
idString1消息id
statusString商品状态变更: 1-上架;2-下架;3-商品铺货;4-取消铺货;5-商品删除; 商品价格变更: 6-商品价格变动; 订单行状态变更: 0待支付、2待收货、3已完成、4已取消、5已退货子消息类型
productCodeString11784103280商品编码
supplierCodeString0000000000商家编码
createTimeString秒级,如1595424210更新时间
orderNoString004859613055订单号
channelString1渠道
orderItemNoString00485961305501订单行号
afterchangedString
idString02区域编码
levelString1级别:1.省 2市 3区/ 县 4镇
nameString万项沙镇名称
pidString父级区域编码02009
snIdStringsnId+level为唯一标识792
secondPidString020Level为4-镇时,有值(对应的市区域编码)
beforeChangedString
idString02区域编码
levelString4级别:1.省 2市 3区/ 县 4镇
nameString万项沙镇名称
pidString02009父级区域编码
snIdStringsnId+level为唯一标识792
secondPidString020Level为4-镇时,有值(对应的市区域编码)
optString10-新增,1-修改,2-删除
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                <sn_request>
  <sn_body>
    <queryQuerymessage>
      <msgType>消息类型</msgType>
      <pageNo>10</pageNo>
      <pageSize>20</pageSize>
    </queryQuerymessage>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "queryQuerymessage": {
        "msgType": "消息类型",
        "pageNo": "10",
        "pageSize": "20"
      }
    }
  }
}
                                
响应示例
  • 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>
    <queryQuerymessage>
      <msgType>1</msgType>
      <msgList>
        <opt>1</opt>
        <orderNo>004859613055</orderNo>
        <productCode>11784103280</productCode>
        <createTime>秒级,如1595424210</createTime>
        <channel>1</channel>
        <orderItemNo>00485961305501</orderItemNo>
        <id>1</id>
        <supplierCode>0000000000</supplierCode>
        <status>商品状态变更: 1-上架;2-下架;3-商品铺货;4-取消铺货;5-商品删除; 商品价格变更: 6-商品价格变动; 订单行状态变更: 0待支付、2待收货、3已完成、4已取消、5已退货</status>
        <afterchanged>
          <secondPid>020</secondPid>
          <snId>snId+level为唯一标识</snId>
          <level>1</level>
          <name>万项沙镇</name>
          <pid>父级区域编码</pid>
          <id>02</id>
        </afterchanged>
        <beforeChanged>
          <secondPid>020</secondPid>
          <snId>snId+level为唯一标识</snId>
          <level>4</level>
          <name>万项沙镇</name>
          <pid>02009</pid>
          <id>02</id>
        </beforeChanged>
      </msgList>
    </queryQuerymessage>
  </sn_body>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_head": {
      "totalSize": "1",
      "pageTotal": "1",
      "pageNo": "1",
      "returnMessage": "biz.handler.data-get:success"
    },
    "sn_body": {
      "queryQuerymessage": [
        {
          "msgType": "1",
          "msgList": [
            {
              "opt": "1",
              "orderNo": "004859613055",
              "productCode": "11784103280",
              "createTime": "秒级,如1595424210",
              "channel": "1",
              "orderItemNo": "00485961305501",
              "id": "1",
              "supplierCode": "0000000000",
              "status": "商品状态变更: 1-上架;2-下架;3-商品铺货;4-取消铺货;5-商品删除; 商品价格变更: 6-商品价格变动; 订单行状态变更: 0待支付、2待收货、3已完成、4已取消、5已退货",
              "afterchanged": [
                {
                  "secondPid": "020",
                  "snId": "snId+level为唯一标识",
                  "level": "1",
                  "name": "万项沙镇",
                  "pid": "父级区域编码",
                  "id": "02"
                }
              ],
              "beforeChanged": [
                {
                  "secondPid": "020",
                  "snId": "snId+level为唯一标识",
                  "level": "4",
                  "name": "万项沙镇",
                  "pid": "02009",
                  "id": "02"
                }
              ]
            }
          ]
        }
      ]
    }
  }
}
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
biz.sngoods.queryquerymessage.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.handler.data-get:no-result 查询没结果 请检查查询参数
isp.sys.service.unavailable.snyh 服务不可用 请联系苏宁技术人员
biz.sngoods.queryquerymessage.invalid-biz:100 请求参数为空 请求参数为空
biz.sngoods.queryquerymessage.invalid-biz:101 参数校验未通 参数校验未通
biz.sngoods.queryquerymessage.invalid-biz:102 请求参数转换异常 请求参数转换异常
biz.sngoods.queryquerymessage.invalid-biz:103 查询订单行状态信息异常 查询订单行状态信息异常
biz.sngoods.queryquerymessage.invalid-biz:104 该用户没有查询权限 该用户没有查询权限
biz.sngoods.queryquerymessage.invalid-biz:105 没有对应类型的信息 没有对应类型的信息
公共异常码
API工具
FAQ