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

taobao.xhotel.house.roomtype.add (民宿房型信息添加)

房型添加或更新

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
hid Number 可选 100000 (已废弃)请使用outHid
name String 必须 标准间
  • 最大长度:30
  • 房型名称。不能超过30字
    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层
    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 卖家房型英文名称
    operator String 可选 operator 操作人信息
    connection_type Number 可选 1 属性值为1: 含义是非直连房型
    house_model String 可选 {"bedroom":4, "bathroom": 2, "livingroom": 1, "study": 1, "balcony": 1,"kitchen":0} 房屋户型, bedroom: 室, bathroom: 卫, livingroom: 厅, study: 书房, balcony: 阳台,kitchen: 厨房
    house_size Number 可选 120 房屋面积
    rent_type Number 可选 1 出租类型:1.整租;2.单间;3.床位
    rent_size Number 可选 120 出租面积,单位平方米
    has_landlord Number 可选 0 是否和房东合住: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
    status Number 可选 0 数据状态 0:正常,-1:删除,-2:停售

    响应参数

    名称 类型 示例值 描述
    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
    • 匹配状态: 0:待系统匹配 1:已系统匹配,匹配成功,待卖家确认 2:已系统匹配,匹配失败,待人工匹配 3:已人工匹配,匹配成功,待卖家确认 4:已人工匹配,匹配失败 5:卖家已确认,确认“YES” 6:卖家已确认,确认“NO” 7:已系统匹配,但是匹配重复,待人工确认
    • └ 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);
    XhotelHouseRoomtypeAddRequest req = new XhotelHouseRoomtypeAddRequest();
    req.setHid(100000L);
    req.setName("标准间");
    req.setMaxOccupancy(2L);
    req.setArea("10");
    req.setFloor("3-5层");
    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.setHouseModel("{\"bedroom\":4, \"bathroom\": 2, \"livingroom\": 1, \"study\": 1, \"balcony\": 1,\"kitchen\":0}");
    req.setHouseSize(120L);
    req.setRentType(1L);
    req.setRentSize(120L);
    req.setHasLandlord(0L);
    req.setBedInfo("[{\"bedType\":1,\"desc\":\"双人床\",\"width\":\"1.8\",\"length\":\"2\",\"bedNum\":1}]");
    req.setStatus(0L);
    XhotelHouseRoomtypeAddResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <xhotel_house_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_house_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 参数不能为空 请对照线上API文档,检查必填参数,更新SDK版本
    isv.invalid-parameter:ERROR 参数不正确 请对照线上API文档,检查参数取值范围,更新SDK版本
    isv.biz-error:NOT_RIGHTS_TO_PUBLISH_ERROR 非消保酒店卖家不能发布修改酒店、房型或宝贝 请使用消保酒店卖家操作
    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 权限不够、非法访问 API对接群(酒店) 联系技术支持申请权限
    isv.remote-service:CONVERT_ERROR 转换对象时出错 请检查输入参数
    isv.invalid-parameter:HOTEL_NOT_EXIST 酒店不存在 查看outHid是否正确
    isv.invalid-parameter:ROOM_TYPE_EXIST 房型不存在 不会出现该问题,不存在会自动新增
    isv.biz-error:SROOMTYP_TO_SHOTEL 标准房型问题 标准房型问题

    API工具

    如何获得此API

    FAQ

    返回
    顶部