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

taobao.xhotel.room.update (房型库存推送接口(全量推送))

此接口用于更新一个酒店商品,根据传入的gid更新商品信息,该商品必须为对应的发布者才能执行更新操作。如果对应的商品在酒店系统中不存在,则会返回错误提示。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
gid Number 可选 100000 废弃,使用out_rid
out_rid String 可选 123321
  • 最大长度:50
  • 卖家房型ID
    vendor String 可选 taobao
  • 最大长度:50
  • 系统商,一般不填写,使用须申请
    title String 可选 aaa
  • 最大长度:60
  • 废弃,宝贝名称展示在店铺里
    guide String 可选 aaa
  • 最大长度:600
  • 废弃,房型购买须知展示在PC购物路径
    desc String 可选 bbb
  • 最大长度:50000
  • 废弃,宝贝描述展示在宝贝详情页面
    pic byte[] 可选 我是被上传的文件内容
  • 最大长度:512000
  • 废弃,宝贝图片,没有默认使用标准酒店房型图片
    has_receipt Boolean 可选 true 废弃,房型是否提供发票
    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": "2017-01-28", "quota": 10, "al_quota": 2, "sp_quota": 3 }, { "date": "2017-01-29", "quota": 10, "al_quota": 2, "sp_quota": 3 } ] 房型共享库存日历。quota物理库存;al_quota保留房库存;sp_quota超预定库存。其中保留房库存和超预定库存需要向运营申请权限示例:[{"date":2011-01-28,"quota":10,"al_quota":2,"sp_quota":3}]
    room_switch_cal String 可选 [{"date":"yyyy-MM-dd","room_status":2},{"date":"yyyy-MM-dd","room_status":1}] 房型库存开关。 1,开;2,关
    superbook_end_time String 可选 20:00:00 超预定库存截止时间
    superbook_start_time String 可选 08:00:00 超预定库存开始时间
    allotment_end_time String 可选 20:00:00 保留房库存截止时间
    allotment_start_time String 可选 08:00:00 保留房库存截止时间
    status Number 可选 1 宝贝状态,1上架。

    响应参数

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

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    XhotelRoomUpdateRequest req = new XhotelRoomUpdateRequest();
    req.setGid(100000L);
    req.setOutRid("123321");
    req.setVendor("taobao");
    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\": \"2017-01-28\",         \"quota\": 10,         \"al_quota\": 2,         \"sp_quota\": 3     },     {         \"date\": \"2017-01-29\",         \"quota\": 10,         \"al_quota\": 2,         \"sp_quota\": 3     } ]");
    req.setRoomSwitchCal("[{\"date\":\"yyyy-MM-dd\",\"room_status\":2},{\"date\":\"yyyy-MM-dd\",\"room_status\":1}]");
    req.setSuperbookEndTime("20:00:00");
    req.setSuperbookStartTime("08:00:00");
    req.setAllotmentEndTime("20:00:00");
    req.setAllotmentStartTime("08:00:00");
    req.setStatus(1L);
    XhotelRoomUpdateResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <xhotel_room_update_response>
        <gid>200000</gid>
    </xhotel_room_update_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:FORMAT_ERROR 参数格式错误 参数格式错误,请检查参数

    API工具

    如何获得此API

    FAQ

    返回
    顶部