购物车2促销活动查询和用券校验
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
appMethod | String | Y | suning.custom.category.query | 方法名 |
appRequestTime | String | Y | 2012-04-25 20:23:30 | 时间戳,格式为yyyy-MM-dd HH:mm:ss,例如:2012-04-25 20:23:30。API服务端允许客户端请求时间误差为10分钟。 |
format | String | N | XML | 默认xml,可指定格式为xml,json |
appKey | String | Y | b0c332a133c102765f39de********** | 分配给应用的访问令牌 |
versionNo | String | Y | v1.2 | API的版本,目前为v1.2版本 |
signInfo | String | Y | 460d7ff15b073e463125b4********** | appSecret,appMethod ,appRequestTime, appKey, versionNo, 请求报文base64加密后的数据顺序MD5(32位小写),其中appSecret为appKey对应的密钥 |
access_token | String | N | a1c5c62b08df3a3cbf7efd********** | 采用OAuth授权方式为必填参数 |
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
memberNo | String | Y | 18397652345 | 会员编号 (即外平台唯一会员编号) |
cartTwoNo | String | Y | 123 | 购物车2号 (外平台购物车2号,外平台首次进入购物车2页(即确认订单页),默认传【0】,苏宁会在当前接口的返回值中返回标准的“购物车2号”;外平台只要没离开车2页,调用购物车2的相关接口,入参都传苏宁返回的“购物车2号”;若果外平台离开车2页再进,就得重传【0】获取新的“购物车2号”) |
chanId | String | Y | 01 | 操作渠道 (01:PC,02:APP,03:WAP) |
city | String | Y | 南京市 | 城市名称 (即苏宁标准城市名) |
mainProductList | String | N | ||
itemId | String | Y | 12345671334 | 行项目号 (外平台购物车2行号,需要和提交订单时的“订单行号”保持一致) |
cmmdtyCode | String | Y | 000013431234512345 | 商品编码 (苏宁标准18位商品编码) |
businessSign | String | Y | 0 | 商品业务标识 (0:普通商品;1:海外购;) 默认传:【0】普通商品; |
marketingActivityType | String | Y | 4-1 | 营销活动类型 (0:普通商品;4-1:大聚惠;4-9:限时促销;4-12:掌上抢;14:促销价;15:大促价;) |
price | String | Y | 1.00 | 商品价格 |
saleNum | String | Y | 2 | 商品销售数量 |
shopCode | String | N | 123456 | 店铺编码,C店商品时必填 |
supplierCode | String | N | 0000000000 | 供应商编码,C店商品时必填 |
couponUsedList | String | N | ||
couponNumber | String | Y | 010134715354 | 券号码 (可用劵中已勾选的劵号码) |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
cartTwoNo | String | 1234112351323 | 购物车2号 |
activityList | String | ||
activityType | String | 2 | 活动类型 (2:订单促销) |
activityShowType | String | 1 | 活动展示类型 (1:自选套餐 2:联合满减 3:优惠换购 4:大促X元N件 5:年费会员套餐 6:订单满赠) |
activityId | String | 13124154123 | 活动编码 |
activityDesc | String | 活动描述 | 活动描述 |
limitSatisfied | String | 1 | 限制条件是否满足 (1.满足累计上下限 2.不满足上限 3.不满足下限) |
gapNumber | String | 1 | 累计件数差值 |
maxLimit | String | 100 | 订单商品数量累计上限 |
minLimit | String | 1 | 订单商品数量累计下限 |
bonusList | String | ||
bonusId | String | 1241241231 | 奖励ID |
bonusType | String | 1 | 奖励类型 (1:直降) |
bonusRulesDesc | String | 全额抵用 | 奖励规则信息 |
remainingQty | String | 12 | 实际奖励数量 |
isSatisfied | String | 1 | 是否满足 (0:不满足,1:满足) |
distanceValue | String | 1 | 差距数值 (若不满足,还差多少;针对订单级活动) |
sharingDetailList | String | ||
itemId | String | 1211241231 | 商品行项目号 |
sharingAmountForItem | String | 1.00 | 分摊优惠 |
bonusClassifierType | String | 1 | 基数量词类型 (1:金额,3:件数;该字段和<差距数值>结合使用,指明<差距数值>差的是“金额”还是“件数”。) |
succeedCouponUsingList | String | ||
couponNumber | String | 12314123123 | 券号码 |
couponRuleId | String | 1201808070001603578 | 券使用规则ID (例如:1201808070001603578) |
couponRulesShowMsg | String | 限自营传统品类品类部分商品使用 | 券使用规则展示信息 |
couponRuleName | String | 45减30老带新 | 券使用规则名称 |
couponType | String | 10001 | 券类型 (10001 云券 10002 限品类云券 10004 易券 10005 限品类易券 10009 无敌劵) |
startTime | String | 2018-01-01 23:59:59 | 开始时间 |
endTime | String | 2018-01-01 23:59:59 | 结束时间 |
usedAmount | String | 1.00 | 用券金额 |
balance | String | 1.00 | 券余额 |
achieveOffsetMark | String | 1 | 是否达到抵扣标识 (海外购业务使用 1:达到 0:未达到) |
usingDetailList | String | ||
itemId | String | 1231231231 | 项目行号 |
usingAmountForItem | String | 1.00 | 行项目分摊金额 |
failedCouponUsingList | String | ||
couponNumber | String | 12314123123 | 券号码 |
couponRuleName | String | 45减30老带新 | 券使用规则名称 |
failedReason | String | 1 | 失败原因 (券不存在----1 券已被停用-----2 券非绑定状态----3 券不在有效期内----4 账户不一致----5 商品范围不符合----6 券使用终端不符合----7 券使用地点不符合----8 上下限校验不通过----9 券互斥----10 券属于线下补券----11 金额不满足层级----12 券余额小于等于0---13 该订单类型不可用券---14 业务标识或营销活动标识不可用券---15 配送方式不符合----16 自提金额不符合----17 删除 符合该券的商品已包邮----18 超过每会员每单限用张数----19(824版本券号密码) 超过每单限用张数---20) 超过云券每单限用张数---97 |
<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" } } } }
<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" } ] } ] } } } }
异常码 | 错误描述 | 解决方案 |
---|---|---|
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 | 系统繁忙 | 请联系苏宁技术人员 |
异常码 | 错误描述 | 解决方案 |
---|---|---|
sys.check.user-permission:inexistence | 访问令牌不存在 | 更换访问令牌 |
sys.check.user-permission:overdue | 访问令牌已过期 | 请使用刷新令牌刷新 |
sys.check.api-permission:inexistence | Api方法不存在 | 请参考帮助中心 |
sys.check.api-permission:overdue | Api方法已过期 | 请参考帮助中心 |
sys.check.method-permission:authority | 无权操作此api | 确认是否有访问该方法权限 |
sys.auth.vendor-request:errory | 无权操作此供应商 | 请确认供应商编码是否正确 |
sys.controller.api-request:limit | Api请求受控 | 超过请求次数 |
sys.check.app-time:error | 请求参数错误api请求时间误差大 | 参考帮助中心 |
sys.check.request-params:error | 请求报文结构错误 | 参考帮助中心、日期格式等 |
sys.check.starttime-format:error | 请求开始时间错误 | 参考帮助中心、日期格式等 |
biz.handler.data-get:success | 业务数据查询成功 | 无 |
biz.handler.data-get:fail | 业务数据查询失败 | 检查请求条件 |
biz.handler.data-get:no-result | 业务数据结果为空 | 无 |
sys.check.pageno-format:error | pageNo格式错误,只允许1到99999之间的整数 | 检查pageNo输入是否有误 |
sys.check.pagesize-format:error | pageSize格式错误,只允许1到50之间的整数(订单相关是1到100) | 检查pageSize输入是否有误 |
sys.check.page-param:error | pageNo或者pageSize不在要求范围内,pageNo只允许1到99999之间的整数,pageSize只允许1到50之间的整数(订单相关是1到100) | 检查pageNo和pageSize输入是否有误 |
sys.check.miss-time:starttime | 不存在开始时间(节点) | 检查输入 |
sys.check.miss-time:endtime | 不存在结束时间(节点) | 检查输入 |
sys.check.starttime-value:null | 开始时间为空(值) | 检查输入 |
sys.check.endtime-value:null | 结束时间为空(值) | 检查输入 |
sys.check.starttime-format:error | 校验开始时间不合法,格式yyyy-MM-dd HH:mm:ss | 检查时间格式 |
sys.check.endtime-format:error | 校验结束时间不合法,格式yyyy-MM-dd HH:mm:ss | 检查时间格式 |
sys.check.query-time:error | 开始时间是否小于结束时间 | 检查开始和结束时间大小 |
sys.check.query-time:outofrange | 时间查询是否超出指定范围 | 检查时间范围 |
sys.check.app-sign:null | 签名信息为空 | 检查签名信息 |
sys.check.app-sign:error | 签名信息错误 | 检查签名信息 |
sys.check.missing-parameter:apiversion | API版本号未指定 | 检查API版本号 |
sys.check.missing-parameter:appRequestTime | 请求时间丢失 | 检查请求时间 |
sys.check.missing-nestElement:sn_body | 缺少sn_body节点 | 检查sn_body是否存在 |
sys.check.user-permission:inexistence | 用户key不存在 | 检查用户key是否存在 |
biz.handler.batch-handler:no-support | 非查询类API不支持批量操作 | 检查API类型 |
biz.handler.request-message:error | 查询类API输入多个业务节点 | 检查业务节点 |
sys.check.header-param:null | header参数为空 | 请检查header参数 |
sys.controller.api-access:limit | 访问限制 | 无 |
sys.controller.api-frequency:limit | 访问频率限制 | 无 |
sys.error.network:failure | 网络异常 | 无 |
sys.error.network-status:? | 响应失败 ?为状态码 | 无 |
sys.check.snunionid.length.is.not:48 | 混淆会员编码长度不是48位 | 使用转换器转换混淆会员编码规定要求混淆会员编码48位 |