alitrip.policy.special.upload (特殊政策上传)

上传特殊类型的单程/往返政策

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param_policy_create_request_d_t_o PolicyCreateRequestDto 必须 普通政策上传参数
  • └ agent_id
  • Number
  • 必须
  • 2052
  • 店铺id
  • delete_policy
  • PolicyQueryParamDTO []
  • 可选
  • 删除政策查询参数,需要删除时execType必须为ADD
  • └ account_code
  • String
  • 可选
  • 1001
  • 大客户编码
  • └ airline
  • String
  • 可选
  • CA
  • 航司二字码
  • └ arr_airport
  • String
  • 可选
  • PEK
  • 到达机场三字码
  • └ cabin_list1
  • String
  • 可选
  • M1
  • 去程舱位
  • └ cabin_list2
  • String
  • 可选
  • M1
  • 回程舱位
  • └ dep_airport
  • String
  • 可选
  • PEK
  • 出发机场三字码
  • └ fuzzy_query
  • Boolean
  • 可选
  • true
  • 根据政策编码模糊查询,暂时不支持
  • └ policy_code
  • String
  • 必须
  • 123
  • 政策编码
  • └ policy_source
  • Number
  • 可选
  • 1
  • 政策来源:0,手工政策;1,excel政策;2,api政策
  • └ sale_start_date
  • Date
  • 可选
  • 2022-09-18 10:10:10
  • 销售起始日期
  • └ sales_end_date
  • Date
  • 可选
  • 2022-09-28 10:10:10
  • 销售截止日期
  • └ status
  • Number
  • 可选
  • 1
  • 政策状态:1,有效;2,挂起;0,删除 3,停用
  • └ travel_end_date
  • Date
  • 可选
  • 2023-09-28 10:10:10
  • 行程截止日期
  • └ travel_start_date
  • Date
  • 可选
  • 2023-09-18 10:10:10
  • 行程起始日期
  • └ is_ow_eoe
  • Boolean
  • 可选
  • true
  • 中转运价标识
  • └ exec_type
  • String
  • 必须
  • ADD
  • 操作类型:ADD,增量;FULL,全量
  • policy_list
  • PolicyDto []
  • 可选
  • 需要导入的政策列表
  • └ airline
  • String
  • 必须
  • CA
  • 航司二字码
  • └ arr_airport
  • String
  • 可选
  • PEK
  • 到达机场三字码
  • └ create_pnr
  • Number
  • 可选
  • 1
  • 是否订位:0,平台不订位;1,平台订位;2,紧张订位;
  • └ dep_airport
  • String
  • 可选
  • PEK
  • 出发机场三字码
  • flights
  • FlightDTO []
  • 可选
  • 行程信息
  • └ allow_flight_num
  • String
  • 可选
  • 1111-2222,3333
  • 允许航班号
  • allow_travel_date
  • DatePairDto []
  • 必须
  • 允许航班日期
  • └ end
  • Date
  • 可选
  • 2023-09-28 10:10:10
  • 允许航班截止日期
  • └ start
  • Date
  • 可选
  • 2023-09-18 10:10:10
  • 允许航班起始日期
  • └ allow_travel_time
  • String
  • 可选
  • 0606-0707,0808-0909
  • 允许航班起飞时间
  • └ cabin
  • String
  • 可选
  • M1
  • 舱位
  • └ cabin_class
  • String
  • 可选
  • Y
  • 舱等
  • └ day_week
  • String []
  • 可选
  • [1,2,3]
  • 班期
  • └ flight_index
  • Number
  • 可选
  • 0
  • 行程类型标记:0,单程;1,往返
  • └ restrict_flight_num
  • String
  • 可选
  • 1111-2222,3333
  • 禁止航班号
  • restrict_travel_date
  • DatePairDto []
  • 可选
  • 禁止航班日期
  • └ end
  • Date
  • 可选
  • 2022-09-28 10:10:10
  • 禁止航班截止日期
  • └ start
  • Date
  • 可选
  • 2022-09-18 10:10:10
  • 禁止航班起始日期
  • └ allow_flight_num2
  • String
  • 可选
  • 8888
  • 第二段可售航班号
  • └ restrict_flight_num2
  • String
  • 可选
  • 8888
  • 第二段不可售航班号
  • └ office_no
  • String
  • 可选
  • 123
  • 商家配置号
  • └ pata
  • Number
  • 可选
  • 1
  • pata:0,不验价;1,验价
  • └ policy_code
  • String
  • 可选
  • 1234
  • 政策编码
  • └ policy_source
  • Number
  • 可选
  • 1
  • 政策来源:0,手工政策;1,excel政策;2,api政策
  • price
  • PriceDto
  • 可选
  • 竞价信息
  • └ commission
  • Number
  • 必须
  • 10
  • 代理费率
  • └ return_price
  • Number
  • 必须
  • 100
  • 留钱,单位为分
  • └ lowest_price
  • Number
  • 可选
  • 100
  • 最低票面价,单位为分
  • └ child_sale_type
  • Number
  • 可选
  • 3
  • 儿童价计算方法:选1/2/3/4/5/6中一个,不填默认1: 1:儿童成人同价或Y50取低且使用儿童税费 2:儿童成人同价同税 3:儿童自定义价格或Y50取低且使用儿童税费 4:儿童不可销售 5:儿童成人同价同税或Y50且使用儿童税费取低 6:儿童成人同价使用儿童税费
  • └ child_fixed_price
  • Number
  • 可选
  • 100
  • 儿童票面价,单位:分,当计算方式是3时生效,票面价必须为整数,且如果大于成人票面价,此政策无效
  • └ baggage
  • Number
  • 可选
  • 1
  • 行李有无:null-以平台行李额为准,0-以平台行李额为准,1-无免费托运行李额,2-有免费托运行李额;
  • └ bidd_fee
  • Number
  • 可选
  • 1000
  • 固定金额竞价空间,单位分,非必填,非负。录入的数值即为竞价阈值。当固定金额和百分比竞价空间同时有值时,取两者之和做为实际的竞价阈值
  • └ bidd_fee_percent
  • Number
  • 可选
  • 1000
  • 百分比竞价空间,单位分,如传100表示为1%,非必填,支持录入0~100%,根据票面价*百分比竞价空间计算竞价阈值,向下进位到小数点后两位。当固定金额和百分比竞价空间同时有值时,取两者之和做为实际的竞价阈值。
  • └ out_price
  • Number
  • 可选
  • 100
  • 去程票面价 单位:分
  • └ back_price
  • Number
  • 可选
  • 100
  • 回程票面价 单位:分
  • sale
  • SaleDto
  • 可选
  • 销售信息
  • └ advance_day
  • String
  • 可选
  • 5-10
  • 提前预定天数
  • sale_date
  • DatePairDto []
  • 必须
  • 销售日期
  • └ end
  • Date
  • 可选
  • 2022-09-28 10:10:10
  • 销售截止日期
  • └ start
  • Date
  • 可选
  • 2022-09-18 10:10:10
  • 销售起始日期
  • └ sale_time
  • String
  • 可选
  • 0606-0707,0808-0909
  • 销售时间
  • └ stay_day
  • String
  • 可选
  • 5
  • 往返停留时长:往返航班之间的停留时长,非必填,为空表示不限制;支持格式:A-B或者A,B>A且均为整数;A-B包含边界值
  • └ sale_mode_code
  • Number
  • 可选
  • 0
  • 销售方式:0,无;1,打包销售套餐1;2,打包销售套餐2;3,打包销售套餐3;4,返现-航司运价;5,返现-销售方包装;6,花呗卖家版;
  • └ goods_market
  • String []
  • 可选
  • [0,1]
  • 0-B2C, 1-B2B, 2-B2G, 3-宝贝。单选,为空表示不限制
  • └ stay_time_unit
  • Number
  • 可选
  • 0
  • 往返停留时长单位:非必填,0-单位:天,3-单位:小时;默认为0
  • └ use_product_model
  • Number
  • 可选
  • 0
  • 是否使用产品码模式: 0,否;1,是
  • └ supply_product_code
  • String []
  • 可选
  • ["ABCD"]
  • “是否使用产品码模式”为是时,此字段必填,具体可投放的产品码可在后台政策页面中查看或咨询运营,仅支持单个
  • └ status
  • Number
  • 必须
  • 1
  • 政策状态:1,有效;2,挂起;0,删除 3,停用
  • └ account_code
  • String
  • 可选
  • 1223
  • 大客户编码
  • └ code_share
  • Number
  • 可选
  • 1
  • 是否共享航班:0,不支持代码共享;1,支持代码共享;2,仅支持代码共享
  • └ code_share_airline
  • String
  • 可选
  • CA
  • 共享航班号码
  • passenger
  • PassengerDto
  • 可选
  • 乘客限制
  • └ documents_type
  • String []
  • 可选
  • 1
  • 证件类型:产品类型为4时,不能为空,仅支持1-身份证。产品类型为其他值时,允许为空。
  • └ documents_limit
  • String
  • 可选
  • 41
  • 证件限制:产品类型为4时,不能为空,可输入身份证号前2位/4位数字,最多可输入10组,多个用英文”,”分隔。产品类型为0或证件类型为空时,必须为空。产品类型为其他值且证件类型非空时允许为空。
  • └ product_code
  • Number
  • 可选
  • 1
  • 产品类型:0,普通;1,学生;2,青年;3,老年;4,地区;5,小团;6,学生认证票;8,会员
  • └ age_limit
  • String
  • 可选
  • 15-24
  • 年龄限制:产品类型为2或3时,不能为空,格式:20-60,表示20-60岁;20表示只限制20岁;55-,表示55岁以上。产品类型为1时允许填写的年龄范围[9,30],产品类型为2时允许填写的年龄范围[9,41],产品类型为3时允许填写的年龄范围[50,100]。产品类型为0时,必须为空。产品类型为其他值时,允许为空,年龄范围[9,100]。
  • └ pax_num
  • String
  • 可选
  • 1-3
  • 人数限制:产品类型为5时,不能为空,允许填写人数范围[1,9],格式:2,表示只适用于两人同行;2-3,表示只适用于2~3人同行。产品类型为0或6时,必须为空。产品类型为其他值时,允许为空。
  • └ fare_price
  • Number
  • 可选
  • 130
  • 指定票面价,单位为元
  • └ fare_basis
  • String
  • 可选
  • A1B2
  • 用于匹配平台退改,如果填写,则只能填写精确的farebasis,不得带通配符;匹配不到,走平台默认退改
  • └ memo
  • String
  • 可选
  • 注意事项
  • 政策备注
  • └ create_pnr_limit
  • Number
  • 可选
  • 5
  • 外放舱位数量小于等于阈值时订位或停售
  • └ transit_airport
  • String
  • 可选
  • HGH
  • 中转点
  • └ direct_transfer_type
  • Number
  • 可选
  • 0
  • 0,直达;1,中转;默认为0
  • └ price_type
  • Number
  • 可选
  • 0
  • 0-往返两程总价, 1-去回程分别定价, 默认为0
  • └ is_ow_eoe
  • Boolean
  • 可选
  • true
  • 是否中转运价.true:是,false:否
  • └ before_combine_airline
  • String
  • 可选
  • CA,MF
  • 前段可衔接航司
  • └ next_combine_airline
  • String
  • 可选
  • CA,MF
  • 后段可衔接航司
  • └ next_combine_city
  • String
  • 可选
  • PEK,HGH
  • 后段可衔接城市(","拼接)
  • └ before_combine_city
  • String
  • 可选
  • PEK,HGH
  • 前段可衔接城市(","拼接)
  • └ urgent_stop_sell
  • Number
  • 可选
  • 0
  • 是否紧张停售 0否 ;1是
  • └ policy_type
  • String
  • 必须
  • T
  • 政策类型:P,普通政策;T,特殊政策;G,规则政策;
  • └ trip_type
  • Number
  • 必须
  • 0
  • 行程类型标记:0,单程;1,往返
  • └ agent_send_time
  • Date
  • 可选
  • 2021-09-28 10:10:10
  • 商家传入时间

