添加和更新民宿门店的信息
名称 | 类型 | 是否必须 | 示例值 | 更多限制 | 描述 | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
out_owner_id | String | 必须 | owner181000 | 外部房东id | |||||||||||||||||||
bnb_booking_time | BnbBookingTimeDto | 可选 | 入住要求&附加信息 | ||||||||||||||||||||
|
|||||||||||||||||||||||
decorate_level | Number | 可选 | 1 | 装修等级 1 精装 2普通 3简装 | |||||||||||||||||||
tel | String | 必须 | 0086#010#12345678 | 联系方式。格式:国家代码(最长6位)#区号(最长4位)#电话(最长20位)。国家代码提示:中国大陆0086、香港00852、澳门00853、台湾00886 | |||||||||||||||||||
receive_foreigners | Number | 可选 | 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 | 必须 | 套房 |
|
门店名称 | ||||||||||||||||||
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 [] | 必须 |
|
民宿门店添加 | |||||||||||||||||||
|
|||||||||||||||||||||||
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 | 可选 | 加人收费信息 | ||||||||||||||||||||
|
|||||||||||||||||||||||
decorate_style | Number | 可选 | 1 | 装修风格,详见装修风格枚举表 | |||||||||||||||||||
check_in_notes | String | 可选 | 前台登记 | 入住须知 | |||||||||||||||||||
real_tel | String | 必须 | 132929123123 | 真实联系方式 | |||||||||||||||||||
location | BnbLocationDto | 必须 | 位置信息 | ||||||||||||||||||||
|
|||||||||||||||||||||||
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 [] | 系统自动生成 | |
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 | 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.setDes( "客厅照片" ); req.setPictures(list3); req.setHasLicense(1L); req.setFloors( "1" ); 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()); |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 | < 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 >[{"url":"http://123.jpg","ismain":"false","type":"大堂","attribute":"普通图"},{"url":"http://456.jpg","ismain":"true","type":"公共区域","attribute":"全景图"},{"url":"http://789.jpg","ismain":"false","type":"大堂","attribute":"普通图"}]</ pics > < service >{"airportShuttle":true}</ service > < hotel_facilities >{"24058":"true","24198":"true","24200":"true"}</ 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 >[{"url":"http://123.jpg","ismain":"false","type":"大堂","attribute":"普通图"},{"url":"http://456.jpg","ismain":"true","type":"公共区域","attribute":"全景图"},{"url":"http://789.jpg","ismain":"false","type":"大堂","attribute":"普通图"}]</ pics > < hotel_facilities >{"24058":"true","24198":"true","24200":"true"}</ hotel_facilities > < hotel_policies >{"children_age_from":"2","children_age_to":"3","children_stay_free":"True","infant_age":"1","min_guest_age":"4"}</ hotel_policies > < description >大床房</ description > < rooms >3</ rooms > < floors >6</ floors > < decorate_time >2013</ decorate_time > < opening_time >2013</ opening_time > < booking_notice >{"hotelInMountaintop":1,"needBoat":1,"hotelInScenicSpot":1,"extraBed":"加床收费xx元","extraCharge":"","arrivalTime":"入住日18点前","extend":""}</ booking_notice > </ x_hotel > </ results > </ xhotel_bnbhouse_add_response > |
1 2 3 4 5 6 | < 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 | 字段错误 | 修改错误字段 |