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

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

酒店产品库rate更新

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
gid Number 可选 100000 不推荐使用,请使用out_rid
rpid Number 可选 100000 不推荐使用,请使用rateplan_code
name String 可选 aaa
  • 最大长度:60
  • 废弃
    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(状态库存开)
    add_bed Number 可选 1 不推荐使用
    add_bed_price Number 可选 1 不推荐使用
    currency_code Number 可选 1 不推荐使用(仅支持CNY)
    shijia_tag Number 可选 1 不推荐使用
    jishiqueren_tag Number 可选 1 不推荐使用
    vendor String 可选 taobao
  • 最大长度:50
  • 系统商,一般不用填写,使用需要申请
    rateplan_code String 可选 12345AAA
  • 最大长度:64
  • 商家价格计划编码
    out_rid String 可选 12345AAA
  • 最大长度:64
  • 商家房型ID
    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:加价规则序号
    hotel_xitem_infos String 可选 [{\"actionType\":\"BOUND\",\"outXcode\":\"123456\",\"subTypeCode\":\"40000_105\",\"shortName\":\"延时14点退房\",\"time\":\"00:00-23:59\",\"value\":1200,\"itemDesc\":\"可延时到14点退房\",\"dimensionType\":1,\"picList\":[],\"adultCount\":1,\"childCount\":1,\"itemLimit\":\"\",\"checkInStart\":\"2023-07-13 00:00:01\",\"checkInEnd\":\"2023-07-13 00:00:01\",\"bookStartTime\":\"2023-07-13 00:00:01\",\"bookStartEnd\":\"2023-07-13 00:00:01\",\"featureDetail\":\"\"}] 是一个JSONArray 字符串 actionType 操作类型 BOUND: 绑定,UNBOUND:解绑; outXcode 元素编码 ; subTypeCode x 元素子类型, 参考:https://open.alitrip.com/docs/doc.htm?spm=0.0.0.0.9MjTPx&docType=1&articleId=121402&previewCode=787DFB0895F05C90D167579A04BD32E3; status: 状态是否生效0 失效, 1生效; shortName x元素标题; time 服务时间段(18:00-21:00); value 商品价值(100 - 999900 单位分); itemDesc 商品使用说明; dimensionType 附加产品使用维度 1:每间房维度 2:每间夜维度; picList 图片格式化信息 [{"url":"https://xxxxx/","isMain":true}]; adultCount 成人数量 (1-99); childCount 儿童数量 (0-99); itemLimit 使用限制, 文字描述,200 字内; checkInStart 入住生效开始时间; checkInEnd 入住生效结束时间; bookStartTime 预定生效开始时间; bookStartEnd 预定生效截止时间; featureDetail 详细信息json字符串 [{"detailName":"免费寄存","detailValue":[""],"type":"single","priority":1}]

    响应参数

    名称 类型 示例值 描述
    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.setGid(100000L);
    req.setRpid(100000L);
    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.setAddBed(1L);
    req.setAddBedPrice(1L);
    req.setCurrencyCode(1L);
    req.setShijiaTag(1L);
    req.setJishiquerenTag(1L);
    req.setVendor("taobao");
    req.setRateplanCode("12345AAA");
    req.setOutRid("12345AAA");
    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.setHotelXitemInfos("[{\\"actionType\\":\\"BOUND\\",\\"outXcode\\":\\"123456\\",\\"subTypeCode\\":\\"40000_105\\",\\"shortName\\":\\"延时14点退房\\",\\"time\\":\\"00:00-23:59\\",\\"value\\":1200,\\"itemDesc\\":\\"可延时到14点退房\\",\\"dimensionType\\":1,\\"picList\\":[],\\"adultCount\\":1,\\"childCount\\":1,\\"itemLimit\\":\\"\\",\\"checkInStart\\":\\"2023-07-13 00:00:01\\",\\"checkInEnd\\":\\"2023-07-13 00:00:01\\",\\"bookStartTime\\":\\"2023-07-13 00:00:01\\",\\"bookStartEnd\\":\\"2023-07-13 00:00:01\\",\\"featureDetail\\":\\"\\"}]");
    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

    返回
    顶部