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

taobao.alitrip.it.policy.get (【国际机票销售规则】单条查询)

通过此接口可以查询单条销售规则的详情,可以根据taobaoId或outId查询,用户outId查询时,如果outId不唯一,只返回最新添加的一条数据。taobaoId为新增成功时候返回的唯一id,outId为新增时的policy_id(产品编号)

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
extend_attributes String 可选 {} 预留扩展字段
out_id String 可选 123 接入方产品编号
taobao_id Number 可选 123 淘宝政策id

响应参数

名称 类型 示例值 描述
extend_attributes String {} 扩展字段
status Number 1 政策状态,0-未发布,1-已发布,2-已过期
taobao_id Number 123 淘宝政策id
policy_do TopPolicyDo 政策信息
  • └ airline
  • String
  • CA
  • 航空公司,航空公司两字码,如CA
  • └ allow_price_range
  • String
  • 100-1000
  • 价格区间,空表示默认值为0-999999默认为正整型上限必须大于下限
  • └ arr_cities
  • String
  • SHA,NYC
  • 目的地,空表示所有航线都适用可录入格式:1) 城市三代如SHA,NYC,SEL2) 国家二代如CN,US,KR3) TC区代码如TC1,TC2,TC34) 为空表示不限制允许1.2.3. 混合录入,可录入多个用,隔开表示多个最多允许录入100个多个用,分隔.可输入单个区域和多个城市,支持区域和城市同时输入,以自定义区域表为准,输入自定义名称,系统存入对应城市三字码集合最多输入100个城市
  • └ buy_ticket_notice
  • String
  • 本产品仅限中国大陆国际的乘客预定; 成功预定和出票赠送机上WIFI券
  • 购票须知,非必输长度小于300字符只在退票规定不为空时才会生效
  • └ cabin_restrict
  • String
  • F,C,Y
  • 舱位,空表示所有舱位都适用多个用,分隔
  • └ cabin_restrict_type
  • String
  • 适用
  • 适用/例外舱位,可选:适用、例外,如果舱位有值,则必须输入适用或例外
  • └ child_sale_rebase
  • String
  • 1
  • 儿童留钱,非必输;为整型;支持负数;单位元
  • └ child_sale_retention
  • String
  • 1
  • 儿童返点,非必输;可输入负值;范围-100至100之间,可保留2位小数
  • └ code_sharing_type
  • String
  • 仅限同集团代码共享适用
  • 代码共享适用类型,空:不允许代码共享;可以选值:仅限同集团代码共享适用、代码共享适用、不允许代码共享、
  • └ dep_cities
  • String
  • SHA,NYC
  • 始发地,空表示所有航线都适用可录入格式:1) 城市三代如SHA,NYC,SEL2) 国家二代如CN,US,KR3) TC区代码如TC1,TC2,TC34) 为空表示不限制允许1.2.3. 混合录入,可录入多个用,隔开表示多个最多允许录入100个多个用,分隔.可输入单个区域和多个城市,支持区域和城市同时输入,以自定义区域表为准,输入自定义名称,系统存入对应城市三字码集合最多输入100个城市
  • └ dep_date
  • String
  • 2013-09-11~2013-10-10
  • 去程旅行日期,必填项;支持添加多对日期多段用,分隔;可支持2013-01-01或2013/01/01格式输入;范围用~表示
  • └ exclude_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个城市
  • └ fare_basis_allowed
  • String
  • F%
  • 适用fareBasis,空表示所有都适用支持数字字母组合支持多个,支持通配符%不限制长度的通配符,只 支持首或末位一个%
  • └ fare_basis_forbidden
  • String
  • F%
  • 例外fareBasis,空表示所有都适用支持数字字母组合支持多个,支持通配符%不限制长度的通配符,只 支持首或末位一个%
  • └ fare_source
  • String
  • 平台运价
  • 运价来源,空:表示平台运价; 此处为单选,输入平台运价,表示平台运价,不同的接入方可选值不一样
  • └ fare_type
  • String
  • 文件运价
  • 可适用运价渠道,空:表示都适用 运价来源为“平台运价”时,此处选项为:GDS, 文件运价。 以上选项若多个用,分隔
  • └ 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 为空表示无限制
  • └ is_support_rt
  • String
  • 允许
  • 是否允许1/2RT组合销售规则,允许、不允许空表示:不允许
  • └ luggage_rule
  • String
  • 普通乘客:2件, 每件23公斤
  • 行李额规定,非必输长度小于300字符请同时录入 退票规定、改签规定和行李额规定
  • └ noshow_rule
  • String
  • 起飞前2小时内取消视作误机, 误机不允许改期不允许退票
  • 误机罚金说明,非必输长度小于300字符只在退票规定不为空时才会生效
  • └ office_no
  • String
  • OFFICE
  • 预定OFFICE,空表示默认优先级最高OFFICE,可输入OFFICE,校验必须为配置中存在的OFFICE
  • └ passenger_type
  • String
  • 普通
  • 成人身份,1.不得为空2.可选:普通/学生 3多个使用,分隔
  • └ policy_id
  • String
  • 12345
  • 产品编号,内容可空,支持字母和数字,最多50个字符
  • └ product_type
  • String
  • 普通
  • 商品类型,非必输;默认为普通可填写为金牌或普通
  • └ refund_rule
  • String
  • 退票免费
  • 退票规定,非必输长度小于300字符请同时录入 退票规定、改签规定和行李额规定
  • └ reissue_rule
  • String
  • 改期费为票价的30%
  • 改签规定,非必输长度小于300字符请同时录入 退票规定、改签规定和行李额规定
  • └ remark
  • String
  • 销售规则备注
  • 备注信息,销售规则备注,最多300个字符
  • └ ret_date
  • String
  • 2013-09-11~2013-10-10,2014-09-11~2014-10-10
  • 回程旅行日期,非必填,支持添加多对日期多段用,分隔;可支持2013-01-01或2013/01/01格式输入;范围用~表示
  • └ rt_commission_formula
  • String
  • 各取各
  • 1/2RT计算方式,空:表示取严,可录入各取各或者取严,表示1/2RT佣金计算方式是各取各或者取严。
  • └ sale_date
  • String
  • 2013-01-01~2013-02-01
  • 销售日期,必填项;销售日期只能输入一段;日期对为左右都是闭区间格式:可支持2013-01-01或2013/01/01格式输入;范围用~表示
  • └ sale_rebase
  • String
  • 12
  • 留钱,返点和留钱至少二选一
  • └ sale_retention
  • String
  • 13
  • 返点,可输入负值范围-100至100之间,可保留2位小数与留钱固定金额二选一必输
  • └ service_level
  • String
  • 头等
  • 服务等级,默认值空:表示所有服务等级适用头等公务超值经济经济可多选,用,分隔
  • └ transfer_cities
  • String
  • SHA
  • 中转点,空表示所有航线都适用可录入格式:1) 城市三代如SHA,NYC,SEL2) 国家二代如CN,US,KR3) TC区代码如TC1,TC2,TC34) 为空表示不限制允许1.2.3. 混合录入,可录入多个用,隔开表示多个最多允许录入100个多个用,分隔.可输入单个区域和多个城市,支持区域和城市同时输入,以自定义区域表为准,输入自定义名称,系统存入对应城市三字码集合最多输入100个城市
  • └ transfer_type
  • String
  • 中转
  • 中转类型(是否直达),空:表示不限,即直达中转都适用,可选:直达、中转
  • └ travel_type
  • String
  • 单程
  • 航程种类,可选:单程、往返、空为不限
  • └ extend_attributes
  • String
  • {}
  • 扩展字段,预留
  • └ is_allow_union_airline
  • String
  • 允许
  • 不同航司联运,非必输;可输入允许或不允许,空表示不允许
  • └ channel_id_desc
  • String
  • amadus
  • 渠道名称,非必输,不同的接入方可选值不一样
  • └ presale_period
  • String
  • 20
  • 提前销售天数
  • └ default_od_deny
  • String
  • BJS-LAX,CN-TC3
  • 例外航线,默认销售规则, 格式为xxx-xxx,xxx-xxx ,英文逗号分开,区域类型与例外始发地的一致
  • └ airline_code_sharing
  • String
  • KA(CX/MU),CA(CZ)
  • 航司代码共享范围 airline_code_sharing : 格式 KA(CX/CX),CA(CZ) 英文逗号分开,/ 分隔内部,航司二字码表示

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripItPolicyGetRequest req = new AlitripItPolicyGetRequest();
req.setExtendAttributes("{}");
req.setOutId("123");
req.setTaobaoId(123L);
AlitripItPolicyGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alitrip_it_policy_get_response>
    <extend_attributes>{}</extend_attributes>
    <status>1</status>
    <taobao_id>123</taobao_id>
    <policy_do>
        <airline>CA</airline>
        <allow_price_range>100-1000</allow_price_range>
        <arr_cities>SHA,NYC</arr_cities>
        <buy_ticket_notice>本产品仅限中国大陆国际的乘客预定; 成功预定和出票赠送机上WIFI券</buy_ticket_notice>
        <cabin_restrict>F,C,Y</cabin_restrict>
        <cabin_restrict_type>适用</cabin_restrict_type>
        <child_sale_rebase>1</child_sale_rebase>
        <child_sale_retention>1</child_sale_retention>
        <code_sharing_type>仅限同集团代码共享适用</code_sharing_type>
        <dep_cities>SHA,NYC</dep_cities>
        <dep_date>2013-09-11~2013-10-10</dep_date>
        <exclude_arr_cities>SHA,NYC</exclude_arr_cities>
        <exclude_dep_cities>SHA,NYC</exclude_dep_cities>
        <fare_basis_allowed>F%</fare_basis_allowed>
        <fare_basis_forbidden>F%</fare_basis_forbidden>
        <fare_source>平台运价</fare_source>
        <fare_type>文件运价</fare_type>
        <flight_restrict>CA123,CA234-999</flight_restrict>
        <is_support_rt>允许</is_support_rt>
        <luggage_rule>普通乘客:2件, 每件23公斤</luggage_rule>
        <noshow_rule>起飞前2小时内取消视作误机, 误机不允许改期不允许退票</noshow_rule>
        <office_no>OFFICE</office_no>
        <passenger_type>普通</passenger_type>
        <policy_id>12345</policy_id>
        <product_type>普通</product_type>
        <refund_rule>退票免费</refund_rule>
        <reissue_rule>改期费为票价的30%</reissue_rule>
        <remark>销售规则备注</remark>
        <ret_date>2013-09-11~2013-10-10,2014-09-11~2014-10-10</ret_date>
        <rt_commission_formula>各取各</rt_commission_formula>
        <sale_date>2013-01-01~2013-02-01</sale_date>
        <sale_rebase>12</sale_rebase>
        <sale_retention>13</sale_retention>
        <service_level>头等</service_level>
        <transfer_cities>SHA</transfer_cities>
        <transfer_type>中转</transfer_type>
        <travel_type>单程</travel_type>
        <extend_attributes>{}</extend_attributes>
        <is_allow_union_airline>允许</is_allow_union_airline>
        <channel_id_desc>amadus</channel_id_desc>
        <presale_period>20</presale_period>
        <default_od_deny>BJS-LAX,CN-TC3</default_od_deny>
        <airline_code_sharing>KA(CX/MU),CA(CZ)</airline_code_sharing>
    </policy_do>
</alitrip_it_policy_get_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

返回
顶部