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

酒店API

taobao.xhotel.combo.add (在线预约宝贝schema套餐新增)

在线预约宝贝schema套餐新增

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
publish_item_v_o OnlineBookingPublishItemVO 必须 套餐发布宝贝模型
  • └ short_title
  • String
  • 必须
  • 短标题
  • 1～30字符
  • └ title
  • String
  • 必须
  • 标题
  • 1～60字符
  • └ is_member_item
  • Boolean
  • 可选
  • false
  • 是否会员商品
  • └ on_shelf_time
  • String
  • 必须
  • 2026-03-22 00:00
  • 定时上架时间，格式 yyyy-MM-dd HH:mm，选择定时上架时必填，即sale_time_type == TIMING_SHELF
  • └ cat_id
  • Number
  • 必须
  • 50794037
  • 固定值50794037
  • └ down_shelf_time
  • String
  • 必须
  • 2026-03-31 23:59
  • 下架时间，格式 yyyy-MM-dd HH:mm
  • └ sale_time_type
  • String
  • 必须
  • PUT_IN_WAREHOUSE
  • 售卖时间类型，只有TIMING_SHELF(定时上架)、PUT_IN_WAREHOUSE（放入仓库）、SALE_AT_ONCE（立即上架，只有在编辑宝贝时可以选择立即上架）
  • combo_desc_info_v_o
  • ComboDescInfoVO
  • 可选
  • 套餐图文描述
  • └ combo_item_highlight_list
  • String []
  • 可选
  • ["亮点1231"，"亮点3242"]
  • 套餐亮点，单个亮点1～66字符，亮点数量不超过4个
  • publish_image_v_o_s
  • PublishImageVO []
  • 必须
  • []
  • 商品图片列表，第一张为主图，需严格按顺序设置，图片规格必须为800*800且小于3MB，最多5张图
  • └ type
  • String
  • 可选
  • 1
  • 图片类型，type：1 （吃）、2（住）、3（享）、4（玩）。第一张图片仅能选择 住
  • └ url
  • String
  • 必须
  • https://img.alicdn.com/bao/uploaded/i1/263682007/O1CN0142x1rn1QhFwM2vHMo_!!4611686018427385815-0-item_pic.jpg
  • 图片 URL 地址
  • └ desc
  • String
  • 必须
  • <p>测试请不要拍 </p>
  • 图文详情，总字符不能超过50000字符
  • └ hotel_num_type
  • String
  • 必须
  • SINGLE
  • 酒店数量，只有"MULTI"或"SINGLE"
  • └ member_benefit
  • Boolean
  • 可选
  • false
  • 是否可享受会员权益
  • booking_rule_param_v_o
  • OnlineBookingBookingRuleParamVO
  • 必须
  • 预约规则
  • └ advance_days_select
  • Boolean
  • 必须
  • false
  • 是否选择提前预约
  • └ advance_days
  • Number
  • 可选
  • 1
  • 提前预约天数,选择提前预约时必填，天数范围1～15天
  • └ booking_open_time_type
  • String
  • 必须
  • SCHEDULED_DATE_RANGE
  • 预约开放时间类型，只有SCHEDULED_DATE_RANGE（指定时间）或FROM_NOW_ON_PASSED_DAYS（自购买之时起{x}天内可约）
  • booking_date_range
  • DateRangeVO
  • 可选
  • 预定日期范围，选择定时上架时必填，即booking_open_time_type == SCHEDULED_DATE_RANGE
  • └ begin_date
  • String
  • 必须
  • 2026-03-11 12:00
  • 开始日期，yyyy-mm-dd hh:mm
  • └ end_date
  • String
  • 必须
  • 2026-03-20 12:00
  • 结束日期，yyyy-mm-dd hh:mm
  • └ booking_in_days
  • Number
  • 可选
  • 7
  • 选择自购买之时起{x}天内可约时必填，即booking_open_time_type ==FROM_NOW_ON_PASSED_DAYS，且只能选择7、14、21
  • └ multiple_times
  • Boolean
  • 必须
  • false
  • 是否支持分次预约，分次预约和多间房不能同时为true
  • └ multi_rooms
  • Boolean
  • 必须
  • false
  • 是否支持多间房，分次预约和多间房不能同时为true
  • performance_rule_param_v_o
  • OnlineBookingPerformanceRuleParamVO
  • 必须
  • 履约规则
  • └ hotel_invoice_type
  • String
  • 必须
  • SELLER
  • 发票提供方，SELLER("卖家提供"), HOTEL("店铺提供"), NONE("无发票");
  • └ publish_bill_type
  • String
  • 必须
  • BILL_TO_STORE
  • 发布账单类型， ONLINE_NONE(不分账结算到店铺),HOTEL_TO_STORE(资金到门店),BILL_TO_STORE(分账到门店)
  • └ retain_commission_type
  • String
  • 可选
  • ITEM
  • 选择BILL_TO_STORE(分账到门店)时必填,留佣类型，HOTEL（留佣到门店）、ITEM（留佣到套餐）
  • └ retained_commission_ratio
  • Number
  • 可选
  • 90
  • 留佣比例百分比，选择ITEM（留佣到套餐）时必填
  • supported_date_range
  • DateRangeVO
  • 必须
  • 套餐可住日期
  • └ begin_date
  • String
  • 必须
  • 2026-03-11
  • 开始日期
  • └ end_date
  • String
  • 必须
  • 2026-03-20
  • 结束日期
  • unsupported_date_range
  • DateRangeVO []
  • 可选
  • []
  • 套餐不可住可住日期
  • └ begin_date
  • String
  • 必须
  • 2026-03-11
  • 开始日期
  • └ end_date
  • String
  • 必须
  • 2026-03-20
  • 结束日期
  • └ weekday_list
  • String []
  • 必须
  • [1,2,4]
  • 星期列表（1～7的整数表示周一到周日），10表示每天
  • └ pkg_fee_not_include
  • String
  • 可选
  • 费用不包含XX
  • 费用不包含
  • └ pkg_fee_include
  • String
  • 可选
  • 费用包含XX
  • 费用包含
  • package_list
  • OnlineBookingPublishSkuVO []
  • 必须
  • []
  • SKU 套餐列表，单个宝贝最多8个sku
  • └ cat_id
  • Number
  • 必须
  • 50794037
  • 类目ID，与商品一致
  • └ sku_name
  • String
  • 必须
  • 测试sku标题
  • 套餐名称,多个sku的名称相互不能重复，单个sku标题需要在1～40字符
  • └ night_count
  • Number
  • 必须
  • 1
  • 间夜数大于0
  • └ breakfast_count
  • Number
  • 必须
  • 2
  • 早餐数量，0～20的整数
  • └ price
  • Number
  • 必须
  • 99000
  • 套餐价格，单位分
  • └ activity_price_select
  • Boolean
  • 必须
  • false
  • 是否选择活动价
  • └ activity_price
  • Number
  • 可选
  • 80000
  • 活动价，选择活动价为true时，必填
  • └ quantity
  • Number
  • 必须
  • 10
  • 库存数
  • combo_add_price_v_o_list
  • ComboAddPriceVO []
  • 可选
  • []
  • 套餐加价规则
  • └ price_rule_number
  • Number
  • 必须
  • 1
  • 价格规则编号，单个sku的加价规则不能重复
  • └ add_price_value
  • Number
  • 必须
  • 2000
  • 补差金额单位分
  • date_range
  • DateRangeVO
  • 必须
  • 加价日期范围
  • └ begin_date
  • String
  • 必须
  • 2026-03-11
  • 开始日期
  • └ end_date
  • String
  • 必须
  • 2026-03-20
  • 结束日期
  • └ weekday_list
  • String []
  • 必须
  • [10]
  • 星期列表（1～7的整数表示周一到周日），10表示每天
  • item_labels
  • ItemLabelOption []
  • 可选
  • [{ "label": "亲子酒店", "value": "25" }, { "label": "湖畔美宿", "value": "26" }]
  • [{"label":"亲子酒店","value":"25"},{"label":"湖畔美宿","value":"26"},{"label":"高空美景","value":"27"},{"label":"城市度假","value":"28"},{"label":"设计师酒店","value":"29"},{"label":"海滨风光","value":"30"},{"label":"温泉泡汤","value":"31"},{"label":"滑雪精选","value":"32"},{"label":"景区周边","value":"33"},{"label":"古镇园林","value":"34"},{"label":"品牌通兑","value":"35"},{"label":"连锁通兑","value":"36"},{"label":"古风国潮","value":"37"},{"label":"山林野趣","value":"38"},{"label":"网红打卡","value":"39"},{"label":"缤纷美食","value":"40"},{"label":"特色民宿","value":"41"},{"label":"情侣出行","value":"42"},{"label":"亲子出行","value":"43"},{"label":"家庭出游","value":"44"},{"label":"闺蜜出行","value":"45"},{"label":"独自旅行","value":"46"},{"label":"商务出行","value":"47"}]
  • └ label
  • String
  • 必须
  • 亲子酒店
  • 标签名称
  • └ value
  • String
  • 必须
  • 25
  • 标签值

