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

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

酒店产品库复杂rate(多人价,连住价等)更新 同时完全涵盖taobao.xhotel.rate.update的功能

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
gid Number 特殊可选 123 废弃,使用out_rid
out_rid String 特殊可选 123 卖家房型ID
rpid Number 特殊可选 123 废弃,使用rate_plan_code
rate_plan_code String 可选 123 卖家自己系统的房价code
name String 可选 aaa 废弃
occupancy Number 必须 1 入住人数(范围1~10)
lengthofstay Number 必须 1 连住天数(范围1~5)
inventory_price String 可选 {"use_room_inventory":false,"inventory_price":[{"date":2015-07-28,"quota":11,"price":150,"tax":100,"addBed":2200,"addPerson":2000},{"date":2015-07-29,"quota":10,"price":200,"tax":100,"addBed":1200,"addPerson":2000}]} 价格和库存信息。 A:use_room_inventory:是否使用房型共享库存,可选值 true false ,false时:使用房价专有库存,此时要求价格和库存必填。 B:date 日期必须为 T---T+180 日内的日期(T为当天),且不能重复 C:price 价格 int类型 取值范围1-99999999 单位为分 D:quota 库存 int 类型 取值范围 0-999(数量库存) 60000(状态库存关) 61000(状态库存开) tax为税费,addBed为加床价,addPerson为加人价1,若连住大于1,price请推送总价
rate_switch_cal String 可选 [{"date":"yyyy-MM-dd","rate_status":1,"checkin_status":1,"checkout_status":1},{"date":"yyyy-MM-dd","rate_status":0,"checkin_status":1,"checkout_status":1}] 价格开关 date:开关状态控制的那一天;rate_status:开关状态(0,关闭;1,打开); checkin_status:入住开关(0,关闭;1,打开);checkout_status:离店开关 (0,关闭;1,打开)
currency_code String 可选 CNY 币种.CNY为人民币
status Number 可选 123 价格状态。0为不可售;1为可售,默认可售
vendor String 可选 taobao 系统商,一般不填写,使用须申请
childnum Number 可选 1
  • 最小值:1
  • 最大值:10
  • 儿童人数
    infantnum Number 可选 1
  • 最小值:1
  • 最大值:10
  • 婴儿人数
    lock_end_time String 可选 2016-07-16 00:00:00 锁库存截止时间,如果当前时间是在锁库存开始时间和截止时间之间,那么不允许修改该活动库存(包含开始时间和截止时间)
    lock_start_time String 可选 2016-07-15 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_occupancy_lengthofstay String 1000-12300-1-1 gid-rpid-occupancy-lengthofstay 商品ID-房价ID-入住人数-连住天数

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    XhotelMultiplerateUpdateRequest req = new XhotelMultiplerateUpdateRequest();
    req.setGid(123L);
    req.setOutRid("123");
    req.setRpid(123L);
    req.setRatePlanCode("123");
    req.setName("aaa");
    req.setOccupancy(1L);
    req.setLengthofstay(1L);
    req.setInventoryPrice("{\"use_room_inventory\":false,\"inventory_price\":[{\"date\":2015-07-28,\"quota\":11,\"price\":150,\"tax\":100,\"addBed\":2200,\"addPerson\":2000},{\"date\":2015-07-29,\"quota\":10,\"price\":200,\"tax\":100,\"addBed\":1200,\"addPerson\":2000}]}");
    req.setRateSwitchCal("[{\"date\":\"yyyy-MM-dd\",\"rate_status\":1,\"checkin_status\":1,\"checkout_status\":1},{\"date\":\"yyyy-MM-dd\",\"rate_status\":0,\"checkin_status\":1,\"checkout_status\":1}]");
    req.setCurrencyCode("CNY");
    req.setStatus(123L);
    req.setVendor("taobao");
    req.setChildnum(1L);
    req.setInfantnum(1L);
    req.setLockEndTime("2016-07-16 00:00:00");
    req.setLockStartTime("2016-07-15 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\"}]}]");
    XhotelMultiplerateUpdateResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <xhotel_multiplerate_update_response>
        <gid_and_rpid_occupancy_lengthofstay>1000-12300-1-1</gid_and_rpid_occupancy_lengthofstay>
    </xhotel_multiplerate_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.biz-error: RATEPLAN_NOT_EXIST_ERROR 定价信息关联的房价不存在 请检查输入参数
    isv.biz-error:BIZ_ERROR 业务异常 请稍后重试
    isv.invalid-parameter:NOTNULL 参数不能为空 参数不能为空,请检查参数必填项
    isv.remote-service:CONVERT_ERROR 转换对象时出错 请检查输入参数
    isv.session-not-exist session信息不存在 session信息不存在,请检查,确保传入正确有效的session信息

    API工具

    如何获得此API

    FAQ

    返回
    顶部