文档中心 > API类目 > 国际机票政策API

taobao.alitrip.it.policy.update (【国际机票销售规则】单条更新)

销售规则更新接口,可以根据taobaoId或outId修改,outId不唯一时,不能用outId修改。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
extend_attributes String 可选 {} 扩展字段
out_id String 可选 123 接入方产品id
taobao_id Number 可选 123 淘宝政策id
top_policy_do TopPolicyDo 可选 国际机票销售规则
  • └ policy_id
  • String
  • 可选
  • CA12345
  • 产品编号,内容可空,支持字母和数字,最多50个字符
  • └ rt_commission_formula
  • String
  • 可选
  • 各取各
  • 1/2RT计算方式,空:表示取严,可录入各取各或者取严,表示1/2RT佣金计算方式是各取各或者取严。
  • └ airline
  • String
  • 必须
  • CA
  • 航空公司,航空公司两字码,如CA
  • └ transfer_type
  • String
  • 可选
  • 中转
  • 中转类型(是否直达),空:表示不限,即直达中转都适用,可选:直达、中转
  • └ travel_type
  • String
  • 可选
  • 单程
  • 航程种类,可选:单程、往返、空为不限
  • └ dep_cities
  • String
  • 可选
  • SHA,NYC
  • 始发地,空表示所有航线都适用可录入格式:1) 城市三代如SHA,NYC,SEL2) 国家二代如CN,US,KR3) TC区代码如TC1,TC2,TC34) 为空表示不限制允许1.2.3. 混合录入,可录入多个用,隔开表示多个最多允许录入100个多个用,分隔.可输入单个区域和多个城市,支持区域和城市同时输入,以自定义区域表为准,输入自定义名称,系统存入对应城市三字码集合最多输入100个城市
  • └ arr_cities
  • String
  • 可选
  • SHA,NYC
  • 目的地,空表示所有航线都适用可录入格式:1) 城市三代如SHA,NYC,SEL2) 国家二代如CN,US,KR3) TC区代码如TC1,TC2,TC34) 为空表示不限制允许1.2.3. 混合录入,可录入多个用,隔开表示多个最多允许录入100个多个用,分隔.可输入单个区域和多个城市,支持区域和城市同时输入,以自定义区域表为准,输入自定义名称,系统存入对应城市三字码集合最多输入100个城市
  • └ exclude_dep_cities
  • String
  • 可选
  • SHA,NYC
  • 例外始发地,空表示所有航线都适用可录入格式:1) 城市三代如SHA,NYC,SEL2) 国家二代如CN,US,KR3) TC区代码如TC1,TC2,TC34) 为空表示不限制允许1.2.3. 混合录入,可录入多个用,隔开表示多个最多允许录入100个多个用,分隔.可输入单个区域和多个城市,支持区域和城市同时输入,以自定义区域表为准,输入自定义名称,系统存入对应城市三字码集合最多输入100个城市
  • └ exclude_arr_cities
  • String
  • 可选
  • SHA,NYC
  • 例外目的地,空表示所有航线都适用可录入格式:1) 城市三代如SHA,NYC,SEL2) 国家二代如CN,US,KR3) TC区代码如TC1,TC2,TC34) 为空表示不限制允许1.2.3. 混合录入,可录入多个用,隔开表示多个最多允许录入100个多个用,分隔.可输入单个区域和多个城市,支持区域和城市同时输入,以自定义区域表为准,输入自定义名称,系统存入对应城市三字码集合最多输入100个城市
  • └ is_support_rt
  • String
  • 可选
  • 允许
  • 是否允许1/2RT组合销售规则,允许、不允许空表示:不允许
  • └ transfer_cities
  • String
  • 可选
  • SHA
  • 中转点,空表示所有航线都适用可录入格式:1) 城市三代如SHA,NYC,SEL2) 国家二代如CN,US,KR3) TC区代码如TC1,TC2,TC34) 为空表示不限制允许1.2.3. 混合录入,可录入多个用,隔开表示多个最多允许录入100个多个用,分隔.可输入单个区域和多个城市,支持区域和城市同时输入,以自定义区域表为准,输入自定义名称,系统存入对应城市三字码集合最多输入100个城市
  • └ remark
  • String
  • 可选
  • 销售规则备注
  • 备注信息,销售规则备注,最多300个字符
  • └ sale_date
  • String
  • 必须
  • 2013-01-01~2013-02-01
  • 销售日期,必填项;销售日期只能输入一段;日期对为左右都是闭区间格式:可支持2013-01-01或2013/01/01格式输入;范围用~表示
  • └ dep_date
  • String
  • 必须
  • 2013-09-11~2013-10-10
  • 去程旅行日期,必填项;支持添加多对日期多段用,分隔;可支持2013-01-01或2013/01/01格式输入;范围用~表示
  • └ ret_date
  • String
  • 可选
  • 2013-09-11~2013-10-10,2014-09-11~2014-10-10
  • 回程旅行日期,非必填,支持添加多对日期多段用,分隔;可支持2013-01-01或2013/01/01格式输入;范围用~表示
  • └ cabin_restrict_type
  • String
  • 可选
  • 适用
  • 适用/例外舱位,可选:适用、例外,如果舱位有值,则必须输入适用或例外
  • └ cabin_restrict
  • String
  • 可选
  • F,C,Y
  • 舱位,空表示所有舱位都适用多个用,分隔
  • └ service_level
  • String
  • 可选
  • 头等
  • 服务等级,默认值空:表示所有服务等级适用头等公务超值经济经济可多选,用,分隔
  • └ fare_basis_allowed
  • String
  • 可选
  • F%
  • 适用fareBasis,空表示所有都适用支持数字字母组合支持多个,支持通配符%不限制长度的通配符,只 支持首或末位一个%
  • └ fare_basis_forbidden
  • String
  • 可选
  • F%
  • 例外fareBasis,空表示所有都适用支持数字字母组合支持多个,支持通配符%不限制长度的通配符,只 支持首或末位一个%
  • └ flight_restrict
  • String
  • 可选
  • CA123,CA234-999
  • 适用航班,同一航段之间用,隔开表示或的关系;不同航段之间用/隔开。 1 CA001-999,CA3000-3999 表示CA001至999以及3000至3999之间航班号的航班2 MU 表示所有MU开头的航班 3 CA(LH\AZ) 表示CA开头的实际承运人为LH或AZ的航班4 CA(*) 表示CA代码共享航班/CA开头的实际承运人为其他航空公司的航班5 CA(CA) 表示CA自营航班/CA实际承运航班;6 CA(OZ)001-999 表示CA开头航班号为001-999之间且实际承运人为OZ的航班;7 为空表示无限制
  • └ code_sharing_type
  • String
  • 可选
  • 仅限同集团代码共享适用
  • 代码共享适用类型,空:不允许代码共享;可以选值:仅限同集团代码共享适用、代码共享适用、不允许代码共享、
  • └ passenger_type
  • String
  • 可选
  • 普通
  • 成人身份,1.不得为空2.可选:普通/学生 3多个使用,分隔
  • └ fare_source
  • String
  • 可选
  • 平台运价
  • 运价来源,空:表示平台运价; 此处为单选,输入平台运价,表示平台运价,不同的接入方可选值不一样
  • └ fare_type
  • String
  • 可选
  • 文件运价
  • 可适用运价渠道,空:表示都适用 运价来源为:平台运价时,此处选项为:私有运价, 公布运价。以上选项若多个用,分隔
  • └ allow_price_range
  • String
  • 可选
  • 100-1000
  • 价格区间,空表示默认值为0-999999默认为正整型上限必须大于下限
  • └ office_no
  • String
  • 可选
  • OFFICE
  • 预定OFFICE,空表示默认优先级最高OFFICE,可输入OFFICE,校验必须为配置中存在的OFFICE
  • └ sale_retention
  • String
  • 可选
  • 13
  • 返点,可输入负值范围-100至100之间,可保留2位小数与留钱固定金额二选一必输
  • └ sale_rebase
  • String
  • 可选
  • 12
  • 留钱,返点和留钱至少二选一
  • └ child_sale_retention
  • String
  • 可选
  • 1
  • 儿童返点,非必输;可输入负值;范围-100至100之间,可保留2位小数
  • └ child_sale_rebase
  • String
  • 可选
  • 1
  • 儿童留钱,非必输;为整型;支持负数;单位元
  • └ refund_rule
  • String
  • 可选
  • 退票免费
  • 退票规定,非必输长度小于300字符请同时录入 退票规定、改签规定和行李额规定
  • └ reissue_rule
  • String
  • 可选
  • 改期费为票价的30%
  • 改签规定,非必输长度小于300字符请同时录入 退票规定、改签规定和行李额规定
  • └ noshow_rule
  • String
  • 可选
  • 起飞前2小时内取消视作误机, 误机不允许改期不允许退票
  • 误机罚金说明,非必输长度小于300字符只在退票规定不为空时才会生效
  • └ luggage_rule
  • String
  • 可选
  • 普通乘客:2件, 每件23公斤
  • 行李额规定,非必输长度小于300字符。全部未使用可否退票,部分未使用可否退票,去程可否改期,回程可否改期,noshow是否有限制,与行李规定,必须全部为空或全部非空 金牌产品该项必须为空
  • └ buy_ticket_notice
  • String
  • 可选
  • 本产品仅限中国大陆国际的乘客预定; 成功预定和出票赠送机上WIFI券
  • 购票须知,非必输长度小于300字符只在退票规定不为空时才会生效
  • └ product_type
  • String
  • 可选
  • 普通
  • 商品类型,非必输;默认为普通可填写为金牌,普通或极速出票。如果没有相应产品权限,则无法投放
  • └ is_allow_union_airline
  • String
  • 可选
  • 允许
  • 不同航司联运,非必输;可输入允许或不允许,空表示不允许
  • └ channel_id_desc
  • String
  • 可选
  • amadus
  • 渠道名称,非必输,不同的接入方可选值不一样
  • └ extend_attributes
  • String
  • 可选
  • {}
  • 扩展字段,预留
  • └ is_can_all_refund
  • String
  • 可选
  • 全部未使用可否退票,可输入:是,否 。金牌产品该项必须为空
  • └ refund_fee_all_unused
  • String
  • 可选
  • 200-72-10%-48-1000-0-*
  • 【全部未使用可否退票】为是时,此项为必填项。 可输入格式如:200-72-300-48-1000-0-*,表示72小时前退票手续费200;48小时到72小时,退票手续费300;飞机起飞不足48小时;退票手续费1000;飞机起飞后不予改期(输入*); 或 10%-72-30%-48-50%-0-*,表示72小时前退票手续费为票面价的10%;48小时到72小时,退票手续费为票面价的30%;飞机起飞不足48小时;退票手续费为票面价的50%;飞机起飞后不予退票(输入*);
  • └ refund_currency_all_unused
  • String
  • 可选
  • CNY
  • 全部未使用退票币种,只能录入币种三字码,默认值CNY
  • └ refund_fee_type_all_unused
  • String
  • 可选
  • 全程
  • 全部未使用退票费用收取方式,按每个航段收还是全程收(0:全程, 1:每个航段,默认值:全程)
  • └ is_can_part_refund
  • String
  • 可选
  • 部分未使用可否退票,可输入:是,否 。金牌产品该项必须为空
  • └ refund_fee_part_unused
  • String
  • 可选
  • 200-72-10%-48-1000-0-*
  • 部分未使用退票费用,格式同【全部未使用退票费用】,【部分未使用可否退票】为是时,此项为必填项
  • └ refund_currency_part_unused
  • String
  • 可选
  • CNY
  • 部分未使用退票币种,可录入币种三字码,默认值CNY
  • └ refund_fee_type_part_unused
  • String
  • 可选
  • 全程
  • 部分未使用退票费用收取方式,按每个航段收还是全程收(0:全程, 1:每个航段,默认值:全程)
  • └ can_dep_change
  • String
  • 可选
  • 去程可否改期,可输入是或否 。金牌产品该项必须为空
  • └ dep_change_fee
  • String
  • 可选
  • 200-72-300-48-1000-0-*
  • 去程改期费用,格式说明参考【全程未使用退票费用】,注意,改期费用不能录入百分比,【去程可否改期】为是时为必填项
  • └ dep_change_currency
  • String
  • 可选
  • CNY
  • 去程改期币种,可录入币种三字码,默认值CNY
  • └ dep_change_fee_type
  • String
  • 可选
  • 全程
  • 去程改期费用收取方式,按每个航段收还是全程收(0:全程, 1:每个航段,默认值:全程)
  • └ can_ret_change
  • String
  • 可选
  • 回程可否改期,可输入是或否 。金牌产品该项必须为空
  • └ ret_change_fee
  • String
  • 可选
  • 200-72-300-48-1000-0-*
  • 回程改期费用,格式同【去程改期费用】,【回程可否改期】为是时为必填
  • └ ret_change_currency
  • String
  • 可选
  • CNY
  • 回程改期币种,可录入币种三字码,默认值CNY
  • └ ret_change_fee_type
  • String
  • 可选
  • 全程
  • 回程改期费用收取方式,按每个航段收还是全程收(0:全程, 1:每个航段,默认值:全程)
  • └ noshow_restrict
  • String
  • 可选
  • NOSHOW是否有限制,可输入是或否 。金牌产品该项必须为空
  • └ noshow_time_restrict
  • String
  • 可选
  • 10
  • NOSHOW时限,只能录入整数,【NOSHOW是否有限制】为是时,此项为必填项
  • └ noshow_time_restrict_unit
  • String
  • 可选
  • 小时
  • NOSHOW时限单位(小时/天, 默认为小时)
  • └ noshow_rule_type
  • String
  • 可选
  • 不可退票,不可改期
  • NOSHOW规则,可录入多个,多个用逗号分隔。可录入不可退票、不可改期,不可退票,不可改期
  • └ noshow_fee
  • String
  • 可选
  • 3000
  • NOSHOW金额,只能录入整数或百分比,【NOSHOW是否有限制】为是,【NOSHOW规则】不是不可退票,不可改期时,此项为必填项
  • └ noshow_currency
  • String
  • 可选
  • CNY
  • NOSHOW币种,可录入币种三字码,默认值CNY
  • └ vip_code
  • String
  • 可选
  • 123abc
  • 开票大客户编码,最大长度50
  • └ gv2_child_rule
  • String
  • 可选
  • 是否适用小团,可选值是或否
  • └ nationality
  • String
  • 可选
  • CN
  • 国籍限制,可输入国家二字码,多个用逗号分隔,最多不超过20个
  • └ exclude_nationality
  • String
  • 可选
  • CN
  • 除外国籍限制,可输入国家二字码,多个用逗号分隔,最多不超过20个
  • └ passenger_age
  • String
  • 可选
  • 1-99
  • 年龄限制,格式为1-99,1-或者-99
  • └ presale_period
  • String
  • 可选
  • 10
  • 提前销售天数限制
  • └ receipts
  • String
  • 可选
  • 电子行程单
  • 必填项 赋值范围:电子行程单,旅行发票,差额行程单发票,等额行程单
  • └ can_oj
  • String
  • 可选
  • 不支持缺口
  • 是否支持缺口, 赋值范围:不支持缺口,只支持缺口,不限
  • └ default_od_deny
  • String
  • 可选
  • BJS-LAX,TC3-CN
  • 例外航线,默认销售规则, 格式为xxx-xxx,xxx-xxx ,英文逗号分开,区域类型与例外始发地的一致
  • └ airline_code_sharing
  • String
  • 可选
  • KA(CX/CX),CA(CZ)
  • 航司代码共享范围 airline_code_sharing : 格式 KA(CX/CX),CA(CZ) 英文逗号分开,/ 分隔内部,航司二字码表示
  • └ child_change_fee_in_unused
  • String
  • 可选
  • 200-72-300-48-1000-0-*
  • 儿童回程改期费用,格式同成人,【回程可否改期】为是时为必填
  • └ child_change_fee_out_unused
  • String
  • 可选
  • 200-72-300-48-1000-0-*
  • 儿童去程改期费用,格式同成人,格式说明参考【全程未使用退票费用】,注意,改期费用不能录入百分比,【去程可否改期】为是时为必填项
  • └ child_refund_fee_part_unused
  • String
  • 可选
  • 200-72-300-48-1000-0-*
  • 儿童部分未使用退票费用,格式同成人,【部分未使用可否退票】为是时,此项为必填项
  • └ child_refund_fee_all_unused
  • String
  • 可选
  • 200-72-300-48-1000-0-*
  • 儿童全部未使用退票费用,格式同成人,【全部未使用可否退票】为是时,此项为必填项。 可输入格式如:200-72-300-48-1000-0-*,表示72小时前退票手续费200;48小时到72小时,退票手续费300;飞机起飞不足48小时;退票手续费1000;飞机起飞后不予改期(输入*); 或 10%-72-30%-48-50%-0-*,表示72小时前退票手续费为票面价的10%;48小时到72小时,退票手续费为票面价的30%;飞机起飞不足48小时;退票手续费为票面价的50%;飞机起飞后不予退票(输入*);