响应参数

名称 类型 示例值 描述
error_message String 错误信息 错误信息
data Data 套餐宝贝模型数据
  • └ hotel_num_type
  • String
  • MULTI
  • 酒店数量，"MULTI"或"SINGLE"
  • └ member_benefit
  • Boolean
  • false
  • 是否含会员权益
  • └ short_title
  • String
  • 测试短标题
  • 短标题
  • package_list
  • PackageList []
  • 套餐信息
  • └ night_count
  • Number
  • 1
  • 间夜数量
  • └ sku_name
  • String
  • 测试套餐
  • 套餐名称
  • └ activity_price
  • Number
  • 100
  • 活动价
  • └ activity_price_select
  • Boolean
  • true
  • 是否选择活动价
  • └ price
  • Number
  • 200
  • sku原价
  • └ sku_id
  • Number
  • 6203331906108
  • skuId
  • └ quantity
  • Number
  • 9
  • sku库存
  • └ cat_id
  • Number
  • 50794037
  • 类目ID
  • combo_add_price_v_o_list
  • ComboAddPriceVOList []
  • sku加价规则
  • └ price_rule_number
  • Number
  • 1
  • 加价规则序号
  • date_range
  • DateRange
  • 加价规则时间范围
  • └ begin_date
  • String
  • 2026-03-11
  • 加价开始日期
  • └ end_date
  • String
  • 2026-03-20
  • 加价结束日期
  • └ weekday_list
  • Number []
  • 加价的周X选择
  • └ add_price_value
  • Number
  • 100
  • 加价金额，单位分
  • └ breakfast_count
  • Number
  • 2
  • 早餐数量
  • └ on_shelf_time
  • String
  • 2026-03-05 00:00
  • 上架时间
  • └ item_id
  • Number
  • 1027636505419
  • 宝贝id
  • └ cat_id
  • Number
  • 50794037
  • 类目ID
  • └ down_shelf_time
  • String
  • 2026-03-31 23:59
  • 下架时间
  • item_labels
  • ItemLabels []
  • 宝贝标签
  • └ label
  • String
  • 湖畔美宿
  • 标签文案
  • └ value
  • String
  • 26
  • 标签值
  • └ title
  • String
  • 满秋测试请不要拍
  • 标题
  • └ is_member_item
  • Boolean
  • false
  • 是否会员
  • performance_rule_param_v_o
  • PerformanceRuleParamVO
  • 履约规则
  • └ pkg_fee_not_include
  • String
  • 费用不包含午餐
  • 费用不包含
  • └ retained_commission_ratio
  • Number
  • 90
  • 宝贝分账，分账比例
  • └ hotel_invoice_type
  • String
  • SELLER
  • 开票方式
  • └ retain_commission_type
  • String
  • ITEM
  • 留佣类型
  • └ pkg_fee_include
  • String
  • 费用包含一份早餐
  • 费用包含
  • unsupported_date_range
  • UnsupportedDateRange []
  • 不可约日期，如
  • └ begin_date
  • String
  • 2026-03-11
  • 不可住开始日期
  • └ end_date
  • String
  • 2026-03-14
  • 不可住结束日期
  • └ weekday_list
  • Number []
  • 不可住日期周X，如[1,2]，表示周一二不可住
  • └ publish_bill_type
  • String
  • BILL_TO_STORE
  • 分账方式
  • supported_date_range
  • DateRangeVO
  • 可住日期
  • └ begin_date
  • String
  • 2026-03-11
  • 可住开始日期
  • └ end_date
  • String
  • 2026-03-14
  • 可住结束日期
  • └ is_edit
  • Boolean
  • true
  • 是否为编辑态
  • booking_rule_param_v_o
  • BookingRuleParamVO
  • 预约规则
  • booking_date_range
  • BookingDateRange
  • 预约时间范围
  • └ begin_date
  • String
  • 2026-03-05 16:38
  • 预约开始日期
  • └ end_date
  • String
  • 2026-04-09 16:38
  • 预约结束日期
  • └ advance_days
  • Number
  • 0
  • 提前预定天数
  • └ advance_days_select
  • Boolean
  • false
  • 是否需要提前预约
  • └ booking_in_days
  • Number
  • 21
  • 购买后X天内可约
  • └ multiple_times
  • Boolean
  • false
  • 是否可拆分
  • └ booking_open_time_type
  • String
  • SCHEDULED_DATE_RANGE
  • 预定方式，可选指定时间范围或购买后{X}天内可约
  • └ multi_rooms
  • Boolean
  • false
  • 是否支持多间房
  • └ sale_time_type
  • String
  • TIMING_SHELF
  • 上架时间类型，定时上架或放入仓库
  • combo_desc_info_v_o
  • ComboDescInfoVO
  • 宝贝图文描述
  • └ combo_item_highlight_list
  • String []
  • 宝贝亮点
  • publish_image_v_o_s
  • PublishImageVOS []
  • 宝贝图片展示，第一张为主图
  • └ type
  • String
  • 2
  • type
  • └ url
  • String
  • https://img.alicdn.com/bao/uploaded///img.alicdn.com/bao/uploaded/i1/263682007/O1CN0142x1rn1QhFwM2vHMo_!!4611686018427385815-0-item_pic.jpg
  • url
  • └ desc
  • String
  • <p>测试请不要拍 </p>
  • 图文描述
