文档中心 > 酒店团购

alitrip.tuan.hotel.item.info.get (宝贝信息查询接口)

商家查询发布的宝贝详情信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
item_id Number 必须 1222 宝贝ID

响应参数

名称 类型 示例值 描述
item_info TuanItemSellParamVO 00 宝贝基本信息
  • └ gift
  • String
  • 免费赠品
  • 免费赠品
  • └ appoint_explain
  • String
  • 000
  • 预约说明,字数限制200
  • └ pic_urls
  • String []
  • https://img.alicdn.com/imgextra/i3/263682007/O1CN01ou4TAT1QhFSDIJ4JX_!!263682007.jpg
  • PC端图片地址
  • └ sec_kills
  • String []
  • web,wap
  • 秒杀商品平台:web-电脑,wap-手机
  • └ during_end_date
  • String
  • 2019-08-09
  • 当前开始到哪天结束
  • └ unavailable_dates
  • String
  • 2019-08-11~2019-08-14
  • 不可用日期(范围)
  • └ effective_days
  • Number
  • 1
  • 购买成功后有效天数
  • └ price
  • String
  • 200.00
  • 若为酒店客房优惠券类目则显示价格,其他类目则显示第一条sku的价格
  • └ begin_hour
  • String
  • 12
  • 售卖时间小时,售卖时间类型1时返回
  • └ confirm_time
  • String
  • 2
  • 确认时间,可选字段:2,6,9,18.确认类型为2时返回
  • └ promoted_status
  • Number
  • 0
  • 橱窗推荐:0-不推荐,1-推荐
  • └ begin_min
  • String
  • 23
  • 售卖时间分钟,售卖时间类型1返回
  • └ cat_id
  • Number
  • 201189402
  • 类目ID:国内酒店套餐-201189402;国际酒店套餐-201188002;酒店餐饮美食-201214101;酒店服务-201214201;酒店客房优惠券-201214301
  • └ item_id
  • Number
  • 602451239218
  • 宝贝ID
  • └ down_shelf_hour
  • String
  • 00
  • 自动下架时间小时
  • └ advance_days
  • Number
  • 0
  • 提前预约天数,数值范围为(0,1,2,3,5,7,15,30),0代表无需设置
  • └ breakfast
  • Number
  • 0
  • 0-无早餐,1-单份早餐,2-两份早餐,3-三份早餐,4-多份早餐。若为酒店服务或酒店餐饮美食与早餐类型无关类目,此处为-1
  • └ main_video_pic_url
  • String
  • https://img.alicdn.com/imgextra/i2/6000000004295/O1CN01liyzk91hb9exHvYzz_!!6000000004295-0-tbvideo.jpg
  • 主图视频封面图和缩略图
  • └ refund
  • Number
  • 100
  • 支持过期退款比率
  • └ night_count
  • Number
  • 3
  • 第一条sku的间夜
  • └ city
  • String
  • 阿勒泰
  • 城市
  • └ orig_price
  • String
  • 500.00
  • 若为酒店客房优惠券类目则显示价格,其他类目则显示第一条sku的原价
  • └ shop_categories_id_list
  • String []
  • 12232
  • 商家店铺类目
  • └ sub_stock_at_buy
  • Number
  • 1
  • 拍下减库存,0-否,1-是
  • └ end_available_date
  • String
  • 2019-08-07
  • 预约时段结束日期,预约时段类型为1返回
  • └ effective_date_type
  • Number
  • 1
  • 预约时段类型:1-开始-结束日期,2-购买成功到哪天,3-购买成功多少天内
  • └ fee_include
  • String
  • 费用包含
  • 费用包含
  • └ prov
  • String
  • 新疆
  • 省份
  • └ seller_nick
  • String
  • 卖家昵称
  • 卖家昵称
  • └ wangpu_detail
  • String
  • 000
  • 旺铺详情
  • └ wireless_pic_urls
  • String []
  • https://img.alicdn.com/imgextra/i3/263682007/O1CN01ou4TAT1QhFSDIJ4JX_!!263682007.jpg
  • 无线端图片地址
  • └ sub2_title
  • String
  • 亮点2
  • 亮点2
  • └ end_effective_date
  • String
  • 2019-09-26
  • 预约时段结束日期,预约时段类型为1返回
  • └ service_type
  • String
  • 2773361951
  • C卖家有效。酒店代订服务-671582076,酒店住宿服务-2773361951
  • └ unavailable_weeks
  • String
  • demo
  • 星期几不可入住
  • └ sub3_title
  • String
  • 亮点3
  • 亮点3
  • └ store_seller_id
  • String
  • demo
  • 店铺卖家ID
  • └ begin_type
  • Number
  • 2
  • 售卖时间类型:0-立刻,1-设定时间,2-放入仓库
  • └ sub4_title
  • String
  • 亮点4
  • 亮点4
  • └ seller_id
  • Number
  • 263682007
  • 卖家ID
  • └ etc
  • Number
  • 0
  • 是否电子凭证
  • └ start_effective_date
  • String
  • 2019-09-20
  • 预约时段开始日期,预约时段类型为1时返回
  • └ down_shelf_min
  • String
  • 00
  • 自动下架时间分钟
  • └ confirm_type
  • String
  • 1
  • 确认类型,1-即时确认,2-二次确认,日历库存下返回
  • └ wl_description
  • String
  • 无线端宝贝描述
  • 无线端宝贝描述
  • └ inventory_type
  • Number
  • 1
  • 库存类型,1-普通库存,5-日历库存
  • └ auto_refund
  • Number
  • 0
  • 支持过期退款比率
  • └ store_seller_nick
  • String
  • demo
  • 门店卖家昵称
  • └ breakfast_desc
  • String
  • 早餐描述
  • 早餐描述
  • └ auction_point
  • Number
  • 0
  • 拍卖点,对C卖家有效
  • └ contain_elements
  • String []
  • 温泉
  • 包含元素
  • └ option_promoted
  • Number
  • 0
  • 参与会员打折 0-不参与,1-参与
  • └ description
  • String
  • 宝贝描述
  • PC端宝贝描述
  • └ title
  • String
  • 何墨测试请不要拍Top
  • 标题
  • └ sub1_title
  • String
  • 亮点1
  • 亮点1
  • └ start_available_date
  • String
  • 2019-09-23
  • 可入住日期开始
  • └ amount
  • Number
  • 0
  • 酒店客房优惠券类目下的代金券数量
  • └ quantity
  • Number
  • 24
  • 若为酒店客房优惠券类目则显示库存,其他类目则显示第一条sku的库存
  • └ fee_exclude
  • String
  • 费用包含
  • 费用包含
  • └ invoice_explain
  • String
  • 发票说明
  • 发票说明
  • └ profit_rate
  • String
  • 10.01
  • 分润比例(推广费比例)
  • └ down_shelf_date
  • String
  • 2019-09-26
  • 自动下架时间日期
  • └ additional_pay
  • String
  • 附加费用
  • 附加费用
  • └ begin_date
  • String
  • 2019-09-26
  • 售卖时间日期,售卖时间类型1返回
  • └ outer_id
  • String
  • 12223
  • 商家编码
  • └ invoice
  • Number
  • 0
  • 是否有发票 0-没有,1-店铺提供,2-卖家提供
