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

taobao.xhotel.bnbhouse.add (民宿门店信息添加)

添加和更新民宿门店的信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
out_owner_id String 必须 owner181000 外部房东id
bnb_booking_time BnbBookingTimeDto 可选 入住要求&附加信息
  • └ start_reception_time
  • String
  • 可选
  • 12:00
  • 开始接待时间 hh:mm,24小时时间格式
  • └ end_reception_time
  • String
  • 可选
  • 12:00
  • 结束接待时间 hh:mm,24小时时间格式
  • └ earliest_check_in_time
  • String
  • 可选
  • 14:00
  • 最早入住时间 hh:mm,24小时时间格式住时间,默认值: 14:00
  • └ latest_booking_time
  • String
  • 可选
  • 12:00
  • 最晚预定时间 hh:mm,24小时时间格式
  • └ latest_check_in_time
  • String
  • 可选
  • 12:00
  • 最晚入住时间 hh:mm,24小时时间格式
  • └ latest_check_out_time
  • String
  • 可选
  • 12:00
  • 最晚离店时间 hh:mm,24小时时间格式,默认值: 12:00
decorate_level Number 可选 1 装修等级 1 精装 2普通 3简装
tel String 必须 0086#010#12345678 联系方式。格式:国家代码(最长6位)#区号(最长4位)#电话(最长20位)。国家代码提示:中国大陆0086、香港00852、澳门00853、台湾00886
receive_foreigners Number 可选 0
  • 默认值:0
  • 是否可接待外宾 0不接待 1接待,默认值: 0
    name_e String 可选 xxx 门店英文名称
    decorate_time String 可选 2015-01-01 装修时间,格式为2015-01-01
    extra_beds_num Number 可选 1 可加床数
    tags String 可选 xxx,xnian 门店标签 标签信息,逗号(,)分隔
    has_front_desk Number 可选 1 是否有前台 0没有 1有
    guest_age Number 可选 1 可接待客人年龄情况:是否接待儿童、老人;成年人必接待,详见“可接待客人”list
    settlement_currency String 可选 CNY 结算过程中的结算币种符合,如需对接请联系飞猪技术支持,请谨慎使用
    name String 必须 套房
  • 最大长度:60
  • 门店名称
    is_use_shoot_image Number 可选 1 是否使用实拍图片 0不使用 1使用
    status byte 必须 0 房型状态。0:正常,-1:删除,-2:停售
    guest_gender Number 可选 1 可接待客人性别 0:不限制,1:只限男性,2:只限女性'
    activities_allowed String 可选 1 详见“允许活动”list 12,32,33,
    opening_time String 可选 2015-01-01 开业时间,格式为2015-01-01
    description String 可选 大床房 门店简介
    pictures BnbPictureDTO [] 必须
  • 最大列表长度:999
  • 民宿门店添加
    • └ attribute
    • String
    • 必须
    • 全景图
    • 图片属性 取值范围只能是:[普通图, 平面图, 全景图]
    • └ ismain
    • Boolean
    • 必须
    • true
    • 是否主图 主图只能有一个,如果有多个或者没有,则会报错
    • └ type
    • String
    • 必须
    • 大堂
    • type表示图片类型,取值范围只能是:[周边, 外观, 商务中心, 健身房, 其他, 会议室, 餐厅, 浴室, 客房, 公共区域, 娱乐设施, 大堂, 泳池]
    • └ url
    • String
    • 必须
    • http://123.jpg
    • 图片地址
    • └ des
    • String
    • 可选
    • 客厅照片
    • 图片描述
    has_license Number 必须 1 有无资质执照 0 无资质 1有资质
    floors String 可选 1 楼层
    video_url String 可选 http://123.jpg 视频地址
    vendor String 可选 1001 对接系统商名称:可为空不要乱填,需要申请后使用
    product_type Number 必须 0 门店类型,详见“房源类型list
    charge BnbChargeDto 可选 加人收费信息
    • └ num
    • Number
    • 可选
    • 1
    • 允许加人数
    • └ fee
    • Number
    • 可选
    • 12
    • 加人费用金额
    • └ add_people
    • Number
    • 可选
    • 1
    • 是否允许加人 0不允许 1允许
    • └ min_charging_age
    • Number
    • 可选
    • 12
    • 最小收费年龄
    decorate_style Number 可选 1 装修风格,详见装修风格枚举表
    check_in_notes String 可选 前台登记 入住须知
    real_tel String 必须 132929123123 真实联系方式
    location BnbLocationDto 必须 位置信息
    • └ country
    • String
    • 必须
    • China
    • domestic为0时,固定China; domestic为1时,必须传定义的海外国家编码值。参见:http://hotel.alitrip.com/area.htm
    • └ address
    • String
    • 必须
    • 北京朝阳金辉大厦
    • 门店地址
    • └ business
    • String
    • 可选
    • 望京
    • 商圈
    • └ city
    • Number
    • 可选
    • 654300
    • 城市编码。参见:http://hotel.alitrip.com/area.htm,domestic为false时,输入对应国家的海外城市编码,可调用海外城市查询接口获取;(更新时为可选)
    • └ latitude
    • String
    • 必须
    • 41.779098
    • 纬度
    • └ position_type
    • String
    • 必须
    • M
    • 坐标类型,现在支持:G – Google; B – 百度; A – 高德; M – Mapbar; L – 灵图
    • └ domestic
    • Number
    • 必须
    • 0
    • 国别 0:国内;1:国外。默认是国内
    • └ province
    • Number
    • 必须
    • 110000
    • 省份编码http://hotel.alitrip.com/area.htm
    • └ en_address
    • String
    • 可选
    • China Beijing Chaoyang
    • 门店英文地址
    • └ reception_address
    • String
    • 可选
    • 望京东SOHO
    • 接待地址
    • └ district
    • Number
    • 必须
    • 101100
    • 区域(县级市)编码。参见:http://hotel.alitrip.com/area.htm
    • └ timezone
    • String
    • 可选
    • +8
    • 时区0到+11或者0到-11
    • └ doorplate
    • String
    • 可选
    • 1101
    • 门牌号
    • └ longitude
    • String
    • 必须
    • 86.139839
    • 经度
    • └ city_name
    • String
    • 可选
    • 北京市
    • 城市名称,优先取city字段,city字段如果为空会校验cityName
    attributes Number 必须 1 门店属性 1 个人房源 2 城市公寓 3 乡村民宿等
    outer_id String 必须 05181208 供应商渠道门店ID
    scenic_feature Number 可选 1 风景类型,详见风景类型枚举表
    brand String 可选 test 品牌名称
    facilities String 可选 {"24058":"true","24198":"true","24200":"true"} 酒店设施。json格式示例值:{"24152":true,"24149":true,"24150":true},key取值参见 https://open.alitrip.com/docs/doc.htm?spm=0.0.0.0.vSVPks&docType=1&articleId=108416&previewCode=987A11324A278EF679E24102BA30D426 中type=20的分类
    house_size Number 可选 70 面积大小
    shid Number 可选 123456 匹配的标准门店
    standard_hotel_facilities String 必须 {"dataVersion":"2.0.0","facilityList":[{"500":true,"fee":true},{"501":true,"option":"1"},{"506":true,"mul-option":["1","2"],"desc":"说明"},{"507":true,"desc":"说明"},{"509":true,"value":"12:00","fee":true},{"2":true,"list":[{"inDoorType":"1","fee":true},{"inDoorType":"2","fee":true}]},{"7":true,"list":[{"restaurantType":"1","name":"品珍中餐厅"},{"restaurantType":"2","name":"和日式料理"}]}]} 标准酒店服务,参考文档https://fliggy.open.taobao.com/doc.htm?docId=120362&docType=1
    is_feizhu_hotel Boolean 可选 true 传入是或者否,是表明为菲住合作模式,hid打标;“否”表示为正常合作模式,hid去标;不传保持原有的合作模式不变
    commission_rate Number 可选 92 作为菲住门店签约的佣金比率,范围为10-50

    响应参数

    名称 类型 示例值 描述
    results XHotel [] 系统自动生成
    • └ country
    • String
    • China
    • 国家编码
    • └ domestic
    • Number
    • 0
    • 0:国内;1:国外
    • └ vendor
    • String
    • xx
    • 对接系统商名称
    • └ name
    • String
    • xx
    • 门店名称
    • └ outer_id
    • String
    • 104931
    • 外部id
    • └ modified_time
    • Date
    • 2000-01-01 00:00:00
    • 修改时间
    • └ created_time
    • Date
    • 2000-01-01 00:00:00
    • 创建时间
    • └ error_info
    • String
    • 门店不存在
    • 未通过时的拒绝原因等。
    • shotel
    • XsHotel
    • 淘宝标准门店信息
    • └ address
    • String
    • 望京大厦
    • 酒店地址
    • └ business
    • String
    • 王府井
    • 商圈
    • └ district
    • Number
    • 110101
    • 区域编码
    • └ city
    • Number
    • 110100
    • 城市编码
    • └ province
    • Number
    • 110000
    • 省份编码
    • └ country
    • String
    • China
    • 国家编码
    • └ domestic
    • Number
    • 0
    • 0:国内;1:国外
    • └ name
    • String
    • 大厂房
    • 门店名称
    • └ shid
    • Number
    • 123123
    • 系统自动生成
    • └ name_e
    • String
    • house
    • 英文名称
    • └ status
    • Number
    • 0
    • 门店状态:0: 正常;-2:停售;-1:删除
    • └ brand
    • String
    • 万达
    • 品牌
    • └ pics
    • String
    • [{"url":"http://123.jpg","ismain":"false","type":"大堂","attribute":"普通图"},{"url":"http://456.jpg","ismain":"true","type":"公共区域","attribute":"全景图"},{"url":"http://789.jpg","ismain":"false","type":"大堂","attribute":"普通图"}]
    • 照片,json格式
    • └ service
    • String
    • {"airportShuttle":true}
    • 交通距离与设施服务。JSON格式。
    • └ hotel_facilities
    • String
    • {"24058":"true","24198":"true","24200":"true"}
    • 酒店设施。json格式
    • └ description
    • String
    • 大床房
    • 描述
    • └ rooms
    • Number
    • 10
    • 房间数
    • └ floors
    • String
    • 6
    • 楼层
    • └ decorate_time
    • String
    • 2013
    • 装修时间
    • └ opening_time
    • String
    • 2013
    • 开业年份
    • └ tel
    • String
    • 0086#010#12345678
    • 门店电话
    • └ latitude
    • String
    • 41.779098
    • 纬度
    • └ position_type
    • Number
    • 1
    • position_type
    • └ longitude
    • String
    • 41.779098
    • 精度
    • └ hid
    • Number
    • 1331212
    • 卖家门店ID
    • └ name_e
    • String
    • xx
    • 英文名称
    • └ tel
    • String
    • 0086#010#12345678
    • 门店电话
    • └ position_type
    • String
    • 1
    • position_type
    • └ latitude
    • String
    • 41.779098
    • 纬度
    • └ longitude
    • String
    • 41.779098
    • 精度
    • └ address
    • String
    • 丰台区xx路
    • 地址
    • └ business
    • String
    • 12
    • 商圈
    • └ district
    • Number
    • 110000
    • 地区
    • └ city
    • Number
    • 110000
    • 城市
    • └ province
    • Number
    • 110000
    • └ brand
    • String
    • 万达
    • 品牌
    • └ pics
    • String
    • [{"url":"http://123.jpg","ismain":"false","type":"大堂","attribute":"普通图"},{"url":"http://456.jpg","ismain":"true","type":"公共区域","attribute":"全景图"},{"url":"http://789.jpg","ismain":"false","type":"大堂","attribute":"普通图"}]
    • 照片格式,json
    • └ hotel_facilities
    • String
    • {"24058":"true","24198":"true","24200":"true"}
    • 设施
    • └ hotel_policies
    • String
    • {"children_age_from":"2","children_age_to":"3","children_stay_free":"True","infant_age":"1","min_guest_age":"4"}
    • 入住政策
    • └ description
    • String
    • 大床房
    • 描述
    • └ rooms
    • Number
    • 3
    • 房间数
    • └ floors
    • String
    • 6
    • 楼层
    • └ decorate_time
    • String
    • 2013
    • 装修时间
    • └ opening_time
    • String
    • 2013
    • 开业时间
    • └ booking_notice
    • String
    • {"hotelInMountaintop":1,"needBoat":1,"hotelInScenicSpot":1,"extraBed":"加床收费xx元","extraCharge":"","arrivalTime":"入住日18点前","extend":""}
    • 预订须知

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    XhotelBnbhouseAddRequest req = new XhotelBnbhouseAddRequest();
    req.setOutOwnerId("owner181000");
    XhotelBnbhouseAddRequest.BnbBookingTimeDto obj1 = new XhotelBnbhouseAddRequest.BnbBookingTimeDto();
    obj1.setStartReceptionTime("12:00");
    obj1.setEndReceptionTime("12:00");
    obj1.setEarliestCheckInTime("14:00");
    obj1.setLatestBookingTime("12:00");
    obj1.setLatestCheckInTime("12:00");
    obj1.setLatestCheckOutTime("12:00");
    req.setBnbBookingTime(obj1);
    req.setDecorateLevel(1L);
    req.setTel("0086#010#12345678");
    req.setReceiveForeigners(0L);
    req.setNameE("xxx");
    req.setDecorateTime("2015-01-01");
    req.setExtraBedsNum(1L);
    req.setTags("xxx,xnian");
    req.setHasFrontDesk(1L);
    req.setGuestAge(1L);
    req.setSettlementCurrency("CNY");
    req.setName("套房");
    req.setIsUseShootImage(1L);
    req.setStatus("0");
    req.setGuestGender(1L);
    req.setActivitiesAllowed("1");
    req.setOpeningTime("2015-01-01");
    req.setDescription("大床房");
    List<XhotelBnbhouseAddRequest.BnbPictureDTO> list3 = new ArrayList<XhotelBnbhouseAddRequest.BnbPictureDTO>();
    XhotelBnbhouseAddRequest.BnbPictureDTO obj4 = new XhotelBnbhouseAddRequest.BnbPictureDTO();
    list3.add(obj4);
    obj4.setAttribute("全景图");
    obj4.setIsmain(true);
    obj4.setType("大堂");
    obj4.setUrl("http://123.jpg");
    obj4.setDes("客厅照片");
    req.setPictures(list3);
    req.setHasLicense(1L);
    req.setFloors("1");
    req.setVideoUrl("http://123.jpg");
    req.setVendor("1001");
    req.setProductType(0L);
    XhotelBnbhouseAddRequest.BnbChargeDto obj5 = new XhotelBnbhouseAddRequest.BnbChargeDto();
    obj5.setNum(1L);
    obj5.setFee(12L);
    obj5.setAddPeople(1L);
    obj5.setMinChargingAge(12L);
    req.setCharge(obj5);
    req.setDecorateStyle(1L);
    req.setCheckInNotes("前台登记");
    req.setRealTel("132929123123");
    XhotelBnbhouseAddRequest.BnbLocationDto obj6 = new XhotelBnbhouseAddRequest.BnbLocationDto();
    obj6.setCountry("China");
    obj6.setAddress("北京朝阳金辉大厦");
    obj6.setBusiness("望京");
    obj6.setCity(654300L);
    obj6.setLatitude("41.779098");
    obj6.setPositionType("M");
    obj6.setDomestic(0L);
    obj6.setProvince(110000L);
    obj6.setEnAddress("China Beijing Chaoyang");
    obj6.setReceptionAddress("望京东SOHO");
    obj6.setDistrict(101100L);
    obj6.setTimezone("+8");
    obj6.setDoorplate("1101");
    obj6.setLongitude("86.139839");
    obj6.setCityName("北京市");
    req.setLocation(obj6);
    req.setAttributes(1L);
    req.setOuterId("05181208");
    req.setScenicFeature(1L);
    req.setBrand("test");
    req.setFacilities("{\"24058\":\"true\",\"24198\":\"true\",\"24200\":\"true\"}");
    req.setHouseSize(70L);
    req.setShid(123456L);
    req.setStandardHotelFacilities("{\"dataVersion\":\"2.0.0\",\"facilityList\":[{\"500\":true,\"fee\":true},{\"501\":true,\"option\":\"1\"},{\"506\":true,\"mul-option\":[\"1\",\"2\"],\"desc\":\"说明\"},{\"507\":true,\"desc\":\"说明\"},{\"509\":true,\"value\":\"12:00\",\"fee\":true},{\"2\":true,\"list\":[{\"inDoorType\":\"1\",\"fee\":true},{\"inDoorType\":\"2\",\"fee\":true}]},{\"7\":true,\"list\":[{\"restaurantType\":\"1\",\"name\":\"品珍中餐厅\"},{\"restaurantType\":\"2\",\"name\":\"和日式料理\"}]}]}");
    req.setIsFeizhuHotel(true);
    req.setCommissionRate(92L);
    XhotelBnbhouseAddResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <xhotel_bnbhouse_add_response>
        <results>
            <x_hotel>
                <country>China</country>
                <domestic>0</domestic>
                <vendor>xx</vendor>
                <name>xx</name>
                <outer_id>104931</outer_id>
                <modified_time>2000-01-01 00:00:00</modified_time>
                <created_time>2000-01-01 00:00:00</created_time>
                <error_info>门店不存在</error_info>
                <shotel>
                    <address>望京大厦</address>
                    <business>王府井</business>
                    <district>110101</district>
                    <city>110100</city>
                    <province>110000</province>
                    <country>China</country>
                    <domestic>0</domestic>
                    <name>大厂房</name>
                    <shid>123123</shid>
                    <name_e>house</name_e>
                    <status>0</status>
                    <brand>万达</brand>
                    <pics>[{&quot;url&quot;:&quot;http://123.jpg&quot;,&quot;ismain&quot;:&quot;false&quot;,&quot;type&quot;:&quot;大堂&quot;,&quot;attribute&quot;:&quot;普通图&quot;},{&quot;url&quot;:&quot;http://456.jpg&quot;,&quot;ismain&quot;:&quot;true&quot;,&quot;type&quot;:&quot;公共区域&quot;,&quot;attribute&quot;:&quot;全景图&quot;},{&quot;url&quot;:&quot;http://789.jpg&quot;,&quot;ismain&quot;:&quot;false&quot;,&quot;type&quot;:&quot;大堂&quot;,&quot;attribute&quot;:&quot;普通图&quot;}]</pics>
                    <service>{&quot;airportShuttle&quot;:true}</service>
                    <hotel_facilities>{&quot;24058&quot;:&quot;true&quot;,&quot;24198&quot;:&quot;true&quot;,&quot;24200&quot;:&quot;true&quot;}</hotel_facilities>
                    <description>大床房</description>
                    <rooms>10</rooms>
                    <floors>6</floors>
                    <decorate_time>2013</decorate_time>
                    <opening_time>2013</opening_time>
                    <tel>0086#010#12345678</tel>
                    <latitude>41.779098</latitude>
                    <position_type>1</position_type>
                    <longitude>41.779098</longitude>
                </shotel>
                <hid>1331212</hid>
                <name_e>xx</name_e>
                <tel>0086#010#12345678</tel>
                <position_type>1</position_type>
                <latitude>41.779098</latitude>
                <longitude>41.779098</longitude>
                <address>丰台区xx路</address>
                <business>12</business>
                <district>110000</district>
                <city>110000</city>
                <province>110000</province>
                <brand>万达</brand>
                <pics>[{&quot;url&quot;:&quot;http://123.jpg&quot;,&quot;ismain&quot;:&quot;false&quot;,&quot;type&quot;:&quot;大堂&quot;,&quot;attribute&quot;:&quot;普通图&quot;},{&quot;url&quot;:&quot;http://456.jpg&quot;,&quot;ismain&quot;:&quot;true&quot;,&quot;type&quot;:&quot;公共区域&quot;,&quot;attribute&quot;:&quot;全景图&quot;},{&quot;url&quot;:&quot;http://789.jpg&quot;,&quot;ismain&quot;:&quot;false&quot;,&quot;type&quot;:&quot;大堂&quot;,&quot;attribute&quot;:&quot;普通图&quot;}]</pics>
                <hotel_facilities>{&quot;24058&quot;:&quot;true&quot;,&quot;24198&quot;:&quot;true&quot;,&quot;24200&quot;:&quot;true&quot;}</hotel_facilities>
                <hotel_policies>{&quot;children_age_from&quot;:&quot;2&quot;,&quot;children_age_to&quot;:&quot;3&quot;,&quot;children_stay_free&quot;:&quot;True&quot;,&quot;infant_age&quot;:&quot;1&quot;,&quot;min_guest_age&quot;:&quot;4&quot;}</hotel_policies>
                <description>大床房</description>
                <rooms>3</rooms>
                <floors>6</floors>
                <decorate_time>2013</decorate_time>
                <opening_time>2013</opening_time>
                <booking_notice>{&quot;hotelInMountaintop&quot;:1,&quot;needBoat&quot;:1,&quot;hotelInScenicSpot&quot;:1,&quot;extraBed&quot;:&quot;加床收费xx元&quot;,&quot;extraCharge&quot;:&quot;&quot;,&quot;arrivalTime&quot;:&quot;入住日18点前&quot;,&quot;extend&quot;:&quot;&quot;}</booking_notice>
            </x_hotel>
        </results>
    </xhotel_bnbhouse_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>

    错误码解释

    错误码 错误描述 解决方案
    isv.invalid-parameter:ERROR 字段错误 修改错误字段

    API工具

    如何获得此API

    FAQ

    返回
    顶部