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

度假-商品管理API

taobao.alitrip.travel.product.base.add (供应商新增产品API)

飞猪供销平台供应商可通过该API发布新产品

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
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）修正并生效映射关系，映射关系生效后，无法识别的目的地将自动替换为映射值 【重要提示-此字段会作为搜索/筛选条件】
  • └ 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以内），或者用户淘宝空间内的图片链接。对于外链图片，将自动下载并上传用户淘宝图片空间，上传失败的外链图片将自动忽略不计。
  • └ accom_nights
  • Number
  • 可选
  • 2
  • 旅游日程-晚数，必须大于等于0，且小于等于旅游日程-天数。 这里注意下，trip_max_days（旅游日程-天数）>=accom_nights（旅游日程-晚数）>=hotel_days（住宿晚数）
  • └ title
  • String
  • 必须
  • 商品标题
  • 必填，商品标题。30个字符以内 【重要-此字段会作为搜索条件】
  • └ sub_titles
  • String []
  • 可选
  • 亮点1,亮点2
  • 商品亮点。1）目前最多支持4个亮点，超过4个的亮点描述不会被保存 2）每个亮点描述35个字符以内 3）每个亮点间用英文逗号分隔
  • └ traveller_template_id
  • Number
  • 可选
  • 1234
  • 可选，出行人模板id。模板id需要商家以店铺账号身份登录飞猪商家工作台，从卖家工具->出行人管理中获取。注意：如果传0则代表设置为不需要出行人模板或使用飞猪平台默认的类目模板。
  • └ from_locations
  • String
  • 可选
  • 上海
  • 出发地（城市），填写中文，如果接口报错提示出发地不存在，则可登录商家基础信息映射管理后台（https://sell.alitrip.com/sell/basicdata/BasicDataMapping.htm）修正并生效映射关系，映射关系生效后，无法识别的出发地将自动替换为映射值 【重要提示-此属性会作为搜索/筛选条件】
itineraries ItemItineraryInfo [] 可选
  • 最大列表长度：20
    		•  选填，详细行程描述结构
    • └ itinerary_no
    • Number
    • 可选
    • 1
    • 必填，第一天行程为1，第二天行程为2
    • └ title
    • String
    • 可选
    • 行程标题
    • 小于等于30字
    • └ 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字
    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_desc
    • String
    • 必须
    • 描述
    • 1500个字
    • └ rule_type
    • String
    • 必须
    • fee_included
    • fee_included：费用包含，跟团游必填； fee_excluded：费用不含，所有类目必填； order_info：预定须知； extra_cost：其他费用，预留；
    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 商品发布结果
    • └ modified
    • Date
    • 2019-09-07 22:56:18
    • 商品修改时间
    • └ item_id
    • Number
    • 123
    • 商品id
    • └ created
    • Date
    • 2019-09-07 22:56:18
    • 商品创建时间

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripTravelProductBaseAddRequest req = new AlitripTravelProductBaseAddRequest();
AlitripTravelProductBaseAddRequest.ProductBaseInfo obj1 = new AlitripTravelProductBaseAddRequest.ProductBaseInfo();
obj1.setTripMaxDays(3L);
obj1.setDesc("产品描述");
obj1.setWapDesc("<wapDesc><shortDesc>标题</shortDesc> <txt>描述</txt> <img>图片路径</img></wapDesc>");
obj1.setItemType(9L);
obj1.setToLocations("上海");
obj1.setPicUrls("https://img.daily.taobaocdn.net/imgextra/i4/3651880377/TB2p4JaXXXXXXabXXXXXXXXXXXX_!!3651880377.jpg,https://img.daily.taobaocdn.net/imgextra/i4/3651880377/TB2p4JaXXXXXXabXXXXXXXXXXXX_!!3651880377.jpg");
obj1.setAccomNights(2L);
obj1.setTitle("商品标题");
obj1.setSubTitles("亮点1,亮点2");
obj1.setTravellerTemplateId(1234L);
obj1.setFromLocations("上海");
req.setBaseInfo(obj1);
List<AlitripTravelProductBaseAddRequest.ItemItineraryInfo> list3 = new ArrayList<AlitripTravelProductBaseAddRequest.ItemItineraryInfo>();
AlitripTravelProductBaseAddRequest.ItemItineraryInfo obj4 = new AlitripTravelProductBaseAddRequest.ItemItineraryInfo();
list3.add(obj4);
obj4.setItineraryNo(1L);
obj4.setTitle("行程标题");
obj4.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>");
req.setItineraries(list3);
AlitripTravelProductBaseAddRequest.ItemRefundInfo obj5 = new AlitripTravelProductBaseAddRequest.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<AlitripTravelProductBaseAddRequest.BookingRuleInfo> list7 = new ArrayList<AlitripTravelProductBaseAddRequest.BookingRuleInfo>();
AlitripTravelProductBaseAddRequest.BookingRuleInfo obj8 = new AlitripTravelProductBaseAddRequest.BookingRuleInfo();
list7.add(obj8);
obj8.setRuleDesc("描述");
obj8.setRuleType("fee_included");
req.setBookingRules(list7);
AlitripTravelProductBaseAddRequest.CruiseProductExt obj9 = new AlitripTravelProductBaseAddRequest.CruiseProductExt();
obj9.setShipFeeInclude("1");
obj9.setShipName("蓝宝石公主号");
obj9.setShipDown("中国（上海）");
obj9.setShipUp("中国（厦门）");
obj9.setCruiseLine("日韩航线");
obj9.setCruiseCompany("美国公主邮轮");
req.setCruiseProductExt(obj9);
AlitripTravelProductBaseAddRequest.ProductSaleInfo obj10 = new AlitripTravelProductBaseAddRequest.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);
AlitripTravelProductBaseAddResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <alitrip_travel_product_base_add_response>
    <travel_item>
        <modified>2019-09-07 22:56:18</modified>
        <item_id>123</item_id>
        <created>2019-09-07 22:56:18</created>
    </travel_item>
</alitrip_travel_product_base_add_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测试工具 错误码查询工具 SDK下载

    如何获得此API

    FAQ

    我要提问
    返回
    顶部
    阿里巴巴集团 | 淘宝网 | 天猫 | 聚划算 | 全球速卖通 | 阿里巴巴国际交易市场 | 1688 | 阿里妈妈 | 阿里旅行·去啊 | 阿里云计算 | YunOS | 阿里通信 | 万网 | 高德 | 优视 | 友盟 | 酷盘 | 虾米 | 天天动听 | 来往 | 钉钉 | 11Main | 支付宝
    关于淘宝 合作伙伴 营销中心 联系客服 开放平台 诚征英才 联系我们 网站地图 法律声明 © 2016 Taobao.com 版权所有
    网络文化经营许可证：文网文[2010]040号 | 增值电信业务经营许可证：浙B2-20080224-1 | 信息网络传播视听节目许可证：1109364号