退出
热词搜索：
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.orderdiscountact.add 订单优惠活动创建
￥免费

商户订单优惠活动创建

公共参数
请求参数
名称 类型 是否必须 示例值 描述
operTypeStringY1操作类型：1、立即发布
activityNameStringY2020订单满减活动活动名称
startTimeStringY2020-01-01 00:00:00活动开始时间
endTimeStringY2020-01-01 00:00:00活动结束时间
baseQuantifierTypeStringY1 1：满（每）元优惠 2：满件优惠
rewardTypeStringY1当优惠维度为1时，优惠方式枚举值为： 1：订单满元减元； 3：订单满元包邮； 12：订单满元打折 当优惠维度为2时，优惠方式枚举值为： 3：订单满件包邮； 4：订单满件打折； 5：订单满件减件； 8：订单满件定价； 11：订单满件减元
booleanCapStringN11、枚举值：上不封顶:1 不勾选：空 2、当选择1（是）时，仅支持设置1个层级
areaCodeStringN00121、不传默认全部包邮； 2、可以从城市代码获取接口里面获取，如有多个英文逗号隔开。
floorListStringN
floorStringY1层级：1、最多5个层级； 2、优惠方式为3（订单满元包邮、订单满件包邮）时仅支持一个层级；
baseAmountStringY22.10阀值：1、每层级分别设置阀值； 2、订单满多少元，或者订单满多少件，产生优惠； 3、高层级的优惠条件阀值要高于低层级的优惠条件阀值； 4、值域范围： 1）满元时：0.01 至 99999999.99 之间两位小数 2）满件时：1 至 99 之间正整数
cutAmountStringN11.11直降金额：1、每层级分别设置阀值； 2、高层级中设置的直降金额要比低层级直降金额的大，并且小于同层级的阀值； 3、到达优惠阀值后，直降的金额，当优惠方式为1（订单满元减元）时，必填。 4、新增处理逻辑：到达优惠阀值后，直降的金额，当优惠方式为11（订单满件减元）时，必填。 5、新增处理逻辑：当优惠方式为11（订单满件减元）时，值域范围：0.01 至 99999999.99 之间两位小数
discountThresholdStringN3.4打折阀值：1、每层级分别设置阀值； 2、打多少折，优惠方式折扣阀值只可输入1.0~9.9，精确到小数点后一位； 3、高层级的打折阀值要比底层及的打折阀值要高 4、当优惠方式为4（订单满件打折），必填。 5、新增处理逻辑：到达优惠阀值后，直降的金额，当优惠方式为12（订单满元打折）时，必填。
reduceLimitStringN2减件阀值：1、每层级分别设置阀值； 2、只可以输入1至99之间正整数。需要小于满件的阀值； 3、高层级中减件阀值要比低层级的减件阀值要高，并且小于阀值； 4、当优惠方式为5（订单满件减件）时必填。
redirectLimitStringN899.99定价阀值：1、每层级分别设置阀值； 2、只能填入1至999999.00之间数值，精确到小数点后两位； 3、填写该数值表示以该价格购买固定件数的商品； 4、高层级中定价阀值要比低层级定价阀值大； 5、当优惠方式为8（订单满件定价购）时，必填。
activityLimitTypeStringYY活动限制类型 Y：限制 N：不限制
activityTimesLimitStringN100活动总次数 ：1、活动期间所有用户可享受优惠的总次数，总次数用完后活动将不再向消费者展示； 2、该参数只能填入1至99999999间的正整数；
peopleActivityTimesLimitStringN1每用户限制总次数 1、限制用户参加活动的总次数； 2、该参数只能填入1至200间的正整数； 3、每用户限制总次数需大于每用户每天限制次数 4、当活动限制类型为Y（限制）时，每用户限制总次数和每用户每天限制次数必填其一
peopleDayTimesLimitStringN2每用户每天限制次数： 1、限制用户每天参加活动的次数； 2、该参数只能填入1至200间的正整数； 3、当活动限制类型为Y（限制）时，每用户限制总次数和每用户每天限制次数必填其一
activityProductTypeStringY1活动商品类型 1：代表全店铺商品； 2：代表指定商品； 3：排除某部分商品；
activityProductListStringN
productTypeStringN00活动主商品类型：1、枚举值： 00：普通商品 01：通码商品 03：套餐商品
productCodeStringN761361976商品编码： 1）只能填写苏宁通码、普通商品或套餐商品编码，最多添加200个商品。当活动商品类型=2或者3时必填。 2）当活动商品类型 = 2 时，必填，表示使用该字段中商品集作为该活动的商品集 3）当活动商品类型 = 3 时，必填，表示使用全店铺商品排除该字段中商品集作为该活动的商品集
响应参数
名称 类型 示例值 描述
returnFlagStringY是否成功：Y:成功 N：失败
businessErrorMsgString活动中有商品存在互斥:商品编码：xxxxxx业务系统错误描述
activityCodeString20202021229382322活动编码
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                <sn_request>
  <sn_body>
    <addOrderdiscountact>
      <floorList>
        <redirectLimit>899.99</redirectLimit>
        <cutAmount>11.11</cutAmount>
        <floor>1</floor>
        <reduceLimit>2</reduceLimit>
        <baseAmount>22.10</baseAmount>
        <discountThreshold>3.4</discountThreshold>
      </floorList>
      <activityProductType>1</activityProductType>
      <rewardType>1</rewardType>
      <activityLimitType>Y</activityLimitType>
      <activityName>2020订单满减活动</activityName>
      <activityProductList>
        <productCode>761361976</productCode>
        <productType>00</productType>
      </activityProductList>
      <operType>1</operType>
      <areaCode>0012</areaCode>
      <peopleDayTimesLimit>2</peopleDayTimesLimit>
      <peopleActivityTimesLimit>1</peopleActivityTimesLimit>
      <baseQuantifierType>1</baseQuantifierType>
      <activityTimesLimit>100</activityTimesLimit>
      <booleanCap>1</booleanCap>
      <startTime>2020-01-01 00:00:00</startTime>
      <endTime>2020-01-01 00:00:00</endTime>
    </addOrderdiscountact>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "addOrderdiscountact": {
        "floorList": [
          {
            "redirectLimit": "899.99",
            "cutAmount": "11.11",
            "floor": "1",
            "reduceLimit": "2",
            "baseAmount": "22.10",
            "discountThreshold": "3.4"
          }
        ],
        "activityProductType": "1",
        "rewardType": "1",
        "activityLimitType": "Y",
        "activityName": "2020订单满减活动",
        "activityProductList": [
          {
            "productCode": "761361976",
            "productType": "00"
          }
        ],
        "operType": "1",
        "areaCode": "0012",
        "peopleDayTimesLimit": "2",
        "peopleActivityTimesLimit": "1",
        "baseQuantifierType": "1",
        "activityTimesLimit": "100",
        "booleanCap": "1",
        "startTime": "2020-01-01 00:00:00",
        "endTime": "2020-01-01 00:00:00"
      }
    }
  }
}
响应示例
  • XML示例
  • JSON示例
