alitrip.policy.rule.upload (规则政策上传)

上传规则类型的单程/往返政策

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param_policy_create_request_d_t_o PolicyCreateRequestDto 必须 普通政策上传参数
  • └ agent_id
  • Number
  • 必须
  • 2052
  • 店铺id
  • delete_policy
  • PolicyQueryParamDTO []
  • 可选
  • 删除政策查询参数,execType必须为ADD
  • └ account_code
  • String
  • 可选
  • PAT:A#CABC123
  • 大客户编码,请输入包含PAT在内的完整格式。
  • └ airline
  • String
  • 可选
  • CA
  • 航司二字码
  • └ arr_airport
  • String
  • 可选
  • PEK
  • 到达机场三字码
  • └ cabin_list1
  • String
  • 可选
  • M1
  • 去程舱位
  • └ cabin_list2
  • String
  • 可选
  • M1
  • 回程舱位
  • └ dep_airport
  • String
  • 可选
  • PVG
  • 出发机场三字码
  • └ fuzzy_query
  • Boolean
  • 可选
  • true
  • 根据政策编码模糊查询,模糊查询执行like,暂不支持前缀索引
  • └ policy_code
  • String
  • 必须
  • 123
  • 政策编码
  • └ policy_source
  • Number
  • 可选
  • 1
  • 政策来源:0,手工政策;1,excel政策;2,api政策
  • └ sale_start_date
  • Date
  • 可选
  • 2022-09-08 10:10:10
  • 销售起始日期,不需要传时分秒
  • └ sales_end_date
  • Date
  • 可选
  • 2022-09-18 10:10:10
  • 销售截止日期,不需要传时分秒
  • └ status
  • Number
  • 可选
  • 1
  • 政策状态:1,有效;2,挂起;0,删除 3,停用
  • └ travel_end_date
  • Date
  • 可选
  • 2022-10-18 10:10:10
  • 行程截止日期,不需要传时分秒
  • └ travel_start_date
  • Date
  • 可选
  • 2022-09-28 10:10:10
  • 行程起始日期,不需要传时分秒
  • └ exec_type
  • String
  • 必须
  • ADD
  • 操作类型(增量/全量),ADD上传不会删除历史政策,FULL上传会删除所有历史政策,请谨慎使用
  • policy_list
  • PolicyDto []
  • 可选
  • 需要导入的政策列表
  • └ airline
  • String
  • 可选
  • CA
  • 航司二字码
  • └ arr_airport
  • String
  • 可选
  • PEK
  • 到达机场三字码,不填代表不限,不要填ALL
  • └ create_pnr
  • Number
  • 可选
  • 1
  • 是否订位:0,平台不订位;1,平台订位;2,紧张订位;
  • └ dep_airport
  • String
  • 可选
  • PVG
  • 出发机场三字码,不填代表不限,不要填ALL
  • flights
  • FlightDTO []
  • 可选
  • 行程信息
  • └ allow_flight_num
  • String
  • 可选
  • 1111-2222,3333
  • 允许航班号,支持录入多个航班与航班范围,范围之间用“-”链接,多个用英文”,”分隔。最多支持8000字符
  • allow_travel_date
  • DatePairDto []
  • 必须
  • 允许航班日期
  • └ end
  • Date
  • 可选
  • 2023-09-28 10:10:10
  • 允许航班截止日期,无需传入时分秒
  • └ start
  • Date
  • 可选
  • 2022-09-28 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
  • 可选
  • 1
  • 行程类型标记(单程/往返)
  • └ restrict_flight_num
  • String
  • 可选
  • 1111-2222,3333
  • 禁止航班号
  • restrict_travel_date
  • DatePairDto []
  • 可选
  • 禁止航班日期
  • └ end
  • Date
  • 可选
  • 2021-09-28 10:10:10
  • 禁止航班截止日期,无需传时分秒
  • └ start
  • Date
  • 可选
  • 2021-09-18 10:10:10
  • 禁止航班起始日期,无需传时分秒
  • └ office_no
  • String
  • 可选
  • HGH171
  • 商家配置号
  • └ pata
  • Number
  • 可选
  • 1
  • pata:0,不验价;1,验价
  • └ policy_code
  • String
  • 可选
  • 1234
  • 政策编码
  • └ policy_source
  • Number
  • 可选
  • 1
  • 政策来源:0,手工政策;1,excel政策;2,api政策
  • price
  • PriceDto
  • 可选
  • 价格信息栏
  • └ commission
  • Number
  • 必须
  • 10
  • 返点,单位分,如传100表示返点为1%。支持正负数
  • └ return_price
  • Number
  • 必须
  • 100
  • 返点,单位分,如传100表示返点为1%。支持正负数
  • └ lowest_price
  • Number
  • 可选
  • 100
  • 最低票面价,单位为分
  • └ carry_rule
  • Number
  • 必须
  • 1
  • 进位规则:1,进到十位;2,四舍五入到十位;3,四舍五入到个位;4,三舍四入到十位
  • └ cal_fare_method
  • Number
  • 必须
  • 1
  • 票面价计算方式:1,票面价减比例;2,标准价减比例;3,票面价减Y舱比例;4,直减金额;5,票面价原价;6,最低外放舱位减比例;7,最低外放舱位减Y舱比例;8,指定舱位减比例;9,指定舱位减Y舱比例,10,标准价折扣减比例;11,按航司旗舰店最低价;12,按指定舱位旗舰店价格;13,按指定舱位官网代购价格;14,按官网代购最低价;15,按旗舰店接口和官网代购最低价;16,指定FareBasis减比例;17,指定金额;20,指定farebasis原价;21,指定星花码原价
  • flight_price_values
  • FlightPriceDto []
  • 可选
  • 票面价计算属性
  • └ down_fare
  • Number
  • 可选
  • 1
  • 直减金额,单位分
  • └ down_percent
  • Number
  • 可选
  • 1
  • 直减比例
  • └ validate_cabin
  • Number
  • 可选
  • 1
  • 验舱:0,不验舱;1,验舱
  • └ fare_cabin
  • String
  • 可选
  • A1
  • 指定舱位
  • └ flight_index
  • Number
  • 可选
  • 0
  • 行程类型标记:0,单程;1,往返
  • └ match_fare_basis
  • String
  • 可选
  • P/CA6Z220046
  • 指定的fareBasis
  • └ sc_code
  • String
  • 可选
  • XH
  • 星花码
  • └ min_price_limit
  • Number
  • 可选
  • 100
  • 最小票面价,单位:元
  • └ max_price_limit
  • Number
  • 可选
  • 200
  • 最大票面价,单位:元
  • └ child_sale_type
  • Number
  • 可选
  • 3
  • 儿童价计算方法:选1/2/3/4/5/6/7中一个,不填默认1: 1:儿童成人同价或Y50取低且使用儿童税费 2:儿童成人同价同税 3:儿童自定义价格或Y50取低且使用儿童税费 4:儿童不可销售(仅学生,青年,老年票,小团,学生认证票允许选择) 5:儿童成人同价同税或Y50且使用儿童税费取低 6:儿童成人同价且使用儿童税费 7:使用基准运价FD/NFD/IBE+对应的儿童价格
  • └ 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%,根据票面价*百分比竞价空间计算竞价阈值,向下进位到小数点后两位。当固定金额和百分比竞价空间同时有值时,取两者之和做为实际的竞价阈值。
  • sale
  • SaleDto
  • 可选
  • 销售信息
  • └ advance_day
  • String
  • 可选
  • 5-10
  • 提前预定天数
  • sale_date
  • DatePairDto []
  • 必须
  • 销售日期
  • └ end
  • Date
  • 可选
  • 2022-09-18 10:10:10
  • 销售截止日期
  • └ start
  • Date
  • 可选
  • 2022-09-08 10:10:10
  • 销售起始日期
  • └ sale_time
  • String
  • 可选
  • 0606-0707,0808-0909
  • 销售时间
  • └ stay_day
  • String
  • 可选
  • 5-10
  • 往返停留时长:往返航班之间的停留时长,非必填,为空表示不限制;支持格式: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
  • 可选
  • PAT:A#CABC123
  • 大客户编码,请输入包含PAT在内的完整格式。
  • └ 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_basis
  • String
  • 可选
  • A1B2
  • 用于匹配平台退改,如果填写,则只能填写精确的farebasis,不得带通配符;匹配不到,走平台默认退改
  • └ fare_source
  • String []
  • 可选
  • 1,2
  • 运价类型:0,FD;1,NFD;2,特殊运价;5,IBE;11,B2T;12,旗舰店;13,官网;14,大卖家
  • └ memo
  • String
  • 可选
  • 注意事项
  • 政策备注
  • └ not_appl_od
  • String []
  • 可选
  • ["KKK-*","*-KKK","KKK-LLL"]
  • 排除航线:格式为:KKK-*,*-KKK,KKK-XXX三种格式;三字码,大写;*表示全部;最多允许4000字符;多个请用英文,隔开
  • └ create_pnr_limit
  • Number
  • 可选
  • 5
  • 外放舱位数量小于等于阈值时订位或停售,只有create_pnr=1或urgent_stop_sell的时候有值
  • └ urgent_stop_sell
  • Number
  • 可选
  • 0
  • 是否紧张停售 0:否 1:是
  • └ fare_category
  • Number
  • 可选
  • 0
  • 运价类型 0普通运价,1星花码运价,2特殊farebasis运价;星花码运价时,票面价算法只能选择21(指定星花码原价),特殊farebasis运价时,票面价算法只能选择20(指定farebasis原价)
  • └ policy_type
  • String
  • 必须
  • G
  • 政策类型:P,普通政策;T,特殊政策;G,规则政策;
  • └ trip_type
  • Number
  • 必须
  • 0
  • 行程类型(单程/往返)
  • └ 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);
