taobao.xhotel.combo.update (宝贝更新)

宝贝更新

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
online_booking_publish_item_vo OnlineBookingPublishItemVO 必须 套餐发布宝贝模型
  • └ hotel_num_type
  • String
  • 必须
  • MULTI
  • 酒店数量,只有"MULTI"或"SINGLE"
  • item_labels
  • ItemLabelOption []
  • 可选
  • []
  • 宝贝标签,标签最多5个,[{ "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
  • 可选
  • 26
  • 标签值
  • └ member_benefit
  • Boolean
  • 可选
  • false
  • 会员权益
  • └ short_title
  • String
  • 必须
  • 短标题
  • 短标题,1~30字符
  • └ title
  • String
  • 必须
  • 标题
  • 标题,1~60字符
  • └ is_member_item
  • Boolean
  • 可选
  • false
  • 是否为会员宝贝
  • performance_rule_param_v_o
  • OnlineBookingPerformanceRuleParamVO
  • 必须
  • 履约规则
  • └ pkg_fee_not_include
  • String
  • 可选
  • 费用不包含XX
  • 费用不包含XX
  • └ retained_commission_ratio
  • Number
  • 可选
  • 90
  • 留佣比例,选择ITEM(留佣到套餐)时必填
  • └ hotel_invoice_type
  • String
  • 必须
  • SELLER
  • 发票提供方,SELLER("卖家提供"), HOTEL("店铺提供"), NONE("无发票");
  • └ retain_commission_type
  • String
  • 可选
  • ITEM
  • 选择BILL_TO_STORE(分账到门店)时必填,留佣类型,HOTEL(留佣到门店)、ITEM(留佣到套餐)
  • supported_date_range
  • DateRangeVO
  • 必须
  • 可住日期
  • └ begin_date
  • String
  • 必须
  • 2026-03-11
  • 开始日期
  • └ end_date
  • String
  • 必须
  • 2026-03-20
  • 结束日期
  • └ pkg_fee_include
  • String
  • 可选
  • 费用包含XX
  • 费用包含
  • 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表示每天
  • └ publish_bill_type
  • String
  • 必须
  • BILL_TO_STORE
  • 发布账单类型, ONLINE_NONE(不分账结算到店铺),HOTEL_TO_STORE(资金到门店),BILL_TO_STORE(分账到门店)
  • package_list
  • OnlineBookingPublishSkuVO []
  • 可选
  • 套餐内容
  • 套餐内容
  • └ sku_name
  • String
  • 必须
  • 套餐名称
  • 套餐名称,多个sku的名称相互不能重复,单个sku标题需要在1~40字符
  • └ night_count
  • Number
  • 必须
  • 1
  • 间夜数大于0
  • └ cat_id
  • Number
  • 必须
  • 50794037
  • 类目ID,与商品一致
  • └ quantity
  • Number
  • 必须
  • 10
  • 库存数
  • └ price
  • Number
  • 必须
  • 99900
  • sku价格
  • └ activity_price
  • Number
  • 可选
  • 80000
  • 活动价,需要小于原价
  • └ activity_price_select
  • Boolean
  • 必须
  • false
  • 是否选择活动价
  • 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表示每天
  • └ sku_id
  • Number
  • 必须
  • 331232131
  • skuId
  • └ breakfast_count
  • Number
  • 必须
  • 2
  • 早餐数量
  • └ on_shelf_time
  • String
  • 可选
  • 2026-03-22 00:00
  • 定时上架时间,格式 yyyy-MM-dd HH:mm,选择定时上架时必填
  • └ item_id
  • Number
  • 必须
  • 21312321
  • 宝贝ID
  • └ cat_id
  • Number
  • 必须
  • 50794037
  • 固定为50794037
  • └ down_shelf_time
  • String
  • 必须
  • 2026-03-31 23:59
  • 自动下架时间,格式 yyyy-MM-dd HH:mm
  • booking_rule_param_v_o
  • OnlineBookingBookingRuleParamVO
  • 必须
  • 预约规则
  • booking_date_range
  • DateRangeVO
  • 必须
  • 预定日期范围
  • └ 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
  • └ advance_days
  • Number
  • 可选
  • 1
  • 提前预约天数,选择提前预约时必填,天数范围1~15天
  • └ booking_in_days
  • Number
  • 可选
  • 7
  • 选择自购买之时起{x}天内可约时必填,只能选择7、14、21
  • └ multiple_times
  • Boolean
  • 可选
  • false
  • 是否支持分次预约,分次预约和多间房不能同时为true
  • └ booking_open_time_type
  • String
  • 可选
  • SCHEDULED_DATE_RANGE
  • 预约开放时间类型,只有SCHEDULED_DATE_RANGE(指定时间)或FROM_NOW_ON_PASSED_DAYS(自购买之时起{x}天内可约)
  • └ multi_rooms
  • Boolean
  • 可选
  • false
  • 是否支持多间房,分次预约和多间房不能同时为true
  • └ sale_time_type
  • String
  • 可选
  • PUT_IN_WAREHOUSE
  • 售卖时间类型,只有TIMING_SHELF、PUT_IN_WAREHOUSE
  • 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
  • 可选
  • 2
  • 图片类型,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>
  • 图文详情

响应参数

名称 类型 示例值 描述
trace_id String 23131312231 鹰眼ID
data OnlineBookingPublishItemVO 套餐宝贝模型
  • └ hotel_num_type
  • String
  • MULTI
  • 酒店类型
  • └ member_benefit
  • Boolean
  • false
  • 会员权益
  • └ short_title
  • String
  • 测试短标题
  • 短标题
  • └ seller_id
  • Number
  • 263682007
  • 卖家ID
  • package_list
  • PackageList []
  • 套餐sku集合
  • └ night_count
  • Number
  • 1
  • 间夜数量
  • └ sku_name
  • String
  • 测试套餐
  • sku名称
  • └ activity_price
  • Number
  • 100
  • 活动价
  • └ activity_price_select
  • Boolean
  • true
  • 是否选择活动价
  • └ price
  • Number
  • 200
  • sku价格
  • └ sku_id
  • Number
  • 6203331906108
  • skuId
  • └ quantity
  • Number
  • 9
  • 库存数量
  • └ cat_id
  • Number
  • 50794037
  • 类目ID
  • combo_add_price_v_o_list
  • ComboAddPriceVOList []
  • 套餐加价规则
  • └ price_rule_number
  • Number
  • 1
  • 加价序号
  • date_range
  • DateRange
  • 加价日期范围
  • └ begin_date
  • String
  • 2026-03-11
  • 开始日期
  • └ end_date
  • String
  • 2026-03-20
  • 结束日期
  • └ weekday_list
  • String []
  • 周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
  • 套餐的履约规则
  • └ retained_commission_ratio
  • Number
  • 90
  • 留佣比例
  • └ hotel_invoice_type
  • String
  • SELLER
  • 发票提供方
  • └ retain_commission_type
  • String
  • ITEM
  • 留佣类型
  • supported_date_range
  • SupportedDateRange
  • 可住日期范围
  • └ begin_date
  • String
  • 2026-03-06
  • 开始日期
  • └ end_date
  • String
  • 2026-04-16
  • 结束日期
  • unsupported_date_range
  • UnsupportedDateRange []
  • 不可住日期集合
  • └ begin_date
  • String
  • 2026-03-11
  • 开始日期
  • └ end_date
  • String
  • 2026-03-14
  • 结束日期
  • └ weekday_list
  • Number []
  • 周X选项
  • └ publish_bill_type
  • String
  • BILL_TO_STORE
  • 分账方式
  • └ pkg_fee_include
  • String
  • 费用包含XX
  • 费用包含
  • └ pkg_fee_not_include
  • String
  • 费用不包含XX
  • 费用不包含
  • └ 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
  • 0
  • 自购买之时起{x}天内可约
  • └ multiple_times
  • Boolean
  • false
  • 分次预约
  • └ booking_open_time_type
  • String
  • SCHEDULED_DATE_RANGE
  • 预定类型
  • └ 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
  • 图片类型
  • └ 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 错误详情 错误详情
error_message String 错误信息 错误信息
error_stack String 错误堆栈 错误堆栈

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
XhotelComboUpdateRequest req = new XhotelComboUpdateRequest();
XhotelComboUpdateRequest.OnlineBookingPublishItemVO obj1 = new XhotelComboUpdateRequest.OnlineBookingPublishItemVO();
obj1.setHotelNumType("MULTI");
List<XhotelComboUpdateRequest.ItemLabelOption> list3 = new ArrayList<XhotelComboUpdateRequest.ItemLabelOption>();
XhotelComboUpdateRequest.ItemLabelOption obj4 = new XhotelComboUpdateRequest.ItemLabelOption();
list3.add(obj4);
obj4.setLabel("湖畔美宿");
obj4.setValue("26");
obj1.setItemLabels(list3);
obj1.setMemberBenefit(false);
obj1.setShortTitle("短标题");
obj1.setTitle("标题");
obj1.setIsMemberItem(false);
XhotelComboUpdateRequest.OnlineBookingPerformanceRuleParamVO obj5 = new XhotelComboUpdateRequest.OnlineBookingPerformanceRuleParamVO();
obj5.setPkgFeeNotInclude("费用不包含XX");
obj5.setRetainedCommissionRatio(90L);
obj5.setHotelInvoiceType("SELLER");
obj5.setRetainCommissionType("ITEM");
XhotelComboUpdateRequest.DateRangeVO obj6 = new XhotelComboUpdateRequest.DateRangeVO();
obj6.setBeginDate("2026-03-11");
obj6.setEndDate("2026-03-20");
obj5.setSupportedDateRange(obj6);
obj5.setPkgFeeInclude("费用包含XX");
List<XhotelComboUpdateRequest.DateRangeVO> list8 = new ArrayList<XhotelComboUpdateRequest.DateRangeVO>();
XhotelComboUpdateRequest.DateRangeVO obj9 = new XhotelComboUpdateRequest.DateRangeVO();
list8.add(obj9);
obj9.setBeginDate("2026-03-11");
obj9.setEndDate("2026-03-20");
obj9.setWeekdayList("1,2,4");
obj5.setUnsupportedDateRange(list8);
obj5.setPublishBillType("BILL_TO_STORE");
obj1.setPerformanceRuleParamVO(obj5);
List<XhotelComboUpdateRequest.OnlineBookingPublishSkuVO> list11 = new ArrayList<XhotelComboUpdateRequest.OnlineBookingPublishSkuVO>();
XhotelComboUpdateRequest.OnlineBookingPublishSkuVO obj12 = new XhotelComboUpdateRequest.OnlineBookingPublishSkuVO();
list11.add(obj12);
obj12.setSkuName("套餐名称");
obj12.setNightCount(1L);
obj12.setCatId(50794037L);
obj12.setQuantity(10L);
obj12.setPrice(99900L);
obj12.setActivityPrice(80000L);
obj12.setActivityPriceSelect(false);
List<XhotelComboUpdateRequest.ComboAddPriceVO> list15 = new ArrayList<XhotelComboUpdateRequest.ComboAddPriceVO>();
XhotelComboUpdateRequest.ComboAddPriceVO obj16 = new XhotelComboUpdateRequest.ComboAddPriceVO();
list15.add(obj16);
obj16.setPriceRuleNumber(1L);
obj16.setAddPriceValue(2000L);
XhotelComboUpdateRequest.DateRangeVO obj18 = new XhotelComboUpdateRequest.DateRangeVO();
obj18.setBeginDate("2026-03-11");
obj18.setEndDate("2026-03-20");
obj18.setWeekdayList("10");
list17.setDateRange(obj18);
list13.setComboAddPriceVOList(list15);
obj12.setSkuId(331232131L);
obj12.setBreakfastCount(2L);
obj1.setPackageList(list11);
obj1.setOnShelfTime("2026-03-22 00:00");
obj1.setItemId(21312321L);
obj1.setCatId(50794037L);
obj1.setDownShelfTime("2026-03-31 23:59");
XhotelComboUpdateRequest.OnlineBookingBookingRuleParamVO obj19 = new XhotelComboUpdateRequest.OnlineBookingBookingRuleParamVO();
XhotelComboUpdateRequest.DateRangeVO obj20 = new XhotelComboUpdateRequest.DateRangeVO();
obj20.setBeginDate("2026-03-11 12:00");
obj20.setEndDate("2026-03-20 12:00");
obj19.setBookingDateRange(obj20);
obj19.setAdvanceDays(1L);
obj19.setBookingInDays(7L);
obj19.setMultipleTimes(false);
obj19.setBookingOpenTimeType("SCHEDULED_DATE_RANGE");
obj19.setMultiRooms(false);
obj1.setBookingRuleParamVO(obj19);
obj1.setSaleTimeType("PUT_IN_WAREHOUSE");
XhotelComboUpdateRequest.ComboDescInfoVO obj21 = new XhotelComboUpdateRequest.ComboDescInfoVO();
obj21.setComboItemHighlightList(""亮点1231","亮点3242"");
List<XhotelComboUpdateRequest.PublishImageVO> list23 = new ArrayList<XhotelComboUpdateRequest.PublishImageVO>();
XhotelComboUpdateRequest.PublishImageVO obj24 = new XhotelComboUpdateRequest.PublishImageVO();
list23.add(obj24);
obj24.setType("2");
obj24.setUrl("https://img.alicdn.com/bao/uploaded/i1/263682007/O1CN0142x1rn1QhFwM2vHMo_!!4611686018427385815-0-item_pic.jpg");
obj21.setPublishImageVOS(list23);
obj21.setDesc("<p>测试请不要拍 </p>");
obj1.setComboDescInfoVO(obj21);
req.setOnlineBookingPublishItemVo(obj1);
XhotelComboUpdateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<xhotel_combo_update_response>
    <trace_id>23131312231</trace_id>
    <data>
        <hotel_num_type>MULTI</hotel_num_type>
        <member_benefit>false</member_benefit>
        <short_title>测试短标题</short_title>
        <seller_id>263682007</seller_id>
        <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>
            <retained_commission_ratio>90</retained_commission_ratio>
            <hotel_invoice_type>SELLER</hotel_invoice_type>
            <retain_commission_type>ITEM</retain_commission_type>
            <supported_date_range>
                <begin_date>2026-03-06</begin_date>
                <end_date>2026-04-16</end_date>
            </supported_date_range>
            <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>
            <pkg_fee_include>费用包含XX</pkg_fee_include>
            <pkg_fee_not_include>费用不包含XX</pkg_fee_not_include>
        </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>0</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>
    <error_message>错误信息</error_message>
    <error_stack>错误堆栈</error_stack>
</xhotel_combo_update_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

返回
顶部