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

酒店商品API

taobao.xhotel.bnbroomtype.add (民宿新增房源)

添加民宿房源

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
rent_size Number 可选 100 单间面积，单位平方米
support_im Number 可选 1 是否支持IM聊天 0不支持 1支持
outer_tags String 可选 xxx,x,xx
  • 最大长度：1000
    		•  房源外部标签 标签信息，逗号(,)分隔，最多1000字符
    cleaning_charge Number 可选 1 清洁费是否收取 0：否 1：是
    invoice Number 必须 1 发票，0：卖家提供发票，1：房东提供发票
    decorate_level Number 可选 1 装修等级 1 精装；2普通；3简装
    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
    • 可选
    • 12: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
    out_hid String 必须 05181208 外部门店id
    tel String 必须 0086#010#12345678 酒店电话。格式：国家代码（最长6位）#区号（最长4位）#电话（最长20位）。国家代码提示：中国大陆0086、香港00852、澳门00853、台湾00886
    receive_foreigners Number 可选 1
  • 默认值：0
    		•  是否可接待外宾 0：否 1：是；默认值: 0
    local_info String 可选 位置描述
  • 最大长度：1000
    		•  位置描述
    brand String 可选 品牌名称
  • 最大长度：100
    		•  品牌名称，最多100字符
    pics BnbPictureDTO [] 必须
  • 最大列表长度：999
    		•  房源图片只支持远程图片，格式如下：[{"url":"http://taobao.com/123.jpg","ismain":"true"},{"url":"http://taobao.com/456.jpg","ismain":"false"},{"url":"http://taobao.com/789.jpg","ismain":"false"}]其中url是远程图片的访问地址（URL地址必须是合法的，否则会报错），main是是否为主图。只能设置一张图片为主图。
    • └ attribute
    • String
    • 必须
    • 平面图
    • 图片属性 取值范围只能是：[普通图, 平面图, 全景图]
    • └ ismain
    • Boolean
    • 必须
    • true
    • 是否主图 false不是， true是,是否主图 主图只能有一个，如果有多个或者没有，则会报错
    • └ des
    • String
    • 可选
    • 客厅照片
    • 图片描述
    • └ type
    • String
    • 必须
    • 大堂
    • type表示图片类型，取值范围只能是：【厨房、卫生间、客厅、卧室、其他】
    • └ url
    • String
    • 必须
    • http://taobao.com/123.jpg
    • 图片地址
    cleaning_type Number 可选 1 清洁费类型 0.线下；1.线上
    deposit_amount Number 可选 1212 押金金额
    name_e String 可选 xxx
  • 最大长度：128
    		•  房源英文名
    decorate_time String 可选 2015-01-01 装修时间，格式为2015-01-01装修时间
    extra_beds_num Number 可选 0 0-n；若不可加床，值为0
    invoice_type Number 必须 2 可提供发票类型，1.专票 2.纸质普票 3.电子普票
    has_front_desk Number 可选 1 是否有前台 0没有 1有
    guest_age Number 可选 1 是否接待儿童、老人；成年人必接待，详见“可接待客人”https://fliggy.open.taobao.com/doc.htm?docId=120148&docType=1
    settlement_currency String 可选 HKD 结算过程中的结算币种符合，如需对接请联系飞猪技术支持，请谨慎使用
    name String [] 必须 大床房
  • 最大长度：60
  • 最大列表长度：60
    		•  房源名
    surround_info String 可选 周边描述
  • 最大长度：1000
    		•  周边描述
    max_occupancy Number 可选 1 最大入住人数 1-99
    is_use_shoot_image Number 可选 1 是否使用实拍图片 0不使用 1使用
    status byte 必须 0 状态 0：在线 -1：不在线 -2:停售
    guest_gender Number 可选 1 0：不限制，1：只限男性，2：只限女性'
    activities_allowed String 可选 12,23
  • 最大长度：500
    		•  详见“允许活动”：https://fliggy.open.taobao.com/doc.htm?docId=120148&docType=1 ，最多500字符
    extra_cleaning_charge Number 可选 1 清洁费金额；整数[1，9999999]
    opening_time String 可选 2021-01-01 开业时间，格式为2015-01-01
    rent_type Number 必须 1 出租类型，1整租；2分租。3床位 默认整租，该字段不能更新
    new_outer_id String 可选 xxx 如果要变更商品房源编码请使用该字段。
    house_model String 必须 {"bedroom":4, "bathroom": 2, "livingroom": 1, "study": 1, "balcony": 1,"kitchen":0} 房屋户型， bedroom: 室, bathroom: 卫, livingroom: 厅, study: 书房, balcony: 阳台,kitchen: 厨房,bedroom和livingroom不能为空
    window_type Number 可选 1 0-无窗 1-有窗 2-部分有窗 3-暗窗 4-部分暗窗 5-落地窗
    has_license Number 必须 1 有无资质执照 0 没有 1有
    video_url String 可选 视频地址
  • 最大长度：1000
    		•  视频地址，最多1000字符
    vendor String 可选 taobao 销售渠道,默认taobao
    brightspot String 可选 亮点描述
  • 最大长度：1000
    		•  亮点描述，最多1000字符
    quick_order Number 可选 1 是否开启闪订 0不开启 1开启
    floor String 可选 3-5层 客房在建筑的第几层，隔层为1-2层，4-5层，7-8层
    house_size Number 必须 100 单间面积，单位平方米
    product_type Number 可选 1 房源类型,见https://fliggy.open.taobao.com/doc.htm?docId=120148&docType=1
    introduction String 可选 不错房源
  • 最大长度：2000
    		•  房源介绍,最多2000字符
    has_landlord Number 可选 1 是否与房东同住 0 不同住 1同住
    charge BnbChargeDto 可选 加人收费信息
    • └ num
    • Number
    • 可选
    • 3
    • 允许加人数
    • └ fee
    • Number
    • 可选
    • 1
    • 加人费用金额
    • └ add_people
    • Number
    • 可选
    • 1
    • 是否允许加人 0不允许 1允许
    • └ min_charging_age
    • Number
    • 可选
    • 5
    • 最小收费年龄
    decorate_style Number 可选 1 装修风格https://fliggy.open.taobao.com/doc.htm?docId=120148&docType=1
    supportcredit Number 可选 1 是否信用免押金0：否 1：是
    check_in_notes String 可选 入住须知
  • 最大长度：2000
    		•  入住须知，最多2000字符
    real_tel String 必须 139888xxx 真实联系方式
    service String 可选 {"24272":"true","24263":"true","24267":"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=40的分类
    cleaning_frequency Number 可选 1 “打扫类型1(1客1扫/换),2(1天1扫/换),https://fliggy.open.taobao.com/doc.htm?docId=120148&docType=1
    outer_id String 必须 xxx 房源id, 这是卖家自己系统中的ID
    location BnbLocationDto 必须 民宿房源位置信息
    • └ country
    • String
    • 必须
    • China
    • domestic为0时，固定China； domestic为1时，必须传定义的海外国家编码值。参见：http://hotel.alitrip.com/area.htm
    • └ address
    • String
    • 可选
    • 北京朝阳金辉大厦
    • 地址，最多200字符
    • └ business
    • String
    • 可选
    • 望京
    • 商圈，最多64字符
    • └ city
    • Number
    • 可选
    • 110100
    • 城市编码。参见：http://hotel.alitrip.com/area.htm，domestic为false时，输入对应国家的海外城市编码，可调用海外城市查询接口获取；（更新酒店时为可选）
    • └ latitude
    • String
    • 必须
    • 111.1222
    • 纬度
    • └ position_type
    • String
    • 必须
    • G
    • 坐标类型，现在支持：G – Google; B – 百度; A – 高德; M – Mapbar; L – 灵图 开芯
    • └ domestic
    • Number
    • 必须
    • 0
    • 是否国内酒店。0:国内;1:国外。默认是国内
    • └ province
    • Number
    • 可选
    • 110000
    • 省份编码http://hotel.alitrip.com/area.htm
    • └ en_address
    • String
    • 可选
    • xxx
    • 英文地址，最多500字符
    • └ reception_address
    • String
    • 可选
    • 接待地址
    • 接待地址，最多200字符
    • └ district
    • Number
    • 必须
    • 101100
    • 区域（县级市）编码。参见：http://hotel.alitrip.com/area.htm
    • └ timezone
    • String
    • 必须
    • +8
    • 时区0到+11或者0到-11
    • └ doorplate
    • String
    • 可选
    • xxx
    • 门牌号，最多200字符
    • └ longitude
    • String
    • 必须
    • 111.13
    • 经度
    scenic_feature Number 可选 1 风景类型(枚举)https://fliggy.open.taobao.com/doc.htm?docId=120148&docType=1
    deposit_type Number 可选 1 押金类型0.线下；1.线上
    bed_info String 必须 [{"bedType":1,"desc":"双人床","width":"1.8","length":"2","bedNum":1}] 床信息: bedType:床型, desc: 床型名, width:床宽, length：床长, bedNum: 床数。床型取值见链接https://open.alitrip.com/docs/doc.htm?spm=0.0.0.0.4zBOVn&docType=1&articleId=108347
    extra_fee String 可选 额外收费
  • 最大长度：2000
    		•  额外收费
    extra_beds_fee Number 可选 14500 加床费,分为单位
    bnb_name String [] 可选 阳光民宿
  • 最大长度：60
  • 最大列表长度：60
    		•  民宿名称，默认取bnbName
    srid Number 可选 1234 添加标准房源匹配
    standard_room_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
    bnb_extend String 可选 {} 民宿扩展信息

    响应参数

    名称 类型 示例值 描述
    xroomtype XRoomType 房源信息
    • └ hid
    • Number
    • 1239999
    • 飞猪门店id
    • └ rid
    • Number
    • 121212
    • 飞猪房源id
    • └ status
    • Number
    • 0
    • 房源状态
    • └ gmt_create
    • Date
    • 2000-01-01 00:00:00
    • 创建时间
    • └ gmt_modified
    • Date
    • 2000-01-01 00:00:00
    • 修改时间
    • └ match_status
    • Number
    • 1
    • 匹配状态: 0：待系统匹配 1：已系统匹配，匹配成功，待卖家确认 2：已系统匹配，匹配失败，待人工匹配 3：已人工匹配，匹配成功，待卖家确认 4：已人工匹配，匹配失败 5：卖家已确认，确认“YES” 6：卖家已确认，确认“NO” 7:已系统匹配，但是匹配重复，待人工确认
    • └ outer_id
    • String
    • xxx
    • 卖家系统id
    • └ name
    • String
    • 房源名称
    • 房源名称
    • └ max_occupancy
    • Number
    • 2
    • 最大入住人数
    • └ area
    • String
    • 面积
    • 面积
    • └ extend
    • String
    • aaa
    • 暂时不对外
    • └ window_type
    • Number
    • 1
    • 窗型,0：无窗/1：有窗
    • └ service
    • String
    • {"bar":false,"catv":false,"ddd":false,"idd":false,"pubtoilet":false,"toilet":false}
    • 设施服务。JSON格式。 value值true有此服务，false没有。 bar：吧台，catv：有线电视，ddd：国内长途电话，idd：国际长途电话，toilet：独立卫生间，pubtoliet：公共卫生间。 如： {"bar":false,"catv":false,"ddd":false,"idd":false,"pubtoilet":false,"toilet":false}
    • └ internet
    • String
    • A
    • 宽带服务。A,B,C,D。分别代表： A：无宽带，B：免费宽带，C：收费宽带，D：部分收费宽带
    • └ floor
    • String
    • 3-5层
    • 客房在建筑的第几层，隔层为1-2层，4-5层，7-8层

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
XhotelBnbroomtypeAddRequest req = new XhotelBnbroomtypeAddRequest();
req.setRentSize(100L);
req.setSupportIm(1L);
req.setOuterTags("xxx,x,xx");
req.setCleaningCharge(1L);
req.setInvoice(1L);
req.setDecorateLevel(1L);
XhotelBnbroomtypeAddRequest.BnbBookingTimeDto obj1 = new XhotelBnbroomtypeAddRequest.BnbBookingTimeDto();
obj1.setStartReceptionTime("12:00");
obj1.setEndReceptionTime("12:00");
obj1.setEarliestCheckInTime("12:00");
obj1.setLatestBookingTime("12:00");
obj1.setLatestCheckInTime("12:00");
obj1.setLatestCheckOutTime("12:00");
req.setBnbBookingTime(obj1);
req.setOutHid("05181208");
req.setTel("0086#010#12345678");
req.setReceiveForeigners(1L);
req.setLocalInfo("位置描述");
req.setBrand("品牌名称");
List<XhotelBnbroomtypeAddRequest.BnbPictureDTO> list3 = new ArrayList<XhotelBnbroomtypeAddRequest.BnbPictureDTO>();
XhotelBnbroomtypeAddRequest.BnbPictureDTO obj4 = new XhotelBnbroomtypeAddRequest.BnbPictureDTO();
list3.add(obj4);
obj4.setAttribute("平面图");
obj4.setIsmain(true);
obj4.setDes("客厅照片");
obj4.setType("大堂");
obj4.setUrl("http://taobao.com/123.jpg");
req.setPics(list3);
req.setCleaningType(1L);
req.setDepositAmount(1212L);
req.setNameE("xxx");
req.setDecorateTime("2015-01-01");
req.setExtraBedsNum(0L);
req.setInvoiceType(2L);
req.setHasFrontDesk(1L);
req.setGuestAge(1L);
req.setSettlementCurrency("HKD");
req.setName("大床房");
req.setSurroundInfo("周边描述");
req.setMaxOccupancy(1L);
req.setIsUseShootImage(1L);
req.setStatus("0");
req.setGuestGender(1L);
req.setActivitiesAllowed("12,23");
req.setExtraCleaningCharge(1L);
req.setOpeningTime("2021-01-01");
req.setRentType(1L);
req.setNewOuterId("xxx");
req.setHouseModel("{\"bedroom\":4, \"bathroom\": 2, \"livingroom\": 1, \"study\": 1, \"balcony\": 1,\"kitchen\":0}");
req.setWindowType(1L);
req.setHasLicense(1L);
req.setVideoUrl("视频地址");
req.setVendor("taobao");
req.setBrightspot("亮点描述");
req.setQuickOrder(1L);
req.setFloor("3-5层");
req.setHouseSize(100L);
req.setProductType(1L);
req.setIntroduction("不错房源");
req.setHasLandlord(1L);
XhotelBnbroomtypeAddRequest.BnbChargeDto obj5 = new XhotelBnbroomtypeAddRequest.BnbChargeDto();
obj5.setNum(3L);
obj5.setFee(1L);
obj5.setAddPeople(1L);
obj5.setMinChargingAge(5L);
req.setCharge(obj5);
req.setDecorateStyle(1L);
req.setSupportcredit(1L);
req.setCheckInNotes("入住须知");
req.setRealTel("139888xxx");
req.setService("{\"24272\":\"true\",\"24263\":\"true\",\"24267\":\"true\"}");
req.setCleaningFrequency(1L);
req.setOuterId("xxx");
XhotelBnbroomtypeAddRequest.BnbLocationDto obj6 = new XhotelBnbroomtypeAddRequest.BnbLocationDto();
obj6.setCountry("China");
obj6.setAddress("北京朝阳金辉大厦");
obj6.setBusiness("望京");
obj6.setCity(110100L);
obj6.setLatitude("111.1222");
obj6.setPositionType("G");
obj6.setDomestic(0L);
obj6.setProvince(110000L);
obj6.setEnAddress("xxx");
obj6.setReceptionAddress("接待地址");
obj6.setDistrict(101100L);
obj6.setTimezone("+8");
obj6.setDoorplate("xxx");
obj6.setLongitude("111.13");
req.setLocation(obj6);
req.setScenicFeature(1L);
req.setDepositType(1L);
req.setBedInfo("[{\"bedType\":1,\"desc\":\"双人床\",\"width\":\"1.8\",\"length\":\"2\",\"bedNum\":1}]");
req.setExtraFee("额外收费");
req.setExtraBedsFee(14500L);
req.setBnbName("阳光民宿");
req.setSrid(1234L);
req.setStandardRoomFacilities("{\"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.setBnbExtend("{}");
XhotelBnbroomtypeAddResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <xhotel_bnbroomtype_add_response>
    <xroomtype>
        <hid>1239999</hid>
        <rid>121212</rid>
        <status>0</status>
        <gmt_create>2000-01-01 00:00:00</gmt_create>
        <gmt_modified>2000-01-01 00:00:00</gmt_modified>
        <match_status>1</match_status>
        <outer_id>xxx</outer_id>
        <name>房源名称</name>
        <max_occupancy>2</max_occupancy>
        <area>面积</area>
        <window_type>1</window_type>
        <service>{&quot;bar&quot;:false,&quot;catv&quot;:false,&quot;ddd&quot;:false,&quot;idd&quot;:false,&quot;pubtoilet&quot;:false,&quot;toilet&quot;:false}</service>
        <internet>A</internet>
        <floor>3-5层</floor>
    </xroomtype>
</xhotel_bnbroomtype_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号