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

taobao.xhotel.rooms.increment (房型库存推送接口(批量增量))

Room库存增量更新接口,用户仅需要更新ROOM库存中发生变化的库存日历即可。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
room_quota_map String 必须 [{"out_rid":"hotel1_roomtype1","vendor":"","allotment_start_Time":"","allotment_end_time":"","superbook_start_time":"","superbook_end_time":"","roomQuota":[{"date":"2023-12-28","quota":10,"al_quota":2,"sp_quota":3}]},{"out_rid":"hotel1_roomtype2","vendor":"","allotment_start_Time":"","allotment_end_time":"","superbook_start_time":"","superbook_end_time":"","roomQuota":[{"date":"2023-12-28","quota":10,"al_quota":2,"sp_quota":3}]}] 批量全量推送房型共享库存,一次最多修改30个房型。json encode。示例:[{"out_rid":"hotel1_roomtype22","vendor":"","allotment_start_Time":"","allotment_end_time":"","superbook_start_time":"","superbook_end_time":"","roomQuota":[{"date":2010-01-28,"quota":10,"al_quota":2,"sp_quota":3}]}] 其中al_quota为保留房库存,sp_quota为超预定库存,quota为物理库存。al_quota和sp_quota需要向运营申请权限才可维护。allotment_start_Time和allotment_end_time为保留房库存开始和截止时间;superbook_start_time和superbook_end_time为超预定库存开始和截止时间。

响应参数

名称 类型 示例值 描述
gids String [] 200000 成功的gids LIST

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
XhotelRoomsIncrementRequest req = new XhotelRoomsIncrementRequest();
req.setRoomQuotaMap("[{\"out_rid\":\"hotel1_roomtype1\",\"vendor\":\"\",\"allotment_start_Time\":\"\",\"allotment_end_time\":\"\",\"superbook_start_time\":\"\",\"superbook_end_time\":\"\",\"roomQuota\":[{\"date\":\"2023-12-28\",\"quota\":10,\"al_quota\":2,\"sp_quota\":3}]},{\"out_rid\":\"hotel1_roomtype2\",\"vendor\":\"\",\"allotment_start_Time\":\"\",\"allotment_end_time\":\"\",\"superbook_start_time\":\"\",\"superbook_end_time\":\"\",\"roomQuota\":[{\"date\":\"2023-12-28\",\"quota\":10,\"al_quota\":2,\"sp_quota\":3}]}]");
XhotelRoomsIncrementResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<xhotel_rooms_increment_response>
    <gids>
        <string>200000</string>
    </gids>
</xhotel_rooms_increment_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 房型匹配状态错误 请检查房型匹配状态
isv.invalid-parameter:ROOMS_INCREMENT_QUOTA_NUMBER_ERROR 多个商品增量更新房态数量不能超过10个 请减少房态数量
isv.sql-error:GET_NAME_TYPE_ERROR 获取名称类型失败 获取名称类型失败
isp.service-unavailable 服务不可用 服务不可用

API工具

如何获得此API

FAQ

返回
顶部