淘宝开放平台 - 文档中心

请求地址：

环境	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。

名称	类型	是否必须	示例值	更多限制	描述
item_id	Number	可选	123		商品id。itemId和outProductId至少填写一个
skus	PontusTravelItemSkuInfo []	必须		最大列表长度：20	商品日历价格库存套餐
└ outer_sku_id String 必须 1111 必填，外部商家映射到具体套餐的SKU ID，一般为外部商家具体商品ID。 └ package_desc String 可选套餐描述套餐描述 └ package_name String 可选套餐名称套餐名称，特别说明：出境邮轮请按照发布后台规范传递套餐名称，会自动解析容纳人数与房型 prices PontusTravelPrices [] 可选商品日历价格库存相关信息 └ date Date 可选 2015-09-19 09:42:24 日期。对于普通商品必填，对于预约商品该字段不填 └ outer_price_id String 可选 123455 （该参数已废弃）外部商家团期ID └ price Number 可选 1234 价格，以分为单位 └ price_type Number 必须 1 价格类型。price_type 取：1-成人价，2-儿童价，3-单房差 └ stock Number 可选 123 库存 products Product [] 可选套餐关联的产品元素列表。以列表中第一个产品元素作为主元素，其他元素作为该套餐的搭配元素。注：新增一个套餐时该参数必填；如果只是要覆盖修改一个已存在套餐的价格库存，则该参数可不填，系统会根据outer_sku_id自动填充该套餐已绑定的产品元素。 └ element_id String 可选 12345 关联的元素。以元素的外部商家编码作为元素标示。不传该值则该Product将被自动忽略 └ num Number 可选 2 绑定销售的元素份数。不传该值则默认设置1份 └ room_type_id Number 可选 15 邮轮房型ID，新版本有值 └ room_type Number 可选 1 邮轮房型类型 └ room_type_name String 可选大床房邮轮房型名称 └ people_number Number 可选 10 人数 └ order_count_match Boolean 可选 false 下单人数是否与房型人数一致
out_product_id	String	可选	111		商品外部商家编码。itemId和outProductId至少填写一个

