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

taobao.xhotel.rate.update (价格推送接口(全量更新))

酒店产品库rate更新

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
inventory_price String 可选 {"use_room_inventory":false,"inventory_price":[{"date":2014-01-28,"quota":10,"price":100},{"date":2014-01-29,"quota":10,"price":200}]} 每日价格和房价专有库存信息。A:use_room_inventory:是否使用room级别共享库存,可选值 true false 1、true时:使用room级别共享库存(即使用gid对应的XRoom中的inventory),rate_quota_map 的json 数据中不需要录入库存信息,录入的库存信息会忽略 2、false时:使用rate级别私有库存,此时要求价格和库存必填。B:date 日期必须为 T---T+180 日内的日期(T为当天),且不能重复C:price 价格 int类型 取值范围1-99999999 单位为分D:quota 库存 int 类型 取值范围 0-999(数量库存) 60000(状态库存关) 61000(状态库存开)
rateplan_code String 特殊可选 12345AAA
  • 最大长度:64
  • 商家价格计划编码
    out_rid String 特殊可选 12345AAA
  • 最大长度:64
  • 商家房型ID
    vendor String 可选 taobao
  • 最大长度:50
  • 系统商,一般不用填写,使用需要申请
    rate_switch_cal String 可选 [{"date":"yyyy-MM-dd","rate_status":1},{"date":"yyyy-MM-dd","rate_status":0}] 日历价格开关, date:开关状态控制的是那一天 rate_status:开关状态。0,关闭;1,打开
    lock_end_time String 可选 2016-07-15 00:00:00 锁库存截止时间,如果当前时间是在锁库存开始时间和截止时间之间,那么不允许修改该活动库存(包含开始时间和截止时间)
    lock_start_time String 可选 2016-07-16 00:00:00 锁库存开始时间,如果当前时间是在锁库存开始时间和截止时间之间,那么不允许修改该活动库存(包含开始时间和截止时间)
    online_booking_binding_info String 可选 [{"itemId":1234235235,"skuId":1234235235,"priceRuleInfoList":[{"priceRuleNumber":"14235253"},{"priceRuleNumber":"14235253"},{"priceRuleNumber":"14235253"}]},{"itemId":1234235235,"skuId":1234235235,"priceRuleInfoList":[{"priceRuleNumber":"14235253"},{"priceRuleNumber":"14235253"},{"priceRuleNumber":"14235253"}]}] 在线预约关联关系推送,priceRuleNumber:加价规则序号

    响应参数

    名称 类型 示例值 描述
    gid_and_rpid String aaaaa 酒店商品ID-酒店RPid

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    XhotelRateUpdateRequest req = new XhotelRateUpdateRequest();
    req.setName("aaa");
    req.setInventoryPrice("{\"use_room_inventory\":false,\"inventory_price\":[{\"date\":2014-01-28,\"quota\":10,\"price\":100},{\"date\":2014-01-29,\"quota\":10,\"price\":200}]}");
    req.setRateplanCode("12345AAA");
    req.setOutRid("12345AAA");
    req.setVendor("taobao");
    req.setRateSwitchCal("[{\"date\":\"yyyy-MM-dd\",\"rate_status\":1},{\"date\":\"yyyy-MM-dd\",\"rate_status\":0}]");
    req.setLockEndTime("2016-07-15 00:00:00");
    req.setLockStartTime("2016-07-16 00:00:00");
    req.setOnlineBookingBindingInfo("[{\"itemId\":1234235235,\"skuId\":1234235235,\"priceRuleInfoList\":[{\"priceRuleNumber\":\"14235253\"},{\"priceRuleNumber\":\"14235253\"},{\"priceRuleNumber\":\"14235253\"}]},{\"itemId\":1234235235,\"skuId\":1234235235,\"priceRuleInfoList\":[{\"priceRuleNumber\":\"14235253\"},{\"priceRuleNumber\":\"14235253\"},{\"priceRuleNumber\":\"14235253\"}]}]");
    req.setGid(100000L);
    req.setRpid(100000L);
    req.setAddBed(1L);
    req.setAddBedPrice(1L);
    req.setCurrencyCode(1L);
    req.setShijiaTag(1L);
    req.setJishiquerenTag(1L);
    XhotelRateUpdateResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <xhotel_rate_update_response>
        <gid_and_rpid>aaaaa</gid_and_rpid>
    </xhotel_rate_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.invalid-parameter:FORMAT_ERROR 参数格式不正确 请检查输入参数
    isv.invalid-parameter:ERROR 参数不正确 请检查输入参数
    isv.permission-error:NO_PERMISSIONS_ERROR 权限不够、非法访问 请申请权限或者使用正确的账号操作
    isv.invalid-parameter: RATE_REPEAT_ERROR 定价信息已经存在 请不要重复添加定价信息
    isv.biz-error: RATEPLAN_NOT_EXIST_ERROR 定价信息关联的价格计划不存在 请检查输入参数
    isv.biz-error:BIZ_ERROR 业务异常 请稍后重试
    isv.biz-error: INVENTORY_NOT_EXSIT_ERROR 库存不存在 请检查输入参数
    isv.invalid-parameter:NOTNULL 参数不能为空 参数不能为空
    isv.remote-service:CONVERT_ERROR 转换对象时出错 请检查输入参数
    isv.invalid-parameter:ROOM_TYPE_NOT_EXIST 无房型 先发布房型
    isv.invalid-parameter: RATE_NOT_EXIST_ERROR 不会出现 没有会自动新增
    isv.room-error:ROOM_NOT_EXIST 房型不存在 房型不存在
    isv.invalid-parameter:RATEPLAN_TYPE_NOT_EXIST 房价rateplan不存在 房价rateplan不存在。请检查参数
    isp.service-unavailable 服务不可用 服务不可用

    API工具

    如何获得此API

    FAQ

    返回
    顶部