文档中心 > 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

    FAQ

    返回
    顶部