名称	类型	示例值	描述
travel_item	TopTravelItem		商品sku修改结果
└ created Date 2015-9-07 22:56:18 商品创建时间 └ item_id Number 123 商品id └ modified Date 2015-09-07 22:56:18 商品修改时间

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripTravelItemSkuOverrideRequest req = new AlitripTravelItemSkuOverrideRequest();
req.setItemId(123L);
List<AlitripTravelItemSkuOverrideRequest.PontusTravelItemSkuInfo> list2 = new ArrayList<AlitripTravelItemSkuOverrideRequest.PontusTravelItemSkuInfo>();
AlitripTravelItemSkuOverrideRequest.PontusTravelItemSkuInfo obj3 = new AlitripTravelItemSkuOverrideRequest.PontusTravelItemSkuInfo();
list2.add(obj3);
obj3.setOuterSkuId("1111");
obj3.setPackageDesc("套餐描述");
obj3.setPackageName("套餐名称");
List<AlitripTravelItemSkuOverrideRequest.PontusTravelPrices> list6 = new ArrayList<AlitripTravelItemSkuOverrideRequest.PontusTravelPrices>();
AlitripTravelItemSkuOverrideRequest.PontusTravelPrices obj7 = new AlitripTravelItemSkuOverrideRequest.PontusTravelPrices();
list6.add(obj7);
obj7.setDate(StringUtils.parseDateTime("2015-09-19 09:42:24"));
obj7.setOuterPriceId("123455");
obj7.setPrice(1234L);
obj7.setPriceType(1L);
obj7.setStock(123L);
list4.setPrices(list6);
List<AlitripTravelItemSkuOverrideRequest.Product> list10 = new ArrayList<AlitripTravelItemSkuOverrideRequest.Product>();
AlitripTravelItemSkuOverrideRequest.Product obj11 = new AlitripTravelItemSkuOverrideRequest.Product();
list10.add(obj11);
obj11.setElementId("12345");
obj11.setNum(2L);
list8.setProducts(list10);
obj3.setRoomTypeId(15L);
obj3.setRoomType(1L);
obj3.setRoomTypeName("大床房");
obj3.setPeopleNumber(10L);
obj3.setOrderCountMatch(false);
req.setSkus(list2);
req.setOutProductId("111");
AlitripTravelItemSkuOverrideResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlitripTravelItemSkuOverrideRequest req = new AlitripTravelItemSkuOverrideRequest();
req.ItemId = 123L;
List<AlitripTravelItemSkuOverrideRequest.PontusTravelItemSkuInfoDomain> list2 = new List<AlitripTravelItemSkuOverrideRequest.PontusTravelItemSkuInfoDomain>();
AlitripTravelItemSkuOverrideRequest.PontusTravelItemSkuInfoDomain obj3 = new AlitripTravelItemSkuOverrideRequest.PontusTravelItemSkuInfoDomain();
list2.Add(obj3);
obj3.OuterSkuId = "1111";
obj3.PackageDesc = "套餐描述";
obj3.PackageName = "套餐名称";
List<AlitripTravelItemSkuOverrideRequest.PontusTravelPricesDomain> list5 = new List<AlitripTravelItemSkuOverrideRequest.PontusTravelPricesDomain>();
AlitripTravelItemSkuOverrideRequest.PontusTravelPricesDomain obj6 = new AlitripTravelItemSkuOverrideRequest.PontusTravelPricesDomain();
list5.Add(obj6);
obj6.Date = DateTime.Parse(2015-09-19 09:42:24");
obj6.OuterPriceId = "123455";
obj6.Price = 1234L;
obj6.PriceType = 1L;
obj6.Stock = 123L;
obj3.Prices= list5;
List<AlitripTravelItemSkuOverrideRequest.ProductDomain> list8 = new List<AlitripTravelItemSkuOverrideRequest.ProductDomain>();
AlitripTravelItemSkuOverrideRequest.ProductDomain obj9 = new AlitripTravelItemSkuOverrideRequest.ProductDomain();
list8.Add(obj9);
obj9.ElementId = "12345";
obj9.Num = 2L;
obj3.Products= list8;
obj3.RoomTypeId = 15L;
obj3.RoomType = 1L;
obj3.RoomTypeName = "大床房";
obj3.PeopleNumber = 10L;
obj3.OrderCountMatch = false;
req.Skus_ = list2;
req.OutProductId = "111";
AlitripTravelItemSkuOverrideResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlitripTravelItemSkuOverrideRequest;
$req->setItemId("123");
$skus = new PontusTravelItemSkuInfo;
$skus->outer_sku_id="1111";
$skus->package_desc="套餐描述";
$skus->package_name="套餐名称";
$prices = new PontusTravelPrices;
$prices->date="2015-09-19 09:42:24";
$prices->outer_price_id="123455";
$prices->price="1234";
$prices->price_type="1";
$prices->stock="123";
$skus->prices = $prices;
$products = new Product;
$products->element_id="12345";
$products->num="2";
$skus->products = $products;
$skus->room_type_id="15";
$skus->room_type="1";
$skus->room_type_name="大床房";
$skus->people_number="10";
$skus->order_count_match="false";
$req->setSkus(json_encode($skus));
$req->setOutProductId("111");
$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.alitrip.travel.item.sku.override' \
-d 'partner_id=apidoc' \
-d 'session=fbc010e1-553a-4677-a1d3-ae4d3279e7a4' \
-d 'sign=4EFF7948573F45BBE713889859C0E77F' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-12-15+05%3A59%3A43' \
-d 'v=2.0' \
-d 'item_id=123' \
-d 'out_product_id=111' \
-d 'skus=null'

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

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

req.item_id=123
req.skus=""
req.out_product_id="111"
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.alitrip.travel.item.sku.override");
add_param(pRequest,"item_id","123");
add_param(pRequest,"skus","数据结构JSON示例");
add_param(pRequest,"out_product_id","111");
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.alitrip.travel.item.sku.override', {
	'item_id':'123',
	'skus':'数据结构JSON示例',
	'out_product_id':'111'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alitrip_travel_item_sku_override_response>
    <travel_item>
        <created>2015-9-07 22:56:18</created>
        <item_id>123</item_id>
        <modified>2015-09-07 22:56:18</modified>
    </travel_item>
</alitrip_travel_item_sku_override_response>

{
    "alitrip_travel_item_sku_override_response":{
        "travel_item":{
            "created":"2015-9-07 22:56:18",
            "item_id":123,
            "modified":"2015-09-07 22:56:18"
        }
    }
}

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"
	}
}

