alitrip.policy.normal.upload (普通政策上传)

上传普通类型的单程/往返政策

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param_policy_create_request_d_t_o PolicyCreateRequestDto 必须 普通政策上传参数
  • └ agent_id
  • Number
  • 必须
  • 2052
  • 店铺id
  • delete_policy
  • PolicyQueryParamDTO []
  • 可选
  • 全量上传时,删除政策查询参数
  • └ airline
  • String
  • 可选
  • CA
  • 航司二字码
  • └ arr_airport
  • String
  • 可选
  • PEK
  • 到达机场三字码
  • └ cabin_list1
  • String
  • 可选
  • M1
  • 去程舱位
  • └ cabin_list2
  • String
  • 可选
  • M1
  • 回程舱位
  • └ dep_airport
  • String
  • 可选
  • PVG
  • 出发机场三字码
  • └ fuzzy_query
  • Boolean
  • 可选
  • false
  • 根据政策编码模糊查询,模糊查询执行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
  • 可选
  • 2023-09-28 10:10:10
  • 行程截止日期,不需要传时分秒
  • └ travel_start_date
  • Date
  • 可选
  • 2023-09-08 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
  • 可选
  • 2023-09-08 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
  • 行程类型标记:0,单程;1,往返
  • └ restrict_flight_num
  • String
  • 可选
  • 1111-2222,3333
  • 禁止航班号
  • restrict_travel_date
  • DatePairDto []
  • 可选
  • 禁止航班日期
  • └ end
  • Date
  • 可选
  • 2021-09-28 10:10:10
  • 禁止航班截止日期,无需传时分秒
  • └ start
  • Date
  • 可选
  • 2021-09-08 10:10:10
  • 禁止航班起始日期,无需传时分秒
  • └ allow_flight_num2
  • String
  • 可选
  • 8888
  • 第二段可售航班号
  • └ restrict_flight_num2
  • String
  • 可选
  • 8888
  • 第二段不可售航班号
  • └ office_no
  • String
  • 可选
  • HGH171
  • 商家配置号
  • └ 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%。支持正负数
  • └ min_price_limit
  • Number
  • 可选
  • 100
  • 最小票面价,单位:元
  • └ max_price_limit
  • Number
  • 可选
  • 200
  • 最大票面价,单位:元
  • └ 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,停用
  • └ is_white
  • Number
  • 可选
  • 0
  • 0-白名单,航班舱位命中填写的去程/回程舱位,则可以使用本条政策;1-黑名单,航班舱位命中填写的去程/回程舱位,则不可以使用本条政策;默认为0-白名单。
  • └ memo
  • String
  • 可选
  • 注意事项
  • 政策备注
  • └ not_appl_od
  • String []
  • 可选
  • ["KKK-*","*-KKK","KKK-LLL"]
  • 排除航线:格式为:KKK-*,*-KKK,KKK-XXX三种格式;三字码,大写;*表示全部;最多允许4000字符;多个请用英文,隔开
  • └ pata
  • Number
  • 可选
  • 1
  • 是否验价:0,不验价;1,验价
  • └ code_share
  • Number
  • 可选
  • 0
  • 共享航班:0,不支持代码共享;1,支持代码共享;2,仅支持代码共享
  • └ code_share_airline
  • String
  • 可选
  • HU,AU
  • 字符;最多200;可输入多个航司二字码,英文逗号分隔;航司二字码
  • └ direct_transfer_type
  • Number
  • 可选
  • 0
  • 直达中转:0,直达;1,中转;默认为0
  • └ out_main_flight
  • Boolean
  • 可选
  • true
  • 是否支持共享出主飞;是:true,否:false
  • └ fare_source
  • String []
  • 可选
  • [0,1]
  • 运价渠道 0:FD 1:NFD 5:IBE 12:旗舰店
  • └ urgent_stop_sell
  • Number
  • 可选
  • 0
  • 是否紧张停售 0:否 1:是
  • └ create_pnr_limit
  • Number
  • 可选
  • 1
  • 外放舱位数量小于等于阈值时订位或停售,只有create_pnr=1或urgent_stop_sell的时候有值
  • └ policy_type
  • String
  • 必须
  • P
  • 政策类型:P,普通政策;1,特殊政策;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);
