文档中心 > API类目 > 阿信-基础数据

taobao.alitrip.travel.fsc.route.api.project.add (新增团期)

新增团期

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
fsc_project_modify_request FscProjectModifyRequest 必须 fscProjectModifyRequest
  • └ product_code
  • String
  • 可选
  • xxxxx
  • 产品编号
  • └ journey_code
  • String
  • 可选
  • xxxxx
  • 行程编号
  • project_list
  • FscRouteProjectApiDto []
  • 可选
  • [{}]
  • 团期列表
  • └ date
  • String
  • 可选
  • 2023-04-20
  • 出团日期 格式yyyy-MM-dd
  • └ project_code
  • String
  • 可选
  • C123456
  • 团期计划编号
  • price_list
  • FscRouteProjectPriceApiDto []
  • 可选
  • -
  • 价格体系
  • └ price_category
  • String
  • 可选
  • xxxxx
  • 价格类型 ADULT:成人价 CHILD:儿童价
  • └ price
  • Number
  • 可选
  • 3
  • 同行价
  • └ promotion_price
  • Number
  • 可选
  • 3
  • 加返
  • └ sale_price
  • Number
  • 可选
  • 3
  • 门市价
  • └ contact_name
  • String
  • 可选
  • 张三
  • 联系人姓名
  • └ contact_phone
  • String
  • 可选
  • 12345678901
  • 联系人电话
  • └ booking_unit_price
  • Number
  • 可选
  • 100
  • 订金单价(单位分)
  • └ end_sign_date
  • String
  • 可选
  • 2023-12-31
  • 截止报名日期
  • └ inv_count
  • Number
  • 可选
  • 2
  • 剩余库存数量
  • └ occupy_count
  • Number
  • 可选
  • 1
  • 已占库存数量
  • fsc_sale_commission
  • FscSaleCommissionApiDTO
  • 可选
  • 佣金设置
  • └ commission_type
  • String
  • 可选
  • ABSOLUTE_VALUE
  • 佣金类型
  • └ commission_num
  • String
  • 可选
  • 10
  • 佣金数值
  • depart_flight
  • FlightInfoApiDTO
  • 可选
  • 去程航班
  • └ day
  • String
  • 可选
  • 1
  • 行程天数第几天
  • └ date
  • String
  • 可选
  • 2023-07-10
  • 行程日期 yyyy-MM-dd
  • └ flight_code
  • String
  • 可选
  • CA0001
  • 航班号
  • └ airline_code
  • String
  • 可选
  • CA
  • 航空公司代码
  • └ start_city
  • String
  • 可选
  • 罗马
  • 出发城市名称
  • └ start_time
  • String
  • 可选
  • 1820
  • 起飞时间HHmm(时分)
  • └ start_airport
  • String
  • 可选
  • HKG
  • 起飞机场代码 机场三字码
  • └ arrive_city
  • String
  • 可选
  • 北京
  • 抵达城市
  • └ arrive_time
  • String
  • 可选
  • 1820
  • 抵达时间HHmm(时分)
  • └ arrive_airport
  • String
  • 可选
  • HKG
  • 降落机场代码
  • └ buy_out
  • Boolean
  • 可选
  • false
  • 是否包机 true-是false-否
  • └ flight_type
  • String
  • 可选
  • 中型
  • 机型
  • └ cabin_type
  • String
  • 可选
  • 经济舱
  • 舱型
  • return_flight
  • FlightInfoApiDTO
  • 可选
  • 返程航班
  • └ day
  • String
  • 可选
  • 1
  • 行程天数第几天
  • └ date
  • String
  • 可选
  • 2023-07-10
  • 行程日期 yyyy-MM-dd
  • └ flight_code
  • String
  • 可选
  • CA0001
  • 航班号
  • └ airline_code
  • String
  • 可选
  • CA
  • 航空公司代码
  • └ start_city
  • String
  • 可选
  • 罗马
  • 出发城市名称
  • └ start_time
  • String
  • 可选
  • 1820
  • 起飞时间HHmm(时分)
  • └ start_airport
  • String
  • 可选
  • HKG
  • 起飞机场代码 机场三字码
  • └ arrive_city
  • String
  • 可选
  • 北京
  • 抵达城市
  • └ arrive_time
  • String
  • 可选
  • 1820
  • 抵达时间HHmm(时分)
  • └ arrive_airport
  • String
  • 可选
  • HKG
  • 降落机场代码
  • └ buy_out
  • Boolean
  • 可选
  • false
  • 是否包机 true-是false-否
  • └ flight_type
  • String
  • 可选
  • 中型
  • 机型
  • └ cabin_type
  • String
  • 可选
  • 经济舱
  • 舱型
  • └ supplier_id
  • String
  • 可选
  • xxxxx
  • 供应商id

响应参数

