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

酒店商品API

taobao.xhotel.roomtype.add (房型新增接口（ID重复变更新）)

房型添加或更新

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
hid Number 可选 100000 （已废弃）请使用outHid
name String 必须 标准间
  • 最大长度：200
    		•  房型名称。不能超过200个字符
    max_occupancy Number 可选 2
  • 默认值：2
    		•  最大入住人数，默认2（1-99）
    area String 可选 10
  • 最大长度：30
    		•  具体面积大小，请按照正确格式填写。两种格式，例如：40或者 10-20
    floor String 可选 3-5层
  • 最大长度：30
    		•  客房在建筑的第几层，隔层为1-2层，4-5层，7-8层
    bed_type String 必须 大床
  • 最大长度：100
    		•  （已废弃）床型请使用bed_info字段
    bed_size String 可选 1.8米
  • 最大长度：30
    		•  床宽。按自己定义存储，比如：2.1米
    internet String 可选 A 宽带服务。A,B,C,D。分别代表： A：无宽带，B：免费宽带，C：收费宽带，D：部分收费宽带
    service String 可选 {"bar":false,"catv":false,"ddd":false,"idd":false,"pubtoilet":false,"toilet":false}
  • 最大长度：1024
    		•  设施服务。JSON格式。 value值true有此服务，false没有。 bar：吧台，catv：有线电视，ddd：国内长途电话，idd：国际长途电话，toilet：独立卫生间，pubtoliet：公共卫生间。 如： {"bar":false,"catv":false,"ddd":false,"idd":false,"pubtoilet":false,"toilet":false}
    extend String 可选 空
  • 最大长度：500
    		•  不要使用
    outer_id String 必须 100000
  • 最大长度：64
    		•  卖家房型ID，不能重复建议格式是:酒店code_房型code
    window_type Number 可选 1 0:无窗/1:有窗/2:部分有窗/3:暗窗/4:部分暗窗
    srid Number 可选 123123 该字段只有确定的时候，才允许填入。用于标示和淘宝房型的匹配关系。目前尚未启动该字段。
    vendor String 可选 taobao
  • 最大长度：50
    		•  系统商，无申请不可使用
    out_hid String 可选 123123
  • 最大长度：50
    		•  （必传）商家酒店ID，指明该房型属于哪家酒店
    pics String 可选 [{"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":"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是是否为主图。只能设置一张图片为主图。
    name_e String 可选 standard room
  • 最大长度：200
    		•  卖家房型英文名称
    operator String 可选 operator 操作人信息
    connection_type Number 可选 1 属性值为1: 含义是非直连房型
    bed_info String 可选 [{ "main_bed_type": "10", "sub_bed_type": [{ "sub_bed_num": 1, "bed_type": "0", "length": "1.8", "width": "2" }, { "sub_bed_num": 1, "bed_type": "0", "length": "1.8", "width": "2" }] }] main_bed_type母床型,sub_bed_type子床型。详情参见文档： https://open.alitrip.com/docs/doc.htm?spm=0.0.0.0.yN2mES&docType=1&articleId=118712&previewCode=1DABB73EA935608455E203BA06CF3566
    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://open.alitrip.com/docs/doc.htm?docType=1&articleId=108891
    window_desc String 可选 { "windowType":1, "windowTypeDefect":"1,2", "windowTypeSpecial":2 } 窗型，窗型（windowType）： 0=无窗 1=有窗 2=部分有窗 窗型缺陷（windowTypeDefect）： 0=窗户不可打开通风 1=窗外有遮挡 2=窗外为酒店内景观 特殊窗（windowTypeSpecial）： 0=落地窗 1=飘窗 2=天窗 3=小窗。 当为有窗或部分有窗时，窗型缺陷可多选，特殊窗型需单选
    add_bed String 可选 { "addBed":true, "fee":true, "desc":"xxxx" } 房型加床政策。 费用(fee) 说明(desc)
    children_policy String 可选 {"isAllowChildren": true, //是否允许携带儿童"isAllowSharingBed": true, //是否允许儿童共用现有床铺"policySharingBed": {//儿童共用床铺信息"maxChildrenCount": 3, //允许共用现有床铺的最大儿童数量"rangeFrom": 0, //允许共用床铺的起始儿童年龄"rangeTo": 17 //允许共用床铺的截止儿童年龄},"limitChildrenAge": {//酒店允许入住的儿童年龄范围"maxChildrenAge": 17, //最大儿童年龄"minChildrenAge": 0 //最小儿童年龄},"policyContent": "该酒店欢迎携带儿童入住", //儿童政策描述"extraBedDetails": [{//儿童加床政策详情 "rangeFrom": 0, //儿童起始年龄 "rangeTo": 3, //儿童截止年龄 "extraBedFeeList": [{"extraBedType": 0, //加床类型"isFree": false, //是否免费"fee": { //费用"amountCent": 999, //原始外币报价金额（分）"amount": 9.99, //原始外币报价金额（元）"currencyCode": "CNY"//币种代码}}, {"extraBedType": 1,"isFree": false,"fee": {"amountCent": 999,"amount": 9.99,"currencyCode": "EUR"} }]},{"rangeFrom": 4, "rangeTo": 12, "extraBedFeeList": [ {"extraBedType": 0,"isFree": true }, {"extraBedType": 2,"isFree": false,"fee": {"amountCent": 333,"amount": 3.33,"currencyCode": "JPY"}}]}]} 儿童政策

    响应参数

    名称 类型 示例值 描述
    xroomtype XRoomType 房型信息
    • └ rid
    • Number
    • 123456
    • rid
    • └ hid
    • Number
    • 123456
    • hid
    • └ created_time
    • Date
    • 2000-01-01 00:00:00
    • 创建时间
    • └ modified_time
    • Date
    • 2000-01-01 00:00:00
    • 修改时间
    • └ match_status
    • Number
    • 1
    • 此字段已废弃
    • └ status
    • Number
    • 1
    • 房型状态。0:正常，-1:删除，-2:停售
    • └ error_info
    • String
    • 房型不存在
    • 出错原因,没有匹配上标准房型时，小二拒绝的理由
    • └ outer_id
    • String
    • 1111
    • 卖家系统id
    • └ name
    • String
    • 标准间
    • 房型名称
    • └ max_occupancy
    • Number
    • 2
    • 最大入住人数
    • └ area
    • String
    • A
    • 可选值：A,B,C,D。分别代表： A：15平米以下，B：16－30平米，C：31－50平米，D：50平米以上 2）也可以自己定义，比如：40平方米
    • └ floor
    • String
    • 3-5层
    • 客房在建筑的第几层，隔层为1-2层，4-5层，7-8层
    • └ bed_type
    • String
    • 大床
    • 床型。按自己定义存储，比如：高低床、上下床
    • └ bed_size
    • String
    • 2.1米
    • 床宽。
    • └ internet
    • String
    • A
    • 宽带服务。A,B,C,D。分别代表： A：无宽带，B：免费宽带，C：收费宽带，D：部分收费宽带
    • └ 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}
    • └ window_type
    • Number
    • 1
    • 窗型,0：无窗/1：有窗
    • └ extend
    • String
    • {"keyword":”上地”}
    • 扩展信息的JSON。 注：此字段的值需要ISV在接入前与淘宝沟通，且确认能解析
    • s_roomtype
    • SRoomType
    • 标准房型信息
    • └ srid
    • Number
    • 123456
    • 匹配的标准房型
    • └ name
    • String
    • aaa
    • 房型名
    • └ floor
    • String
    • 7-8层
    • 楼层
    • └ internet
    • String
    • aaa
    • 宽带服务 "0","有线上网(免费), "1","有线上网(无)", "2","有线上网(收费)", "3","有线上网(部分有且免费)", "4","有线上网(部分有且收费)"
    • └ shid
    • Number
    • 123456
    • shid
    • └ pic_url
    • String
    • aaa
    • pic_url
    • └ facility
    • String
    • aaa
    • facility
    • └ max_occupancy
    • Number
    • 1
    • 最大入住人数
    • └ area
    • String
    • 16－30平米
    • 面积
    • └ extend
    • String
    • aaa
    • 扩展字段
    • └ created_time
    • Date
    • 2000-01-01 00:00:00
    • 创建时间
    • └ modified_time
    • Date
    • 2000-01-01 00:00:00
    • 修改时间
    • └ window_type
    • String
    • 有窗
    • 窗型，枚举类型 0, 无窗, 1, 有窗;
    • └ bed
    • String
    • [{"bedType":"大床","bedSize":"1.5m"},{"bedType":"双床","bedSize":"1.2m"}]
    • 床型。json格式：[{"bedType":"大床","bedSize":"1.5m"},{"bedType":"双床","bedSize":"1.2m"}]
    • └ status
    • Number
    • 1
    • 状态。0:正常;-1:删除
    • └ name_e
    • String
    • standard room
    • 卖家房型英文名称

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
XhotelRoomtypeAddRequest req = new XhotelRoomtypeAddRequest();
req.setHid(100000L);
req.setName("标准间");
req.setMaxOccupancy(2L);
req.setArea("10");
req.setFloor("3-5层");
req.setBedType("大床");
req.setBedSize("1.8米");
req.setInternet("A");
req.setService("{\"bar\":false,\"catv\":false,\"ddd\":false,\"idd\":false,\"pubtoilet\":false,\"toilet\":false}");
req.setExtend("空");
req.setOuterId("100000");
req.setWindowType(1L);
req.setSrid(123123L);
req.setVendor("taobao");
req.setOutHid("123123");
req.setPics("[{\"url\":\"http://taobao.com/123.jpg\",\"ismain\":\"true\"},{\"url\":\"http://taobao.com/456.jpg\",\"ismain\":\"false\"},{\"url\":\"http://taobao.com/789.jpg\",\"ismain\":\"false\"}]");
req.setNameE("standard room");
req.setOperator("operator");
req.setConnectionType(1L);
req.setBedInfo("[{ \"main_bed_type\": \"10\", \"sub_bed_type\": [{ \"sub_bed_num\": 1, \"bed_type\": \"0\", \"length\": \"1.8\", \"width\": \"2\" }, { \"sub_bed_num\": 1, \"bed_type\": \"0\", \"length\": \"1.8\", \"width\": \"2\" }] }]");
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.setWindowDesc("{ \"windowType\":1, \"windowTypeDefect\":\"1,2\", \"windowTypeSpecial\":2 }");
req.setAddBed("{ \"addBed\":true, \"fee\":true, \"desc\":\"xxxx\" }");
req.setChildrenPolicy("{\"isAllowChildren\": true, //是否允许携带儿童\"isAllowSharingBed\": true, //是否允许儿童共用现有床铺\"policySharingBed\": {//儿童共用床铺信息\"maxChildrenCount\": 3, //允许共用现有床铺的最大儿童数量\"rangeFrom\": 0, //允许共用床铺的起始儿童年龄\"rangeTo\": 17 //允许共用床铺的截止儿童年龄},\"limitChildrenAge\": {//酒店允许入住的儿童年龄范围\"maxChildrenAge\": 17, //最大儿童年龄\"minChildrenAge\": 0 //最小儿童年龄},\"policyContent\": \"该酒店欢迎携带儿童入住\", //儿童政策描述\"extraBedDetails\": [{//儿童加床政策详情  \"rangeFrom\": 0, //儿童起始年龄  \"rangeTo\": 3, //儿童截止年龄  \"extraBedFeeList\": [{\"extraBedType\": 0, //加床类型\"isFree\": false, //是否免费\"fee\": { //费用\"amountCent\": 999, //原始外币报价金额（分）\"amount\": 9.99, //原始外币报价金额（元）\"currencyCode\": \"CNY\"//币种代码}}, {\"extraBedType\": 1,\"isFree\": false,\"fee\": {\"amountCent\": 999,\"amount\": 9.99,\"currencyCode\": \"EUR\"} }]},{\"rangeFrom\": 4, \"rangeTo\": 12, \"extraBedFeeList\": [ {\"extraBedType\": 0,\"isFree\": true }, {\"extraBedType\": 2,\"isFree\": false,\"fee\": {\"amountCent\": 333,\"amount\": 3.33,\"currencyCode\": \"JPY\"}}]}]}");
XhotelRoomtypeAddResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <xhotel_roomtype_add_response>
    <xroomtype>
        <rid>123456</rid>
        <hid>123456</hid>
        <created_time>2000-01-01 00:00:00</created_time>
        <modified_time>2000-01-01 00:00:00</modified_time>
        <match_status>1</match_status>
        <status>1</status>
        <error_info>房型不存在</error_info>
        <outer_id>1111</outer_id>
        <name>标准间</name>
        <max_occupancy>2</max_occupancy>
        <area>A</area>
        <floor>3-5层</floor>
        <bed_type>大床</bed_type>
        <bed_size>2.1米</bed_size>
        <internet>A</internet>
        <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>
        <window_type>1</window_type>
        <extend>{&quot;keyword&quot;:”上地”}</extend>
        <s_roomtype>
            <srid>123456</srid>
            <name>aaa</name>
            <floor>7-8层</floor>
            <internet>aaa</internet>
            <shid>123456</shid>
            <pic_url>aaa</pic_url>
            <facility>aaa</facility>
            <max_occupancy>1</max_occupancy>
            <area>16－30平米</area>
            <extend>aaa</extend>
            <created_time>2000-01-01 00:00:00</created_time>
            <modified_time>2000-01-01 00:00:00</modified_time>
            <window_type>有窗</window_type>
            <bed>[{&quot;bedType&quot;:&quot;大床&quot;,&quot;bedSize&quot;:&quot;1.5m&quot;},{&quot;bedType&quot;:&quot;双床&quot;,&quot;bedSize&quot;:&quot;1.2m&quot;}]</bed>
            <status>1</status>
        </s_roomtype>
        <name_e>standard room</name_e>
    </xroomtype>
</xhotel_roomtype_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:NOTNULL 参数不能为空 请检查参数
    isv.invalid-parameter:ERROR 参数不正确 请检查参数
    isv.biz-error:STATUS_NOT_CORRECT 状态不正确 请检查状态
    isv.biz-error:NOT_RIGHTS_TO_PUBLISH_ERROR 非消保酒店卖家不能发布修改酒店、房型或宝贝 请使用消保酒店卖家操作
    isv.invalid-parameter:ROOM_TYPE_EXIST 房型已存在 请添加其他房型
    isv.invalid-parameter:ROOM_TYPE_NOT_EXIST 房型不存在 请检查输入参数
    isv.biz-error:CAN_NOT_UPDATE_ROOMTYPE 房型处于待匹配待确认或已确认成功状态无法更新 请更换房型操作或稍后重试
    isv.biz-error:UPDATE_ROOMTYPE_ERROR 更新房型失败 请稍后重试
    isv.biz-error:HAS_NOT_MATCH_SHOTEL 酒店尚未匹配到标准酒店 请先进行酒店匹配
    isv.biz-error:HAS_NOT_CONFRIM_HOTEL 酒店匹配结果尚未确认 请先进行酒店匹配结果确认
    isv.biz-error:CAN_NOT_UPDATE_HID 不能变更房型所属的酒店 不要更新房型对应的hid
    isv.biz-error:ALREADY_EXIST_SROOMTYPE 该卖家已经有房型匹配了该标准房型 请检查房型信息，不要重复匹配
    isv.permission-error:NO_PERMISSIONS_ERROR 权限不够、非法访问 请申请权限
    isv.remote-service:CONVERT_ERROR 转换对象时出错 请检查输入参数
    isv.invalid-parameter:HOTEL_NOT_EXIST 酒店不存在 查看outHid是否正确
    isv.biz-error:SROOMTYP_TO_SHOTEL 标准房型问题 标准房型问题

    API工具

    API测试工具 错误码查询工具 SDK下载

    如何获得此API

    FAQ

    我要提问
    返回
    顶部
    阿里巴巴集团 | 淘宝网 | 天猫 | 聚划算 | 全球速卖通 | 阿里巴巴国际交易市场 | 1688 | 阿里妈妈 | 阿里旅行·去啊 | 阿里云计算 | YunOS | 阿里通信 | 万网 | 高德 | 优视 | 友盟 | 酷盘 | 虾米 | 天天动听 | 来往 | 钉钉 | 11Main | 支付宝
    关于淘宝 合作伙伴 营销中心 联系客服 开放平台 诚征英才 联系我们 网站地图 法律声明 © 2016 Taobao.com 版权所有
    网络文化经营许可证：文网文[2010]040号 | 增值电信业务经营许可证：浙B2-20080224-1 | 信息网络传播视听节目许可证：1109364号