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

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

旅行度假新商品日历价格库存信息修改接口 第三版。提供商家通过TOP API方式修改商品sku信息。

公共参数

请求参数

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

    响应示例

    • 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>

    异常示例

    • 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>

    错误码解释

    错误码 错误描述 解决方案
    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工具

    如何获得此API

    FAQ

    返回
    顶部