淘宝开放平台 - 文档中心

请求地址：

环境	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	可选	12345		商品id。itemId和outProductId至少填写一个
skus	ItemSkuInfo []	必须		最大列表长度：20	商品日历价格库存套餐
└ outer_sku_id String 必须 123456 必填，外部商家映射到具体套餐的SKU ID，一般为外部商家具体商品ID。 └ package_desc String 可选套餐描述套餐描述 └ package_name String 可选套餐名称套餐名称，特别说明：出境邮轮请按照发布后台规范传递套餐名称，会自动解析容纳人数与房型 └ package_operation Number 必须 1 必填，套餐操作：1-增加一个套餐，2-删除一个套餐（根据outer_sku_id定位该套餐），3-覆盖修改一个套餐（根据outer_sku_id定位该套餐） prices Prices [] 可选商品日历价格库存相关信息 └ date Date 可选 2016-03-19 00:00:00 日期。对于普通商品必填，对于预约商品该字段不填 └ outer_price_id String 可选 23333 （该参数已废弃）外部商家团期ID └ price Number 可选 1223 价格 └ price_type Number 可选 1 价格类型。新增或修改套餐时必填。price_type 取：1-成人价，2-儿童价，3-单房差 └ stock Number 可选 12 库存 products Product [] 可选套餐关联的产品元素列表。以列表中第一个产品元素作为主元素，其他元素作为该套餐的搭配元素。注：新增一个套餐时该参数必填；如果只是要覆盖修改一个已存在套餐的价格库存，则该参数可不填，系统会根据outer_sku_id自动填充该套餐已绑定的产品元素。 └ element_id String 可选 12345 关联的元素。以元素的外部商家编码作为元素标示。不传该值则该Product将被自动忽略 └ num Number 可选 2 绑定销售的元素份数。不传该值则默认设置1份
out_product_id	String	可选	111		商品外部商家编码。itemId和outProductId至少填写一个

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

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripTravelItemSkuPackageModifyRequest req = new AlitripTravelItemSkuPackageModifyRequest();
req.setItemId(12345L);
List<AlitripTravelItemSkuPackageModifyRequest.ItemSkuInfo> list2 = new ArrayList<AlitripTravelItemSkuPackageModifyRequest.ItemSkuInfo>();
AlitripTravelItemSkuPackageModifyRequest.ItemSkuInfo obj3 = new AlitripTravelItemSkuPackageModifyRequest.ItemSkuInfo();
list2.add(obj3);
obj3.setOuterSkuId("123456");
obj3.setPackageDesc("套餐描述");
obj3.setPackageName("套餐名称");
obj3.setPackageOperation(1L);
List<AlitripTravelItemSkuPackageModifyRequest.Prices> list6 = new ArrayList<AlitripTravelItemSkuPackageModifyRequest.Prices>();
AlitripTravelItemSkuPackageModifyRequest.Prices obj7 = new AlitripTravelItemSkuPackageModifyRequest.Prices();
list6.add(obj7);
obj7.setDate(StringUtils.parseDateTime("2016-03-19 00:00:00"));
obj7.setOuterPriceId("23333");
obj7.setPrice(1223L);
obj7.setPriceType(1L);
obj7.setStock(12L);
list4.setPrices(list6);
List<AlitripTravelItemSkuPackageModifyRequest.Product> list10 = new ArrayList<AlitripTravelItemSkuPackageModifyRequest.Product>();
AlitripTravelItemSkuPackageModifyRequest.Product obj11 = new AlitripTravelItemSkuPackageModifyRequest.Product();
list10.add(obj11);
obj11.setElementId("12345");
obj11.setNum(2L);
list8.setProducts(list10);
req.setSkus(list2);
req.setOutProductId("111");
AlitripTravelItemSkuPackageModifyResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

XML示例
JSON示例

<alitrip_travel_item_sku_package_modify_response>
    <travel_item>
        <created>2015-9-07 22:56:18</created>
        <item_id>122344</item_id>
        <modified>2015-09-07 22:56:18</modified>
    </travel_item>
