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

alitrip.car.product.upload (用车商品发布)

用车、接送机商品发布接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
wap_desc String 可选 <wapDesc><shortDesc>标题1</shortDesc> <txt>描述1</txt> <img>图片路径1</img> <shortDesc>标题2</shortDesc> <txt>描述2</txt> <img>图片路径2</img> </wapDesc> 可选,手机端详情描述,xml格式,格式详见示例。
desc_xml String 可选 <DESC><HIGHLIGHT><title>亮点1</title> <txt>亮点描述1</txt> <img>亮点图片链接1</img></HIGHLIGHT> <HIGHLIGHT><title>亮点2</title> <txt>亮点描述2</txt> <img>亮点图片链接2</img></HIGHLIGHT></DESC> PC端详情描述(新发布商品时,desc_xml和desc_html二者至少填写一个),xml格式:DESC根标签必须有,每一个亮点(HIGHLIGHT)支持1个title子标签,1个txt子标签和多个img子标签。
car_refund_desc String 可选 请在下单页查看具体取消规则 退改规则
car_category String 可选 轿车 车辆种类,单选,取值范围:轿车。商务车,电动汽车,越野车,跑车,房车,摩托车,自行车,其他
out_product_id String 可选 1111 必填,商家自定义商品编码。注:商品基本信息维护、价格库存维护,商品查询都以该编码为主键。
to_locations String 可选 东京,京都 新发布商品时必填。目的地,多个目的地用英文逗号分隔。地址可以使用飞猪标准地址名称,也可以使用商家系统中目的地地址(支持商家目的地id和商家目的地名称)。如果需要使用商家目的地地址,必须在目的地关联页(https://sell.alitrip.com/icenter/main.htm#/widgets/api-adaptor?_k=n61ii0)配置映射关系(一次性批量上传建立映射关系,之后度假所有类目、API接口共用该映射关系)。 商家目的地地址使用示例1:东京,大阪。示例2:123,124。说明:商家目的地id(123,124)会根据映射关系自动转换成飞猪标准地址
sub_stock Number 可选 0 可选,减库存方式。0-拍下减库存。1-付款减库存。不传默认为0
special_service String [] 可选 24小时中文客服,可配中文GPS导航
  • 最大列表长度:20
  • 特色服务,多选,数组,取值范围:24小时中文客服,可配中文GPS导航,可配儿童座椅 ,支持异地还车 ,支持机场取车 ,支持送车上门 ,送驾照翻译
    title String 可选 商品标题 商品标题
    car_package_info_list CarPackageInfo [] 可选
  • 最大列表长度:20
  • 用车商品的套餐信息,可以一次上传多个商品,如果是编辑商品,每次都要上传完整的套餐信息,不能传一个,不传一个,字段啥的也都要传全
    • car_price_and_sock_list
    • CarPriceAndSock []
    • 可选
    • 价格和库存等信息
    • └ out_id
    • String
    • 可选
    • 1111
    • 商家编码
    • └ stock
    • Number
    • 可选
    • 10
    • 库存数量
    • └ price
    • String
    • 可选
    • 100.00
    • 价格,单位:元
    • └ car_name
    • String
    • 可选
    • 经济型5座
    • 车型分类
    • └ car_remark
    • String
    • 可选
    • 备注
    • 备注
    • └ car_gear_box
    • Number
    • 可选
    • 0
    • 变速箱类型,0:自动;1:手动
    • └ car_brand
    • String
    • 可选
    • 车品牌名称
    • 车品牌
    • └ car_series
    • String
    • 可选
    • 车系列名称
    • 车系列
    • └ package_type
    • String
    • 可选
    • 租车:租车;租车+其他;接送:机场接送,专车接送
    • 套餐类型,租车需要填写,0:租车,1:租车+其他
    • └ name
    • String
    • 可选
    • 套餐名称
    • 套餐名称
    pic_urls String [] 可选 https://img.daily.taobaocdn.net/imgextra/i3/2024098454/TB2C4VXXXXXXXc1XXXXXXXXXXXX_!!2024098454.jpg,http://ww1.sinaimg.cn/large/005EDdjYgw1fanv4d823dj31gs0z6qb8.jpg
  • 最大列表长度:20
  • 新发布商品时必填。商品图片路径。最多支持5张,第一张为主图,必填,其余四张可选填。图片链接支持外链图片(即商家系统中图片链接,必须外网可访问,且格式为jpg或jpeg,大小在500k以内),或者用户淘宝空间内的图片链接。对于外链图片,将自动下载并上传用户淘宝图片空间,上传失败的外链图片将自动忽略不计。。注:在SDK中数组多个元素间以英文逗号分隔
    item_id Number 可选 1234 可选,淘系商品id,用于将out_product_id关联到已经存在的商品,并且修改该商品外部商家编码为out_product_id。
    desc_html String 可选 PC端详情描述 PC端详情描述(新发布商品时,desc_xml和desc_html二者至少填写一个),Html格式。商家自定义Html格式描述。
    sub_titles String [] 可选 亮点1,亮点2,亮点3
  • 最大列表长度:20
  • 可选,商品亮点,最多支持4个亮点。注:在SDK中数组多个元素间以英文逗号分隔
    traveller_template_id Number 可选 111 可选,出行人模板id,预留,暂不支持
    car_type String 必须 用车类型,0:租车,1:接送机 用车类型,0:租车,1:接送机,发布租车,接送机商品不能为空
    price_declaration String 可选 报价类型,0:一价全包,1:非一价全包 报价类型,0:一价全包,1:非一价全包,发布接送机商品不能为空
    fee_include_list String [] 可选 车辆服务费,司机服务费
  • 最大列表长度:20
  • 费用包含列表,发布接送机商品不能为空
    join_trip_super_market Boolean 可选 true 是否加入出境超市
    tourist_service_provider String 可选 一嗨租车 实际的服务提供商名称
    order_info String [] 可选 为了确保您能够按时出行,产品确认后请在48小时内付款,同时请按要求尽快提供出游所需的材料并签订旅游合同。 团队报价按2人入住1间房核算,如出现单男单女,则尽量安排与其他同性别团友拼房或加床;若客人无需安排或旅行社无法安排,请补齐单房差以享用单人房间。
  • 最大列表长度:20
  • 预定须知

    响应参数

    名称 类型 示例值 描述
    first_result TopTravelItem first_result firstResult
    • └ extend
    • String
    • 1234
    • extend
    • └ modified
    • Date
    • 2015-09-07 22:56:18
    • modified
    • └ out_product_id
    • String
    • 1234
    • outProductId
    • └ item_id
    • Number
    • 123456
    • itemId

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AlitripCarProductUploadRequest req = new AlitripCarProductUploadRequest();
    req.setWapDesc("<wapDesc><shortDesc>标题1</shortDesc> <txt>描述1</txt> <img>图片路径1</img> <shortDesc>标题2</shortDesc> <txt>描述2</txt> <img>图片路径2</img> </wapDesc>");
    req.setDescXml("<DESC><HIGHLIGHT><title>亮点1</title> <txt>亮点描述1</txt> <img>亮点图片链接1</img></HIGHLIGHT> <HIGHLIGHT><title>亮点2</title> <txt>亮点描述2</txt> <img>亮点图片链接2</img></HIGHLIGHT></DESC>");
    req.setCarRefundDesc("请在下单页查看具体取消规则");
    req.setCarCategory("轿车");
    req.setOutProductId("1111");
    req.setToLocations("东京,京都");
    req.setSubStock(0L);
    req.setSpecialService("24小时中文客服,可配中文GPS导航");
    req.setTitle("商品标题");
    List<AlitripCarProductUploadRequest.CarPackageInfo> list2 = new ArrayList<AlitripCarProductUploadRequest.CarPackageInfo>();
    AlitripCarProductUploadRequest.CarPackageInfo obj3 = new AlitripCarProductUploadRequest.CarPackageInfo();
    list2.add(obj3);
    List<AlitripCarProductUploadRequest.CarPriceAndSock> list6 = new ArrayList<AlitripCarProductUploadRequest.CarPriceAndSock>();
    AlitripCarProductUploadRequest.CarPriceAndSock obj7 = new AlitripCarProductUploadRequest.CarPriceAndSock();
    list6.add(obj7);
    obj7.setOutId("1111");
    obj7.setStock(10L);
    obj7.setPrice("100.00");
    obj7.setCarName("经济型5座");
    obj7.setCarRemark("备注");
    obj7.setCarGearBox(0L);
    obj7.setCarBrand("车品牌名称");
    obj7.setCarSeries("车系列名称");
    list4.setCarPriceAndSockList(list6);
    obj3.setPackageType("租车:租车;租车+其他;接送:机场接送,专车接送");
    obj3.setName("套餐名称");
    req.setCarPackageInfoList(list2);
    req.setPicUrls("https://img.daily.taobaocdn.net/imgextra/i3/2024098454/TB2C4VXXXXXXXc1XXXXXXXXXXXX_!!2024098454.jpg,http://ww1.sinaimg.cn/large/005EDdjYgw1fanv4d823dj31gs0z6qb8.jpg");
    req.setItemId(1234L);
    req.setDescHtml("PC端详情描述");
    req.setSubTitles("亮点1,亮点2,亮点3");
    req.setTravellerTemplateId(111L);
    req.setCarType("用车类型,0:租车,1:接送机");
    req.setPriceDeclaration("报价类型,0:一价全包,1:非一价全包");
    req.setFeeIncludeList("车辆服务费,司机服务费");
    req.setJoinTripSuperMarket(true);
    req.setTouristServiceProvider("一嗨租车");
    req.setOrderInfo("为了确保您能够按时出行,产品确认后请在48小时内付款,同时请按要求尽快提供出游所需的材料并签订旅游合同。 团队报价按2人入住1间房核算,如出现单男单女,则尽量安排与其他同性别团友拼房或加床;若客人无需安排或旅行社无法安排,请补齐单房差以享用单人房间。");
    AlitripCarProductUploadResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <alitrip_car_product_upload_response>
        <first_result>
            <extend>1234</extend>
            <modified>2015-09-07 22:56:18</modified>
            <out_product_id>1234</out_product_id>
            <item_id>123456</item_id>
        </first_result>
    </alitrip_car_product_upload_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>

    错误码解释

    错误码 错误描述 解决方案
    0 0 0
    isv.remote-service-error 远程服务调用失败 请稍后重试

    API工具

    如何获得此API

    FAQ

    返回
    顶部