API接口目录

电商能力输出业务

商品API
商品API
价格API
订单API
营销API
基础数据API
物流API
促销API
同城帮定制API
优惠券定制业务API
会员API
客服沟通咨询API
三方库存API
账单API
异常码自查工具
suning.online.searchinstall.query 查询安装时效信息
¥免费

用户修改配送时效后,返回新的安装时效信息

公共参数
请求参数
名称 类型 是否必须 示例值 描述
cmmdtyCodeStringY000000000102423671商品编码
provinceStringY江苏省
cityStringY南京市
countyStringY江宁区区/县
villageStringN淳化镇镇/街道
addressStringYXXX小区XXX号详细地址
orderItemIdStringN99883884行项目号
saleNumStringY2销售数量
chanIdStringY02下单渠道
selectedArrivalTimeStringY2018-08-24-1用户已选送货时间
响应参数
名称 类型 示例值 描述
isSuccessStringY成功失败标识
selectedArrivalTimeFlagStringY配送时效校验标识
itemNoString99883884商品行项目号
selectedArrivalTimeString2018-11-12-1已选送货时间 格式为YYYY-MM-DD-X X的取值:1-白天;2-上午;3-下午;4-晚上
selectedInstallDateString[{"2018-08-19":["3","2","1"]}]已选安装时间【】
earliestArrivalTimeString2018-11-12-1最早送达时间 格式为YYYY-MM-DD-X X的取值:1-白天;2-上午;3-下午;4-晚上
availableArrivalTimeString[{"2018-08-03": ["1"], "2018-08-04": ["1"]}]可选送达时间
earliestServiceDateString[{"2018-08-19":["3","2","1"]}]最早安装时间
availableServiceDateString[{"2018-08-19":["3","2","1"]}]可选安装时间
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                <sn_request>
  <sn_body>
    <querySearchinstall>
      <cmmdtyCode>000000000102423671</cmmdtyCode>
      <village>淳化镇</village>
      <orderItemId>99883884</orderItemId>
      <county>江宁区</county>
      <address>XXX小区XXX号</address>
      <chanId>02</chanId>
      <province>江苏省</province>
      <selectedArrivalTime>2018-08-24-1</selectedArrivalTime>
      <saleNum>2</saleNum>
      <city>南京市</city>
    </querySearchinstall>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "querySearchinstall": {
        "cmmdtyCode": "000000000102423671",
        "village": "淳化镇",
        "address": "XXX小区XXX号",
        "county": "江宁区",
        "orderItemId": "99883884",
        "chanId": "02",
        "province": "江苏省",
        "selectedArrivalTime": "2018-08-24-1",
        "saleNum": "2",
        "city": "南京市"
      }
    }
  }
}
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              <sn_responseContent>
  <sn_body>
    <querySearchinstall>
      <itemNo>99883884</itemNo>
      <isSuccess>Y</isSuccess>
      <earliestServiceDate>[{"2018-08-19":["3","2","1"]}]</earliestServiceDate>
      <earliestArrivalTime>2018-11-12-1</earliestArrivalTime>
      <selectedArrivalTimeFlag>Y</selectedArrivalTimeFlag>
      <selectedArrivalTime>2018-11-12-1</selectedArrivalTime>
      <availableArrivalTime>[{"2018-08-03": ["1"], "2018-08-04": ["1"]}]</availableArrivalTime>
      <selectedInstallDate>[{"2018-08-19":["3","2","1"]}]</selectedInstallDate>
      <availableServiceDate>[{"2018-08-19":["3","2","1"]}]</availableServiceDate>
    </querySearchinstall>
  </sn_body>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_body": {
      "querySearchinstall": {
        "itemNo": "99883884",
        "earliestArrivalTime": "2018-11-12-1",
        "earliestServiceDate": "[{\"2018-08-19\":[\"3\",\"2\",\"1\"]}]",
        "isSuccess": "Y",
        "availableArrivalTime": "[{\"2018-08-03\": [\"1\"], \"2018-08-04\": [\"1\"]}]",
        "selectedArrivalTime": "2018-11-12-1",
        "selectedArrivalTimeFlag": "Y",
        "availableServiceDate": "[{\"2018-08-19\":[\"3\",\"2\",\"1\"]}]",
        "selectedInstallDate": "[{\"2018-08-19\":[\"3\",\"2\",\"1\"]}]"
      }
    }
  }
}
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
biz.online.querysearchinstall.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.handler.data-get:no-result 查询没结果 请检查查询参数
isp.sys.service.unavailable.pangu 服务不可用 请联系苏宁技术人员
biz.online.querysearchinstall.invalid-biz:100 平台账号无效 请联系苏宁业务人员
biz.online.querysearchinstall.invalid-biz:101 json转换异常 请检查报文格式
biz.online.querysearchinstall.invalid-biz:102 商品不在选品范围内,商品编码 请输入正确的商品编码
biz.online.querysearchinstall.invalid-biz:103 系统异常 请联系苏宁业务人员
公共异常码
API工具
FAQ