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

alitrip.travel.gereralproduct.update (通用类目产品发布编辑)

提供给飞猪供销平台供应商发布编辑通用类目产品的API

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
base_info GeneralProductBaseInfo 必须 产品基本信息
  • └ desc
  • String
  • 可选
  • 我家的货很好很好很好
  • 商品描述
  • └ wap_desc
  • String
  • 可选
  • <wapDesc><shortDesc>标题</shortDesc> <txt>描述</txt><img>图片路径</img></wapDesc>
  • 手机描述 格式:标题 描述图片路径
  • └ reserve_deadline_minutes
  • Number
  • 可选
  • 30
  • 最晚收客时间:分钟。仅个别类目支持
  • └ category_id
  • Number
  • 可选
  • 50018298
  • 商品类目id,发布商品必填,编辑选填;支持的线上类目ID,船票:50018298
  • └ out_id
  • String
  • 可选
  • 1234
  • 商家编码
  • └ to_locations
  • String
  • 可选
  • 上海
  • 目的地,填写中文,以英文逗号分隔,最多可填12个,如果国家底下还有城市,则必须精确到城市。如果接口报错提示目的地不存在,则可登录商家基础信息映射管理后台(https://sell.alitrip.com/sell/basicdata/BasicDataMapping.htm)修正并生效映射关系,映射关系生效后,无法识别的目的地将自动替换为映射值 【重要提示-此字段会作为搜索/筛选条件】
  • └ pic_urls
  • String []
  • 可选
  • https://img.alicdn.com/tfs/TB1QyC0RxTpK1RjSZFMXXbG_VXa-246-246.jpg,https://img.alicdn.com/tfs/TB1QyC0RxTpK1RjSZFMXXbG_VXa-246-246.jpg
  • 品图片路径。最多支持5张,第一张为主图 必填,其余四张可选填(多张图片间使用英文逗号分隔)。图片链接支持外链图片(即商家系统中图片链接,必须外网可访问,且格式为png、jpg或jpeg,大小在500k以内),或者用户淘宝空间内的图片链接。对于外链图片,将自动下载并上传用户淘宝图片空间,上传失败的外链图片将自动忽略不计。
  • └ item_id
  • Number
  • 可选
  • 12345
  • 淘宝平台商品ID 产品更新时使用
  • └ confirm_time
  • Number
  • 可选
  • 1
  • 可选,资源确认时长,当confirm_type=2时必填。1:2个工作小时内确认,2:6个工作小时内确认,3:9个工作小时内确认,4:18个工作小时内确认
  • └ sub_titles
  • String []
  • 可选
  • 亮点1,亮点2
  • 商品亮点。1)目前最多支持4个亮点,超过4个的亮点描述不会被保存 2)每个亮点描述35个字符以内 3)每个亮点间用英文逗号分隔
  • └ title
  • String
  • 可选
  • xxxx
  • 必填,商品标题。30个字符以内 【重要-此字段会作为搜索条件】
  • └ duration
  • Number
  • 可选
  • 0
  • 至少提前天数,最晚成团提前天数,最小0天,最大为300天;不传则为0
  • └ reserve_deadline_hours
  • Number
  • 可选
  • 1
  • 最晚收客时间:小时。仅个别类目支持
  • props
  • CatPropInfo []
  • 可选
  • 商品属性列表;由类目的属性PID和VID组成,属性的pid调用taobao.itemprops.get取得,属性值的vid用taobao.itempropvalues.get取得vid。如果该类目下面没有属性,可以不用填写。如果有属性,必选属性必填,其他非必选属性可以选择不填写.属性不能超过35对。
  • └ vid
  • String
  • 可选
  • 111
  • 属性PID,调用taobao.itemprops.get取得
  • └ pid
  • String
  • 可选
  • 222
  • 属性VID,调用taobao.itemprops.get取得
  • └ confirm_type
  • Number
  • 可选
  • 1
  • 可选,资源确认类型。1-即时确认,2-二次确认。不传默认1
refund_info ItemRefundInfo 可选 退款规则结构
  • └ refund_regulations
  • String []
  • 可选
  • ["30_30_0","30_15_5","14_7_15","6_4_70","3_1_85","1_1_90"]
  • 退改规则 1)格式:标准规则 或 自定义规则:a_a_num,a_b_num,b-1_c_num,c-1_c-1_num 2)规则:自定义规则里最多可含5组规则
  • └ refund_type
  • Number
  • 可选
  • 0
  • 退改规则类型,0为标准,1为自定义 2为不支持退改规则。不传默认为0
