文档中心 > 酒店团购

alitrip.tuan.hotel.item.sku.update (酒店团购套餐商品SKU更新和新增)

商户对发布的宝贝套餐价格库存信息进行更新,对于已存在的sku,未进行传递则不会进行覆盖。skuId必须为已存在的skuId,暂不支持库存类型的更改。因发布页改造升级,2020.03.05将下线此接口的新增SKU功能,更新SKU功能将保留,但商户2020.03.05后须前往发布页进行宝贝更新后,方可调用本接口。对于日历库存宝贝日历维度的价格和库存数据的更新,此接口存在调用超时的问题,不推荐使用,若有诉求,请使用alitrip.tuan.hotel.item.sku.calendar.update接口(该接口提供增量更新能力),接口地址为https://open.taobao.com/api.htm?docId=48160&docType=2&scopeId=12326

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
item_sku_list TopTuanItemSkuVO [] 必须
  • 最大列表长度:15
  • 关于sku(价格策略)的字段填写的说明 国内酒店套餐类目(日历库存必填选项:套餐名称、原价、间夜;普通库存必填选项:套餐名称、价格、原价、库存、间夜)。 国际酒店套餐类目(日历库存必填选型:套餐名称、原价、间夜、人数;普通库存必填选项:套餐名称、价格、原件、库存、间夜、人数)。 酒店餐饮美食类目(日历库存必填选项:套餐名称、原价、人数、次数;普通库存必填选项:套餐名称、价格、原价、库存、人数,次数)。 酒店服务类目(日历库存必填选项:套餐名称、原价、使用次数;普通库存必填选项:套餐名称、价格、原价、库存、使用次数)。 酒店客房优惠券类目(无sku(价格策略)选项,不填写)。
    • └ night_count
    • Number
    • 可选
    • 3
    • 套餐间夜
    • └ quantity
    • Number
    • 可选
    • 3
    • 套餐库存
    • └ orig_price
    • String
    • 必须
    • 22.23
    • 套餐原价,单位为元,仅支持精确到分(小数点后两位)
    • └ price
    • String
    • 必须
    • 25.25
    • 套餐价格。单位为元,仅支持精确到分(小数点后两位)
    • └ people_count
    • Number
    • 可选
    • 24
    • 套餐人数
    • └ name
    • String
    • 必须
    • 套餐一
    • 套餐名称
    • └ outer_id
    • String
    • 可选
    • 12544
    • 商家编码
    • calendar_info
    • TopSkuCalendarInfo
    • 可选
    • 套餐日历库存价格信息,日历库存需完整填写,普通库存请将此项设置为空,示例:("calendar_info": { })
    • └ end
    • String
    • 可选
    • 2019-08-22
    • 日历库存的结束时间,日历库存必填
    • diff
    • TopSkuDailyInfo []
    • 可选
    • 日历库存价格信息,日历库存必填
    • └ d
    • String
    • 可选
    • 2019-08-22
    • 日期,日历库存必填
    • └ price
    • String
    • 可选
    • 12.23
    • 价格,日历库存必填,单位为元,仅支持精确到分(小数点后两位)
    • └ stock
    • Number
    • 可选
    • 22
    • 库存,日历库存必填
    • └ begin
    • String
    • 可选
    • 2019-08-22
    • 日历库存的开始时间,日历库存必填
    • └ sku_id
    • Number
    • 必须
    • 0
    • skuId,若更新sku信息,必填;若新增sku,此项填写为0
    • └ use_count
    • Number
    • 可选
    • 3
    • 使用次数
    item_id Number 必须 1222 宝贝ID
    cat_id Number 必须 201189402 宝贝所属类目

    响应参数

    名称 类型 示例值 描述
    item_id Number 2300951348640 宝贝ID
    seller_id Number 2024098454 卖家ID
    top_item_sku_base_info_list TopItemSkuBaseInfo [] 商品的sku列表
    • └ sku_name
    • String
    • 套餐二
    • sku名称
    • └ outer_id
    • String
    • 1222
    • 商家编码
    • └ sku_id
    • Number
    • 33272543438
    • skuId
    msg_code String 0 错误码
    status Boolean true 操作状态
    message String 操作成功 错误信息

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AlitripTuanHotelItemSkuUpdateRequest req = new AlitripTuanHotelItemSkuUpdateRequest();
    List<AlitripTuanHotelItemSkuUpdateRequest.TopTuanItemSkuVO> list2 = new ArrayList<AlitripTuanHotelItemSkuUpdateRequest.TopTuanItemSkuVO>();
    AlitripTuanHotelItemSkuUpdateRequest.TopTuanItemSkuVO obj3 = new AlitripTuanHotelItemSkuUpdateRequest.TopTuanItemSkuVO();
    list2.add(obj3);
    obj3.setNightCount(3L);
    obj3.setQuantity(3L);
    obj3.setOrigPrice("22.23");
    obj3.setPrice("25.25");
    obj3.setPeopleCount(24L);
    obj3.setName("套餐一");
    obj3.setOuterId("12544");
    AlitripTuanHotelItemSkuUpdateRequest.TopSkuCalendarInfo obj5 = new AlitripTuanHotelItemSkuUpdateRequest.TopSkuCalendarInfo();
    obj5.setEnd("2019-08-22");
    List<AlitripTuanHotelItemSkuUpdateRequest.TopSkuDailyInfo> list7 = new ArrayList<AlitripTuanHotelItemSkuUpdateRequest.TopSkuDailyInfo>();
    AlitripTuanHotelItemSkuUpdateRequest.TopSkuDailyInfo obj8 = new AlitripTuanHotelItemSkuUpdateRequest.TopSkuDailyInfo();
    list7.add(obj8);
    obj8.setD("2019-08-22");
    obj8.setPrice("12.23");
    obj8.setStock(22L);
    obj5.setDiff(list7);
    obj5.setBegin("2019-08-22");
    list4.setCalendarInfo(obj5);
    obj3.setSkuId(0L);
    obj3.setUseCount(3L);
    req.setItemSkuList(list2);
    req.setItemId(1222L);
    req.setCatId(201189402L);
    AlitripTuanHotelItemSkuUpdateResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <alitrip_tuan_hotel_item_sku_update_response>
        <item_id>2300951348640</item_id>
        <seller_id>2024098454</seller_id>
        <top_item_sku_base_info_list>
            <top_item_sku_base_info>
                <sku_name>套餐二</sku_name>
                <outer_id>1222</outer_id>
                <sku_id>33272543438</sku_id>
            </top_item_sku_base_info>
        </top_item_sku_base_info_list>
        <msg_code>0</msg_code>
        <status>true</status>
        <message>操作成功</message>
    </alitrip_tuan_hotel_item_sku_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

    返回
    顶部