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

alitrip.travel.gereralitem.update (除度假线路、门票以外的其他类目商品维护接口(商品ID重复将自动更新))

除度假线路、门票以外的商品维护接口;目前该接口支持以下类目; (123740001:客栈周边交通服务、125038002:旅行设备/GPS/相机租赁、50018298:船票、124084006:酒店商品升级差价、125228016:预约卡券、50011954:旅游服务、50012913:酒店优惠券、50214003:旅游会员卡/酒店会员卡、50012917:巴士/地铁/交通卡/一卡通、50134002:代客烧香/还愿、50026091:境外火车票、123742001:客栈周边餐饮服务、50019817:海外套餐(该类目已废弃)、125210016:团建/outing、124212017:其他预定、50025888:机场行李托运取送寄存、50025831:旅游年票/年卡、124142009:旅游商品升级差价/押金、123744001:客栈周边其他服务、50012762:广深口岸港澳送关服务、50025880:旅行拍照/婚纱摄影、123166001:酒店餐饮美食(该类目已废弃)、50668002:手绘地图/明信片、50024210:旅游购物/纪念品、50024208:酒店用品、50024215:购物折扣卡券、50025878:酒店SPA/足浴/温泉、50024212:旅游必备品、123738001:客栈周边票务服务、123164002:游泳健身(该类目已废弃)、50686003:机票增值产品、123164001:酒店SPA(该类目已废弃)、124832008:美食卡券/酒店餐饮卡券、125408001:旅游定制服务、50018112:旅行社/网站优惠券、124258004:酒店客房优惠券(该类目已废弃)、50104001:机场周边停车位、124730002:内机机场/火车站送关服务、124090010:其他)

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
base_info BaseInfo 可选 必填,商品基本信息
  • └ approve_status
  • Number
  • 可选
  • 1
  • 用户指定的上下架操作:0-下架,1-上架(立即上架,定时上架),2-从未上架。注意,已失效,默认下架状态。如需上架请调用taobao.alitrip.travel.item.shelve接口操作。
  • └ category_id
  • Number
  • 可选
  • 1111
  • 商品类目id,发布商品必填,编辑选填;支持的线上类目ID: 123740001, 125038002, 50018298, 124084006, 125228016, 50011954, 50012913, 50214003, 50012917, 50134002, 50026091, 123742001, 50019817, 125210016, 124212017, 50025888, 50025831, 124142009, 123744001, 50012762, 50025880, 123166001, 50668002, 50024210, 50024208, 50024215, 50025878, 50024212, 123738001, 123164002, 50686003, 123164001, 124832008, 125408001, 50018112, 124258004, 50104001, 124730002, 124090010;支持的测试类目ID: 145732013, 145632040, 145632038, 145632039, 50018322, 145632036, 145632037, 145632034, 145632035, 145632032, 145632033, 145632031, 50019817, 146476005
  • └ city
  • String
  • 可选
  • 杭州
  • 宝贝所在市。不填默认设置 杭州
  • └ desc
  • String
  • 可选
  • 我家的货很好很好很好
  • 商品描述
  • └ exts_map
  • String
  • 可选
  • {"showStart":"2017-10-16","showEnd":"2017-10-20"}
  • 商品的补充描述,不同类目所设置值不一样,根据类目配置模版来决定传值;目前仅演艺类目使用,模版:145632032=showStart#演出开始时间#3#20@showEnd#演出结束时间#3#20
  • └ has_discount
  • Boolean
  • 可选
  • false
  • 是否支持会员打折。可选值:true,false;默认值:false(不打折)。不传的话默认为false
  • └ has_showcase
  • Boolean
  • 可选
  • false
  • 是否橱窗推荐,可选值:true,false;默认值:false(不推荐)
  • └ item_id
  • Number
  • 可选
  • 112111
  • 淘宝平台商品ID 商品更新时使用
  • └ label
  • String
  • 可选
  • 演艺
  • 商品标签 提高曝光率
  • └ online_time
  • Date
  • 可选
  • 2000-01-01 00:00:00
  • 上架时间。大于当前时间则宝贝会下架进入定时上架的宝贝中。
  • └ out_id
  • String
  • 可选
  • 11111
  • 商家编码
  • └ pic_urls
  • String []
  • 可选
  • https://img.daily.taobaocdn.net/imgextra/i4/3651880377/TB2p4JaXXXXXXabXXXXXXXXXXXX_!!3651880377.jpg,https://img.daily.taobaocdn.net/imgextra/i4/3651880377/TB2p4JaXXXXXXabXXXXXXXXXXXX_!!3651880377.jpg
  • 品图片路径。最多支持5张,第一张为主图 必填,其余四张可选填(多张图片间使用英文逗号分隔)。图片链接支持外链图片(即商家系统中图片链接,必须外网可访问,且格式为png、jpg或jpeg,大小在500k以内),或者用户淘宝空间内的图片链接。对于外链图片,将自动下载并上传用户淘宝图片空间,上传失败的外链图片将自动忽略不计。
  • props
  • CatPropInfo []
  • 可选
  • 商品属性列表;由类目的属性PID和VID组成,属性的pid调用taobao.itemprops.get取得,属性值的vid用taobao.itempropvalues.get取得vid。如果该类目下面没有属性,可以不用填写。如果有属性,必选属性必填,其他非必选属性可以选择不填写.属性不能超过35对。
  • └ pid
  • String
  • 可选
  • 111
  • 属性PID,调用taobao.itemprops.get取得
  • └ vid
  • String
  • 可选
  • 222
  • 属性VID,调用taobao.itempropvalues.get取得
  • └ prov
  • String
  • 可选
  • 浙江
  • 宝贝所在地省,后台通过用户输入城市去获取该城市对应省份
  • └ second_kill
  • String
  • 可选
  • wap_only
  • 商品秒杀,商品秒杀三个值:可选类型web_only(只能通过web网络秒杀),wap_only(只能通过wap网络秒杀),web_and_wap(既能通过web秒杀也能通过wap秒杀)
  • └ seller_cids
  • String []
  • 可选
  • ["12344","24332"]
  • 宝贝店铺分类
  • └ sub_stock
  • Number
  • 可选
  • 1
  • 库存计数方式,默认采用拍下减库存,不支持用户选择。0拍下减库存,1付款减库存;
  • └ sub_titles
  • String []
  • 可选
  • 亮点1,亮点2
  • 商品亮点。1)目前最多支持4个亮点,超过4个的亮点描述不会被保存 2)每个亮点描述35个字符以内 3)每个亮点间用英文逗号分隔
  • └ title
  • String
  • 必须
  • xxxx
  • 必填,商品标题。30个字符以内 【重要-此字段会作为搜索条件】
  • └ wap_desc
  • String
  • 可选
  • <wapDesc><shortDesc>标题</shortDesc> <txt>描述</txt><img>图片路径</img></wapDesc>
  • 手机描述 格式:标题 描述图片路径
  • └ from_locations
  • String
  • 可选
  • 杭州
  • 出发地(城市),填写中文,如果接口报错提示出发地不存在,则可登录商家基础信息映射管理后台(https://sell.alitrip.com/sell/basicdata/BasicDataMapping.htm)修正并生效映射关系,映射关系生效后,无法识别的出发地将自动替换为映射值 【重要提示-此属性会作为搜索/筛选条件】
  • └ to_locations
  • String
  • 可选
  • 上海
  • 目的地,填写中文,以英文逗号分隔,最多可填12个,如果国家底下还有城市,则必须精确到城市。如果接口报错提示目的地不存在,则可登录商家基础信息映射管理后台(https://sell.alitrip.com/sell/basicdata/BasicDataMapping.htm)修正并生效映射关系,映射关系生效后,无法识别的目的地将自动替换为映射值 【重要提示-此字段会作为搜索/筛选条件】
  • └ confirm_type
  • Number
  • 可选
  • 1
  • 可选,资源确认类型。1-即时确认,2-二次确认。不传默认1
  • └ confirm_time
  • Number
  • 可选
  • 1
  • 可选,资源确认时长,当confirm_type=2时必填。1:2个工作小时内确认,2:6个工作小时内确认,3:9个工作小时内确认,4:18个工作小时内确认
  • └ duration
  • Number
  • 可选
  • 0
  • 至少提前天数,最晚成团提前天数,最小0天,最大为300天;不传则为0
  • └ reserve_deadline_hours
  • Number
  • 可选
  • 1
  • 最晚收客时间:小时。仅个别类目支持
  • └ reserve_deadline_minutes
  • Number
  • 可选
  • 30
  • 最晚收客时间:分钟。仅个别类目支持
booking_rules BookingRuleInfo [] 必须
  • 最大列表长度:20
  • 必填,预定规则结构。示例: [{ "rule_type": "fee_excluded", "rule_desc": "费用包含描述"},{ "rule_type": "fee_included", "rule_desc": "费用不含描述"},{ "rule_type": "order_info", "rule_desc": "预定须知描述"}]
    • └ rule_desc
    • String
    • 必须
    • xxxx
    • 1500个字
    • └ rule_type
    • String
    • 必须
    • fee_included
    • fee_included:费用包含,跟团游必填; fee_excluded:费用不含,所有类目必填; order_info:预定须知; extra_cost:其他费用,预留;
    date_sku_info_list DateSkuInfo [] 可选
  • 最大列表长度:500
  • 更新sku信息,仅限日历商品使用
    • alias
    • PropertyAliasInfo []
    • 可选
    • sku销售属性别名;如套餐1 需要调整成其他 需要在这里修改
    • └ properties
    • String
    • 可选
    • 20000:33564
    • 销售属性的pid和vid,属性的pid调用taobao.itemprops.get取得,属性值的vid用taobao.itempropvalues.get取得vid
    • └ value
    • String
    • 可选
    • 香港直飞 四星泳池
    • 属性具体别名值
    • date_list
    • DateInventoryAndPrice []
    • 可选
    • SKU的销售价格库存,日历商品使用
    • └ date
    • Date
    • 可选
    • 2015-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到无穷大的区间中)
    • └ stock
    • Number
    • 可选
    • 1000
    • Sku的库存数量。sku的总数量应该小于等于商品总数量(Item的NUM),sku数量变化后item的总数量也会随着变化。取值范围:大于等于零的整数
    • └ outer_id
    • String
    • 可选
    • 1111
    • sku商品编码
    • properties
    • CatPropInfo []
    • 可选
    • SKU销售属性列表,若未填写,其他sku信息不会生效;由类目的属性PID和VID组成,属性的pid调用taobao.itemprops.get取得,属性值的vid用taobao.itempropvalues.get取得vid。如果该类目下面没有属性,可以不用填写。如果有属性,必选属性必填,其他非必选属性可以选择不填写.属性不能超过35对。
    • └ pid
    • String
    • 可选
    • 111
    • 属性PID,调用taobao.itemprops.get取得
    • └ vid
    • String
    • 可选
    • 222
    • 属性VID,调用taobao.itempropvalues.get取得
    item_ele_cert_info ItemEleCertInfo 可选 新版电子凭证信息。如果传递了此参数,则sales_info中旧版电子凭证信息将被忽略,否则电子凭证信息将以旧版电子凭证参数为准。如果新、旧版参数都没传,则该商品不支持电子凭证
    • └ auto_refund_rate
    • Number
    • 可选
    • 100
    • 可选,售中自动退款比例,0~100。默认为0,即不支持售中自动退款;当值为1~100时表示售中自动退款的比例
    • └ expired_refund_rate
    • Number
    • 可选
    • 100
    • 可选,过期自动退款比例,0~100。默认为0,即不支持过期自动退款比例;当值为1~100时表示过期自动退款的比例
    • └ expiry_date_end
    • Date
    • 可选
    • 2018-01-01 00:00:00
    • 殊必填(expiryDateType为1或2时必填),电子凭证 有效期 结束时间
    • └ expiry_date_start
    • Date
    • 可选
    • 2017-01-01 00:00:00
    • 特殊必填(expiryDateType为1时必填),电子凭证 有效期 开始时间
    • └ expiry_date_type
    • Number
    • 可选
    • 1
    • 必填,电子凭证有效期 过期类型。1:xxxx-xx-xx 到 xxxx-xx-xx; 2:购买成功日 至 xxxx-xx-xx; 3:购买成功 xx 天内有效
    • └ expiry_days
    • Number
    • 可选
    • 5
    • 特殊必填(expiryDateType为3时必填),电子凭证 有效期 天数
    • └ package_id
    • Number
    • 可选
    • 20182296
    • 必填,核销门店库id
    item_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
    common_sku_list NoDateSkuInfo [] 可选
  • 最大列表长度:500
  • 更新sku信息,仅限非日历(普通)商品使用
    • alias
    • PropertyAliasInfo []
    • 可选
    • sku销售属性别名;如套餐1 需要调整成其他 需要在这里修改
    • └ properties
    • String
    • 可选
    • 20000:33564
    • 销售属性的pid和vid,属性的pid调用taobao.itemprops.get取得,属性值的vid用taobao.itempropvalues.get取得vid
    • └ value
    • String
    • 可选
    • 香港直飞 四星泳池
    • 属性具体别名值
    • └ outer_id
    • String
    • 可选
    • 1111
    • sku商家编码
    • └ price
    • Number
    • 可选
    • 1000
    • Sku的销售价格。单位:分。如:20007,表示:200元7分。修改后的sku价格要保证商品的价格在所有sku价格所形成的价格区间内(例如:商品价格为6元,sku价格有5元、10元两种,如果要修改5元sku的价格,那么修改的范围只能是0-6元之间;如果要修改10元的sku,那么修改的范围只能是6到无穷大的区间中)
    • properties
    • CatPropInfo []
    • 可选
    • SKU销售属性列表,若未填写,其他sku信息不会生效;由类目的属性PID和VID组成,属性的pid调用taobao.itemprops.get取得,属性值的vid用taobao.itempropvalues.get取得vid。如果该类目下面没有属性,可以不用填写。如果有属性,必选属性必填,其他非必选属性可以选择不填写.属性不能超过35对。
    • └ pid
    • String
    • 可选
    • 111
    • 属性PID,调用taobao.itemprops.get取得
    • └ vid
    • String
    • 可选
    • 222
    • 属性VID,调用taobao.itempropvalues.get取得
    • └ quantity
    • Number
    • 可选
    • 1000
    • Sku的库存数量。sku的总数量应该小于等于商品总数量(Item的NUM),sku数量变化后item的总数量也会随着变化。取值范围:大于等于零的整数
    poi Poi 可选 poi信息,个别类目必填,如演艺类目下场馆信息
    • └ id
    • Number
    • 可选
    • 1
    • POI对应ID
    • └ name
    • String
    • 可选
    • 黄龙体育场馆
    • POI对应的名称

    响应参数

    名称 类型 示例值 描述
    travel_item TopTravelItem 11 商品发布结果
    • └ 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);
    AlitripTravelGereralitemUpdateRequest req = new AlitripTravelGereralitemUpdateRequest();
    AlitripTravelGereralitemUpdateRequest.BaseInfo obj1 = new AlitripTravelGereralitemUpdateRequest.BaseInfo();
    obj1.setApproveStatus(1L);
    obj1.setCategoryId(1111L);
    obj1.setCity("杭州");
    obj1.setDesc("我家的货很好很好很好");
    obj1.setExtsMap("{\"showStart\":\"2017-10-16\",\"showEnd\":\"2017-10-20\"}");
    obj1.setHasDiscount(false);
    obj1.setHasShowcase(false);
    obj1.setItemId(112111L);
    obj1.setLabel("演艺");
    obj1.setOnlineTime(StringUtils.parseDateTime("2000-01-01 00:00:00"));
    obj1.setOutId("11111");
    obj1.setPicUrls("https://img.daily.taobaocdn.net/imgextra/i4/3651880377/TB2p4JaXXXXXXabXXXXXXXXXXXX_!!3651880377.jpg,https://img.daily.taobaocdn.net/imgextra/i4/3651880377/TB2p4JaXXXXXXabXXXXXXXXXXXX_!!3651880377.jpg");
    List<AlitripTravelGereralitemUpdateRequest.CatPropInfo> list3 = new ArrayList<AlitripTravelGereralitemUpdateRequest.CatPropInfo>();
    AlitripTravelGereralitemUpdateRequest.CatPropInfo obj4 = new AlitripTravelGereralitemUpdateRequest.CatPropInfo();
    list3.add(obj4);
    obj4.setPid("111");
    obj4.setVid("222");
    obj1.setProps(list3);
    obj1.setProv("浙江");
    obj1.setSecondKill("wap_only");
    obj1.setSellerCids(""12344","24332"");
    obj1.setSubStock(1L);
    obj1.setSubTitles("亮点1,亮点2");
    obj1.setTitle("xxxx");
    obj1.setWapDesc("<wapDesc><shortDesc>标题</shortDesc> <txt>描述</txt><img>图片路径</img></wapDesc>");
    obj1.setFromLocations("杭州");
    obj1.setToLocations("上海");
    obj1.setConfirmType(1L);
    obj1.setConfirmTime(1L);
    obj1.setDuration(0L);
    obj1.setReserveDeadlineHours(1L);
    obj1.setReserveDeadlineMinutes(30L);
    req.setBaseInfo(obj1);
    List<AlitripTravelGereralitemUpdateRequest.BookingRuleInfo> list6 = new ArrayList<AlitripTravelGereralitemUpdateRequest.BookingRuleInfo>();
    AlitripTravelGereralitemUpdateRequest.BookingRuleInfo obj7 = new AlitripTravelGereralitemUpdateRequest.BookingRuleInfo();
    list6.add(obj7);
    obj7.setRuleDesc("xxxx");
    obj7.setRuleType("fee_included");
    req.setBookingRules(list6);
    List<AlitripTravelGereralitemUpdateRequest.DateSkuInfo> list9 = new ArrayList<AlitripTravelGereralitemUpdateRequest.DateSkuInfo>();
    AlitripTravelGereralitemUpdateRequest.DateSkuInfo obj10 = new AlitripTravelGereralitemUpdateRequest.DateSkuInfo();
    list9.add(obj10);
    List<AlitripTravelGereralitemUpdateRequest.PropertyAliasInfo> list13 = new ArrayList<AlitripTravelGereralitemUpdateRequest.PropertyAliasInfo>();
    AlitripTravelGereralitemUpdateRequest.PropertyAliasInfo obj14 = new AlitripTravelGereralitemUpdateRequest.PropertyAliasInfo();
    list13.add(obj14);
    obj14.setProperties("20000:33564");
    obj14.setValue("香港直飞 四星泳池");
    list11.setAlias(list13);
    List<AlitripTravelGereralitemUpdateRequest.DateInventoryAndPrice> list17 = new ArrayList<AlitripTravelGereralitemUpdateRequest.DateInventoryAndPrice>();
    AlitripTravelGereralitemUpdateRequest.DateInventoryAndPrice obj18 = new AlitripTravelGereralitemUpdateRequest.DateInventoryAndPrice();
    list17.add(obj18);
    obj18.setDate(StringUtils.parseDateTime("2015-09-19 09:42:12"));
    obj18.setPrice(1000L);
    obj18.setStock(1000L);
    list15.setDateList(list17);
    obj10.setOuterId("1111");
    List<AlitripTravelGereralitemUpdateRequest.CatPropInfo> list21 = new ArrayList<AlitripTravelGereralitemUpdateRequest.CatPropInfo>();
    AlitripTravelGereralitemUpdateRequest.CatPropInfo obj22 = new AlitripTravelGereralitemUpdateRequest.CatPropInfo();
    list21.add(obj22);
    obj22.setPid("111");
    obj22.setVid("222");
    list19.setProperties(list21);
    req.setDateSkuInfoList(list9);
    AlitripTravelGereralitemUpdateRequest.ItemEleCertInfo obj23 = new AlitripTravelGereralitemUpdateRequest.ItemEleCertInfo();
    obj23.setAutoRefundRate(100L);
    obj23.setExpiredRefundRate(100L);
    obj23.setExpiryDateEnd(StringUtils.parseDateTime("2018-01-01 00:00:00"));
    obj23.setExpiryDateStart(StringUtils.parseDateTime("2017-01-01 00:00:00"));
    obj23.setExpiryDateType(1L);
    obj23.setExpiryDays(5L);
    obj23.setPackageId(20182296L);
    req.setItemEleCertInfo(obj23);
    AlitripTravelGereralitemUpdateRequest.ItemRefundInfo obj24 = new AlitripTravelGereralitemUpdateRequest.ItemRefundInfo();
    obj24.setRefundRegulations(""30_30_0","30_15_5","14_7_15","6_4_70","3_1_85","1_1_90"");
    obj24.setRefundType(0L);
    req.setItemRefundInfo(obj24);
    List<AlitripTravelGereralitemUpdateRequest.NoDateSkuInfo> list26 = new ArrayList<AlitripTravelGereralitemUpdateRequest.NoDateSkuInfo>();
    AlitripTravelGereralitemUpdateRequest.NoDateSkuInfo obj27 = new AlitripTravelGereralitemUpdateRequest.NoDateSkuInfo();
    list26.add(obj27);
    List<AlitripTravelGereralitemUpdateRequest.PropertyAliasInfo> list30 = new ArrayList<AlitripTravelGereralitemUpdateRequest.PropertyAliasInfo>();
    AlitripTravelGereralitemUpdateRequest.PropertyAliasInfo obj31 = new AlitripTravelGereralitemUpdateRequest.PropertyAliasInfo();
    list30.add(obj31);
    obj31.setProperties("20000:33564");
    obj31.setValue("香港直飞 四星泳池");
    list28.setAlias(list30);
    obj27.setOuterId("1111");
    obj27.setPrice(1000L);
    List<AlitripTravelGereralitemUpdateRequest.CatPropInfo> list34 = new ArrayList<AlitripTravelGereralitemUpdateRequest.CatPropInfo>();
    AlitripTravelGereralitemUpdateRequest.CatPropInfo obj35 = new AlitripTravelGereralitemUpdateRequest.CatPropInfo();
    list34.add(obj35);
    obj35.setPid("111");
    obj35.setVid("222");
    list32.setProperties(list34);
    obj27.setQuantity(1000L);
    req.setCommonSkuList(list26);
    AlitripTravelGereralitemUpdateRequest.Poi obj36 = new AlitripTravelGereralitemUpdateRequest.Poi();
    obj36.setId(1L);
    obj36.setName("黄龙体育场馆");
    req.setPoi(obj36);
    AlitripTravelGereralitemUpdateResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <alitrip_travel_gereralitem_update_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_gereralitem_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>

    错误码解释

    错误码 错误描述 解决方案
    isv.PARAM_ERROR 参数错误 根据错误提示修改

    API工具

    如何获得此API

    FAQ

    返回
    顶部