booking_rules BookingRuleInfo [] 必须
  • 最大列表长度:20
  • 必填,预定规则结构。示例: [{ "rule_type": "fee_excluded", "rule_desc": "费用包含描述"},{ "rule_type": "fee_included", "rule_desc": "费用不含描述"},{ "rule_type": "order_info", "rule_desc": "预定须知描述"}]
    • └ rule_type
    • String
    • 必须
    • fee_included
    • fee_included:费用包含,跟团游必填; fee_excluded:费用不含,所有类目必填; order_info:预定须知; extra_cost:其他费用,预留;
    • └ rule_desc
    • String
    • 必须
    • xxxx
    • 1500个字
    product_sale_info ProductSaleInfo 可选 产品销售信息
    • └ confirm_time
    • Number
    • 可选
    • 1
    • 可选,资源确认时长,当confirm_type=2时必填。1:2个工作小时内确认,2:6个工作小时内确认,3:9个工作小时内确认,4:18个工作小时内确认
    • └ duration
    • Number
    • 可选
    • 0
    • 至少提前天数,最晚成团提前天数,最小0天,最大为300天;不传则为0
    • └ distribute
    • Boolean
    • 可选
    • false
    • 是否支持经销
    • └ product_line
    • Number
    • 可选
    • 123
    • 产品线
    • └ agent
    • Boolean
    • 可选
    • true
    • 是否支持代销
    • └ price_upper
    • String
    • 可选
    • 11.11
    • 建议零售价上限,单位:元
    • └ confirm_type
    • Number
    • 可选
    • 1
    • 可选,资源确认类型。1-即时确认,2-二次确认。不传默认1
    • └ price_lower
    • String
    • 可选
    • 0.01
    • 建议零售价下限,单位:元
    date_sku_info_list DateSkuInfo [] 可选
  • 最大列表长度:20
  • 更新sku信息,仅限日历商品使用
    • alias
    • PropertyAliasInfo []
    • 可选
    • sku销售属性别名;如套餐1 需要调整成其他 需要在这里修改
    • └ value
    • String
    • 可选
    • 香港直飞 四星泳池
    • 属性具体别名值
    • └ properties
    • String
    • 可选
    • 20000:33564
    • 销售属性的pid和vid,属性的pid调用taobao.itemprops.get取得,属性值的vid用taobao.itempropvalues.get取得vid
    • date_list
    • DateInventoryAndPrice []
    • 可选
    • SKU的销售价格库存,日历商品使用
    • └ stock
    • Number
    • 可选
    • 1000
    • Sku的库存数量。sku的总数量应该小于等于商品总数量(Item的NUM),sku数量变化后item的总数量也会随着变化。取值范围:大于等于零的整数
    • └ date
    • Date
    • 可选
    • 2019-09-19 09:42:12
    • 销售日期
    • └ price
    • Number
    • 可选
    • 1000
    • Sku的销售价格。单位:分。如:20007,表示:200元7分。修改后的sku价格要保证商品的价格在所有sku价格所形成的价格区间内(例如:商品价格为6元,sku价格有5元、10元两种,如果要修改5元sku的价格,那么修改的范围只能是0-6元之间;如果要修改10元的sku,那么修改的范围只能是6到无穷大的区间中)
    • properties
    • CatPropInfo []
    • 可选
    • SKU销售属性列表;由类目的属性PID和VID组成,属性的pid调用taobao.itemprops.get取得,属性值的vid用taobao.itempropvalues.get取得vid。如果该类目下面没有属性,可以不用填写。如果有属性,必选属性必填,其他非必选属性可以选择不填写.属性不能超过35对。
    • └ vid
    • String
    • 可选
    • 222
    • 属性VID,调用taobao.itempropvalues.get取得
    • └ pid
    • String
    • 可选
    • 111
    • 属性PID,调用taobao.itemprops.get取得
    • └ outer_id
    • String
    • 可选
    • 1111
    • sku商品编码

    响应参数

    名称 类型 示例值 描述
    first_result TopTravelItem firstResult
    • └ modified
    • Date
    • 2019-9-07 22:56:18
    • 商品修改时间
    • └ item_id
    • String
    • 123445
    • 产品id
    • └ created
    • Date
    • 2019-9-07 22:56:18
    • 商品创建时间

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AlitripTravelGereralproductUpdateRequest req = new AlitripTravelGereralproductUpdateRequest();
    AlitripTravelGereralproductUpdateRequest.GeneralProductBaseInfo obj1 = new AlitripTravelGereralproductUpdateRequest.GeneralProductBaseInfo();
    obj1.setDesc("我家的货很好很好很好");
    obj1.setWapDesc("<wapDesc><shortDesc>标题</shortDesc> <txt>描述</txt><img>图片路径</img></wapDesc>");
    obj1.setReserveDeadlineMinutes(30L);
    obj1.setCategoryId(50018298L);
    obj1.setOutId("1234");
    obj1.setToLocations("上海");
    obj1.setPicUrls("https://img.alicdn.com/tfs/TB1QyC0RxTpK1RjSZFMXXbG_VXa-246-246.jpg,https://img.alicdn.com/tfs/TB1QyC0RxTpK1RjSZFMXXbG_VXa-246-246.jpg");
    obj1.setItemId(12345L);
    obj1.setConfirmTime(1L);
    obj1.setSubTitles("亮点1,亮点2");
    obj1.setTitle("xxxx");
    obj1.setDuration(0L);
    obj1.setReserveDeadlineHours(1L);
    List<AlitripTravelGereralproductUpdateRequest.CatPropInfo> list3 = new ArrayList<AlitripTravelGereralproductUpdateRequest.CatPropInfo>();
    AlitripTravelGereralproductUpdateRequest.CatPropInfo obj4 = new AlitripTravelGereralproductUpdateRequest.CatPropInfo();
    list3.add(obj4);
    obj4.setVid("111");
    obj4.setPid("222");
    obj1.setProps(list3);
    obj1.setConfirmType(1L);
    req.setBaseInfo(obj1);
    AlitripTravelGereralproductUpdateRequest.ItemRefundInfo obj5 = new AlitripTravelGereralproductUpdateRequest.ItemRefundInfo();
    obj5.setRefundRegulations(""30_30_0","30_15_5","14_7_15","6_4_70","3_1_85","1_1_90"");
    obj5.setRefundType(0L);
    req.setRefundInfo(obj5);
    List<AlitripTravelGereralproductUpdateRequest.BookingRuleInfo> list7 = new ArrayList<AlitripTravelGereralproductUpdateRequest.BookingRuleInfo>();
    AlitripTravelGereralproductUpdateRequest.BookingRuleInfo obj8 = new AlitripTravelGereralproductUpdateRequest.BookingRuleInfo();
    list7.add(obj8);
    obj8.setRuleType("fee_included");
    obj8.setRuleDesc("xxxx");
    req.setBookingRules(list7);
    AlitripTravelGereralproductUpdateRequest.ProductSaleInfo obj9 = new AlitripTravelGereralproductUpdateRequest.ProductSaleInfo();
    obj9.setConfirmTime(1L);
    obj9.setDuration(0L);
    obj9.setDistribute(false);
    obj9.setProductLine(123L);
    obj9.setAgent(true);
    obj9.setPriceUpper("11.11");
    obj9.setConfirmType(1L);
    obj9.setPriceLower("0.01");
    req.setProductSaleInfo(obj9);
    List<AlitripTravelGereralproductUpdateRequest.DateSkuInfo> list11 = new ArrayList<AlitripTravelGereralproductUpdateRequest.DateSkuInfo>();
    AlitripTravelGereralproductUpdateRequest.DateSkuInfo obj12 = new AlitripTravelGereralproductUpdateRequest.DateSkuInfo();
    list11.add(obj12);
    List<AlitripTravelGereralproductUpdateRequest.PropertyAliasInfo> list15 = new ArrayList<AlitripTravelGereralproductUpdateRequest.PropertyAliasInfo>();
    AlitripTravelGereralproductUpdateRequest.PropertyAliasInfo obj16 = new AlitripTravelGereralproductUpdateRequest.PropertyAliasInfo();
    list15.add(obj16);
    obj16.setValue("香港直飞 四星泳池");
    obj16.setProperties("20000:33564");
    list13.setAlias(list15);
    List<AlitripTravelGereralproductUpdateRequest.DateInventoryAndPrice> list19 = new ArrayList<AlitripTravelGereralproductUpdateRequest.DateInventoryAndPrice>();
    AlitripTravelGereralproductUpdateRequest.DateInventoryAndPrice obj20 = new AlitripTravelGereralproductUpdateRequest.DateInventoryAndPrice();
    list19.add(obj20);
    obj20.setStock(1000L);
    obj20.setDate(StringUtils.parseDateTime("2019-09-19 09:42:12"));
    obj20.setPrice(1000L);
    list17.setDateList(list19);
    List<AlitripTravelGereralproductUpdateRequest.CatPropInfo> list23 = new ArrayList<AlitripTravelGereralproductUpdateRequest.CatPropInfo>();
    AlitripTravelGereralproductUpdateRequest.CatPropInfo obj24 = new AlitripTravelGereralproductUpdateRequest.CatPropInfo();
    list23.add(obj24);
    obj24.setVid("222");
    obj24.setPid("111");
    list21.setProperties(list23);
    obj12.setOuterId("1111");
    req.setDateSkuInfoList(list11);
    AlitripTravelGereralproductUpdateResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <alitrip_travel_gereralproduct_update_response>
        <first_result>
            <modified>2019-9-07 22:56:18</modified>
            <item_id>123445</item_id>
            <created>2019-9-07 22:56:18</created>
        </first_result>
    </alitrip_travel_gereralproduct_update_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>

    错误码解释

    错误码 错误描述 解决方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部