tuan_item_sku_list TopTuanItemSkuVOList [] sku列表
  • └ night_count
  • Number
  • 2
  • 套餐间夜
  • └ quantity
  • Number
  • 3
  • 套餐库存
  • └ item_title
  • String
  • 何墨测试请不要拍Top
  • 宝贝标题
  • └ orig_price
  • String
  • 500.00
  • 套餐原价
  • └ item_id
  • Number
  • 602451239218
  • 宝贝ID
  • └ seller_id
  • Number
  • 263682007
  • 卖家ID
  • └ price
  • String
  • 400.00
  • 套餐价格
  • └ people_count
  • Number
  • 0
  • 套餐人数
  • └ name
  • String
  • taocanyi
  • 套餐名称
  • calendar_info
  • TopSkuCalendarInfo
  • demo
  • 日历库存信息
  • └ end
  • String
  • 2019-09-26
  • 日历库存范围结束日期
  • diffs
  • TopSkuDailyInfo []
  • 日历库存价格信息
  • └ d
  • String
  • 2019-09-24
  • 日期
  • └ price
  • String
  • 234
  • 价格
  • └ stock
  • Number
  • 2
  • 库存
  • └ begin
  • String
  • 2019-09-22
  • 日历库存范围开始日期
  • └ outer_id
  • String
  • 12223
  • 商家编码
  • └ sku_id
  • Number
  • 4386263418291
  • skuId
