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

taobao.alitrip.travel.product.base.modify (供应商编辑产品API)

飞猪供销平台供应商可通过该API编辑产品

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
itineraries ItemItineraryInfo [] 可选
  • 最大列表长度:20
  • 详细行程描述结构
    • └ content
    • String
    • 可选
    • <txt>文本描述</txt><img>https://img.daily.taobaocdn.net/imgextra/i4/3651880377/TB2p4JaXXXXXXabXXXXXXXXXXXX_!!3651880377.jpg</img><txt>文本描述2</txt><txt>文本描述3</txt><img>https://img.daily.taobaocdn.net/imgextra/i4/3651880377/TB2p4JaXXXXXXabXXXXXXXXXXXX_!!3651880377.jpg</img>
    • 1.使用xml标签(img和txt)进行图文混排,目前仅支持一段文字和多张图片,如果文件有多段,将会被合并 2.每段行程文字总和小于1500字
    • └ title
    • String
    • 可选
    • 行程标题
    • 小于等于30字
    • └ itinerary_no
    • Number
    • 可选
    • 1
    • 第一天行程为1,第二天行程为2
    base_info ProductBaseInfo 可选 产品基本信息
    • └ trip_max_days
    • Number
    • 可选
    • 3
    • 旅游日程-天数
    • └ desc
    • String
    • 可选
    • 产品描述
    • pc端商品描述,不超过50000个字符。详情描述支持纯文本描述,也支持html格式的详情描述。html格式的详情描述中 图片链接支持外链图片(必须外网可访问, 且格式为png、jpg或jpeg,大小在500k以内)和淘宝图片空间链接。
    • └ wap_desc
    • String
    • 可选
    • <wapDesc><shortDesc>标题</shortDesc> <txt>描述</txt> <img>图片路径</img></wapDesc>
    • 手机端描述。格式: 使用xml标签(shortDesc,txt和img)进行图文混排,shortDesc标签表示添加小标题,txt标签表示添加文本描述,img标签表示添加一张图片。 注意: 1)shortDesc,txt和img三个xml标签独立,可以乱序使用,但不能嵌套; 2)图片链接支持外链图片(必须外网可访问, 且格式为png、jpg或jpeg,大小在500k以内)和淘宝图片空间链接;3)手机端描述内容以wapDesc标签标示开始和结束
    • └ item_type
    • Number
    • 可选
    • 9
    • 产品类型。目前仅支持 6-国际邮轮 9-境内邮轮
    • └ to_locations
    • String
    • 可选
    • 上海
    • 目的地,所有商品必填,填写中文,以英文逗号分隔,最多可填12个,如果国家底下还有城市,则必须精确到城市。如果接口报错提示目的地不存在,则可登录商家基础信息映射管理后台(https://sell.alitrip.com/sell/basicdata/BasicDataMapping.htm)修正并生效映射关系,映射关系生效后,无法识别的目的地将自动替换为映射值 【重要提示-此字段会作为搜索/筛选条件】
    • └ out_id
    • String
    • 可选
    • 123
    • 商家编码
    • └ 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以内),或者用户淘宝空间内的图片链接。对于外链图片,将自动下载并上传用户淘宝图片空间,上传失败的外链图片将自动忽略不计。
    • └ accom_nights
    • Number
    • 可选
    • 2
    • 旅游日程-晚数,必须大于等于0,且小于等于旅游日程-天数。 这里注意下,trip_max_days(旅游日程-天数)>=accom_nights(旅游日程-晚数)>=hotel_days(住宿晚数)
    • └ title
    • String
    • 可选
    • 产品标题
    • 产品标题
    • └ sub_titles
    • String []
    • 可选
    • 亮点1,亮点2
    • 商品亮点。1)目前最多支持4个亮点,超过4个的亮点描述不会被保存 2)每个亮点描述35个字符以内 3)每个亮点间用英文逗号分隔
    • └ traveller_template_id
    • Number
    • 可选
    • 0
    • 出行人模板id。模板id需要商家以店铺账号身份登录飞猪商家工作台,从卖家工具->出行人管理中获取。注意:如果传0则代表设置为不需要出行人模板或使用飞猪平台默认的类目模板。
    item_id Number 必须 12345 产品id
    refund_info ItemRefundInfo 可选 退款规则结构
    • └ refund_regulations
    • String []
    • 可选
    • ["30_30_0","30_15_5","14_7_15","6_4_70","3_1_85","1_1_90"]
    • 当refund_type=1或7时,需要上传自定义退改内容。自定义退改规则,最多可含5组规则,每组规则间以英文逗号分隔。 1)当refund_type为1时格式为:a_b_num,b-1_c_num。含义:提前a天至提前b天发起退款,买家需支付num比例违约费。 2)当refund_type为7时格式为:a_b_num1_num2_0,b-1_c_num1_num2_0。含义:提前a天至提前b天发起退款,买家需支付num1比例违约费,卖家需支付num2比例违约费,最后一个数字代表是否节假日规则(0-不是,1-是)。特别注意,当refund_type为7时,自定义退改规则必须设置 n天以上违约规则 以及 行程当日违约规则,即第一组规则需要以-1_a_num1_num2_0或-1_a_num1_num2_1开头,且最后一组规则需要以0_0_num1_num2_0或0_0_num1_num2_1结尾。
    • └ refund_regulations_json
    • String
    • 可选
    • [{"firstDay":-1,"secondDay":5,"percent":50,"sellerPercent":20},{"firstDay":4,"secondDay":1,"percent":80,"sellerPercent":50},{"firstDay":0,"secondDay":0,"percent":100,"sellerPercent":70},{"firstDay":0,"secondDay":0,"percent":100,"sellerPercent":90,"isHoliday":true}]
    • 退款规则(json数组格式)。自定义退改时需填写(与refund_regulations字段二选一)。示例中一共包含4条规则(3条平日规则,1条节假日规则),按照顺序每条规则含义如下:出行前5日及以上,买家违约收取总费用的50,卖家违约收取总费用的20;出行前4日至1日,买家违约收取总费用的80,卖家违约收取总费用的50;行程开始当天,买家违约收取总费用的100,卖家违约收取总费用的70;如果行程日期包含节假日,则节假日条款为买家违约收取总费用的100,卖家违约收取总费用的90
    • └ refund_type
    • Number
    • 可选
    • 0
    • 退改规则类型,0-平台标准退改规则,1-自定义退改规则,2-不支持退改(已废弃,勿用),7-新版自定义退改规则。
    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
    • 可选
    • 描述
    • 1500个字
    cruise_product_ext CruiseProductExt 可选 邮轮商品相关信息
    • └ ship_fee_include
    • String []
    • 可选
    • 1
    • 邮轮相关小费包含选项。境内邮轮: 1-"船票" 2-"岸上观光费" 3-"导游" 4-"其他费用" ...... 国际邮轮 1-"船票" 2-"港务费、邮轮税费" 3-"岸上观光费" 4-"签证费用" 5-"小费" 6-"领队费" 7-"其他费用"
    • └ ship_name
    • String
    • 可选
    • 蓝宝石公主号
    • 邮轮船名
    • └ ship_down
    • String
    • 可选
    • 中国(上海)
    • 邮轮下船地点
    • └ ship_up
    • String
    • 可选
    • 中国(厦门)
    • 邮轮上船地点
    • └ cruise_line
    • String
    • 可选
    • 日韩航线
    • 邮轮线路
    • └ cruise_company
    • String
    • 可选
    • 美国公主邮轮
    • 邮轮公司
    product_sale_info ProductSaleInfo 可选 商品的销售属性相关信息
    • └ confirm_time
    • Number
    • 可选
    • 1
    • 资源确认时长。1:2个工作小时内确认,2:6个工作小时内确认,3:9个工作小时内确认
    • └ duration
    • Number
    • 可选
    • 2
    • 至少提前天数,最晚成团提前天数,最小0天,最大为300天;不传则为0
    • └ distribute
    • Boolean
    • 可选
    • false
    • 是否支持经销
    • └ product_line
    • Number
    • 可选
    • 1001
    • 产品线ID
    • └ sale_type
    • Number
    • 可选
    • 0
    • 商品售卖类型,0为日历商品,1为预约商品,2为非日历商品;默认为0
    • └ end_combo_date
    • Date
    • 可选
    • 2019-09-18 19:47:45
    • 可选出发结束日期,格式:yyyy-MM-dd
    • └ agent
    • Boolean
    • 可选
    • true
    • 是否支持代销
    • └ price_upper
    • String
    • 可选
    • 11.11
    • 建议零售价上限,单位:元
    • └ start_combo_date
    • Date
    • 可选
    • 2019-09-18 19:47:45
    • 可选出发开始日期,格式:yyyy-MM-dd
    • └ confirm_type
    • Number
    • 可选
    • 1
    • 资源确认方式。1:即时确认,2:二次确认
    • └ price_lower
    • String
    • 可选
    • 0.01
    • 建议零售价下限,单位:元

    响应参数

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

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AlitripTravelProductBaseModifyRequest req = new AlitripTravelProductBaseModifyRequest();
    List<AlitripTravelProductBaseModifyRequest.ItemItineraryInfo> list2 = new ArrayList<AlitripTravelProductBaseModifyRequest.ItemItineraryInfo>();
    AlitripTravelProductBaseModifyRequest.ItemItineraryInfo obj3 = new AlitripTravelProductBaseModifyRequest.ItemItineraryInfo();
    list2.add(obj3);
    obj3.setContent("<txt>文本描述</txt><img>https://img.daily.taobaocdn.net/imgextra/i4/3651880377/TB2p4JaXXXXXXabXXXXXXXXXXXX_!!3651880377.jpg</img><txt>文本描述2</txt><txt>文本描述3</txt><img>https://img.daily.taobaocdn.net/imgextra/i4/3651880377/TB2p4JaXXXXXXabXXXXXXXXXXXX_!!3651880377.jpg</img>");
    obj3.setTitle("行程标题");
    obj3.setItineraryNo(1L);
    req.setItineraries(list2);
    AlitripTravelProductBaseModifyRequest.ProductBaseInfo obj4 = new AlitripTravelProductBaseModifyRequest.ProductBaseInfo();
    obj4.setTripMaxDays(3L);
    obj4.setDesc("产品描述");
    obj4.setWapDesc("<wapDesc><shortDesc>标题</shortDesc> <txt>描述</txt> <img>图片路径</img></wapDesc>");
    obj4.setItemType(9L);
    obj4.setToLocations("上海");
    obj4.setOutId("123");
    obj4.setPicUrls("https://img.alicdn.com/tfs/TB1QyC0RxTpK1RjSZFMXXbG_VXa-246-246.jpg,https://img.alicdn.com/tfs/TB1QyC0RxTpK1RjSZFMXXbG_VXa-246-246.jpg");
    obj4.setAccomNights(2L);
    obj4.setTitle("产品标题");
    obj4.setSubTitles("亮点1,亮点2");
    obj4.setTravellerTemplateId(0L);
    req.setBaseInfo(obj4);
    req.setItemId(12345L);
    AlitripTravelProductBaseModifyRequest.ItemRefundInfo obj5 = new AlitripTravelProductBaseModifyRequest.ItemRefundInfo();
    obj5.setRefundRegulations(""30_30_0","30_15_5","14_7_15","6_4_70","3_1_85","1_1_90"");
    obj5.setRefundRegulationsJson("[{\"firstDay\":-1,\"secondDay\":5,\"percent\":50,\"sellerPercent\":20},{\"firstDay\":4,\"secondDay\":1,\"percent\":80,\"sellerPercent\":50},{\"firstDay\":0,\"secondDay\":0,\"percent\":100,\"sellerPercent\":70},{\"firstDay\":0,\"secondDay\":0,\"percent\":100,\"sellerPercent\":90,\"isHoliday\":true}]");
    obj5.setRefundType(0L);
    req.setRefundInfo(obj5);
    List<AlitripTravelProductBaseModifyRequest.BookingRuleInfo> list7 = new ArrayList<AlitripTravelProductBaseModifyRequest.BookingRuleInfo>();
    AlitripTravelProductBaseModifyRequest.BookingRuleInfo obj8 = new AlitripTravelProductBaseModifyRequest.BookingRuleInfo();
    list7.add(obj8);
    obj8.setRuleType("fee_included");
    obj8.setRuleDesc("描述");
    req.setBookingRules(list7);
    AlitripTravelProductBaseModifyRequest.CruiseProductExt obj9 = new AlitripTravelProductBaseModifyRequest.CruiseProductExt();
    obj9.setShipFeeInclude("1");
    obj9.setShipName("蓝宝石公主号");
    obj9.setShipDown("中国(上海)");
    obj9.setShipUp("中国(厦门)");
    obj9.setCruiseLine("日韩航线");
    obj9.setCruiseCompany("美国公主邮轮");
    req.setCruiseProductExt(obj9);
    AlitripTravelProductBaseModifyRequest.ProductSaleInfo obj10 = new AlitripTravelProductBaseModifyRequest.ProductSaleInfo();
    obj10.setConfirmTime(1L);
    obj10.setDuration(2L);
    obj10.setDistribute(false);
    obj10.setProductLine(1001L);
    obj10.setSaleType(0L);
    obj10.setEndComboDate(StringUtils.parseDateTime("2019-09-18 19:47:45"));
    obj10.setAgent(true);
    obj10.setPriceUpper("11.11");
    obj10.setStartComboDate(StringUtils.parseDateTime("2019-09-18 19:47:45"));
    obj10.setConfirmType(1L);
    obj10.setPriceLower("0.01");
    req.setProductSaleInfo(obj10);
    AlitripTravelProductBaseModifyResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <alitrip_travel_product_base_modify_response>
        <travel_item>
            <created>2019-9-07 22:56:18</created>
            <item_id>123</item_id>
            <modified>2019-9-07 22:56:18</modified>
        </travel_item>
    </alitrip_travel_product_base_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>

    错误码解释

    错误码 错误描述 解决方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部