响应参数

名称 类型 示例值 描述
taobao_id Number 123 淘宝政策id
extend_attributes String {} 扩展字段

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripItPolicyUpdateRequest req = new AlitripItPolicyUpdateRequest();
req.setExtendAttributes("{}");
req.setOutId("123");
req.setTaobaoId(123L);
TopPolicyDo obj1 = new TopPolicyDo();
obj1.setPolicyId("CA12345");
obj1.setRtCommissionFormula("各取各");
obj1.setAirline("CA");
obj1.setTransferType("中转");
obj1.setTravelType("单程");
obj1.setDepCities("SHA,NYC");
obj1.setArrCities("SHA,NYC");
obj1.setExcludeDepCities("SHA,NYC");
obj1.setExcludeArrCities("SHA,NYC");
obj1.setIsSupportRt("允许");
obj1.setTransferCities("SHA");
obj1.setRemark("销售规则备注");
obj1.setSaleDate("2013-01-01~2013-02-01");
obj1.setDepDate("2013-09-11~2013-10-10");
obj1.setRetDate("2013-09-11~2013-10-10,2014-09-11~2014-10-10");
obj1.setCabinRestrictType("适用");
obj1.setCabinRestrict("F,C,Y");
obj1.setServiceLevel("头等");
obj1.setFareBasisAllowed("F%");
obj1.setFareBasisForbidden("F%");
obj1.setFlightRestrict("CA123,CA234-999");
obj1.setCodeSharingType("仅限同集团代码共享适用");
obj1.setPassengerType("普通");
obj1.setFareSource("平台运价");
obj1.setFareType("文件运价");
obj1.setAllowPriceRange("100-1000");
obj1.setOfficeNo("OFFICE");
obj1.setSaleRetention("13");
obj1.setSaleRebase("12");
obj1.setChildSaleRetention("1");
obj1.setChildSaleRebase("1");
obj1.setRefundRule("退票免费");
obj1.setReissueRule("改期费为票价的30%");
obj1.setNoshowRule("起飞前2小时内取消视作误机, 误机不允许改期不允许退票");
obj1.setLuggageRule("普通乘客:2件, 每件23公斤");
obj1.setBuyTicketNotice("本产品仅限中国大陆国际的乘客预定; 成功预定和出票赠送机上WIFI券");
obj1.setProductType("普通");
obj1.setIsAllowUnionAirline("允许");
obj1.setChannelIdDesc("amadus");
obj1.setExtendAttributes("{}");
obj1.setIsCanAllRefund("是");
obj1.setRefundFeeAllUnused("200-72-10%-48-1000-0-*");
obj1.setRefundCurrencyAllUnused("CNY");
obj1.setRefundFeeTypeAllUnused("全程");
obj1.setIsCanPartRefund("是");
obj1.setRefundFeePartUnused("200-72-10%-48-1000-0-*");
obj1.setRefundCurrencyPartUnused("CNY");
obj1.setRefundFeeTypePartUnused("全程");
obj1.setCanDepChange("否");
obj1.setDepChangeFee("200-72-300-48-1000-0-*");
obj1.setDepChangeCurrency("CNY");
obj1.setDepChangeFeeType("全程");
obj1.setCanRetChange("否");
obj1.setRetChangeFee("200-72-300-48-1000-0-*");
obj1.setRetChangeCurrency("CNY");
obj1.setRetChangeFeeType("全程");
obj1.setNoshowRestrict("是");
obj1.setNoshowTimeRestrict("10");
obj1.setNoshowTimeRestrictUnit("小时");
obj1.setNoshowRuleType("不可退票,不可改期");
obj1.setNoshowFee("3000");
obj1.setNoshowCurrency("CNY");
obj1.setVipCode("123abc");
obj1.setGv2ChildRule("是");
obj1.setNationality("CN");
obj1.setExcludeNationality("CN");
obj1.setPassengerAge("1-99");
obj1.setPresalePeriod("10");
obj1.setReceipts("电子行程单");
obj1.setCanOj("不支持缺口");
obj1.setDefaultOdDeny("BJS-LAX,TC3-CN");
obj1.setAirlineCodeSharing("KA(CX/CX),CA(CZ)");
obj1.setChildChangeFeeInUnused("200-72-300-48-1000-0-*");
obj1.setChildChangeFeeOutUnused("200-72-300-48-1000-0-*");
obj1.setChildRefundFeePartUnused("200-72-300-48-1000-0-*");
obj1.setChildRefundFeeAllUnused("200-72-300-48-1000-0-*");
req.setTopPolicyDo(obj1);
AlitripItPolicyUpdateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alitrip_it_policy_update_response>
    <taobao_id>123</taobao_id>
    <extend_attributes>{}</extend_attributes>
</alitrip_it_policy_update_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>

错误码解释

错误码 错误描述 解决方案
NONE_DATA
PARAM_ERROR
SYSTEM_EXCEPTION

API工具

如何获得此API

FAQ

返回
顶部