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

taobao.xhotel.multiplerate.get (复杂房价查询接口)

查询复杂房价,支持通过入住人数,连住天数,商品信息,房价信息查询

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
nod Number 可选 1 连住天数(范围1~10)
nop Number 可选 1 入住人数(范围1~10)
rate_plan_code String 特殊可选 123 卖家的房价code
rate_plan_id Number 特殊可选 1000 废弃,使用rate_plan_code
out_rid String 特殊可选 1234 卖家的房型code
gid Number 特殊可选 1000 废弃,使用out_rid
vendor String 可选 taobao 系统商,一般不填写,使用须申请

响应参数

名称 类型 示例值 描述
rates MultipleRate [] 复杂价格返回结果类
  • └ occupancy
  • Number
  • 1
  • 入住人数
  • └ lengthofstay
  • Number
  • 1
  • 连住天数
  • └ gid
  • Number
  • 123456
  • 酒店商品id
  • └ rpid
  • Number
  • 123456
  • 房价id
  • └ name
  • String
  • aaa
  • 名称
  • └ currency_code
  • Number
  • 123456
  • 币种
  • └ created_time
  • Date
  • 2000-01-01 00:00:00
  • 创建时间
  • └ modified_time
  • Date
  • 2000-01-01 00:00:00
  • 修改时间
  • └ inventory_price
  • String
  • {"use_room_inventory":false,"inventory_price":[{"date":2015-06-28,"quota":10,"price":100,"tax":100,"addBed":1200,"addPerson":2000},{"date":2015-06-29,"quota":10,"price":200,"tax":100,"addBed":1200,"addPerson":2000}]}
  • 价格和库存信息,包括加床价,加人价等信息。date 日期必须为 T---T+90 日内的日期(T为当天),且不能重复price 价格 int类型 取值范围1-99999999 单位为分quota 库存 int 类型 取值范围 0-999(数量库存) 60000(状态库存关) 61000(状态库存开)addPerson 加人价addBed 加床价

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
XhotelMultiplerateGetRequest req = new XhotelMultiplerateGetRequest();
req.setNod(1L);
req.setNop(1L);
req.setRatePlanCode("123");
req.setRatePlanId(1000L);
req.setOutRid("1234");
req.setGid(1000L);
req.setVendor("taobao");
XhotelMultiplerateGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<xhotel_multiplerate_get_response>
    <rates>
        <multiple_rate>
            <occupancy>1</occupancy>
            <lengthofstay>1</lengthofstay>
            <gid>123456</gid>
            <rpid>123456</rpid>
            <name>aaa</name>
            <currency_code>123456</currency_code>
            <created_time>2000-01-01 00:00:00</created_time>
            <modified_time>2000-01-01 00:00:00</modified_time>
            <inventory_price>{&quot;use_room_inventory&quot;:false,&quot;inventory_price&quot;:[{&quot;date&quot;:2015-06-28,&quot;quota&quot;:10,&quot;price&quot;:100,&quot;tax&quot;:100,&quot;addBed&quot;:1200,&quot;addPerson&quot;:2000},{&quot;date&quot;:2015-06-29,&quot;quota&quot;:10,&quot;price&quot;:200,&quot;tax&quot;:100,&quot;addBed&quot;:1200,&quot;addPerson&quot;:2000}]}</inventory_price>
        </multiple_rate>
    </rates>
</xhotel_multiplerate_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.biz-error: RATEPLAN_NOT_EXIST_ERROR 定价信息关联的房价不存在 请检查输入参数
isv.biz-error:BIZ_ERROR 业务异常 请稍后重试
isv.remote-service:CONVERT_ERROR 转换对象时出错 请检查输入参数
isp.session-not-exist session信息不存在 session信息不存在,请检查确保输入正确的session信息
isv.invalid-parameter: RATE_NOT_EXIST_ERROR 获取复杂房价-指定的复杂房价Rates信息不存在 获取复杂房价-指定的复杂房价Rates信息不存在,请确认输入参数

API工具

如何获得此API

FAQ

返回
顶部