error_detail String 错误详情 错误详情

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
XhotelComboAddRequest req = new XhotelComboAddRequest();
XhotelComboAddRequest.OnlineBookingPublishItemVO obj1 = new XhotelComboAddRequest.OnlineBookingPublishItemVO();
obj1.setShortTitle("短标题");
obj1.setTitle("标题");
obj1.setIsMemberItem(false);
obj1.setOnShelfTime("2026-03-22 00:00");
obj1.setCatId(50794037L);
obj1.setDownShelfTime("2026-03-31 23:59");
obj1.setSaleTimeType("PUT_IN_WAREHOUSE");
XhotelComboAddRequest.ComboDescInfoVO obj2 = new XhotelComboAddRequest.ComboDescInfoVO();
obj2.setComboItemHighlightList(""亮点1231"，"亮点3242"");
List<XhotelComboAddRequest.PublishImageVO> list4 = new ArrayList<XhotelComboAddRequest.PublishImageVO>();
XhotelComboAddRequest.PublishImageVO obj5 = new XhotelComboAddRequest.PublishImageVO();
list4.add(obj5);
obj5.setType("1");
obj5.setUrl("https://img.alicdn.com/bao/uploaded/i1/263682007/O1CN0142x1rn1QhFwM2vHMo_!!4611686018427385815-0-item_pic.jpg");
obj2.setPublishImageVOS(list4);
obj2.setDesc("<p>测试请不要拍 </p>");
obj1.setComboDescInfoVO(obj2);
obj1.setHotelNumType("SINGLE");
obj1.setMemberBenefit(false);
XhotelComboAddRequest.OnlineBookingBookingRuleParamVO obj6 = new XhotelComboAddRequest.OnlineBookingBookingRuleParamVO();
obj6.setAdvanceDaysSelect(false);
obj6.setAdvanceDays(1L);
obj6.setBookingOpenTimeType("SCHEDULED_DATE_RANGE");
XhotelComboAddRequest.DateRangeVO obj7 = new XhotelComboAddRequest.DateRangeVO();
obj7.setBeginDate("2026-03-11 12:00");
obj7.setEndDate("2026-03-20 12:00");
obj6.setBookingDateRange(obj7);
obj6.setBookingInDays(7L);
obj6.setMultipleTimes(false);
obj6.setMultiRooms(false);
obj1.setBookingRuleParamVO(obj6);
XhotelComboAddRequest.OnlineBookingPerformanceRuleParamVO obj8 = new XhotelComboAddRequest.OnlineBookingPerformanceRuleParamVO();
obj8.setHotelInvoiceType("SELLER");
obj8.setPublishBillType("BILL_TO_STORE");
obj8.setRetainCommissionType("ITEM");
obj8.setRetainedCommissionRatio(90L);
XhotelComboAddRequest.DateRangeVO obj9 = new XhotelComboAddRequest.DateRangeVO();
obj9.setBeginDate("2026-03-11");
obj9.setEndDate("2026-03-20");
obj8.setSupportedDateRange(obj9);
List<XhotelComboAddRequest.DateRangeVO> list11 = new ArrayList<XhotelComboAddRequest.DateRangeVO>();
XhotelComboAddRequest.DateRangeVO obj12 = new XhotelComboAddRequest.DateRangeVO();
list11.add(obj12);
obj12.setBeginDate("2026-03-11");
obj12.setEndDate("2026-03-20");
obj12.setWeekdayList("1,2,4");
obj8.setUnsupportedDateRange(list11);
obj8.setPkgFeeNotInclude("费用不包含XX");
obj8.setPkgFeeInclude("费用包含XX");
obj1.setPerformanceRuleParamVO(obj8);
List<XhotelComboAddRequest.OnlineBookingPublishSkuVO> list14 = new ArrayList<XhotelComboAddRequest.OnlineBookingPublishSkuVO>();
XhotelComboAddRequest.OnlineBookingPublishSkuVO obj15 = new XhotelComboAddRequest.OnlineBookingPublishSkuVO();
list14.add(obj15);
obj15.setCatId(50794037L);
obj15.setSkuName("测试sku标题");
obj15.setNightCount(1L);
obj15.setBreakfastCount(2L);
obj15.setPrice(99000L);
obj15.setActivityPriceSelect(false);
obj15.setActivityPrice(80000L);
obj15.setQuantity(10L);
List<XhotelComboAddRequest.ComboAddPriceVO> list18 = new ArrayList<XhotelComboAddRequest.ComboAddPriceVO>();
XhotelComboAddRequest.ComboAddPriceVO obj19 = new XhotelComboAddRequest.ComboAddPriceVO();
list18.add(obj19);
obj19.setPriceRuleNumber(1L);
obj19.setAddPriceValue(2000L);
XhotelComboAddRequest.DateRangeVO obj21 = new XhotelComboAddRequest.DateRangeVO();
obj21.setBeginDate("2026-03-11");
obj21.setEndDate("2026-03-20");
obj21.setWeekdayList("10");
list20.setDateRange(obj21);
list16.setComboAddPriceVOList(list18);
obj1.setPackageList(list14);
List<XhotelComboAddRequest.ItemLabelOption> list23 = new ArrayList<XhotelComboAddRequest.ItemLabelOption>();
XhotelComboAddRequest.ItemLabelOption obj24 = new XhotelComboAddRequest.ItemLabelOption();
list23.add(obj24);
obj24.setLabel("亲子酒店");
obj24.setValue("25");
obj1.setItemLabels(list23);
req.setPublishItemVO(obj1);
XhotelComboAddResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<xhotel_combo_add_response>
    <error_message>错误信息</error_message>
    <data>
        <hotel_num_type>MULTI</hotel_num_type>
        <member_benefit>false</member_benefit>
        <short_title>测试短标题</short_title>
        <package_list>
            <package_list>
                <night_count>1</night_count>
                <sku_name>测试套餐</sku_name>
                <activity_price>100</activity_price>
                <activity_price_select>true</activity_price_select>
                <price>200</price>
                <sku_id>6203331906108</sku_id>
                <quantity>9</quantity>
                <cat_id>50794037</cat_id>
                <combo_add_price_v_o_list>
                    <combo_add_price_v_o_list>
                        <price_rule_number>1</price_rule_number>
                        <date_range>
                            <begin_date>2026-03-11</begin_date>
                            <end_date>2026-03-20</end_date>
                        </date_range>
                        <add_price_value>100</add_price_value>
                    </combo_add_price_v_o_list>
                </combo_add_price_v_o_list>
                <breakfast_count>2</breakfast_count>
            </package_list>
        </package_list>
        <on_shelf_time>2026-03-05 00:00</on_shelf_time>
        <item_id>1027636505419</item_id>
        <cat_id>50794037</cat_id>
        <down_shelf_time>2026-03-31 23:59</down_shelf_time>
        <item_labels>
            <item_labels>
                <label>湖畔美宿</label>
                <value>26</value>
            </item_labels>
        </item_labels>
        <title>满秋测试请不要拍</title>
        <is_member_item>false</is_member_item>
        <performance_rule_param_v_o>
            <pkg_fee_not_include>费用不包含午餐</pkg_fee_not_include>
            <retained_commission_ratio>90</retained_commission_ratio>
            <hotel_invoice_type>SELLER</hotel_invoice_type>
            <retain_commission_type>ITEM</retain_commission_type>
            <pkg_fee_include>费用包含一份早餐</pkg_fee_include>
            <unsupported_date_range>
                <unsupported_date_range>
                    <begin_date>2026-03-11</begin_date>
                    <end_date>2026-03-14</end_date>
                </unsupported_date_range>
            </unsupported_date_range>
            <publish_bill_type>BILL_TO_STORE</publish_bill_type>
            <supported_date_range>
                <begin_date>2026-03-11</begin_date>
                <end_date>2026-03-14</end_date>
            </supported_date_range>
        </performance_rule_param_v_o>
        <is_edit>true</is_edit>
        <booking_rule_param_v_o>
            <booking_date_range>
                <begin_date>2026-03-05 16:38</begin_date>
                <end_date>2026-04-09 16:38</end_date>
            </booking_date_range>
            <advance_days>0</advance_days>
            <advance_days_select>false</advance_days_select>
            <booking_in_days>21</booking_in_days>
            <multiple_times>false</multiple_times>
            <booking_open_time_type>SCHEDULED_DATE_RANGE</booking_open_time_type>
            <multi_rooms>false</multi_rooms>
        </booking_rule_param_v_o>
        <sale_time_type>TIMING_SHELF</sale_time_type>
        <combo_desc_info_v_o>
            <publish_image_v_o_s>
                <publish_image_v_o_s>
                    <type>2</type>
                    <url>https://img.alicdn.com/bao/uploaded///img.alicdn.com/bao/uploaded/i1/263682007/O1CN0142x1rn1QhFwM2vHMo_!!4611686018427385815-0-item_pic.jpg</url>
                </publish_image_v_o_s>
            </publish_image_v_o_s>
            <desc>&lt;p&gt;测试请不要拍 &lt;/p&gt;</desc>
        </combo_desc_info_v_o>
    </data>
    <error_detail>错误详情</error_detail>
</xhotel_combo_add_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测试工具 错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问
返回
顶部
阿里巴巴集团 | 淘宝网 | 天猫 | 聚划算 | 全球速卖通 | 阿里巴巴国际交易市场 | 1688 | 阿里妈妈 | 阿里旅行·去啊 | 阿里云计算 | YunOS | 阿里通信 | 万网 | 高德 | 优视 | 友盟 | 酷盘 | 虾米 | 天天动听 | 来往 | 钉钉 | 11Main | 支付宝
关于淘宝 合作伙伴 营销中心 联系客服 开放平台 诚征英才 联系我们 网站地图 法律声明 © 2016 Taobao.com 版权所有
网络文化经营许可证：文网文[2010]040号 | 增值电信业务经营许可证：浙B2-20080224-1 | 信息网络传播视听节目许可证：1109364号