响应参数

名称 类型 示例值 描述
result Result 异步获取历史数据接口返回结果
  • data
  • PolicyCreateResponseDto
  • 创建&删除结果参数
  • create_result
  • ResultDto
  • 创建结果
  • └ data
  • Number
  • 1
  • 任务id
  • └ error_code
  • String
  • 1
  • 任务失败错误码
  • └ error_msg
  • String
  • XX异常
  • 任务失败错误原因
  • └ success
  • Boolean
  • true
  • 是否成功
  • delete_result
  • ResultDto
  • 删除结果
  • └ data
  • Number
  • 1
  • 任务id
  • └ error_code
  • String
  • 1
  • 任务失败错误码
  • └ error_msg
  • String
  • XX异常
  • 任务失败错误原因
  • └ success
  • Boolean
  • true
  • 是否成功
  • └ error_code
  • String
  • 1
  • 错误码
  • └ error_msg
  • String
  • XX异常
  • 错误原因
  • └ success
  • Boolean
  • true
  • 执行结果

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripPolicySpecialUploadRequest req = new AlitripPolicySpecialUploadRequest();
AlitripPolicySpecialUploadRequest.PolicyCreateRequestDto obj1 = new AlitripPolicySpecialUploadRequest.PolicyCreateRequestDto();
obj1.setAgentId(2052L);
List<AlitripPolicySpecialUploadRequest.PolicyQueryParamDTO> list3 = new ArrayList<AlitripPolicySpecialUploadRequest.PolicyQueryParamDTO>();
AlitripPolicySpecialUploadRequest.PolicyQueryParamDTO obj4 = new AlitripPolicySpecialUploadRequest.PolicyQueryParamDTO();
list3.add(obj4);
obj4.setAccountCode("1001");
obj4.setAirline("CA");
obj4.setArrAirport("PEK");
obj4.setCabinList1("M1");
obj4.setCabinList2("M1");
obj4.setDepAirport("PEK");
obj4.setFuzzyQuery(true);
obj4.setPolicyCode("123");
obj4.setPolicySource(1L);
obj4.setSaleStartDate(StringUtils.parseDateTime("2022-09-18 10:10:10"));
obj4.setSalesEndDate(StringUtils.parseDateTime("2022-09-28 10:10:10"));
obj4.setStatus(1L);
obj4.setTravelEndDate(StringUtils.parseDateTime("2023-09-28 10:10:10"));
obj4.setTravelStartDate(StringUtils.parseDateTime("2023-09-18 10:10:10"));
obj4.setIsOwEoe(true);
obj1.setDeletePolicy(list3);
obj1.setExecType("ADD");
List<AlitripPolicySpecialUploadRequest.PolicyDto> list6 = new ArrayList<AlitripPolicySpecialUploadRequest.PolicyDto>();
AlitripPolicySpecialUploadRequest.PolicyDto obj7 = new AlitripPolicySpecialUploadRequest.PolicyDto();
list6.add(obj7);
obj7.setAirline("CA");
obj7.setArrAirport("PEK");
obj7.setCreatePnr(1L);
obj7.setDepAirport("PEK");
List<AlitripPolicySpecialUploadRequest.FlightDTO> list10 = new ArrayList<AlitripPolicySpecialUploadRequest.FlightDTO>();
AlitripPolicySpecialUploadRequest.FlightDTO obj11 = new AlitripPolicySpecialUploadRequest.FlightDTO();
list10.add(obj11);
obj11.setAllowFlightNum("1111-2222,3333");
List<AlitripPolicySpecialUploadRequest.DatePairDto> list14 = new ArrayList<AlitripPolicySpecialUploadRequest.DatePairDto>();
AlitripPolicySpecialUploadRequest.DatePairDto obj15 = new AlitripPolicySpecialUploadRequest.DatePairDto();
list14.add(obj15);
obj15.setEnd(StringUtils.parseDateTime("2023-09-28 10:10:10"));
obj15.setStart(StringUtils.parseDateTime("2023-09-18 10:10:10"));
list12.setAllowTravelDate(list14);
obj11.setAllowTravelTime("0606-0707,0808-0909");
obj11.setCabin("M1");
obj11.setCabinClass("Y");
obj11.setDayWeek("1,2,3");
obj11.setFlightIndex(0L);
obj11.setRestrictFlightNum("1111-2222,3333");
List<AlitripPolicySpecialUploadRequest.DatePairDto> list18 = new ArrayList<AlitripPolicySpecialUploadRequest.DatePairDto>();
AlitripPolicySpecialUploadRequest.DatePairDto obj19 = new AlitripPolicySpecialUploadRequest.DatePairDto();
list18.add(obj19);
obj19.setEnd(StringUtils.parseDateTime("2022-09-28 10:10:10"));
obj19.setStart(StringUtils.parseDateTime("2022-09-18 10:10:10"));
list16.setRestrictTravelDate(list18);
obj11.setAllowFlightNum2("8888");
obj11.setRestrictFlightNum2("8888");
list8.setFlights(list10);
obj7.setOfficeNo("123");
obj7.setPata(1L);
obj7.setPolicyCode("1234");
obj7.setPolicySource(1L);
AlitripPolicySpecialUploadRequest.PriceDto obj21 = new AlitripPolicySpecialUploadRequest.PriceDto();
obj21.setCommission(10L);
obj21.setReturnPrice(100L);
obj21.setLowestPrice(100L);
obj21.setChildSaleType(3L);
obj21.setChildFixedPrice(100L);
obj21.setBaggage(1L);
obj21.setBiddFee(1000L);
obj21.setBiddFeePercent(1000L);
obj21.setOutPrice(100L);
obj21.setBackPrice(100L);
list20.setPrice(obj21);
AlitripPolicySpecialUploadRequest.SaleDto obj23 = new AlitripPolicySpecialUploadRequest.SaleDto();
obj23.setAdvanceDay("5-10");
List<AlitripPolicySpecialUploadRequest.DatePairDto> list25 = new ArrayList<AlitripPolicySpecialUploadRequest.DatePairDto>();
AlitripPolicySpecialUploadRequest.DatePairDto obj26 = new AlitripPolicySpecialUploadRequest.DatePairDto();
list25.add(obj26);
obj26.setEnd(StringUtils.parseDateTime("2022-09-28 10:10:10"));
obj26.setStart(StringUtils.parseDateTime("2022-09-18 10:10:10"));
obj23.setSaleDate(list25);
obj23.setSaleTime("0606-0707,0808-0909");
obj23.setStayDay("5");
obj23.setSaleModeCode(0L);
obj23.setGoodsMarket("0,1");
obj23.setStayTimeUnit(0L);
obj23.setUseProductModel(0L);
obj23.setSupplyProductCode(""ABCD"");
list22.setSale(obj23);
obj7.setStatus(1L);
obj7.setAccountCode("1223");
obj7.setCodeShare(1L);
obj7.setCodeShareAirline("CA");
AlitripPolicySpecialUploadRequest.PassengerDto obj28 = new AlitripPolicySpecialUploadRequest.PassengerDto();
obj28.setDocumentsType("1");
obj28.setDocumentsLimit("41");
obj28.setProductCode(1L);
obj28.setAgeLimit("15-24");
obj28.setPaxNum("1-3");
list27.setPassenger(obj28);
obj7.setFarePrice(130L);
obj7.setFareBasis("A1B2");
obj7.setMemo("注意事项");
obj7.setCreatePnrLimit(5L);
obj7.setTransitAirport("HGH");
obj7.setDirectTransferType(0L);
obj7.setPriceType(0L);
obj7.setIsOwEoe(true);
obj7.setBeforeCombineAirline("CA,MF");
obj7.setNextCombineAirline("CA,MF");
obj7.setNextCombineCity("PEK,HGH");
obj7.setBeforeCombineCity("PEK,HGH");
obj7.setUrgentStopSell(0L);
obj1.setPolicyList(list6);
obj1.setPolicyType("T");
obj1.setTripType(0L);
obj1.setAgentSendTime(StringUtils.parseDateTime("2021-09-28 10:10:10"));
req.setParamPolicyCreateRequestDTO(obj1);
AlitripPolicySpecialUploadResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alitrip_policy_special_upload_response>
    <result>
        <data>
            <create_result>
                <data>1</data>
                <error_code>1</error_code>
                <error_msg>XX异常</error_msg>
                <success>true</success>
            </create_result>
            <delete_result>
                <data>1</data>
                <error_code>1</error_code>
                <error_msg>XX异常</error_msg>
                <success>true</success>
            </delete_result>
        </data>
        <error_code>1</error_code>
        <error_msg>XX异常</error_msg>
        <success>true</success>
    </result>
</alitrip_policy_special_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>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部