名称 类型 示例值 描述
top_result TopResult 通用返回结果
  • └ success
  • Boolean
  • true
  • 是否成功
  • └ error_code
  • String
  • SYSTEM_ERROR
  • 错误码
  • └ error_msg
  • String
  • 授权异常
  • 错误信息
  • fsc_project_add_api_response
  • FscProjectAddApiResponse
  • 业务数据
  • project_map_d_t_o_s
  • FscProjectMapDTO []
  • A123,B456
  • 团期计划ID映射
  • └ project_code
  • String
  • A123
  • 供应商(外部)团期编码
  • └ fsc_project_id
  • String
  • B456
  • 供销平台团期编码

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripTravelFscRouteApiProjectAddRequest req = new AlitripTravelFscRouteApiProjectAddRequest();
AlitripTravelFscRouteApiProjectAddRequest.FscProjectModifyRequest obj1 = new AlitripTravelFscRouteApiProjectAddRequest.FscProjectModifyRequest();
obj1.setProductCode("xxxxx");
obj1.setJourneyCode("xxxxx");
List<AlitripTravelFscRouteApiProjectAddRequest.FscRouteProjectApiDto> list3 = new ArrayList<AlitripTravelFscRouteApiProjectAddRequest.FscRouteProjectApiDto>();
AlitripTravelFscRouteApiProjectAddRequest.FscRouteProjectApiDto obj4 = new AlitripTravelFscRouteApiProjectAddRequest.FscRouteProjectApiDto();
list3.add(obj4);
obj4.setDate("2023-04-20");
obj4.setProjectCode("C123456");
List<AlitripTravelFscRouteApiProjectAddRequest.FscRouteProjectPriceApiDto> list7 = new ArrayList<AlitripTravelFscRouteApiProjectAddRequest.FscRouteProjectPriceApiDto>();
AlitripTravelFscRouteApiProjectAddRequest.FscRouteProjectPriceApiDto obj8 = new AlitripTravelFscRouteApiProjectAddRequest.FscRouteProjectPriceApiDto();
list7.add(obj8);
obj8.setPriceCategory("xxxxx");
obj8.setPrice(3L);
obj8.setPromotionPrice(3L);
obj8.setSalePrice(3L);
list5.setPriceList(list7);
obj4.setContactName("张三");
obj4.setContactPhone("12345678901");
obj4.setBookingUnitPrice(100L);
obj4.setEndSignDate("2023-12-31");
obj4.setInvCount(2L);
obj4.setOccupyCount(1L);
AlitripTravelFscRouteApiProjectAddRequest.FscSaleCommissionApiDTO obj10 = new AlitripTravelFscRouteApiProjectAddRequest.FscSaleCommissionApiDTO();
obj10.setCommissionType("ABSOLUTE_VALUE");
obj10.setCommissionNum("10");
list9.setFscSaleCommission(obj10);
AlitripTravelFscRouteApiProjectAddRequest.FlightInfoApiDTO obj12 = new AlitripTravelFscRouteApiProjectAddRequest.FlightInfoApiDTO();
obj12.setDay("1");
obj12.setDate("2023-07-10");
obj12.setFlightCode("CA0001");
obj12.setAirlineCode("CA");
obj12.setStartCity("罗马");
obj12.setStartTime("1820");
obj12.setStartAirport("HKG");
obj12.setArriveCity("北京");
obj12.setArriveTime("1820");
obj12.setArriveAirport("HKG");
obj12.setBuyOut(false);
obj12.setFlightType("中型");
obj12.setCabinType("经济舱");
list11.setDepartFlight(obj12);
AlitripTravelFscRouteApiProjectAddRequest.FlightInfoApiDTO obj14 = new AlitripTravelFscRouteApiProjectAddRequest.FlightInfoApiDTO();
obj14.setDay("1");
obj14.setDate("2023-07-10");
obj14.setFlightCode("CA0001");
obj14.setAirlineCode("CA");
obj14.setStartCity("罗马");
obj14.setStartTime("1820");
obj14.setStartAirport("HKG");
obj14.setArriveCity("北京");
obj14.setArriveTime("1820");
obj14.setArriveAirport("HKG");
obj14.setBuyOut(false);
obj14.setFlightType("中型");
obj14.setCabinType("经济舱");
list13.setReturnFlight(obj14);
obj1.setProjectList(list3);
obj1.setSupplierId("xxxxx");
req.setFscProjectModifyRequest(obj1);
AlitripTravelFscRouteApiProjectAddResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alitrip_travel_fsc_route_api_project_add_response>
    <top_result>
        <success>true</success>
        <error_code>SYSTEM_ERROR</error_code>
        <error_msg>授权异常</error_msg>
        <fsc_project_add_api_response>
            <project_map_d_t_o_s>
                <fsc_project_map_d_t_o>
                    <project_code>A123</project_code>
                    <fsc_project_id>B456</fsc_project_id>
                </fsc_project_map_d_t_o>
            </project_map_d_t_o_s>
        </fsc_project_add_api_response>
    </top_result>
</alitrip_travel_fsc_route_api_project_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

FAQ

返回
顶部