</alitrip_travel_item_sku_package_modify_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.CALINPRI_EMPTY	套餐的日历价格库存不能为空	调用方排查
isv.IC_SAVE_INVENTORY_TO_IP_FAILED	库存信息保存失败	请稍后重试
isv.biz-error:ITEM_NOT_FOUNT	商品未找到	调用方确认商品是否已经删除
isv.biz-error:COMBO_COUNT_OVERRANGE	套餐数量超过限制	请根据错误提示调整套餐数量（类目下可支持的套参数上限不同）
isv.ACROSS_ERROR	套餐的价格日历跨度不能超过179天	请修改套餐价格日历的开始和结束日期
isv.RANGE_ERROR	套餐的价格日历不能定义从当前日期起300天之后的日期	修改套餐的价格日历
isv.invalid-parameter:title	商品标题长度不能超过60个字节（30个汉字）	请修改商品标题长度
isv.IC_DB_ACCESS_ERRORGENERIC_FAILUREIC_OPTIMISTIC_LOCKING_CONFLICT	日期太多，或者访问太频繁	日期太多，或者访问太频繁
isv.invalid-parameter:product	套餐关联的产品元素错误	当地玩乐的商品套餐需要关联产品元素product
isv.remote-service-error	服务异常	服务异常
isv.FORBIDDEN_QUANTITY_ZERO_ERROR	在售的商品库存必须大于0	请下架商品
isv.IP_TRADE_INVENTORY_MODIFY_ERROR	库存保存失败	重试
isv.old_sq_not_match	库存已经发生变化	请重新编辑
isv.DATE_DUPLICATE	套餐在某日期下的重复设置	检查套餐下的日期设置
isv.invalid-parameter:WORD_OVERRANGE	商品标题不能超过30个字	请修改商品标题
isv.invalid-parameter:bookTips\|missing-parameter:descr\|invalid-parameter:product	预定须知不能为空	预定须知不能为空
isv.IC_CATEGORY_NOT_GRANT_FOR_B	未授权发布此类目的商品	请先开通类目发布权限
isv.invalid-parameter:NOTNULL	字段为空	请根据提示的信息修改
isv.invalid-parameter:title\|invalid-parameter:bookTips\|missing-parameter:descr	预定须知不能为空	预定须知不能为空
isv.IC_DB_ACCESS_ERRORGENERIC_FAILURE	系统错误，请稍后再试	系统错误，请稍后再试
isv.java.io.IOException: tfs系统出错保存描述失败	保存tfs失败	重试
isv.IC_ITEM_DESC_COULD_NOT_BE_EMPTY	宝贝描述不能为空	请添加商品描述
isv.invalid-parameter:bookTips	预定须知不能为空	预定须知不能为空
isv.missing-parameter:descr	商品PC详情不能为空	请添加商品PC详情
isv.IPM_OPERATION_SUCCESS	数据保存出现问题	系统错误，请稍后再试
isv.RULE_ERR_TRIP_HUODONG_93058_SKU_QUANTITY_LOCK	该商品参加了活动，库存只能增加，不能减少;不能删除或增加商品sku;不能修改价格	活动规则限制
isv.GENERIC_FAILUREIC_DB_ACCESS_ERRORIC_OPTIMISTIC_LOCKING_CONFLICT	系统错误，请稍后再试	系统错误，请稍后再试
isv.COMBO_NAME_TO_LONG	套餐的名称过长，最多可设置20个字符	请修改套餐名称的长度
isv.GENERIC_FAILUREIC_DB_ACCESS_ERROR	系统错误，请稍后再试	系统错误，请稍后再试
isv.IC_INTERFACE_QPS_LIMIT	接口访问太频繁	降低接口的访问频率
isv.IC_CHECKSTEP_SKU_TOO_MUCH	sku数量太多	减少sku数量
isv.date_formate_error	日期格式异常	日期格式异常，请修改日期格式
isv.category-invalid:CATEGORY_ERROR	不支持该类目下宝贝	接口不适用该商品请勿重复调用
isv.invalid-parameter:ERROR	参数错误	请根据errorMsg提示修改请求参数
isp.remote-service-error	远程服务错误	请根据errorMsg提示操作或稍后重试
isv.invalid-parameter:title\|invalid-parameter:product	套餐下的元素资源不能为空	请添加元素资源product
isv.IC_ALI_TRIP_SHANGOU_LIMIT	商品参加了闪购，暂不能修改	退出闪购活动后才可修改
isv.biz-error:PERSON_TEMPLATE_INCORRECT	【出行人信息模板】无效或已被删除	请重新选择或添加新模板后再提交
isv.IPM_OPERATION_SUCCESS;IC_OPERATION_SUCCESS	系统错误	请重试
isv.invalid-parameter:bookTips\|missing-parameter:descr	预定须知不能为空\|商品PC详情不能为空	请输入预定须知和商品PC详情
isv.123:IC商品编辑错误	系统错误	请重试
isv.QUERY_ITEM_ERROR	商品查询失败	https://sell.fliggy.com/icenter/errorcode/ErrorCodeSolution.htm?code=QUERY_ITEM_ERROR&owner=1
isv.UN_SUPPORT_OPERATION	暂不支持此类商品修改	请登录sell发布后台修改
isp.SYS_EXCEPTION	系统异常	请重试
isv.biz-biz-error:COMBO_EMPTY	没有可售卖的日期	请检查你的入参是否会导致更新后没有可售卖的日期
isv.	isv异常	根据错误提示修改
isv.套餐[绿地假日	套餐设置问题	请参考错误提示修改
isv.套餐[双人2日次日取	请根据错误提示修改	请根据错误提示修改
isv.套餐[家庭2日当天取	根据错误提示修改	根据错误提示修改
isv.IC_PRICE_SERVICE_ERROR	价格中心保存失败	重试解决
isv.rights-invalid:PUBLISH_NOT_PERMIT	没有权限编辑	没有权限编辑
isv.IC_CATEGORY_CPV_FREEZE	类目属性被冻结	类目属性被冻结，请根据错误提示切换类目属性
isv.biz-error:	业务异常	业务异常
isv.invalid-parameter:refundRule	退款规则设置失败	请根据错误提示修改
isv.IC_BRAND_NOT_GRANT_FOR_B	请根据错误提示修改	请根据错误提示修改
isv.QUERY_USER_INFO_ERROR	查询用户信息失败	根据错误提示修改
isv.COMBO_PRICE_ERROR	价格日历异常	根据错误提示修改
isv.IC_PRICE_UNSUPPORT_ZERO_PRICE	不支持价格为0	不支持价格为0
isv.套餐[1晚	套餐异常	套餐异常
isv.COMBO_NAME_EMPTY	价格库存不能为空	价格库存不能为空
isv.no_permission	没有权限	没有权限
isv.DATE_FORMAT_ERROR	日期格式异常	请修改日期格式
isv.sellable_quantity less withholding	可售卖库存不足	可售卖库存不足
isv.套餐[双人温泉	套餐异常	套餐异常
isv.套餐[2晚	套餐异常	套餐异常
isv.套餐[3晚	套餐异常	套餐异常
isv.套餐[4晚	套餐异常	套餐异常

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

开放平台

度假-商品管理API

taobao.alitrip.travel.item.sku.package.modify (【API3.0】套餐级别日历价格库存增删操作)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