API接口目录

平台业务

商品API
价格API
库存API
销售准备API
交易API
退货退款API(新)
财务API
店铺API
物流API
促销API
分销API
发票API
招商API
换货API
互动营销API
退货退款API
客服API
平台营销API
风控API
会员通API
账房API
财务记账API
异常码自查工具
suning.custom.appoint.create 线上预约活动创建
¥免费

线上预约活动创建:
1.活动创建

2.活动修改

3.活动停用

公共参数
请求参数
名称 类型 是否必须 示例值 描述
enrollInfoCodeStringYSU191028101810140135报文唯一标识
versionNumberStringY1版本号
actionIdStringN2019102800001活动ID,创建时无需传值,修改\停用场景必须传值
actionTypeStringY0:普通预约预约活动类型
actionNameStringY预约活动名称活动名称
operateTypeStringY01:新建,02:修改,03:停用操作类型
adapteTerminalStringY1:PC,2:移动,3:PC+移动活动适用终端
actionStartTimeStringY2019-10-01 00:00:01活动开始时间
scheduleStartTimeStringY2019-10-01 00:00:01预约开始时间
scheduleEndTimeStringY2019-10-01 00:00:01预约结束时间
supervipPurchaseStartTimeStringN2019-10-01 00:00:01付费会员购买开始时间
purchaseStartTimeStringY2019-10-01 00:00:01普通会员抢购开始时间
ticketResaleStartTimeStringY2019-10-01 00:00:01黄牛购买开始时间
purchaseEndTimeStringY2019-10-01 00:00:01活动抢购结束时间
actionEndTimeStringY2019-10-01 00:00:01活动结束时间
sendUserMsgStringY0:不发送,1:发送是否给用户发送抢购提醒短信
sendScalperMsgStringY0:不发送,1:发送是否给黄牛用户发送抢购提醒短信
excludeCitysStringY9017,9264活动排除城市
vendorTypeStringY00-自营,10-代表C模式,20-代表SWL模式,30-代表海外购模式,50-线上联营商家类型
vendorCodeStringY0000000000商家编码
vendorNameStringY商家名称商家名称
transitFlagStringY2:否,1:是是否在途
transitDateStringN2019-10-01 00:00:01在途时间
noticePhoneStringY11111111111商家通知手机号
otherTerminalSaleStringY0:否,1:是其他渠道是否可售
phoneShareImgUrlStringYurl链接移动端分享链接
phoneShareTitleStringY我在苏宁易购预约了商品移动端分享标题
phoneShareContentStringY***商品正在做预约移动端分享内容
phoneShareUrlStringYurl链接移动端分享链接地址
receiveSysStringYAAAA请求方系统系统
partTypeStringY00:普通单商品,01:通子码商品,02:蔟商品,03:套餐商品商品类型
operateUserStringY工号操作人
goodsListStringN
totalLimitStringY10000活动下商品的可售数量
personBuyLimitStringY2活动下商品的单人可购买数量
partnumberStringY000000000123456789商品编码
partNameStringY这是商品名称商品名称
appointPriceStringY3999预约价
priceLabelStringY3??9预约文本价
priceStringY3899抢购价
standardStringN42码商品规格
colorStringN红色商品颜色
defaultGoodsFlagsStringY1商品在频道页能显示0否,1是,多个商品时有且只有一个为1,至少有一个为1
msgContentStringY您好,您预约的XXX将于XXX开始抢购......提醒用户抢购短信
catengrpCodeStringY000000000123456788通码商品编码
goodsSubListStringN
subPartNameStringY这是子商品名称子商品名称
subPartNumberStringY000000000123456789子商品编码
countStringY2套餐下子商品的数量
subAppointPriceStringY500子商品预约价
subPriceStringY399子商品抢购价
subTextPriceStringY299子商品文本价
响应参数
名称 类型 示例值 描述
resultCodeString1结果编码 0:成功 1:失败
resultMsgString系统错误结果信息
enrollInfoCodeString1314520报名信息编码
actionIdString201911260077活动编码
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                
<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": "预约活动名称"
      }
    }
  }
}
			
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              
<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": "系统错误"
      }
    }
  }
}
			
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
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 服务不可用 请联系苏宁技术人员
公共异常码
API工具
FAQ