文档中心 > API类目 > 酒店商品API

taobao.xhotel.promotion.create (新增/更新营销活动)

新增/更新营销活动,更新为全量更新,商家需把活动信息全量再传一次。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
create_promotion_param CreatePromotionParam 必须 促销活动对象
  • └ promotion_rule_id
  • Number
  • 可选
  • 12345
  • 促销规则Id,传值代表修改,不传代表新建
  • promotion_rules
  • PromotionRule []
  • 必须
  • 活动规则对象
  • 当前一个活动ID只可传1条规则
  • └ length_of_stay
  • Number
  • 可选
  • 3
  • 连住天数,仅【连住优惠】活动类型需要传值且必须大于等于1,其他活动传值不生效。
  • book_date
  • DateRange
  • 可选
  • 预定日期
  • └ start
  • String
  • 可选
  • 2024-06-11
  • 开始日期,不传默认今天
  • └ end
  • String
  • 可选
  • 2024-06-12
  • 结束日期,不传默认今天+10年
  • └ stay_weekdays
  • String []
  • 必须
  • [1,0,1,1,1,0,1]
  • 入住时间的适用星期,周一到周日,适用1,不适用是0, 不支持所有日期都设置0
  • └ min_advance_day
  • Number
  • 可选
  • 1
  • 提前预订天数,仅【早订优惠】 时需要传值,需要大于等于1,其他活动传值不生效。
  • book_time
  • TimeRange
  • 可选
  • 限时特惠、今夜甩卖(尾房)必传预订时间点,其他活动类型传了不生效。
  • └ start_time
  • String
  • 可选
  • 14:00:00
  • 开始时间,今夜甩卖 start_time 最早开始时间 14:00,限时特惠活动预订时间限当天,start_time最早开始时间 00:00:00
  • └ end_time
  • String
  • 可选
  • 16:00:00
  • 今夜甩卖支持end_time 如果到第二天的凌晨,则需+24h,如第二天凌晨4点,即传28:00:00,最大到31:00:00;限时特惠活动预订时间限当天end_time最大为23:59:59。
  • un_stay_date
  • DateRange []
  • 可选
  • [{"start":"2024-06-01","end":"2024-06-02"},{"start":"2024-07-01","end":"2024-07-02"}]
  • 不生效日期,支持传多段,最大限制10段
  • └ start
  • String
  • 可选
  • 2024-06-01
  • 开始时间
  • └ end
  • String
  • 可选
  • 2024-06-02
  • 结束时间
  • └ discount_value
  • Number
  • 必须
  • 20
  • 优惠值,与discount_type 使用。 优惠20%,discount_value = 20,discount_type = 1;立减20元,discount_value = 2000,discount_type = 2;表示立减20元,原价200元,优惠后的金额为180元。
  • stay_date
  • DateRange
  • 必须
  • 促销限制的入住时间范围
  • └ start
  • String
  • 必须
  • 2024-06-01
  • 开始入住时间
  • └ end
  • String
  • 必须
  • 2024-06-02
  • 结束入住时间
  • └ discount_type
  • Number
  • 必须
  • 1
  • 折扣类型,1 代表折扣,2 代表立减,创建后不支持修改
  • └ promotion_code
  • String
  • 必须
  • 4151
  • 促销类别代码: [天天特惠 4151], [早订优惠 4154], [连住优惠 4153], [限时特惠 4152], [今夜甩卖 4367], [门店新客 4155], [出行特惠 4322] 活动创建成功后,不可修改活动类型。

响应参数

名称 类型 示例值 描述
result ResultSet 营销活动创建结果
  • └ promotion_rule_id
  • Number
  • 12345
  • 促销活动ID,创建活动会返回,更新不返回
  • └ error_code
  • String
  • isv.invalid-parameter:NOTNULL
  • 错误码
  • └ error_msg
  • String
  • 参数不能为空
  • 错误信息
  • └ success
  • Boolean
  • true
  • 是否成功,true代表成功
  • └ trace_id
  • String
  • 122334232
  • 日志id

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
XhotelPromotionCreateRequest req = new XhotelPromotionCreateRequest();
XhotelPromotionCreateRequest.CreatePromotionParam obj1 = new XhotelPromotionCreateRequest.CreatePromotionParam();
obj1.setPromotionRuleId(12345L);
List<XhotelPromotionCreateRequest.PromotionRule> list3 = new ArrayList<XhotelPromotionCreateRequest.PromotionRule>();
XhotelPromotionCreateRequest.PromotionRule obj4 = new XhotelPromotionCreateRequest.PromotionRule();
list3.add(obj4);
obj4.setLengthOfStay(3L);
XhotelPromotionCreateRequest.DateRange obj6 = new XhotelPromotionCreateRequest.DateRange();
obj6.setStart("2024-06-11");
obj6.setEnd("2024-06-12");
list5.setBookDate(obj6);
obj4.setStayWeekdays("1,0,1,1,1,0,1");
obj4.setMinAdvanceDay(1L);
XhotelPromotionCreateRequest.TimeRange obj8 = new XhotelPromotionCreateRequest.TimeRange();
obj8.setStartTime("14:00:00");
obj8.setEndTime("16:00:00");
list7.setBookTime(obj8);
List<XhotelPromotionCreateRequest.DateRange> list11 = new ArrayList<XhotelPromotionCreateRequest.DateRange>();
XhotelPromotionCreateRequest.DateRange obj12 = new XhotelPromotionCreateRequest.DateRange();
list11.add(obj12);
obj12.setStart("2024-06-01");
obj12.setEnd("2024-06-02");
list9.setUnStayDate(list11);
obj4.setDiscountValue(20L);
XhotelPromotionCreateRequest.DateRange obj14 = new XhotelPromotionCreateRequest.DateRange();
obj14.setStart("2024-06-01");
obj14.setEnd("2024-06-02");
list13.setStayDate(obj14);
obj1.setPromotionRules(list3);
obj1.setDiscountType(1L);
obj1.setPromotionCode("4151");
req.setCreatePromotionParam(obj1);
XhotelPromotionCreateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<xhotel_promotion_create_response>
    <result>
        <promotion_rule_id>12345</promotion_rule_id>
        <error_code>isv.invalid-parameter:NOTNULL</error_code>
        <error_msg>参数不能为空</error_msg>
        <success>true</success>
        <trace_id>122334232</trace_id>
    </result>
</xhotel_promotion_create_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部