API接口目录

电商能力输出业务

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

购物车2促销活动查询和用券校验

公共参数
请求参数
名称 类型 是否必须 示例值 描述
memberNoStringY18397652345会员编号 (即外平台唯一会员编号)
cartTwoNoStringY123购物车2号 (外平台购物车2号,外平台首次进入购物车2页(即确认订单页),默认传【0】,苏宁会在当前接口的返回值中返回标准的“购物车2号”;外平台只要没离开车2页,调用购物车2的相关接口,入参都传苏宁返回的“购物车2号”;若果外平台离开车2页再进,就得重传【0】获取新的“购物车2号”)
chanIdStringY01操作渠道 (01:PC,02:APP,03:WAP)
cityStringY南京市城市名称 (即苏宁标准城市名)
mainProductListStringN
itemIdStringY12345671334行项目号 (外平台购物车2行号,需要和提交订单时的“订单行号”保持一致)
cmmdtyCodeStringY000013431234512345商品编码 (苏宁标准18位商品编码)
businessSignStringY0商品业务标识 (0:普通商品;1:海外购;) 默认传:【0】普通商品;
marketingActivityTypeStringY4-1营销活动类型 (0:普通商品;4-1:大聚惠;4-9:限时促销;4-12:掌上抢;14:促销价;15:大促价;)
priceStringY1.00商品价格
saleNumStringY2商品销售数量
shopCodeStringN123456店铺编码,C店商品时必填
supplierCodeStringN0000000000供应商编码,C店商品时必填
couponUsedListStringN
couponNumberStringY010134715354券号码 (可用劵中已勾选的劵号码)
响应参数
名称 类型 示例值 描述
cartTwoNoString1234112351323购物车2号
activityListString
activityTypeString2活动类型 (2:订单促销)
activityShowTypeString1活动展示类型 (1:自选套餐 2:联合满减 3:优惠换购 4:大促X元N件 5:年费会员套餐 6:订单满赠)
activityIdString13124154123活动编码
activityDescString活动描述活动描述
limitSatisfiedString1限制条件是否满足 (1.满足累计上下限 2.不满足上限 3.不满足下限)
gapNumberString1累计件数差值
maxLimitString100订单商品数量累计上限
minLimitString1订单商品数量累计下限
bonusListString
bonusIdString1241241231奖励ID
bonusTypeString1奖励类型 (1:直降)
bonusRulesDescString全额抵用奖励规则信息
remainingQtyString12实际奖励数量
isSatisfiedString1是否满足 (0:不满足,1:满足)
distanceValueString1差距数值 (若不满足,还差多少;针对订单级活动)
sharingDetailListString
itemIdString1211241231商品行项目号
sharingAmountForItemString1.00分摊优惠
bonusClassifierTypeString1基数量词类型 (1:金额,3:件数;该字段和<差距数值>结合使用,指明<差距数值>差的是“金额”还是“件数”。)
succeedCouponUsingListString
couponNumberString12314123123券号码
couponRuleIdString1201808070001603578券使用规则ID (例如:1201808070001603578)
couponRulesShowMsgString限自营传统品类品类部分商品使用券使用规则展示信息
couponRuleNameString45减30老带新券使用规则名称
couponTypeString10001券类型 (10001 云券 10002 限品类云券 10004 易券 10005 限品类易券 10009 无敌劵)
startTimeString2018-01-01 23:59:59开始时间
endTimeString2018-01-01 23:59:59结束时间
usedAmountString1.00用券金额
balanceString1.00券余额
achieveOffsetMarkString1是否达到抵扣标识 (海外购业务使用 1:达到 0:未达到)
usingDetailListString
itemIdString1231231231项目行号
usingAmountForItemString1.00行项目分摊金额
failedCouponUsingListString
couponNumberString12314123123券号码
couponRuleNameString45减30老带新券使用规则名称
failedReasonString1失败原因 (券不存在----1 券已被停用-----2 券非绑定状态----3 券不在有效期内----4 账户不一致----5 商品范围不符合----6 券使用终端不符合----7 券使用地点不符合----8 上下限校验不通过----9 券互斥----10 券属于线下补券----11 金额不满足层级----12 券余额小于等于0---13 该订单类型不可用券---14 业务标识或营销活动标识不可用券---15 配送方式不符合----16 自提金额不符合----17 删除 符合该券的商品已包邮----18 超过每会员每单限用张数----19(824版本券号密码) 超过每单限用张数---20) 超过云券每单限用张数---97
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                <sn_request>
  <sn_body>
    <confirmCarttwoactandcoupon>
      <memberNo>18397652345</memberNo>
      <mainProductList>
        <shopCode>123456</shopCode>
        <itemId>12345671334</itemId>
        <marketingActivityType>4-1</marketingActivityType>
        <price>1.00</price>
        <cmmdtyCode>000013431234512345</cmmdtyCode>
        <businessSign>0</businessSign>
        <supplierCode>0000000000</supplierCode>
        <saleNum>2</saleNum>
      </mainProductList>
      <couponUsedList>
        <couponNumber>010134715354</couponNumber>
      </couponUsedList>
      <cartTwoNo>123</cartTwoNo>
      <city>南京市</city>
      <chanId>01</chanId>
    </confirmCarttwoactandcoupon>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "confirmCarttwoactandcoupon": {
        "memberNo": "18397652345",
        "mainProductList": [
          {
            "shopCode": "123456",
            "itemId": "12345671334",
            "marketingActivityType": "4-1",
            "price": "1.00",
            "cmmdtyCode": "000013431234512345",
            "businessSign": "0",
            "supplierCode": "0000000000",
            "saleNum": "2"
          }
        ],
        "couponUsedList": [
          {
            "couponNumber": "010134715354"
          }
        ],
        "cartTwoNo": "123",
        "city": "南京市",
        "chanId": "01"
      }
    }
  }
}
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              <sn_responseContent>
  <sn_body>
    <confirmCarttwoactandcoupon>
      <failedCouponUsingList>
        <couponRuleName>45减30老带新</couponRuleName>
        <couponNumber>12314123123</couponNumber>
        <failedReason>1</failedReason>
      </failedCouponUsingList>
      <succeedCouponUsingList>
        <couponRuleName>45减30老带新</couponRuleName>
        <couponRulesShowMsg>限自营传统品类品类部分商品使用</couponRulesShowMsg>
        <achieveOffsetMark>1</achieveOffsetMark>
        <couponRuleId>1201808070001603578</couponRuleId>
        <balance>1.00</balance>
        <couponNumber>12314123123</couponNumber>
        <couponType>10001</couponType>
        <usedAmount>1.00</usedAmount>
        <startTime>2018-01-01 23:59:59</startTime>
        <usingDetailList>
          <itemId>1231231231</itemId>
          <usingAmountForItem>1.00</usingAmountForItem>
        </usingDetailList>
        <endTime>2018-01-01 23:59:59</endTime>
      </succeedCouponUsingList>
      <cartTwoNo>1234112351323</cartTwoNo>
      <activityList>
        <activityId>13124154123</activityId>
        <activityShowType>1</activityShowType>
        <maxLimit>100</maxLimit>
        <minLimit>1</minLimit>
        <limitSatisfied>1</limitSatisfied>
        <activityType>2</activityType>
        <gapNumber>1</gapNumber>
        <activityDesc>活动描述</activityDesc>
        <bonusList>
          <bonusClassifierType>1</bonusClassifierType>
          <distanceValue>1</distanceValue>
          <isSatisfied>1</isSatisfied>
          <bonusId>1241241231</bonusId>
          <bonusType>1</bonusType>
          <bonusRulesDesc>全额抵用</bonusRulesDesc>
          <remainingQty>12</remainingQty>
        </bonusList>
      </activityList>
    </confirmCarttwoactandcoupon>
  </sn_body>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_body": {
      "confirmCarttwoactandcoupon": {
        "failedCouponUsingList": [
          {
            "couponRuleName": "45减30老带新",
            "couponNumber": "12314123123",
            "failedReason": "1"
          }
        ],
        "succeedCouponUsingList": [
          {
            "couponRuleName": "45减30老带新",
            "couponRulesShowMsg": "限自营传统品类品类部分商品使用",
            "achieveOffsetMark": "1",
            "couponRuleId": "1201808070001603578",
            "balance": "1.00",
            "couponNumber": "12314123123",
            "couponType": "10001",
            "usedAmount": "1.00",
            "startTime": "2018-01-01 23:59:59",
            "usingDetailList": [
              {
                "itemId": "1231231231",
                "usingAmountForItem": "1.00"
              }
            ],
            "endTime": "2018-01-01 23:59:59"
          }
        ],
        "cartTwoNo": "1234112351323",
        "activityList": [
          {
            "activityId": "13124154123",
            "activityShowType": "1",
            "maxLimit": "100",
            "minLimit": "1",
            "limitSatisfied": "1",
            "activityType": "2",
            "gapNumber": "1",
            "activityDesc": "活动描述",
            "bonusList": [
              {
                "bonusClassifierType": "1",
                "distanceValue": "1",
                "isSatisfied": "1",
                "bonusId": "1241241231",
                "bonusType": "1",
                "bonusRulesDesc": "全额抵用",
                "remainingQty": "12"
              }
            ]
          }
        ]
      }
    }
  }
}
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
biz.online.confirmcarttwoactandcoupon.format-error:* 参数格式错误 请检查此参数的值,*号表示参数字段名
biz.online.confirmcarttwoactandcoupon.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
isp.sys.service.unavailable.pangu 服务不可用 请联系苏宁技术人员
biz.online.confirmcarttwoactandcoupon.invalid-biz:100 未查询到平台配置信息 请联系苏宁技术人员
biz.online.confirmcarttwoactandcoupon.invalid-biz:101 包含非选品,商品编码XX 请联系苏宁技术人员
biz.online.confirmcarttwoactandcoupon.invalid-biz:102 地址解析错误,地址描述XX 请联系苏宁技术人员
biz.online.confirmcarttwoactandcoupon.invalid-biz:103 会员编号转换异常,会员号XX 请联系苏宁技术人员
biz.online.confirmcarttwoactandcoupon.invalid-biz:104 参数校验不通过 请联系苏宁技术人员
biz.online.confirmcarttwoactandcoupon.invalid-biz:105 系统繁忙 请联系苏宁技术人员
公共异常码
API工具
FAQ