API接口目录

电商能力输出业务

商品API
商品API
价格API
订单API
营销API
基础数据API
物流API
促销API
同城帮定制API
优惠券定制业务API
会员API
客服沟通咨询API
三方库存API
账单API
异常码自查工具
suning.online.activity.get 获取大聚惠活动信息
¥免费

获取大聚会活动信息

公共参数
请求参数
名称 类型 是否必须 示例值 描述
cmmdtyCodeStringY1234456789商品编码
activityIdStringN213333333大聚惠活动ID
chanIdStringN02下单渠道
supplierCodeStringN0000000000供应商编码
shopCodeStringN026店铺编码
响应参数
名称 类型 示例值 描述
activityInfoString
cmmdtyCodeString123456789商品编码
activityIdString1232445活动ID
beginDateString2018-01-10 00:00:00抢购开始时间
endDateString2018-01-22 23;59:59抢购结束时间
limitedNumString2个人限购数量返回空时业务含义是不限购
saleStatusString1预热是否可售 有预热活动时有值 1:可售、0:不可售, 无值时传空
preBeginDateString2018-01-10 00:00:00预热开始时间
activityCurStageString0活动当前阶段 0活动未开始,1预热,2爆发
activityControlString1活动控制内容 1:限量,2:限购,4:限时
limitBuyTypeString1限购类型 限购时才有值 1、每人限购;2、每订单限购;3、每人每天限购
startCountString1起售数量 (若有值,则返回值,若无值,则返回空)
shopCodeString026店铺编码
supplierCodeString00000000供应商编码
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                
<sn_request>
  <sn_body>
    <getActivity>
      <shopCode>026</shopCode>
      <activityId>213333333</activityId>
      <cmmdtyCode>1234456789</cmmdtyCode>
      <chanId>02</chanId>
      <supplierCode>0000000000</supplierCode>
    </getActivity>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "getActivity": {
        "shopCode": "026",
        "activityId": "213333333",
        "cmmdtyCode": "1234456789",
        "chanId": "02",
        "supplierCode": "0000000000"
      }
    }
  }
}
			
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              
<sn_responseContent>
  <sn_body>
    <getActivity>
      <activityInfo>
        <activityControl>1</activityControl>
        <shopCode>026</shopCode>
        <startCount>1</startCount>
        <endDate>2018-01-22 23;59:59</endDate>
        <cmmdtyCode>123456789</cmmdtyCode>
        <limitedNum>2</limitedNum>
        <saleStatus>1</saleStatus>
        <supplierCode>00000000</supplierCode>
        <activityCurStage>0</activityCurStage>
        <activityId>1232445</activityId>
        <beginDate>2018-01-10 00:00:00</beginDate>
        <limitBuyType>1</limitBuyType>
        <preBeginDate>2018-01-10 00:00:00</preBeginDate>
      </activityInfo>
    </getActivity>
  </sn_body>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_body": {
      "getActivity": {
        "activityInfo": [
          {
            "activityControl": "1",
            "shopCode": "026",
            "startCount": "1",
            "endDate": "2018-01-22 23;59:59",
            "cmmdtyCode": "123456789",
            "limitedNum": "2",
            "saleStatus": "1",
            "supplierCode": "00000000",
            "activityCurStage": "0",
            "activityId": "1232445",
            "beginDate": "2018-01-10 00:00:00",
            "limitBuyType": "1",
            "preBeginDate": "2018-01-10 00:00:00"
          }
        ]
      }
    }
  }
}
			
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
biz.online.getactivity.format-error:* 参数格式错误 请检查此参数的值,*号表示参数字段名
biz.online.getactivity.length-overlong:* 参数的值超过规定长度 请检查此参数的值,*号表示参数字段名
biz.online.getactivity.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.handler.data-get:no-result 查询没结果 请检查查询参数
isp.sys.service.unavailable.pangu 服务不可用 请联系苏宁技术人员
biz.online.getactivity.invalid-biz:100 商品不在选品范围内 联系运营查看商品状态
biz.online.getactivity.invalid-biz:101 未查询到活动信息 重新获取价格
公共异常码
API工具
FAQ