淘宝开放平台 - 文档中心

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

名称	类型	是否必须	示例值	更多限制	描述
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());

ITopClient client = new DefaultTopClient(url, appkey, secret);
XhotelRateUpdateRequest req = new XhotelRateUpdateRequest();
req.Gid = 100000L;
req.Rpid = 100000L;
req.Name = "aaa";
req.InventoryPrice = "{\"use_room_inventory\":false,\"inventory_price\":[{\"date\":2014-01-28,\"quota\":10,\"price\":100},{\"date\":2014-01-29,\"quota\":10,\"price\":200}]}";
req.AddBed = 1L;
req.AddBedPrice = 1L;
req.CurrencyCode = 1L;
req.ShijiaTag = 1L;
req.JishiquerenTag = 1L;
req.Vendor = "taobao";
req.RateplanCode = "12345AAA";
req.OutRid = "12345AAA";
req.RateSwitchCal = "[{\"date\":\"yyyy-MM-dd\",\"rate_status\":1},{\"date\":\"yyyy-MM-dd\",\"rate_status\":0}]";
req.LockEndTime = "2016-07-15 00:00:00";
req.LockStartTime = "2016-07-16 00:00:00";
req.OnlineBookingBindingInfo = "[{\"itemId\":1234235235,\"skuId\":1234235235,\"priceRuleInfoList\":[{\"priceRuleNumber\":\"14235253\"},{\"priceRuleNumber\":\"14235253\"},{\"priceRuleNumber\":\"14235253\"}]},{\"itemId\":1234235235,\"skuId\":1234235235,\"priceRuleInfoList\":[{\"priceRuleNumber\":\"14235253\"},{\"priceRuleNumber\":\"14235253\"},{\"priceRuleNumber\":\"14235253\"}]}]";
req.HotelXitemInfos = "[{\\"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);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new XhotelRateUpdateRequest;
$req->setGid("100000");
$req->setRpid("100000");
$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("1");
$req->setAddBedPrice("1");
$req->setCurrencyCode("1");
$req->setShijiaTag("1");
$req->setJishiquerenTag("1");
$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\\":\\"\\"}]");
$resp = $c->execute($req, $sessionKey);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=taobao.xhotel.rate.update' \
-d 'partner_id=apidoc' \
-d 'session=6d32b1fa-c14f-43ec-bf93-6a9aa877d025' \
-d 'sign=29799A907518CDC6441864F0BE150247' \
-d 'sign_method=hmac' \
-d 'timestamp=2024-12-26+19%3A08%3A37' \
-d 'v=2.0' \
-d 'add_bed=1' \
-d 'add_bed_price=1' \
-d 'currency_code=1' \
-d 'gid=100000' \
-d 'hotel_xitem_infos=%7B%5C%22actionType%5C%22%3A%5C%22BOUND%5C%22%2C%5C%22outXcode%5C%22%3A%5C%22123456%5C%22%2C%5C%22subTypeCode%5C%22%3A%5C%2240000_105%5C%22%2C%5C%22shortName%5C%22%3A%5C%22%E5%BB%B6%E6%97%B614%E7%82%B9%E9%80%80%E6%88%BF%5C%22%2C%5C%22time%5C%22%3A%5C%2200%3A00-23%3A59%5C%22%2C%5C%22value%5C%22%3A1200%2C%5C%22itemDesc%5C%22%3A%5C%22%E5%8F%AF%E5%BB%B6%E6%97%B6%E5%88%B014%E7%82%B9%E9%80%80%E6%88%BF%5C%22%2C%5C%22dimensionType%5C%22%3A1%2C%5C%22picList%5C%22%3A%5B%5D%2C%5C%22adultCount%5C%22%3A1%2C%5C%22childCount%5C%22%3A1%2C%5C%22itemLimit%5C%22%3A%5C%22%5C%22%2C%5C%22checkInStart%5C%22%3A%5C%222023-07-13+00%3A00%3A01%5C%22%2C%5C%22checkInEnd%5C%22%3A%5C%222023-07-13+00%3A00%3A01%5C%22%2C%5C%22bookStartTime%5C%22%3A%5C%222023-07-13+00%3A00%3A01%5C%22%2C%5C%22bookStartEnd%5C%22%3A%5C%222023-07-13+00%3A00%3A01%5C%22%2C%5C%22featureDetail%5C%22%3A%5C%22%5C%22%7D' \
-d 'inventory_price=%7B%5C%22use_room_inventory%5C%22%3Afalse%2C%5C%22inventory_price%5C%22%3A%5B%7B%5C%22date%5C%22%3A2014-01-28%2C%5C%22quota%5C%22%3A10%2C%5C%22price%5C%22%3A100%7D%2C%7B%5C%22date%5C%22%3A2014-01-29%2C%5C%22quota%5C%22%3A10%2C%5C%22price%5C%22%3A200%7D%5D%7D' \
-d 'jishiqueren_tag=1' \
-d 'lock_end_time=2016-07-15+00%3A00%3A00' \
-d 'lock_start_time=2016-07-16+00%3A00%3A00' \
-d 'name=aaa' \
-d 'online_booking_binding_info=%7B%22itemId%22%3A1234235235%2C%22skuId%22%3A1234235235%2C%22priceRuleInfoList%22%3A%5B%7B%22priceRuleNumber%22%3A%2214235253%22%7D%2C%7B%22priceRuleNumber%22%3A%2214235253%22%7D%2C%7B%22priceRuleNumber%22%3A%2214235253%22%7D%5D%7D%2C%7B%22itemId%22%3A1234235235%2C%22skuId%22%3A1234235235%2C%22priceRuleInfoList%22%3A%5B%7B%22priceRuleNumber%22%3A%2214235253%22%7D%2C%7B%22priceRuleNumber%22%3A%2214235253%22%7D%2C%7B%22priceRuleNumber%22%3A%2214235253%22%7D%5D%7D' \
-d 'out_rid=12345AAA' \
-d 'rate_switch_cal=%7B%22date%22%3A%22yyyy-MM-dd%22%2C%22rate_status%22%3A1%7D%2C%7B%22date%22%3A%22yyyy-MM-dd%22%2C%22rate_status%22%3A0%7D' \
-d 'rateplan_code=12345AAA' \
-d 'rpid=100000' \
-d 'shijia_tag=1' \
-d 'vendor=taobao'