AlitripPolicyNormalUploadRequest req = new AlitripPolicyNormalUploadRequest();
AlitripPolicyNormalUploadRequest.PolicyCreateRequestDto obj1 = new AlitripPolicyNormalUploadRequest.PolicyCreateRequestDto();
obj1.setAgentId(2052L);
List<AlitripPolicyNormalUploadRequest.PolicyQueryParamDTO> list3 = new ArrayList<AlitripPolicyNormalUploadRequest.PolicyQueryParamDTO>();
AlitripPolicyNormalUploadRequest.PolicyQueryParamDTO obj4 = new AlitripPolicyNormalUploadRequest.PolicyQueryParamDTO();
list3.add(obj4);
obj4.setAirline("CA");
obj4.setArrAirport("PEK");
obj4.setCabinList1("M1");
obj4.setCabinList2("M1");
obj4.setDepAirport("PVG");
obj4.setFuzzyQuery(false);
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("2023-09-28 10:10:10"));
obj4.setTravelStartDate(StringUtils.parseDateTime("2023-09-08 10:10:10"));
obj1.setDeletePolicy(list3);
obj1.setExecType("ADD");
List<AlitripPolicyNormalUploadRequest.PolicyDto> list6 = new ArrayList<AlitripPolicyNormalUploadRequest.PolicyDto>();
AlitripPolicyNormalUploadRequest.PolicyDto obj7 = new AlitripPolicyNormalUploadRequest.PolicyDto();
list6.add(obj7);
obj7.setAirline("CA");
obj7.setArrAirport("PEK");
obj7.setCreatePnr(1L);
obj7.setDepAirport("PVG");
List<AlitripPolicyNormalUploadRequest.FlightDTO> list10 = new ArrayList<AlitripPolicyNormalUploadRequest.FlightDTO>();
AlitripPolicyNormalUploadRequest.FlightDTO obj11 = new AlitripPolicyNormalUploadRequest.FlightDTO();
list10.add(obj11);
obj11.setAllowFlightNum("1111-2222,3333");
List<AlitripPolicyNormalUploadRequest.DatePairDto> list14 = new ArrayList<AlitripPolicyNormalUploadRequest.DatePairDto>();
AlitripPolicyNormalUploadRequest.DatePairDto obj15 = new AlitripPolicyNormalUploadRequest.DatePairDto();
list14.add(obj15);
obj15.setEnd(StringUtils.parseDateTime("2023-09-28 10:10:10"));
obj15.setStart(StringUtils.parseDateTime("2023-09-08 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<AlitripPolicyNormalUploadRequest.DatePairDto> list18 = new ArrayList<AlitripPolicyNormalUploadRequest.DatePairDto>();
AlitripPolicyNormalUploadRequest.DatePairDto obj19 = new AlitripPolicyNormalUploadRequest.DatePairDto();
list18.add(obj19);
obj19.setEnd(StringUtils.parseDateTime("2021-09-28 10:10:10"));
obj19.setStart(StringUtils.parseDateTime("2021-09-08 10:10:10"));
list16.setRestrictTravelDate(list18);
obj11.setAllowFlightNum2("8888");
obj11.setRestrictFlightNum2("8888");
list8.setFlights(list10);
obj7.setOfficeNo("HGH171");
obj7.setPolicyCode("1234");
obj7.setPolicySource(1L);
AlitripPolicyNormalUploadRequest.PriceDTO obj21 = new AlitripPolicyNormalUploadRequest.PriceDTO();
obj21.setCommission(10L);
obj21.setReturnPrice(100L);
obj21.setMinPriceLimit(100L);
obj21.setMaxPriceLimit(200L);
obj21.setBiddFee(1000L);
obj21.setBiddFeePercent(1000L);
list20.setPrice(obj21);
AlitripPolicyNormalUploadRequest.SaleDTO obj23 = new AlitripPolicyNormalUploadRequest.SaleDTO();
obj23.setAdvanceDay("5-10");
List<AlitripPolicyNormalUploadRequest.DatePairDTO> list25 = new ArrayList<AlitripPolicyNormalUploadRequest.DatePairDTO>();
AlitripPolicyNormalUploadRequest.DatePairDTO obj26 = new AlitripPolicyNormalUploadRequest.DatePairDTO();
list25.add(obj26);
obj26.setEnd(StringUtils.parseDateTime("2022-09-18 10:10:10"));
obj26.setStart(StringUtils.parseDateTime("2022-09-08 10:10:10"));
obj23.setSaleDate(list25);
obj23.setSaleTime("0606-0707,0808-0909");
obj23.setStayDay("5-10");
obj23.setSaleModeCode(0L);
obj23.setGoodsMarket("0,1");
obj23.setStayTimeUnit(0L);
obj23.setUseProductModel(0L);
obj23.setSupplyProductCode(""ABCD"");
list22.setSale(obj23);
obj7.setStatus(1L);
obj7.setIsWhite(0L);
obj7.setMemo("注意事项");
obj7.setNotApplOd(""KKK-*","*-KKK","KKK-LLL"");
obj7.setPata(1L);
obj7.setCodeShare(0L);
obj7.setCodeShareAirline("HU,AU");
obj7.setDirectTransferType(0L);
obj7.setOutMainFlight(true);
obj7.setFareSource("0,1");
obj7.setUrgentStopSell(0L);
obj7.setCreatePnrLimit(1L);
obj1.setPolicyList(list6);
obj1.setPolicyType("P");
obj1.setTripType(0L);
obj1.setAgentSendTime(StringUtils.parseDateTime("2021-09-28 10:10:10"));
req.setParamPolicyCreateRequestDTO(obj1);
AlitripPolicyNormalUploadResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alitrip_policy_normal_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_normal_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

返回
顶部