文档中心 > API类目 > 酒店商品API

taobao.xhotel.rate.get (酒店产品库rate查询)

酒店产品库rate查询

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
gid Number 可选 100000 gid酒店商品id
rpid Number 可选 100000 酒店RPID
vendor String 可选 ChinaOnline
  • 最大长度:50
  • 用于标示该宝贝的售卖渠道信息,允许同一个卖家酒店房型在淘宝系统发布多个售卖渠道的宝贝的价格。
    rateplan_code String 可选 12345AAA
  • 最大长度:128
  • 卖家自己系统的Code,简称RateCode
    out_rid String 可选 12345AAA
  • 最大长度:128
  • 卖家房型ID, 这是卖家自己系统中的房型ID 注意:需要按照规则组合
    rate_id Number 可选 112221 RateID

    响应参数

    名称 类型 示例值 描述
    rate Rate rate
    • └ gid
    • Number
    • 123456
    • 酒店商品id
    • └ rpid
    • Number
    • 123456
    • 酒店RPID
    • └ name
    • String
    • aaa
    • 名称
    • └ 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+90 日内的日期(T为当天),且不能重复 C:price 价格 int类型 取值范围1-99999999 单位为分 D:quota 库存 int 类型 取值范围 0-999(数量库存) 60000(状态库存关) 61000(状态库存开)
    • └ add_bed
    • Number
    • 1
    • 额外服务-是否可以加床,1:不可以,2:可以
    • └ add_bed_price
    • Number
    • 222
    • 额外服务-加床价格
    • └ currency_code
    • Number
    • 123456
    • 币种(仅支持CNY)
    • └ shijia_tag
    • Number
    • 1
    • 实价有房标签(RP支付类型为全额支付)
    • └ jishiqueren_tag
    • Number
    • 1
    • 即时确认状态,表示此rate预订后是否可以直接发货。可取范围:0,1。可以为空
    • └ created_time
    • Date
    • 2000-01-01 00:00:00
    • 创建时间
    • └ modified_time
    • Date
    • 2000-01-01 00:00:00
    • 修改时间
    • └ use_room_inventory
    • Boolean
    • false
    • 是否使用RoomInventory库存 仅当Rate上使用时有意义
    • └ inv_price_with_switch
    • String
    • [ { "alQuota": 43, "date": "2017-07-22", "price": 1200, "genAlQuota":31, "quota": 12, "rateSwitch": false }, { "alQuota": 43, "date": "2017-07-23", "price": 1200, "quota": 12, "genAlQuota":11, "rateSwitch": false } ]
    • 结构化的库存和开关, date 日期 price 价格 int 类型, 取值范围1-99999999 单位为分 quota 普通库存 int 类型 取值范围 0-999(数量库存) 60000(状态库存关) 61000(状态库存开) alQuota 协议保留房库存 int 类型 取值范围 0-999(数量库存) 60000(状态库存关) 61000(状态库存开) genAlQuota 普通保留房库存, int 类型 取值范围 0-999(数量库存) 60000(状态库存关) 61000(状态库存开) rateSwitch date日期的价格开关, 值为true时,表示当天价格开, false表示价格关
    • └ tag_json
    • String
    • {"ebk-tail-room-Rate":1}
    • rate 维度下特殊标签含义 json: {"ebk-tail-room-Rate":1}, key:ebk-tail-room-Rate 表示rate维度ebk尾房标

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    XhotelRateGetRequest req = new XhotelRateGetRequest();
    req.setGid(100000L);
    req.setRpid(100000L);
    req.setVendor("ChinaOnline");
    req.setRateplanCode("12345AAA");
    req.setOutRid("12345AAA");
    req.setRateId(112221L);
    XhotelRateGetResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <xhotel_rate_get_response>
        <rate>
            <gid>123456</gid>
            <rpid>123456</rpid>
            <name>aaa</name>
            <inventory_price>{&quot;use_room_inventory&quot;:false,inventory_price:[{&quot;date&quot;:2014-01-28,&quot;quota&quot;:10,&quot;price&quot;:100},{&quot;date&quot;:2014-01-29,&quot;quota&quot;:10,&quot;price&quot;:200}]}</inventory_price>
            <add_bed>1</add_bed>
            <add_bed_price>222</add_bed_price>
            <currency_code>123456</currency_code>
            <shijia_tag>1</shijia_tag>
            <jishiqueren_tag>1</jishiqueren_tag>
            <created_time>2000-01-01 00:00:00</created_time>
            <modified_time>2000-01-01 00:00:00</modified_time>
            <use_room_inventory>false</use_room_inventory>
            <inv_price_with_switch>[   {     &quot;alQuota&quot;: 43,     &quot;date&quot;: &quot;2017-07-22&quot;,     &quot;price&quot;: 1200,     &quot;genAlQuota&quot;:31,     &quot;quota&quot;: 12,     &quot;rateSwitch&quot;: false   },   {     &quot;alQuota&quot;: 43,     &quot;date&quot;: &quot;2017-07-23&quot;,     &quot;price&quot;: 1200,     &quot;quota&quot;: 12,     &quot;genAlQuota&quot;:11,     &quot;rateSwitch&quot;: false   } ]</inv_price_with_switch>
            <tag_json>{&quot;ebk-tail-room-Rate&quot;:1}</tag_json>
        </rate>
    </xhotel_rate_get_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 转换对象时出错 请检查输入参数

    API工具

    如何获得此API

    FAQ

    返回
    顶部