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

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

房型添加或更新

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
outer_id String 必须 100000
  • 最大长度:64
  • 卖家房型ID,不能重复建议格式是:酒店code_房型code
    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层
    bed_type String 必须 大床
  • 最大长度:100
  • 床型。按链接中床型列表定义值存储 http://open.taobao.com/docs/doc.htm?&docType=1&articleId=105610
    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
  • 不要使用
    window_type Number 可选 1 0:无窗/1:有窗/2:部分有窗/3:暗窗/4:部分暗窗
    srid Number 可选 123123 该字段只有确定的时候,才允许填入。用于标示和淘宝房型的匹配关系。目前尚未启动该字段。
    out_hid String 特殊可选 123123
  • 最大长度:50
  • (必传)商家酒店ID,指明该房型属于哪家酒店
    vendor String 可选 taobao
  • 最大长度:50
  • 系统商,无申请不可使用
    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: 含义是非直连房型
    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":"和日式料理"} ]} ] } 酒店房型设施

    响应参数

    名称 类型 示例值 描述
    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
    • 修改时间
    • └ status
    • Number
    • 1
    • 房型状态。0:正常,-1:删除,-2:停售
    • 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:删除
    • └ match_status
    • Number
    • 1
    • 匹配状态: 0:待系统匹配 1:已系统匹配,匹配成功,待卖家确认 2:已系统匹配,匹配失败,待人工匹配 3:已人工匹配,匹配成功,待卖家确认 4:已人工匹配,匹配失败 5:卖家已确认,确认“YES” 6:卖家已确认,确认“NO” 7:已系统匹配,但是匹配重复,待人工确认
    • └ 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}
    • └ extend
    • String
    • {"keyword":”上地”}
    • 扩展信息的JSON。 注:此字段的值需要ISV在接入前与淘宝沟通,且确认能解析
    • └ window_type
    • 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.setOuterId("100000");
    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.setWindowType(1L);
    req.setSrid(123123L);
    req.setOutHid("123123");
    req.setVendor("taobao");
    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\":\"和日式料理\"}     ]}   ] }");
    XhotelRoomtypeAddResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <xhotel_roomtype_add_response>
        <xroomtype>
        </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 参数不能为空 请对照线上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 标准房型问题 标准房型问题
    accesscontrol.limited-by-seller-access-count
    isv.invalid-parameter:RoomType_BED_INFO_ERROR
    isv.invalid-parameter:ROOM_TYPE_NOT_EXIST

    API工具

    如何获得此API

    FAQ

    返回
    顶部