tuan_eticket_package TuanEticketPackageVo 电子核销库信息,日历库存和国际套餐暂不支持电子凭证,则无数值返回
  • └ pass_merchant_user_name
  • String
  • 淘宝
  • 核销放行码商名称
  • └ is_money_to_store
  • Number
  • 0
  • 门店分账是否支持资金到门店:0不支持,1支持
  • └ bill_type
  • Number
  • 0
  • 分账方式 0-不分账,1-门店分账 2-宝贝分账
  • └ send_merchant_user_name
  • String
  • 淘宝
  • 核销帐号名称
  • └ is_sub_account
  • Number
  • 0
  • 宝贝分账是否支持子账号核销
  • └ online
  • Number
  • 0
  • 系统自动生成
  • └ send_merchant_user_id
  • Number
  • 0
  • 核销帐号id。电子凭证下,返回。关于发行码商和核销放行的说明 淘宝:0 阿里旅行代金券:2395482105 第三方码商(浙江深大:1077204890、孟宽测试:112414636、子畵码商:436160339、银科环企:2811880569)
  • └ multiple_times
  • Number
  • 0
  • 是否分次预约,0-否,1-是
  • └ bill_infos
  • String
  • 宝贝分账信息,宝贝分账必填。分账多个账号之间以逗号隔开。数据格式(名称:比例数值或金额:类型
  • └ pass_merchant_user_id
  • Number
  • 0
  • 核销放行码商id
  • └ bill_type_desc
  • String
  • 不分账
  • 分账描述
stores TopStoreVO [] [] 关联门店列表
  • └ hid
  • Number
  • 16952001007
  • 物理酒店ID
  • └ city
  • Number
  • 654300
  • 城市
  • └ shid
  • Number
  • 52324457
  • 标准酒店ID
  • └ store_id
  • Number
  • 163682254
  • 门店ID
  • └ bill_infos
  • String
  • user1:10:1
  • 门店分账下的分账信息,数据格式(淘宝账户名称:比例或者金额:分账方式(1-按照比例的方式进行分账,2-按照固定金额的方式进行分账))
  • └ bill_descs
  • String
  • demo
  • 分账描述
  • └ write_off_accounts
  • String
  • user
  • 核销账号
  • room_types
  • TopRoomTypeVO []
  • []
  • 房型列表
  • └ type_name
  • String
  • 标准间
  • 房型名称
  • └ type_id
  • Number
  • 56491307
  • 房型ID
  • └ name
  • String
  • 阿勒泰阳光假日酒店
  • 酒店名称
  • appoint_phones
  • TopAppointPhoneVO []
  • []
  • 联系电话列表
  • └ mobil
  • String
  • 322
  • 手机号
  • └ area
  • String
  • 0906
  • 地区
  • └ country
  • String
  • 0086
  • 国家
  • └ fix
  • String
  • 2119688
  • 固话号码
  • └ p400
  • String
  • p400
  • p400
  • └ type
  • String
  • fixed
  • 类型固话或手机
related_poi_detail_v_o_list RelatedPoiDetailVo [] 关联POI列表
  • └ poi_name
  • String
  • 御膳房故宫
  • POI名称
  • └ poi_id
  • Number
  • 141150669
  • POI ID
tuan_item_relate_gift_list TuanItemRelateGiftVO [] 关联礼包列表
  • └ num
  • Number
  • 1
  • 数量
  • └ type
  • Number
  • 1
  • 类别:1-温泉;2-滑雪;3-门票;4-美食;5-下午茶;6-SPA;7-礼包;8-亲子;9-交通;10-代金券;999-用户自定义
  • └ item_id
  • Number
  • 602451239218
  • 宝贝ID
  • └ unit
  • String
  • 单位
  • └ desc
  • String
  • 温泉
  • 描述
msg_code String 0 错误码
status Boolean true 操作状态
message String 操作成功 错误信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripTuanHotelItemInfoGetRequest req = new AlitripTuanHotelItemInfoGetRequest();
req.setItemId(1222L);
AlitripTuanHotelItemInfoGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alitrip_tuan_hotel_item_info_get_response>
    <item_info>
        <gift>免费赠品</gift>
        <appoint_explain>000</appoint_explain>
        <pic_urls>
            <string>https://img.alicdn.com/imgextra/i3/263682007/O1CN01ou4TAT1QhFSDIJ4JX_!!263682007.jpg</string>
        </pic_urls>
        <sec_kills>
            <string>web</string>
            <string>wap</string>
        </sec_kills>
        <during_end_date>2019-08-09</during_end_date>
        <unavailable_dates>2019-08-11~2019-08-14</unavailable_dates>
        <effective_days>1</effective_days>
        <price>200.00</price>
        <begin_hour>12</begin_hour>
        <confirm_time>2</confirm_time>
        <promoted_status>0</promoted_status>
        <begin_min>23</begin_min>
        <cat_id>201189402</cat_id>
        <item_id>602451239218</item_id>
        <down_shelf_hour>00</down_shelf_hour>
        <advance_days>0</advance_days>
        <breakfast>0</breakfast>
        <main_video_pic_url>https://img.alicdn.com/imgextra/i2/6000000004295/O1CN01liyzk91hb9exHvYzz_!!6000000004295-0-tbvideo.jpg</main_video_pic_url>
        <refund>100</refund>
        <night_count>3</night_count>
        <city>阿勒泰</city>
        <orig_price>500.00</orig_price>
        <shop_categories_id_list>
            <string>12232</string>
        </shop_categories_id_list>
        <sub_stock_at_buy>1</sub_stock_at_buy>
        <end_available_date>2019-08-07</end_available_date>
        <effective_date_type>1</effective_date_type>
        <fee_include>费用包含</fee_include>
        <prov>新疆</prov>
        <seller_nick>卖家昵称</seller_nick>
        <wangpu_detail>000</wangpu_detail>
        <wireless_pic_urls>
            <string>https://img.alicdn.com/imgextra/i3/263682007/O1CN01ou4TAT1QhFSDIJ4JX_!!263682007.jpg</string>
        </wireless_pic_urls>
        <sub2_title>亮点2</sub2_title>
        <end_effective_date>2019-09-26</end_effective_date>
        <service_type>2773361951</service_type>
        <unavailable_weeks>demo</unavailable_weeks>
        <sub3_title>亮点3</sub3_title>
        <store_seller_id>demo</store_seller_id>
        <begin_type>2</begin_type>
        <sub4_title>亮点4</sub4_title>
        <seller_id>263682007</seller_id>
        <etc>0</etc>
        <start_effective_date>2019-09-20</start_effective_date>
        <down_shelf_min>00</down_shelf_min>
        <confirm_type>1</confirm_type>
        <wl_description>无线端宝贝描述</wl_description>
        <inventory_type>1</inventory_type>
        <auto_refund>0</auto_refund>
        <store_seller_nick>demo</store_seller_nick>
        <breakfast_desc>早餐描述</breakfast_desc>
        <auction_point>0</auction_point>
        <contain_elements>
            <string>温泉</string>
        </contain_elements>
        <option_promoted>0</option_promoted>
        <description>宝贝描述</description>
        <title>何墨测试请不要拍Top</title>
        <sub1_title>亮点1</sub1_title>
        <start_available_date>2019-09-23</start_available_date>
        <amount>0</amount>
        <quantity>24</quantity>
        <fee_exclude>费用包含</fee_exclude>
        <invoice_explain>发票说明</invoice_explain>
        <profit_rate>10.01</profit_rate>
        <down_shelf_date>2019-09-26</down_shelf_date>
        <additional_pay>附加费用</additional_pay>
        <begin_date>2019-09-26</begin_date>
        <outer_id>12223</outer_id>
        <invoice>0</invoice>
    </item_info>
    <tuan_item_sku_list>
        <top_tuan_item_sku_v_o_list>
            <night_count>2</night_count>
            <quantity>3</quantity>
            <item_title>何墨测试请不要拍Top</item_title>
            <orig_price>500.00</orig_price>
            <item_id>602451239218</item_id>
            <seller_id>263682007</seller_id>
            <price>400.00</price>
            <people_count>0</people_count>
            <name>taocanyi</name>
            <calendar_info>
                <end>2019-09-26</end>
                <diffs>
                    <top_sku_daily_info>
                        <d>2019-09-24</d>
                        <price>234</price>
                        <stock>2</stock>
                    </top_sku_daily_info>
                </diffs>
                <begin>2019-09-22</begin>
            </calendar_info>
            <outer_id>12223</outer_id>
            <sku_id>4386263418291</sku_id>
        </top_tuan_item_sku_v_o_list>
    </tuan_item_sku_list>
    <tuan_eticket_package>
        <pass_merchant_user_name>淘宝</pass_merchant_user_name>
        <is_money_to_store>0</is_money_to_store>
        <bill_type>0</bill_type>
        <send_merchant_user_name>淘宝</send_merchant_user_name>
        <is_sub_account>0</is_sub_account>
        <online>0</online>
        <send_merchant_user_id>0</send_merchant_user_id>
        <multiple_times>0</multiple_times>
        <bill_infos></bill_infos>
        <pass_merchant_user_id>0</pass_merchant_user_id>
        <bill_type_desc>不分账</bill_type_desc>
    </tuan_eticket_package>
    <stores>
        <top_store_v_o>
            <hid>16952001007</hid>
            <city>654300</city>
            <shid>52324457</shid>
            <store_id>163682254</store_id>
            <bill_infos>user1:10:1</bill_infos>
            <bill_descs>demo</bill_descs>
            <write_off_accounts>user</write_off_accounts>
            <room_types>
                <top_room_type_v_o>
                    <type_name>标准间</type_name>
                    <type_id>56491307</type_id>
                </top_room_type_v_o>
            </room_types>
            <name>阿勒泰阳光假日酒店</name>
            <appoint_phones>
                <top_appoint_phone_v_o>
                    <mobil>322</mobil>
                    <area>0906</area>
                    <country>0086</country>
                    <fix>2119688</fix>
                    <p400>p400</p400>
                    <type>fixed</type>
                </top_appoint_phone_v_o>
            </appoint_phones>
        </top_store_v_o>
    </stores>
    <related_poi_detail_v_o_list>
        <related_poi_detail_vo>
            <poi_name>御膳房故宫</poi_name>
            <poi_id>141150669</poi_id>
        </related_poi_detail_vo>
    </related_poi_detail_v_o_list>
    <tuan_item_relate_gift_list>
        <tuan_item_relate_gift_v_o>
            <num>1</num>
            <type>1</type>
            <item_id>602451239218</item_id>
            <unit>份</unit>
            <desc>温泉</desc>
        </tuan_item_relate_gift_v_o>
    </tuan_item_relate_gift_list>
    <msg_code>0</msg_code>
    <status>true</status>
    <message>操作成功</message>
</alitrip_tuan_hotel_item_info_get_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

返回
顶部