文档中心 > API类目 > 酒店API(新)

taobao.xhotel.room.add (已废弃,勿用)

此接口用于发布一个集市酒店商品,商品的发布者是当前会话的用户。如果该酒店、该房型、该用户所对应的商品在淘宝集市酒店系统中已经存在,则会返回错误提示。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
hid Number 可选 100000 酒店ID, 这是淘宝系统中的酒店ID 如果hid不为空那么rid也不能为空
rid Number 特殊可选 100000 房型ID, 这是淘宝系统中的房型ID 如果out_rid为空那么rid不能为空
title String 必须 aaa
  • 最大长度:60
  • 宝贝名称。宝贝名称长度不能超过60字节(30汉字)
    guide String 可选 aaa
  • 最大长度:600
  • 购买须知。购买须知长度不能超过600字节
    desc String 可选 bbb
  • 最大长度:50000
  • 宝贝描述。宝贝描述长度不能超过50000字节
    pic byte[] 可选 我是被上传的文件内容
  • 最大长度:512000
  • 酒店商品图片。类型:JPG,GIF;最大长度:500K。支持的文件类型:gif,jpg,jpeg,png。发布的时候只能发布一张图片,可为空,默认使用房型图片
    支持的文件类型:jpg,png,gif
    has_receipt Boolean 可选 true 酒店商品是否提供发票。注意:B卖家必填该字段,C卖家可选
    receipt_type String 可选 A 发票类型。A,B。分别代表: A:酒店住宿发票,B:其他
    receipt_other_type_desc String 可选 aaa
  • 最大长度:30
  • 发票类型为其他时的发票描述,不能超过30个字
    receipt_info String 可选 bbb
  • 最大长度:100
  • 发票说明,不能超过100个字
    inventory String 可选 [{"date":2011-01-28,"quota":10},{"date":2011-01-29,"quota":10}] room级别库存日历,可选参数。备注:taobao酒店库存分为room级别共享库存和rate级别私用库存(请参考taobao.xhotel.rate.add接口查看库存在下单时候的校验逻辑)。请top用户根据自己的数据模型选择合适的对接方式。示例[{"date":2011-01-28,"quota":10},{"date":2011-01-29,"quota":10}]
    vendor String 可选 chinaonline
  • 最大长度:50
  • 用于标示该宝贝的售卖渠道信息,允许同一个卖家酒店房型在淘宝系统发布多个售卖渠道的宝贝。不确定渠道信息不要填写,默认是"taobao"如果rid为空那么out_rid不能为空
    out_rid String 特殊可选 12345321
  • 最大长度:50
  • 卖家房型ID, 这是卖家自己系统中的房型ID 如果rid为空那么out_rid不能为空
    room_switch_cal String 可选 [{"date":"yyyy-MM-dd","room_status":2},{"date":"yyyy-MM-dd","room_status":1}] 在添加新room时,同时添加room开关日历,可以单独控制某一天room得可售状态。 可以只设定想设定的某些天,可以不连续。 date:开关状态控制的是那一天 rate_status:开关状态。1,上架;2,下架;3,删除。如果传入数据中有重复日期将以后一个为准。

    响应参数

    名称 类型 示例值 描述
    gid Number 200000 gid酒店商品id

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    XhotelRoomAddRequest req = new XhotelRoomAddRequest();
    req.setHid(100000L);
    req.setRid(100000L);
    req.setTitle("aaa");
    req.setGuide("aaa");
    req.setDesc("bbb");
    req.setPic(new FileItem("/tmp/file.txt"));
    req.setHasReceipt(true);
    req.setReceiptType("A");
    req.setReceiptOtherTypeDesc("aaa");
    req.setReceiptInfo("bbb");
    req.setInventory("[{\"date\":2011-01-28,\"quota\":10},{\"date\":2011-01-29,\"quota\":10}]");
    req.setVendor("chinaonline");
    req.setOutRid("12345321");
    req.setRoomSwitchCal("[{\"date\":\"yyyy-MM-dd\",\"room_status\":2},{\"date\":\"yyyy-MM-dd\",\"room_status\":1}]");
    XhotelRoomAddResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <xhotel_room_add_response>
        <gid>200000</gid>
    </xhotel_room_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.remote-service:CONVERT_ERROR 转换对象时出错 请检查输入参数
    isv.invalid-parameter:ROOM_QUOTA_PARSE_ERROR 商品房态不正确 请检查输入参数
    isv.invalid-parameter:ROOMS_QUOTA_NUMBER_ERROR 多个商品房态数量不能超过30个 请减少房态数量
    isv.invalid-parameter: ERROR_SELLER_ROOM 商品不属于卖家 请使用正确的卖家账号操作
    isv.invalid-parameter: ERROR_ROOM_REPEAT 一个房型下只允许发一个商品 请不要重复发商品
    isv.invalid-parameter: ERROR_GUIDE 购买须知超长 请控制购买须知长度
    isv.invalid-parameter: ERROR_NO_FOUND_ROOM 查询无此商品 请输入正确的参数
    isv.invalid-parameter: ERROR_INVENTORY_NO_FOUND 查询不到对应商品的库存 请检查商品库存
    isv.invalid-parameter: ERROR_HOTEL 酒店查询失败 请检查输入参数
    isv.invalid-parameter: ERROR_ROOMTYPE 房型查询失败 请检查输入参数
    isv.invalid-parameter: ERROR_RECEIPT 发票错误 请检查发票输入
    isv.invalid-parameter: ERROR_SPU 生成spu失败 请检查输入参数
    isv.invalid-parameter: ERROR_SHOTEL 标准酒店查询失败 请检查输入参数
    isv.invalid-parameter: ERROR_PIC 图片参数错误 请检查图片参数
    isv.invalid-parameter: ERROR_DESC 商品详情不能为空 商品详情不能为空
    isv.invalid-parameter: ERROR_CHECK_INVENTORY 库存校验错误 请检查库存参数
    isv.invalid-parameter: ERROR_TITILE 商品标题不能为空 商品标题不能为空
    isv.invalid-parameter: ERROR_PIC_UP 图片上传错误 请检查图片参数并重新上传图片
    isv.invalid-parameter: ERROR_PIC_POWER 图片权限错误 请检查图片参数
    isv.invalid-parameter: ERROR_SHOTEL_STATUS 标准酒店状态错误 请检查输入参数
    isv.permission-error:NO_PERMISSIONS_ERROR 权限不够、非法访问 请申请权限或者使用正确的卖家操作
    isv.invalid-parameter: ERROR_HOTEL_POWER 酒店不属于该卖家 请使用正确的卖家操作
    isv.invalid-parameter: ERROR_HOTEL_MATCH 酒店匹配状态错误 请检查酒店匹配状态
    isv.invalid-parameter: ERROR_HOTEL_STATUS 酒店状态错误 请检查酒店状态
    isv.invalid-parameter: ERROR_HOTEL_ROOMTYPE 房型不属于该酒店 请检查输入参数
    isv.invalid-parameter: ERROR_ROOMTYPE_POWER 房型不属于该卖家 请使用正确的卖家操作
    isv.invalid-parameter: ERROR_ROOMTYPE_STATUS 房型状态错误 请检查房型状态
    isv.invalid-parameter: ERROR_ROOMTYPE_MATCH 房型匹配状态错误 请检查房型匹配状态

    API工具

    如何获得此API

    FAQ

    返回
    顶部