退出
热词搜索：
API接口目录

零售云业务

采购API
订单API
库存API
价格API
商品API
报表API
消息服务API
基础数据API
物流API
零售商认证API
发票API
快修回收API
云仓API
异常码自查工具
suning.retailer.cmmdtyinstall.query 零售云安装信息查询接口
￥免费

零售云安装信息查询接口

公共参数
请求参数
名称 类型 是否必须 示例值 描述
appIdStringY111111调用方唯一编码
merchantCustNoStringN7017963441老板账号编码
storeCodeStringN59021店铺编码
cmmdtyListStringN
itemNoStringYfd3af1ads4jlg3realf5ga行唯一标识
distributorCodeStringY0000000000分销商编码
cmmdtyCodeStringY000000000100004919商品编码
quantityStringY1数量
cityCodeStringY025城市编码
districtCodeStringY01区县编号
townCodeStringN99镇编码
addressStringY苏宁大道1号详细地址
isPrototypeStringN1是否样机，1：样机，空：非样机
selectedArrivalTimeStringN2018-07-30-1已选送达时间（yyyy-MM-dd-X X的取值： 1-白天； 2-上午； 3-下午； 4-晚上）
响应参数
名称 类型 示例值 描述
respListString
itemNoStringfd3af1ads4jlg3realf5ga行唯一标识（与入参匹配）
earlestArrivalDateString2018-08-07 09:00:00最早送货时间
earlestArrivalDatePointString2018-08-07-2最早送货时间点
estimateOutTimeString2018-08-07 11:04:00预计出库时间
hopeArrivalTimeString2018-08-07-2期望送达时间
unavailableArrivalTimesString
unavailableArrivalTimeString2018-07-25-1不可送达时间，日期格式: yyyy-MM-dd-X X的取值： 1-白天； 2-上午； 3-下午； 4-晚上
installationDatesString
installationDateString2018-07-25可服务日期（日期格式为yyyy-MM-dd）
installationTimesString
installationTimeString1可服务时间段（1上午； 2下午； 3白天； 4夜间； 默认的优先级是3（白天）>1（上午）、2（下午）>4（夜间））
plantCodeStringD025发货地点编码
factorySendFlagString01厂送标识（01:厂送，02：非厂送）
distributionStrategyString0配送策略
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                
<sn_request>
  <sn_body>
    <queryCmmdtyinstall>
      <appId>111111</appId>
      <cmmdtyList>
        <cmmdtyCode>000000000100004919</cmmdtyCode>
        <itemNo>fd3af1ads4jlg3realf5ga</itemNo>
        <isPrototype>1</isPrototype>
        <districtCode>01</districtCode>
        <address>苏宁大道1号</address>
        <cityCode>025</cityCode>
        <quantity>1</quantity>
        <selectedArrivalTime>2018-07-30-1</selectedArrivalTime>
        <distributorCode>0000000000</distributorCode>
        <townCode>99</townCode>
      </cmmdtyList>
      <merchantCustNo>7017963441</merchantCustNo>
      <storeCode>59021</storeCode>
    </queryCmmdtyinstall>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "queryCmmdtyinstall": {
        "appId": "111111",
        "cmmdtyList": [
          {
            "cmmdtyCode": "000000000100004919",
            "isPrototype": "1",
            "itemNo": "fd3af1ads4jlg3realf5ga",
            "districtCode": "01",
            "address": "苏宁大道1号",
            "cityCode": "025",
            "quantity": "1",
            "selectedArrivalTime": "2018-07-30-1",
            "distributorCode": "0000000000",
            "townCode": "99"
          }
        ],
        "merchantCustNo": "7017963441",
        "storeCode": "59021"
      }
    }
  }
}
响应示例
  • XML示例
  • JSON示例
复制全部代码 
                              
<sn_responseContent>
  <sn_body>
    <queryCmmdtyinstall>
      <respList>
        <itemNo>fd3af1ads4jlg3realf5ga</itemNo>
        <factorySendFlag>01</factorySendFlag>
        <estimateOutTime>2018-08-07 11:04:00</estimateOutTime>
        <unavailableArrivalTimes>
          <unavailableArrivalTime>2018-07-25-1</unavailableArrivalTime>
        </unavailableArrivalTimes>
        <earlestArrivalDate>2018-08-07 09:00:00</earlestArrivalDate>
        <earlestArrivalDatePoint>2018-08-07-2</earlestArrivalDatePoint>
        <hopeArrivalTime>2018-08-07-2</hopeArrivalTime>
        <distributionStrategy>0</distributionStrategy>
        <installationDates>
          <installationDate>2018-07-25</installationDate>
          <installationTimes>
            <installationTime>1</installationTime>
          </installationTimes>
        </installationDates>
        <plantCode>D025</plantCode>
      </respList>
    </queryCmmdtyinstall>
  </sn_body>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_body": {
      "queryCmmdtyinstall": {
        "respList": [
          {
            "factorySendFlag": "01",
            "itemNo": "fd3af1ads4jlg3realf5ga",
            "estimateOutTime": "2018-08-07 11:04:00",
            "unavailableArrivalTimes": [
              {
                "unavailableArrivalTime": "2018-07-25-1"
              }
            ],
            "earlestArrivalDate": "2018-08-07 09:00:00",
            "earlestArrivalDatePoint": "2018-08-07-2",
            "hopeArrivalTime": "2018-08-07-2",
            "distributionStrategy": "0",
            "plantCode": "D025",
            "installationDates": [
              {
                "installationDate": "2018-07-25",
                "installationTimes": [
                  {
                    "installationTime": "1"
                  }
                ]
              }
            ]
          }
        ]
      }
    }
  }
}
异常示例
  • XML示例
  • JSON示例
复制全部代码 

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
业务异常码
异常码 错误描述 解决方案
biz.retailer.querycmmdtyinstall.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.retailer.querycmmdtyinstall.format-error:* 参数格式错误 请检查此参数的值,*号表示参数字段名
biz.retailer.querycmmdtyinstall.length-overlong:* 参数的值超过规定长度 请检查此参数的值,*号表示参数字段名
biz.handler.data-get:no-result 查询没结果 请检查查询参数
isp.sys.service.unavailable.srcdss 服务不可用 请联系苏宁技术人员
biz.retailer.querycmmdtyinstall.invalid-biz:100 请求参数缺失或异常 请检查入参
biz.retailer.querycmmdtyinstall.invalid-biz:101 接口执行返回失败 请检查入参
biz.retailer.querycmmdtyinstall.invalid-biz:102 查询结果为空 请检查入参
biz.retailer.querycmmdtyinstall.invalid-biz:103 系统异常 请联系苏宁技术人员
biz.retailer.querycmmdtyinstall.invalid-biz:105 无效的AppId请求 请检查入参
biz.retailer.querycmmdtyinstall.invalid-biz:106 老板编号与门店不匹配 请检查入参
biz.retailer.querycmmdtyinstall.invalid-biz:107 请求参数超出最大限制20条 请检查入参
公共异常码
API工具
API TOOLS 在线测试工具异常码查询工具SDK调用示例SDK下载
FAQ