此接口用于发布一个集市酒店商品，商品的发布者是当前会话的用户。如果该酒店、该房型、该用户所对应的商品在淘宝集市酒店系统中已经存在，则会返回错误提示。
| 名称 | 类型 | 是否必须 | 示例值 | 更多限制 | 描述 |
|---|---|---|---|---|---|
| hid | Number | 可选 | 100000 | 酒店ID, 这是淘宝系统中的酒店ID 如果hid不为空那么rid也不能为空 | |
| rid | Number | 特殊可选 | 100000 | 房型ID, 这是淘宝系统中的房型ID 如果out_rid为空那么rid不能为空 | |
| title | String | 必须 | aaa |
|
宝贝名称。宝贝名称长度不能超过60字节（30汉字） |
| guide | String | 可选 | aaa |
|
购买须知。购买须知长度不能超过600字节 |
| desc | String | 可选 | bbb |
|
宝贝描述。宝贝描述长度不能超过50000字节 |
| pic | byte[] | 可选 | 我是被上传的文件内容 |
|
酒店商品图片。类型: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个字 |
| receipt_info | String | 可选 | bbb |
|
发票说明，不能超过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 |
|
用于标示该宝贝的售卖渠道信息，允许同一个卖家酒店房型在淘宝系统发布多个售卖渠道的宝贝。不确定渠道信息不要填写，默认是"taobao"如果rid为空那么out_rid不能为空 |
| out_rid | String | 特殊可选 | 12345321 |
|
卖家房型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 |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 | 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()); |
1 2 3 | <xhotel_room_add_response> <gid>200000</gid></xhotel_room_add_response> |
1 2 3 4 5 6 | <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 | 房型匹配状态错误 | 请检查房型匹配状态 |