复制全部代码 
                              <sn_responseContent>
  <sn_body>
    <addOrderdiscountact>
      <activityCode>20202021229382322</activityCode>
      <returnFlag>Y</returnFlag>
      <businessErrorMsg>活动中有商品存在互斥:商品编码：xxxxxx</businessErrorMsg>
    </addOrderdiscountact>
  </sn_body>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_body": {
      "addOrderdiscountact": {
        "activityCode": "20202021229382322",
        "returnFlag": "Y",
        "businessErrorMsg": "活动中有商品存在互斥:商品编码：xxxxxx"
      }
    }
  }
}
异常示例
  • XML示例
  • JSON示例
复制全部代码 

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
业务异常码
异常码 错误描述 解决方案
biz.custom.addorderdiscountact.format-error:* 参数格式错误 请检查此参数的值,*号表示参数字段名
biz.custom.addorderdiscountact.enumeration-error:* 参数的可选值错误 请检查此参数的值,*号表示参数字段名
biz.custom.addorderdiscountact.length-overlong:* 参数的值超过规定长度 请检查此参数的值,*号表示参数字段名
biz.custom.addorderdiscountact.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
isp.sys.service.unavailable.mpms 服务不可用 请联系苏宁技术人员
公共异常码
API工具
API TOOLS 在线测试工具异常码查询工具SDK调用示例SDK下载
FAQ