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.delivery.add 店铺ISV页面投放
¥基础

店铺购买应用后,使用应用生成的活动页、会员页等可通过此接口导入其店铺内,并可直接投放至站内各页面店铺楼层中

公共参数
请求参数
名称 类型 是否必须 示例值 描述
decoPageIpStringY//www.suning.com该应用的设置页的地址
pageTypeStringY会员 memIndex ; 抽奖 draw ;签到打卡 daka ; 其他 other页面类型,支持会员页、抽奖页、打卡页以及其他活动页
pageNameStringYXX会员页页面名称,店铺装修后台-页面管理菜单中的展示名称
showPageIpStringY//www.suning.com展示页地址,面向消费者的前台页面访问地址
serverIdStringY1008722服务市场的服务编码,用来查询服务订购有效期,过期后将不再投放
deliveryListStringN
channelStringN03投放渠道,支持将页面投放至以下位置,包括:01支付成功页店铺楼层、03物流页店铺楼层、04确认收货页店铺楼层、06商品详情页店铺楼层、1036移动店铺首页引导弹窗、1037移动店铺首页悬浮图标。页面类型为会员页时除上述渠道外,还可投放至1002移动店铺导航会员tab,替代原有官方会员页
posterUrlStringN//www.suning.com海报地址,投放渠道为06商品详情页店铺楼层时必传,图片尺寸为678*180(px)
posterStartTimeStringN2020-03-01 12:03:30投放海报的展示生效时间,投放渠道为四级页时可填,不填默认取当前时间
posterEndTimeStringN2020-03-31 00:00:00投放海报的展示失效时间,投放渠道为四级页时可填,不填默认取应用失效时间
guidePicUrlStringN//www.suning.com引导弹窗图地址,投放渠道为1036引导弹窗时必传,图片尺寸宽为590px,高度为750px
floatIconUrlStringN//www.suning.com悬浮图标地址,投放渠道为1037悬浮图标时必传,图片尺寸为210*210(px)
deliveryIconUrlStringN//www.suning.com投放图标地址,投放渠道为01、03、04时必传,图片尺寸为100*100(px)
deliveryTitleStringN诚邀您加入店铺XX会员投放标题,投放渠道为01、03、04时必传,最多12个字
deliveryDescStringN立即入会,享受专属会员福利投放描述,投放渠道为01、03、04时必传,最多15个字
deliveryStatusStringN0投放活动状态,投放渠道为确认收货页店铺楼层、物流页店铺楼层时可填,支持投放生效和投放失效,默认为投放生效,0:失效,1:生效
响应参数
名称 类型 示例值 描述
successStringY处理标识,Y成功,N失败
signUrlString//shdspre.cnsuning.com/shds-web/positiveNew/wap/page/deco/loadPageMgr.action?showArea=deliveryPageMgr《免责声明》签署地址,处理标识为N时返回
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                
<sn_request>
  <sn_body>
    <addDelivery>
      <deliveryList>
        <posterUrl>//www.suning.com</posterUrl>
        <posterEndTime>2020-03-31 00:00:00</posterEndTime>
        <deliveryTitle>诚邀您加入店铺XX会员</deliveryTitle>
        <channel>03</channel>
        <posterStartTime>2020-03-01 12:03:30</posterStartTime>
        <deliveryIconUrl>//www.suning.com</deliveryIconUrl>
        <deliveryDesc>立即入会,享受专属会员福利</deliveryDesc>
        <guidePicUrl>//www.suning.com</guidePicUrl>
        <floatIconUrl>//www.suning.com</floatIconUrl>
        <deliveryStatus>0</deliveryStatus>
      </deliveryList>
      <decoPageIp>//www.suning.com</decoPageIp>
      <pageType>会员  memIndex ; 抽奖 draw ;签到打卡  daka ;  其他 other</pageType>
      <pageName>XX会员页</pageName>
      <serverId>1008722</serverId>
      <showPageIp>//www.suning.com</showPageIp>
    </addDelivery>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "addDelivery": {
        "deliveryList": [
          {
            "posterUrl": "//www.suning.com",
            "posterEndTime": "2020-03-31 00:00:00",
            "deliveryTitle": "诚邀您加入店铺XX会员",
            "channel": "03",
            "posterStartTime": "2020-03-01 12:03:30",
            "deliveryIconUrl": "//www.suning.com",
            "deliveryDesc": "立即入会,享受专属会员福利",
            "guidePicUrl": "//www.suning.com",
            "floatIconUrl": "//www.suning.com",
            "deliveryStatus": "0"
          }
        ],
        "decoPageIp": "//www.suning.com",
        "pageType": "会员  memIndex ; 抽奖 draw ;签到打卡  daka ;  其他 other",
        "pageName": "XX会员页",
        "serverId": "1008722",
        "showPageIp": "//www.suning.com"
      }
    }
  }
}
			
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              
<sn_responseContent>
  <sn_body>
    <addDelivery>
      <success>Y</success>
      <signUrl>//shdspre.cnsuning.com/shds-web/positiveNew/wap/page/deco/loadPageMgr.action?showArea=deliveryPageMgr</signUrl>
    </addDelivery>
  </sn_body>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_body": {
      "addDelivery": {
        "success": "Y",
        "signUrl": "//shdspre.cnsuning.com/shds-web/positiveNew/wap/page/deco/loadPageMgr.action?showArea=deliveryPageMgr"
      }
    }
  }
}
			
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
biz.custom.adddelivery.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.custom.adddelivery.enumeration-error:* 参数的可选值错误 请检查此参数的值,*号表示参数字段名
biz.custom.adddelivery.length-overlong:* 参数的值超过规定长度 请检查此参数的值,*号表示参数字段名
isp.sys.service.unavailable.shds 服务不可用 请联系苏宁技术人员
biz.custom.adddelivery.invalid-biz:101 当前应用已过有效期 请续费后投放
biz.custom.adddelivery.invalid-biz:102 移动店铺在用首页未装修引导弹窗模块 请商户到装修后台为移动端在用首页添加引导弹窗
biz.custom.adddelivery.invalid-biz:103 移动店铺在用首页未装修悬浮图标模块 请商户到装修后台为移动端在用首页添加悬浮图标
biz.custom.adddelivery.invalid-biz:104 当前商户不存在 请联系苏宁技术人员
biz.custom.adddelivery.invalid-biz:105 移动店铺在用首页未装修导航模块 请商户到装修后台移动端在用首页重新保存导航模块
biz.custom.adddelivery.invalid-biz:106 投放文案中存在敏感词 请调整文案后重新投放
biz.custom.adddelivery.invalid-biz:107 投放失败,当前店铺中生效的服务非本次投放的服务 请调整后重新投放
公共异常码
API工具
FAQ