错误码	错误描述	解决方案
isp.remote-service-error	系统错误	联系服务提供方
isv.invalid-parameter:NOTNULL	参数不能为空	调用方排查
isv.invalid-parameter:ERROR	参数不正确	调用方排查
isv.biz-error:ITEM_NOT_FOUNT	商品未找到	调用方确认商品是否已经删除
isv.invalid-parameter:product	套餐下的元素资源不能为空	请添加元素资源product
isv.invalid-parameter:LENGTH_OVERRANGE	长度超过限制	请根据错误提示修改
isv.invalid-parameter:WORD_OVERRANGE	商品标题不能超过30个字	请修改商品标题
isv.IC_PERMISSION_FOR_JU_LIMIT_1	a	a
isv.IC_ITEM_DESC_COULD_NOT_BE_EMPTY	宝贝描述不能为空	请添加商品描述
isv.CALINPRI_EMPTY	套餐的日历价格库存不能为空	调用方排查
isv.remote-service-error	远程服务失败	远程服务失败，重试解决
isv.invalid-parameter:title\|invalid-parameter:product	套餐下的元素资源不能为空	请添加元素资源product
isv.biz-error:KFC_FORBIDEN_WORDS	包含违禁词	根据错误提示修改
isv.IC_DB_ACCESS_ERRORGENERIC_FAILURE	访问数据库失败	稍后重试
isv.IC_CATEGORY_NOT_GRANT_FOR_B	未授权发布此类目的商品	请先开通类目发布权限
isv.IC_DB_ACCESS_ERRORGENERIC_FAILUREIC_OPTIMISTIC_LOCKING_CONFLICT	访问太频繁，请求被限制	降低访问频次
isv.rights-invalid:PUBLISH_NOT_PERMIT	没有发布权限	根据错误提示修改
isv.COMBO_NAME_TO_LONG	套餐的名称过长，最多可设置20个字符	请修改套餐名称的长度
isv.category-invalid:CATEGORY_ERROR	不支持该类目	不支持该类目
isv.2091216302	a	a
isv.IC_SAVE_INVENTORY_TO_IP_FAILED	系统错误	请重试
isv.653302572	a	a
isv.invalid-parameter:title	标题设置不合规范	请根据错误提示修改
isv.invalid-parameter:PARAM_ERROR	参数错误	请根据错误提示修改
isv.系统错误	系统错误	稍后重试
isv.IC_CHECKSTEP_INPUT_PROPERTY_ERROR	a	a
isv.biz-error:	业务逻辑错误（如同一票种下日期区间重叠或收费项目下已存在商品）	请根据具体的业务错误描述修改
isv.RANGE_ERROR	套餐的价格日历不能定义从当前日期起300天之后的日期	修改套餐的价格日历
isv.调用商品中心接口出错	a	a
isv.FORBIDDEN_QUANTITY_ZERO_ERROR	所有的库存都为0	请设置有效的库存
isv.biz-error:COMBO_COUNT_OVERRANGE	a	a
isv.IPM_OPERATION_SUCCESS	数据保存出现问题	系统错误，请稍后再试
isv.GENERIC_FAILUREIC_DB_ACCESS_ERROR	DB访问失败	稍后重试
isv.RULE_ERR_TRIP_HUODONG_93058_SKU_QUANTITY_LOCK	该商品参加了活动，库存只能增加，不能减少;不能删除或增加商品sku;不能修改价格	活动规则限制
isv.IP_TRADE_INVENTORY_MODIFY_ERROR	修改库存失败	请稍后重试
isv.ACROSS_ERROR	套餐的价格日历跨度不能超过179天	请修改套餐价格日历的开始和结束日期
isv.IC_CHECKSTEP_SKU_PRICE_ERROR	宝贝销售价格不能为0	请修改商品价格
isv.QUERY_USER_INFO_ERROR	系统错误，获取用户数据失败	请重试
isv.IC_INTERFACE_QPS_LIMIT	系统错误，IC接口限流	请重试
isv.QUERY_ITEM_ERROR	商品查询失败	https://sell.fliggy.com/icenter/errorcode/ErrorCodeSolution.htm?code=QUERY_ITEM_ERROR&owner=1
isv.invalid-parameter:personTemplateId	出行人模板查询错误	根据错误提示修改
isv.UN_SUPPORT_OPERATION	不支持通过api接口修改	请通过sell后台修改
isv.PARAM_EXCEPTION	参数异常	请根据错误提示修改
isv.DATE_DUPLICATE	日期重复	删除重复日期
isp.SYS_EXCEPTION	系统异常	稍后重试
isv.GENERIC_FAILUREIC_DB_ACCESS_ERRORIC_OPTIMISTIC_LOCKING_CONFLICT	访问太频繁	降低访问频率
isv.location_parameter-error	目的地属性填写错误	https://sell.fliggy.com/icenter/errorcode/ErrorCodeSolution.htm?code=location_parameter-error&owner=1
isv.isv.invalid-parameter:ERROR	参数异常	请根据错误提示修改
isv.old_sq_not_match	数据不一致	请根据错误提示修改
isv.invalid-parameter:subtitle	副标题异常	根据错误提示修改

API测试工具错误码查询工具 SDK下载

开放平台

度假-商品管理API

taobao.alitrip.travel.item.sku.override (【API3.0】商品级别日历价格库存修改，全量覆盖)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