API接口目录

电商能力输出业务

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

营销资格检查

公共参数
请求参数
名称 类型 是否必须 示例值 描述
activityInfoStringN
cmmdtyCodeStringY123456789商品编码
memberNoStringY290392会员编码
activityIdStringY34567788营销活动ID
saleNumStringY2销售数量
cartItemIdStringY12312123123商品行号
chanIdStringN02下单渠道(01:PC,02:APP,03:WAP)
supplierCodeStringN0000000000供应商编码
shopCodeStringN026店铺编码
响应参数
名称 类型 示例值 描述
activityResultInfoString
canBuyString0: 用户已超过单人限购数量 1:用户有资格购买 2:商品暂不销售 3:活动剩余数量不足 4:用户还有机会购买 5:商品占用数量不足 6:购买数量小于起售数量是否有资格购买
cmmdtyCodeString123456789商品编码
limitedNumString10个人限购数量返回空时业务含义是不限购
remanentQtyString50活动剩余数量返回为空时业务含义是不限购
taskUpQtyString3商品占用数量
startCountString1起售数量 (若有值,则返回值,若无值,则返回空)
cartItemIdString12312123123商品行号
shopCodeString026店铺编码
supplierCodeString0000000000供应商编码
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                
<sn_request>
  <sn_body>
    <confirmActivity>
      <activityInfo>
        <shopCode>026</shopCode>
        <activityId>34567788</activityId>
        <memberNo>290392</memberNo>
        <cmmdtyCode>123456789</cmmdtyCode>
        <chanId>02</chanId>
        <supplierCode>0000000000</supplierCode>
        <saleNum>2</saleNum>
        <cartItemId>12312123123</cartItemId>
      </activityInfo>
    </confirmActivity>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "confirmActivity": {
        "activityInfo": [
          {
            "shopCode": "026",
            "activityId": "34567788",
            "memberNo": "290392",
            "cmmdtyCode": "123456789",
            "chanId": "02",
            "supplierCode": "0000000000",
            "saleNum": "2",
            "cartItemId": "12312123123"
          }
        ]
      }
    }
  }
}
			
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              
<sn_responseContent>
  <sn_body>
    <confirmActivity>
      <activityResultInfo>
        <shopCode>026</shopCode>
        <startCount>1</startCount>
        <remanentQty>50</remanentQty>
        <cmmdtyCode>123456789</cmmdtyCode>
        <limitedNum>10</limitedNum>
        <supplierCode>0000000000</supplierCode>
        <canBuy>0: 用户已超过单人限购数量 1:用户有资格购买 2:商品暂不销售 3:活动剩余数量不足 4:用户还有机会购买 5:商品占用数量不足 6:购买数量小于起售数量</canBuy>
        <cartItemId>12312123123</cartItemId>
        <taskUpQty>3</taskUpQty>
      </activityResultInfo>
    </confirmActivity>
  </sn_body>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_body": {
      "confirmActivity": {
        "activityResultInfo": [
          {
            "shopCode": "026",
            "startCount": "1",
            "remanentQty": "50",
            "cmmdtyCode": "123456789",
            "limitedNum": "10",
            "supplierCode": "0000000000",
            "canBuy": "0: 用户已超过单人限购数量 1:用户有资格购买 2:商品暂不销售 3:活动剩余数量不足 4:用户还有机会购买 5:商品占用数量不足 6:购买数量小于起售数量",
            "cartItemId": "12312123123",
            "taskUpQty": "3"
          }
        ]
      }
    }
  }
}
			
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
isp.sys.service.unavailable.pangu 服务不可用 请联系苏宁技术人员
biz.online.confirmactivity.format-error:* 参数格式错误 请检查此参数的值,*号表示参数字段名
biz.online.confirmactivity.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.online.confirmactivity.invalid-biz:100 大聚会活动检查失败,未知原因建议重试
biz.online.confirmactivity.invalid-biz:101 该单含有非选品商品,商品编码为*,不可销售
biz.online.confirmactivity.invalid-biz:102 未找到原始校验行项目
biz.online.confirmactivity.invalid-biz:103 未查询到平台配置信息
公共异常码
API工具
FAQ