AlitripPolicyRuleUploadRequest req = new AlitripPolicyRuleUploadRequest();
AlitripPolicyRuleUploadRequest.PolicyCreateRequestDto obj1 = new AlitripPolicyRuleUploadRequest.PolicyCreateRequestDto();
obj1.setAgentId(2052L);
List<AlitripPolicyRuleUploadRequest.PolicyQueryParamDTO> list3 = new ArrayList<AlitripPolicyRuleUploadRequest.PolicyQueryParamDTO>();
AlitripPolicyRuleUploadRequest.PolicyQueryParamDTO obj4 = new AlitripPolicyRuleUploadRequest.PolicyQueryParamDTO();
list3.add(obj4);
obj4.setAccountCode("PAT:A#CABC123");
obj4.setAirline("CA");
obj4.setArrAirport("PEK");
obj4.setCabinList1("M1");
obj4.setCabinList2("M1");
obj4.setDepAirport("PVG");
obj4.setFuzzyQuery(true);
obj4.setPolicyCode("123");
obj4.setPolicySource(1L);
obj4.setSaleStartDate(StringUtils.parseDateTime("2022-09-08 10:10:10"));
obj4.setSalesEndDate(StringUtils.parseDateTime("2022-09-18 10:10:10"));
obj4.setStatus(1L);
obj4.setTravelEndDate(StringUtils.parseDateTime("2022-10-18 10:10:10"));
obj4.setTravelStartDate(StringUtils.parseDateTime("2022-09-28 10:10:10"));
obj1.setDeletePolicy(list3);
obj1.setExecType("ADD");
List<AlitripPolicyRuleUploadRequest.PolicyDto> list6 = new ArrayList<AlitripPolicyRuleUploadRequest.PolicyDto>();
AlitripPolicyRuleUploadRequest.PolicyDto obj7 = new AlitripPolicyRuleUploadRequest.PolicyDto();
list6.add(obj7);
obj7.setAirline("CA");
obj7.setArrAirport("PEK");
obj7.setCreatePnr(1L);
obj7.setDepAirport("PVG");
List<AlitripPolicyRuleUploadRequest.FlightDTO> list10 = new ArrayList<AlitripPolicyRuleUploadRequest.FlightDTO>();
AlitripPolicyRuleUploadRequest.FlightDTO obj11 = new AlitripPolicyRuleUploadRequest.FlightDTO();
list10.add(obj11);
obj11.setAllowFlightNum("1111-2222,3333");
List<AlitripPolicyRuleUploadRequest.DatePairDto> list14 = new ArrayList<AlitripPolicyRuleUploadRequest.DatePairDto>();
AlitripPolicyRuleUploadRequest.DatePairDto obj15 = new AlitripPolicyRuleUploadRequest.DatePairDto();
list14.add(obj15);
obj15.setEnd(StringUtils.parseDateTime("2023-09-28 10:10:10"));
obj15.setStart(StringUtils.parseDateTime("2022-09-28 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(1L);
obj11.setRestrictFlightNum("1111-2222,3333");
List<AlitripPolicyRuleUploadRequest.DatePairDto> list18 = new ArrayList<AlitripPolicyRuleUploadRequest.DatePairDto>();
AlitripPolicyRuleUploadRequest.DatePairDto obj19 = new AlitripPolicyRuleUploadRequest.DatePairDto();
list18.add(obj19);
obj19.setEnd(StringUtils.parseDateTime("2021-09-28 10:10:10"));
obj19.setStart(StringUtils.parseDateTime("2021-09-18 10:10:10"));
list16.setRestrictTravelDate(list18);
list8.setFlights(list10);
obj7.setOfficeNo("HGH171");
obj7.setPata(1L);
obj7.setPolicyCode("1234");
obj7.setPolicySource(1L);
AlitripPolicyRuleUploadRequest.PriceDto obj21 = new AlitripPolicyRuleUploadRequest.PriceDto();
obj21.setCommission(10L);
obj21.setReturnPrice(100L);
obj21.setLowestPrice(100L);
obj21.setCarryRule(1L);
obj21.setCalFareMethod(1L);
List<AlitripPolicyRuleUploadRequest.FlightPriceDto> list23 = new ArrayList<AlitripPolicyRuleUploadRequest.FlightPriceDto>();
AlitripPolicyRuleUploadRequest.FlightPriceDto obj24 = new AlitripPolicyRuleUploadRequest.FlightPriceDto();
list23.add(obj24);
obj24.setDownFare(1L);
obj24.setDownPercent(1L);
obj24.setValidateCabin(1L);
obj24.setFareCabin("A1");
obj24.setFlightIndex(0L);
obj24.setMatchFareBasis("P/CA6Z220046");
obj24.setScCode("XH");
obj21.setFlightPriceValues(list23);
obj21.setMinPriceLimit(100L);
obj21.setMaxPriceLimit(200L);
obj21.setChildSaleType(3L);
obj21.setChildFixedPrice(100L);
obj21.setBaggage(1L);
obj21.setBiddFee(1000L);
obj21.setBiddFeePercent(1000L);
list20.setPrice(obj21);
AlitripPolicyRuleUploadRequest.SaleDto obj26 = new AlitripPolicyRuleUploadRequest.SaleDto();
obj26.setAdvanceDay("5-10");
List<AlitripPolicyRuleUploadRequest.DatePairDto> list28 = new ArrayList<AlitripPolicyRuleUploadRequest.DatePairDto>();
AlitripPolicyRuleUploadRequest.DatePairDto obj29 = new AlitripPolicyRuleUploadRequest.DatePairDto();
list28.add(obj29);
obj29.setEnd(StringUtils.parseDateTime("2022-09-18 10:10:10"));
obj29.setStart(StringUtils.parseDateTime("2022-09-08 10:10:10"));
obj26.setSaleDate(list28);
obj26.setSaleTime("0606-0707,0808-0909");
obj26.setStayDay("5-10");
obj26.setSaleModeCode(0L);
obj26.setGoodsMarket("0,1");
obj26.setStayTimeUnit(0L);
obj26.setUseProductModel(0L);
obj26.setSupplyProductCode(""ABCD"");
list25.setSale(obj26);
obj7.setStatus(1L);
obj7.setAccountCode("PAT:A#CABC123");
obj7.setCodeShare(1L);
obj7.setCodeShareAirline("CA");
AlitripPolicyRuleUploadRequest.PassengerDto obj31 = new AlitripPolicyRuleUploadRequest.PassengerDto();
obj31.setDocumentsType("1");
obj31.setDocumentsLimit("41");
obj31.setProductCode(1L);
obj31.setAgeLimit("15-24");
obj31.setPaxNum("1-3");
list30.setPassenger(obj31);
obj7.setFareBasis("A1B2");
obj7.setFareSource("1,2");
obj7.setMemo("注意事项");
obj7.setNotApplOd(""KKK-*","*-KKK","KKK-LLL"");
obj7.setCreatePnrLimit(5L);
obj7.setUrgentStopSell(0L);
obj7.setFareCategory(0L);
obj1.setPolicyList(list6);
obj1.setPolicyType("G");
obj1.setTripType(0L);
obj1.setAgentSendTime(StringUtils.parseDateTime("2021-09-28 10:10:10"));
req.setParamPolicyCreateRequestDTO(obj1);
AlitripPolicyRuleUploadResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alitrip_policy_rule_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_rule_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

返回
顶部