# -*- coding: utf-8 -*-
import top.api

req=top.api.XhotelRateUpdateRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.gid=100000
req.rpid=100000
req.name="aaa"
req.inventory_price="{\"use_room_inventory\":false,\"inventory_price\":[{\"date\":2014-01-28,\"quota\":10,\"price\":100},{\"date\":2014-01-29,\"quota\":10,\"price\":200}]}"
req.add_bed=1
req.add_bed_price=1
req.currency_code=1
req.shijia_tag=1
req.jishiqueren_tag=1
req.vendor="taobao"
req.rateplan_code="12345AAA"
req.out_rid="12345AAA"
req.rate_switch_cal="[{\"date\":\"yyyy-MM-dd\",\"rate_status\":1},{\"date\":\"yyyy-MM-dd\",\"rate_status\":0}]"
req.lock_end_time="2016-07-15 00:00:00"
req.lock_start_time="2016-07-16 00:00:00"
req.online_booking_binding_info="[{\"itemId\":1234235235,\"skuId\":1234235235,\"priceRuleInfoList\":[{\"priceRuleNumber\":\"14235253\"},{\"priceRuleNumber\":\"14235253\"},{\"priceRuleNumber\":\"14235253\"}]},{\"itemId\":1234235235,\"skuId\":1234235235,\"priceRuleInfoList\":[{\"priceRuleNumber\":\"14235253\"},{\"priceRuleNumber\":\"14235253\"},{\"priceRuleNumber\":\"14235253\"}]}]"
req.hotel_xitem_infos="[{\\"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\\":\\"\\"}]"
try:
	resp= req.getResponse(sessionkey)
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"taobao.xhotel.rate.update");
add_param(pRequest,"gid","100000");
add_param(pRequest,"rpid","100000");
add_param(pRequest,"name","aaa");
add_param(pRequest,"inventory_price","{\"use_room_inventory\":false,\"inventory_price\":[{\"date\":2014-01-28,\"quota\":10,\"price\":100},{\"date\":2014-01-29,\"quota\":10,\"price\":200}]}");
add_param(pRequest,"add_bed","1");
add_param(pRequest,"add_bed_price","1");
add_param(pRequest,"currency_code","1");
add_param(pRequest,"shijia_tag","1");
add_param(pRequest,"jishiqueren_tag","1");
add_param(pRequest,"vendor","taobao");
add_param(pRequest,"rateplan_code","12345AAA");
add_param(pRequest,"out_rid","12345AAA");
add_param(pRequest,"rate_switch_cal","{"date":"yyyy-MM-dd","rate_status":1},{"date":"yyyy-MM-dd","rate_status":0}");
add_param(pRequest,"lock_end_time","2016-07-15 00:00:00");
add_param(pRequest,"lock_start_time","2016-07-16 00:00:00");
add_param(pRequest,"online_booking_binding_info","{"itemId":1234235235,"skuId":1234235235,"priceRuleInfoList":[{"priceRuleNumber":"14235253"},{"priceRuleNumber":"14235253"},{"priceRuleNumber":"14235253"}]},{"itemId":1234235235,"skuId":1234235235,"priceRuleInfoList":[{"priceRuleNumber":"14235253"},{"priceRuleNumber":"14235253"},{"priceRuleNumber":"14235253"}]}");
add_param(pRequest,"hotel_xitem_infos","{\"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\":\"\"}");
pResponse = top_execute(pClient,pRequest,sessionKey);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('taobao.xhotel.rate.update', {
	'gid':'100000',
	'rpid':'100000',
	'name':'aaa',
	'inventory_price':'{\"use_room_inventory\":false,\"inventory_price\":[{\"date\":2014-01-28,\"quota\":10,\"price\":100},{\"date\":2014-01-29,\"quota\":10,\"price\":200}]}',
	'add_bed':'1',
	'add_bed_price':'1',
	'currency_code':'1',
	'shijia_tag':'1',
	'jishiqueren_tag':'1',
	'vendor':'taobao',
	'rateplan_code':'12345AAA',
	'out_rid':'12345AAA',
	'rate_switch_cal':'{"date":"yyyy-MM-dd","rate_status":1},{"date":"yyyy-MM-dd","rate_status":0}',
	'lock_end_time':'2016-07-15 00:00:00',
	'lock_start_time':'2016-07-16 00:00:00',
	'online_booking_binding_info':'{"itemId":1234235235,"skuId":1234235235,"priceRuleInfoList":[{"priceRuleNumber":"14235253"},{"priceRuleNumber":"14235253"},{"priceRuleNumber":"14235253"}]},{"itemId":1234235235,"skuId":1234235235,"priceRuleInfoList":[{"priceRuleNumber":"14235253"},{"priceRuleNumber":"14235253"},{"priceRuleNumber":"14235253"}]}',
	'hotel_xitem_infos':'{\"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\":\"\"}'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<xhotel_rate_update_response>
    <gid_and_rpid>aaaaa</gid_and_rpid>
</xhotel_rate_update_response>

{
    "xhotel_rate_update_response":{
        "gid_and_rpid":"aaaaa"
    }
}

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>

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码	错误描述	解决方案
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测试工具错误码查询工具 SDK下载

taobao.xhotel.rate.update更新失败

开放平台

酒店API（新）

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

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