线上预约活动创建:
1.活动创建
2.活动修改
3.活动停用
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
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授权方式为必填参数 |
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
enrollInfoCode | String | Y | SU191028101810140135 | 报文唯一标识 |
versionNumber | String | Y | 1 | 版本号 |
actionId | String | N | 2019102800001 | 活动ID,创建时无需传值,修改\停用场景必须传值 |
actionType | String | Y | 0:普通预约 | 预约活动类型 |
actionName | String | Y | 预约活动名称 | 活动名称 |
operateType | String | Y | 01:新建,02:修改,03:停用 | 操作类型 |
adapteTerminal | String | Y | 1:PC,2:移动,3:PC+移动 | 活动适用终端 |
actionStartTime | String | Y | 2019-10-01 00:00:01 | 活动开始时间 |
scheduleStartTime | String | Y | 2019-10-01 00:00:01 | 预约开始时间 |
scheduleEndTime | String | Y | 2019-10-01 00:00:01 | 预约结束时间 |
supervipPurchaseStartTime | String | N | 2019-10-01 00:00:01 | 付费会员购买开始时间 |
purchaseStartTime | String | Y | 2019-10-01 00:00:01 | 普通会员抢购开始时间 |
ticketResaleStartTime | String | Y | 2019-10-01 00:00:01 | 黄牛购买开始时间 |
purchaseEndTime | String | Y | 2019-10-01 00:00:01 | 活动抢购结束时间 |
actionEndTime | String | Y | 2019-10-01 00:00:01 | 活动结束时间 |
sendUserMsg | String | Y | 0:不发送,1:发送 | 是否给用户发送抢购提醒短信 |
sendScalperMsg | String | Y | 0:不发送,1:发送 | 是否给黄牛用户发送抢购提醒短信 |
excludeCitys | String | Y | 9017,9264 | 活动排除城市 |
vendorType | String | Y | 00-自营,10-代表C模式,20-代表SWL模式,30-代表海外购模式,50-线上联营 | 商家类型 |
vendorCode | String | Y | 0000000000 | 商家编码 |
vendorName | String | Y | 商家名称 | 商家名称 |
transitFlag | String | Y | 2:否,1:是 | 是否在途 |
transitDate | String | N | 2019-10-01 00:00:01 | 在途时间 |
noticePhone | String | Y | 11111111111 | 商家通知手机号 |
otherTerminalSale | String | Y | 0:否,1:是 | 其他渠道是否可售 |
phoneShareImgUrl | String | Y | url链接 | 移动端分享链接 |
phoneShareTitle | String | Y | 我在苏宁易购预约了商品 | 移动端分享标题 |
phoneShareContent | String | Y | ***商品正在做预约 | 移动端分享内容 |
phoneShareUrl | String | Y | url链接 | 移动端分享链接地址 |
receiveSys | String | Y | AAAA | 请求方系统系统 |
partType | String | Y | 00:普通单商品,01:通子码商品,02:蔟商品,03:套餐商品 | 商品类型 |
operateUser | String | Y | 工号 | 操作人 |
goodsList | String | N | ||
totalLimit | String | Y | 10000 | 活动下商品的可售数量 |
personBuyLimit | String | Y | 2 | 活动下商品的单人可购买数量 |
partnumber | String | Y | 000000000123456789 | 商品编码 |
partName | String | Y | 这是商品名称 | 商品名称 |
appointPrice | String | Y | 3999 | 预约价 |
priceLabel | String | Y | 3??9 | 预约文本价 |
price | String | Y | 3899 | 抢购价 |
standard | String | N | 42码 | 商品规格 |
color | String | N | 红色 | 商品颜色 |
defaultGoodsFlags | String | Y | 1 | 商品在频道页能显示0否,1是,多个商品时有且只有一个为1,至少有一个为1 |
msgContent | String | Y | 您好,您预约的XXX将于XXX开始抢购...... | 提醒用户抢购短信 |
catengrpCode | String | Y | 000000000123456788 | 通码商品编码 |
goodsSubList | String | N | ||
subPartName | String | Y | 这是子商品名称 | 子商品名称 |
subPartNumber | String | Y | 000000000123456789 | 子商品编码 |
count | String | Y | 2 | 套餐下子商品的数量 |
subAppointPrice | String | Y | 500 | 子商品预约价 |
subPrice | String | Y | 399 | 子商品抢购价 |
subTextPrice | String | Y | 299 | 子商品文本价 |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
resultCode | String | 1 | 结果编码 0:成功 1:失败 |
resultMsg | String | 系统错误 | 结果信息 |
enrollInfoCode | String | 1314520 | 报名信息编码 |
actionId | String | 201911260077 | 活动编码 |
<sn_request> <sn_body> <createAppoint> <actionEndTime>2019-10-01 00:00:01</actionEndTime> <vendorType>00-自营,10-代表C模式,20-代表SWL模式,30-代表海外购模式,50-线上联营</vendorType> <transitDate>2019-10-01 00:00:01</transitDate> <noticePhone>11111111111</noticePhone> <sendUserMsg>0:不发送,1:发送</sendUserMsg> <goodsList> <standard>42码</standard> <msgContent>您好,您预约的XXX将于XXX开始抢购......</msgContent> <totalLimit>10000</totalLimit> <color>红色</color> <catengrpCode>000000000123456788</catengrpCode> <price>3899</price> <personBuyLimit>2</personBuyLimit> <defaultGoodsFlags>1</defaultGoodsFlags> <appointPrice>3999</appointPrice> <partnumber>000000000123456789</partnumber> <partName>这是商品名称</partName> <priceLabel>3??9</priceLabel> </goodsList> <excludeCitys>9017,9264</excludeCitys> <scheduleStartTime>2019-10-01 00:00:01</scheduleStartTime> <vendorCode>0000000000</vendorCode> <phoneShareTitle>我在苏宁易购预约了商品</phoneShareTitle> <adapteTerminal>1:PC,2:移动,3:PC+移动</adapteTerminal> <ticketResaleStartTime>2019-10-01 00:00:01</ticketResaleStartTime> <receiveSys>AAAA</receiveSys> <otherTerminalSale>0:否,1:是</otherTerminalSale> <phoneShareImgUrl>url链接</phoneShareImgUrl> <operateUser>工号</operateUser> <actionStartTime>2019-10-01 00:00:01</actionStartTime> <enrollInfoCode>SU191028101810140135</enrollInfoCode> <sendScalperMsg>0:不发送,1:发送</sendScalperMsg> <partType>00:普通单商品,01:通子码商品,02:蔟商品,03:套餐商品</partType> <scheduleEndTime>2019-10-01 00:00:01</scheduleEndTime> <phoneShareContent>***商品正在做预约</phoneShareContent> <purchaseEndTime>2019-10-01 00:00:01</purchaseEndTime> <phoneShareUrl>url链接</phoneShareUrl> <supervipPurchaseStartTime>2019-10-01 00:00:01</supervipPurchaseStartTime> <operateType>01:新建,02:修改,03:停用</operateType> <vendorName>商家名称</vendorName> <versionNumber>1</versionNumber> <actionType>0:普通预约</actionType> <purchaseStartTime>2019-10-01 00:00:01</purchaseStartTime> <actionId>2019102800001</actionId> <goodsSubList> <subPartName>这是子商品名称</subPartName> <count>2</count> <subTextPrice>299</subTextPrice> <subPartNumber>000000000123456789</subPartNumber> <subAppointPrice>500</subAppointPrice> <subPrice>399</subPrice> </goodsSubList> <transitFlag>2:否,1:是</transitFlag> <actionName>预约活动名称</actionName> </createAppoint> </sn_body> </sn_request>
{ "sn_request": { "sn_body": { "createAppoint": { "actionEndTime": "2019-10-01 00:00:01", "vendorType": "00-自营,10-代表C模式,20-代表SWL模式,30-代表海外购模式,50-线上联营", "transitDate": "2019-10-01 00:00:01", "noticePhone": "11111111111", "sendUserMsg": "0:不发送,1:发送", "goodsList": [ { "standard": "42码", "msgContent": "您好,您预约的XXX将于XXX开始抢购......", "totalLimit": "10000", "color": "红色", "catengrpCode": "000000000123456788", "price": "3899", "personBuyLimit": "2", "defaultGoodsFlags": "1", "appointPrice": "3999", "partnumber": "000000000123456789", "partName": "这是商品名称", "priceLabel": "3??9" } ], "excludeCitys": "9017,9264", "scheduleStartTime": "2019-10-01 00:00:01", "vendorCode": "0000000000", "phoneShareTitle": "我在苏宁易购预约了商品", "adapteTerminal": "1:PC,2:移动,3:PC+移动", "ticketResaleStartTime": "2019-10-01 00:00:01", "receiveSys": "AAAA", "otherTerminalSale": "0:否,1:是", "phoneShareImgUrl": "url链接", "operateUser": "工号", "actionStartTime": "2019-10-01 00:00:01", "enrollInfoCode": "SU191028101810140135", "sendScalperMsg": "0:不发送,1:发送", "partType": "00:普通单商品,01:通子码商品,02:蔟商品,03:套餐商品", "scheduleEndTime": "2019-10-01 00:00:01", "phoneShareContent": "***商品正在做预约", "purchaseEndTime": "2019-10-01 00:00:01", "phoneShareUrl": "url链接", "supervipPurchaseStartTime": "2019-10-01 00:00:01", "operateType": "01:新建,02:修改,03:停用", "vendorName": "商家名称", "versionNumber": "1", "actionType": "0:普通预约", "purchaseStartTime": "2019-10-01 00:00:01", "actionId": "2019102800001", "goodsSubList": [ { "subPartName": "这是子商品名称", "count": "2", "subTextPrice": "299", "subPartNumber": "000000000123456789", "subAppointPrice": "500", "subPrice": "399" } ], "transitFlag": "2:否,1:是", "actionName": "预约活动名称" } } } }
<sn_responseContent> <sn_body> <createAppoint> <resultCode>1</resultCode> <actionId>201911260077</actionId> <enrollInfoCode>1314520</enrollInfoCode> <resultMsg>系统错误</resultMsg> </createAppoint> </sn_body> </sn_responseContent>
{ "sn_responseContent": { "sn_body": { "createAppoint": { "resultCode": "1", "actionId": "201911260077", "enrollInfoCode": "1314520", "resultMsg": "系统错误" } } } }
异常码 | 错误描述 | 解决方案 |
---|---|---|
biz.custom.createappoint.missing-parameter:* | 参数必填 | 请检查此参数的值,*号表示参数字段名 |
biz.custom.createappoint.length-overlong:* | 参数的值超过规定长度 | 请检查此参数的值,*号表示参数字段名 |
biz.custom.createappoint.enumeration-error:* | 参数的可选值错误 | 请检查此参数的值,*号表示参数字段名 |
biz.custom.createappoint.format-error:* | 参数格式错误 | 请检查此参数的值,*号表示参数字段名 |
isp.sys.service.unavailable.pss | 服务不可用 | 请联系苏宁技术人员 |
异常码 | 错误描述 | 解决方案 |
---|---|---|
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位 |