文档中心 > API类目 > 度假-商品管理API

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

【API3.0】套餐级别日历价格库存增删操作

公共参数

请求参数

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

    如何获得此API

    FAQ

    返回
    顶部