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

taobao.xhotel.rate.add (新增专享房价)

酒店产品库rate添加

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
gid Number 可选 100000 gid酒店商品id
rpid Number 可选 100000 酒店RPID
vendor String 可选 ChinaOnline
  • 最大长度:50
  • 用于标示该宝贝的售卖渠道信息,允许同一个卖家酒店房型在淘宝系统发布多个售卖渠道的宝贝的价格。
    rateplan_code String 可选 12345AAA
  • 最大长度:64
  • 卖家自己系统的Code,简称RateCode
    out_rid String 可选 abc123
  • 最大长度:64
  • 卖家房型ID, 这是卖家自己系统中的房型ID,注意:需按照规则组合
    rate_switch_cal String 可选 [{"date":"yyyy-MM-dd","rate_status":1},{"date":"yyyy-MM-dd","rate_status":0}] 在添加新rate时,同时添加rate开关日历。可以只设定想设定的某些天,可以不连续。date:开关状态控制的是那一天rate_status:开关状态。0,关闭;1,打开
    name String 可选 aaa
  • 最大长度:60
  • 名称
    inventory_price String 必须 {"use_room_inventory":false,"inventory_price":[{"date":"2017-10-10","quota":10,"price":100,"alQuota":10,"genAlQuota":10},{"date":"2017-10-11","quota":10,"price":200},{"date":"2017-10-13","quota":10,"price":300,"alQuota":10,"genAlQuota":10}]} 价格和库存信息。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 可选 1 额外服务-加床价格
    currency_code Number 可选 1 币种(仅支持CNY)
    shijia_tag Number 可选 1 实价有房标签(RP支付类型为全额支付)
    jishiqueren_tag Number 可选 1 “即时确认”标识,此类商品预订后直接发货。
    lock_end_time String 可选 2016-07-15 00:00:00 锁库存截止时间,如果当前时间是在锁库存开始时间和截止时间之间,那么不允许修改该活动库存(包含开始时间和截止时间)
    lock_start_time String 可选 2016-07-15 00:00:00 锁库存开始时间,如果当前时间是在锁库存开始时间和截止时间之间,那么不允许修改该活动库存(包含开始时间和截止时间)
    currency_code_name String 可选 CNY 币种信息,默认是CNY, @see com.taobao.trip.hotel.model.enums.CurrencyEnum
    operator String 可选 XXX小二 操作人信息
    source Number 可选 2 默认是2 ,
    status Number 可选 1 1是开,0是关, 不填默认是开, rate状态
    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
    results String [] 112-34,rateId#14555 results
    warn_message String warnMessage warnMessage

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    XhotelRateAddRequest req = new XhotelRateAddRequest();
    req.setGid(100000L);
    req.setRpid(100000L);
    req.setVendor("ChinaOnline");
    req.setRateplanCode("12345AAA");
    req.setOutRid("abc123");
    req.setRateSwitchCal("[{\"date\":\"yyyy-MM-dd\",\"rate_status\":1},{\"date\":\"yyyy-MM-dd\",\"rate_status\":0}]");
    req.setName("aaa");
    req.setInventoryPrice("{\"use_room_inventory\":false,\"inventory_price\":[{\"date\":\"2017-10-10\",\"quota\":10,\"price\":100,\"alQuota\":10,\"genAlQuota\":10},{\"date\":\"2017-10-11\",\"quota\":10,\"price\":200},{\"date\":\"2017-10-13\",\"quota\":10,\"price\":300,\"alQuota\":10,\"genAlQuota\":10}]}");
    req.setAddBed(1L);
    req.setAddBedPrice(1L);
    req.setCurrencyCode(1L);
    req.setShijiaTag(1L);
    req.setJishiquerenTag(1L);
    req.setLockEndTime("2016-07-15 00:00:00");
    req.setLockStartTime("2016-07-15 00:00:00");
    req.setCurrencyCodeName("CNY");
    req.setOperator("XXX小二");
    req.setSource(2L);
    req.setStatus(1L);
    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\":\"\"}]");
    XhotelRateAddResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <xhotel_rate_add_response>
        <gid_and_rpid>aaaaa</gid_and_rpid>
        <results>
            <string>112-34</string>
            <string>rateId#14555</string>
        </results>
        <warn_message>warnMessage</warn_message>
    </xhotel_rate_add_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:RATEPLAN_TYPE_NOT_EXIST RP不存在 发布RP
    isv.room-error:ROOM_NOT_EXIST 房型不存在 房型不存在,请检查房型参数
    isp.service-unavailable 服务不可用 服务不可用

    API工具

    如何获得此API

    FAQ

    返回
    顶部