淘宝开放平台 - 文档中心

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

名称	类型	是否必须	示例值	更多限制	描述
create_intl_policy_dto	CreateIntlPolicyDTO	必须			普通政策创建参数
└ supply_source String 可选 1234 供应来源；是否默认普通政策为是时，该字段不可填写 └ account_code String 可选 1234 大客户编码；为空表示不限制；仅允许填写字母、数字、“/”和“”，支持模糊匹配，表示多位。XXX表示以XXX结尾，XX表示以XX开头。优先匹配例外accountCode，再匹配适用；accountCode。是否默认普通政策为是时，该字段不可填写 no_show IntlNoShowDTO 可选误机罚金 └ no_show_fee String 可选 100 误机罚金金额；包含百分比时，请保证该单元格格式必须为文本；误机罚金为有，且误机罚金规则类型为空时，为必填项；误机罚金为无，或者误机罚金规则类型同时为不可退票、不可改期时，不可填写 └ no_show_currency String 可选 CNY 误机罚金币种；货币代码,默认为CNY；误机罚金为无时，不可填写 └ no_show_rule_type String [] 可选 [0,1] 误机罚金规则类型：0，不可退票；1，不可改期。多个中间使用“,”隔开，默认为空；误机罚金为无时，不可填写 └ no_show_limit_time Number 可选 10 误机罚金规则时限；误机罚金为有时，为必填项；误机罚金为无时，不可填写；只能录入整数 └ no_show_type Number 可选 0 误机罚金，0，无；1，有；是否使用公布运价退改签为否时，该字段必须填写；是否使用公布运价退改签为是时，该字段不可填写；是否默认普通政策为是时，该字段不可填写 └ no_show_limit_time_unit Number 可选 0 时限单位：0，小时；1，天；误机罚金为无时，不可填写；误机罚金为有时，默认为小时 └ working_time String 可选 09:00MON-18:00FRI 工作时间，空，表示不限制；09:00-18:00表示每一天的早上9点到下午6点，09:00MON-18:00FRI表示周一到周五的每天早上9点到下午6点；最多录入三个时间段用逗号隔开表示或的关系；是否默认普通政策为是时，该字段不可填写 └ code_share_airline String 可选 KA(CX/CZ) 航司代码共享范围；格式为：KA(CX/CZ),CA(CZ)，可以录入多组，多组之间是或者关系，用逗号分隔括号中是实际承运航司可以多个(多个用/分隔)。该字段仅校验代码共享航班航段。全程航班，不管哪一段是代码共享，都要满足自定义代码共享字段。这个字段为空，则不用校验这个字段。 └ default_type Number 可选 0 是否默认普通政策: 0，否；1，是；默认为0。选否时，投放上对应国际老平台上的销售规则；选是时，投放上对应国际老平台上的默认销售规则。 └ restrict_account_code String 可选 1234 排除大客户编码；为空表示不限制；仅允许填写字母、数字、“/”和“”，支持模糊匹配，表示多位。XXX表示以XXX结尾，XX表示以XX开头。优先匹配例外accountCode，再匹配适用 └ restrict_fare_basis String 可选 123abc 排除farebasis；指定例外的farebasis；支持数字字母组合，支持多个，支持通配符；不限制长度的通配符,只支持首或末位一个%；是否默认普通政策为是时，该字段不可填写 └ fare_basis String 可选 123abc farebasis；空表示所有都适用；支持数字字母组合，支持多个，支持通配符；不限制长度的通配符,只支持首或末位一个%；是否默认普通政策为是时，该字段不可填写 └ code_share Number 可选 0 代码共享适用类型：0，不限制；1，同集团代码共享适用；2，不适用于代码共享；3，代码共享适用 price IntlPriceDTO 必须价格信息 └ support_fare_channel Number 可选 1 仅填写可适用运价渠道的code，具体请参考excel中运价来源sheet页中的可适用运价渠道 └ child_return_price Number 可选 20 儿童营销费用；为整型，支持负数，单位元，不填默认为0 └ min_price_limit Number 可选 10 最小营销定价；空表示默认值为0-999999，默认为正整型，最大营销定价必须大于最小营销定价；是否默认普通政策为是时，该字段不可填写 └ invoice_type Number 必须 3 发票类型：3，境外电子凭证；5，旅行发票；7，差额行程单发票；9，等额行程单 └ commission String 必须 20.02 营销费率；1、只允许填写数字，支持到小数点后两位；不用填写% 2、营销费率范围：-100至50，小于50，小于-100，成人价=销售营销定价（1-营销费率）+营销费用 3、营销费率和营销费用二选一，不能同时为空 4、不填默认为0 └ child_commission String 可选 20.02 儿童营销费率；可输入负值，范围-100至50之间，可保留2位小数，不填默认为0 └ fare_source Number 必须 2 仅填写运价来源的code，具体请参考excel中运价来源sheet页的运价来源 └ return_price Number 必须 100 营销费用；0或正负数字；-20表示返20元；20代表留20元；可输入范围-1000至32767 ；营销费率和营销费用二选一，不能同时为空；不填默认为0 └ max_price_limit Number 可选 999999 最大营销定价；空表示默认值为0-999999，默认为正整型，最大营销定价必须大于最小营销定价；是否默认普通政策为是时，该字段不可填写 └ soto_return_price Number 可选 20 soto营销费用；为整型，支持负数，单位元；是否默认普通政策为是时，该字段不可填写 └ soto_commission String 可选 20.02 soto营销费率；可输入负值，范围-100至50之间，可保留2位小数；是否默认普通政策为是时，该字段不可填写 └ bidd_fee Number 可选 10 固定金额竞价空间；非必填，支持范围大于0，小于等于1000，正整数输入，业务含义表示金额下浮，为空代表无固定金额竞价 └ bidd_fee_percent String 可选 2.12 百分比竞价空间；非必填，支持范围大于0，小于等于50，两位小数输入，业务含义表示百分比金额下浮，为空则无百分比竞价 limit IntlPriceDTO 必须限制信息 flight IntlFlightLimitDTO 可选航班限制信息 └ default_restrict_od String 可选 SHA-NYC 排除航线；1、格式为xxx-xxx,xxx-xxx； 2、空表示所有航线都适用； 3、支持输入城市、国家、TC区和自定义区域代码，支持混合输入； 4、多个输入用','分割，最多允许录入50对； 5、是否默认普通政策为否时，该字段不可填写 └ restrict_arrive String 可选 SHA 排除目的地；空表示所有航线都适用可录入格式： 1) 城市三代如SHA,NYC,SEL 2) 国家二代如CN,US,KR 3) TC区代码如TC1,TC2,TC3 4) 为空表示不限制允许1.2.3. 混合录入，可录入多个用，隔开表示多个最多允许录入100个多个用","分隔可输入单个区域和多个城市,支持区域和城市同时输入，以自定义区域表为准，输入自定义名称，系统存入对应城市三字码集合最多输入100个城市 └ transit_depot String 可选 HKG 中转点；空表示所有航线都适用可录入格式： 1) 城市三代如SHA,NYC,SEL 2) 国家二代如CN,US,KR 3) TC区代码如TC1,TC2,TC3 4) 为空表示不限制允许1.2.3. 混合录入，可录入多个用，隔开表示多个最多允许录入100个多个用","分隔可输入单个区域和多个城市,支持区域和城市同时输入，以自定义区域表为准，输入自定义名称，系统存入对应城市三字码集合最多输入100个城市是否默认普通政策为是时，该字段不可填写 └ restrict_depart String 可选 NYC 排除始发地；空表示所有航线都适用可录入格式： 1) 城市三代如SHA,NYC,SEL 2) 国家二代如CN,US,KR 3) TC区代码如TC1,TC2,TC3 4) 为空表示不限制允许1.2.3. 混合录入，可录入多个用，隔开表示多个最多允许录入100个多个用","分隔可输入单个区域和多个城市,支持区域和城市同时输入，以自定义区域表为准，输入自定义名称，系统存入对应城市三字码集合最多输入100个城市 └ trip_type Number 可选 0 航程类型：0，不限制；1，单程；2，往返；是否默认普通政策为否时，空默认为不限制；是否默认普通政策为是时，该字段不可填写 └ direct_transfer_type Number 可选 0 行程类型：0，不限制；1，直达；2，中转；是否默认普通政策为否时，空默认为不限制；是否默认普通政策为是时，该字段不可填写 └ arrive String 可选 SHA 目的地；空表示所有航线都适用可录入格式： 1) 城市三代如SHA,NYC,SEL 2) 国家二代如CN,US,KR 3) TC区代码如TC1,TC2,TC3 4) 为空表示不限制允许1.2.3. 混合录入，可录入多个用，隔开表示多个最多允许录入100个多个用","分隔. 可输入单个区域和多个城市,支持区域和城市同时输入，以自定义区域表为准，输入自定义名称，系统存入对应城市三字码集合最多输入100个城市 itineraries IntlItineraryDTO [] 必须 2024-09-08 10:10:10 行程信息 allow_travel_date DatePair [] 必须 2024-09-08 10:10:10 旅行有效日期；去程旅行有效日期时，必填；回程旅行有效日期在是否默认普通政策为否时，必填 └ start Date 必须 2024-09-08 10:10:10 旅行有效开始日期 └ end Date 必须 2024-09-08 10:10:10 旅行有效结束日期 └ flight_index Number 必须 0 行程类型标记：0，去程；1，回程 └ cabin String 可选 Y 舱位；空表示所有舱位都适用，多个用","分隔，最多200个字符 └ cabin_class String 可选 P,Y 舱位等级：P，超值经济舱；Y，经济舱；C，商务舱；F，头等舱；支持多个，用,分隔 └ cabin_type Number 可选 0 舱位类型：0，例外；1，适用。默认为1，适用 └ allow_flight_num String 可选 CA5512 可售航班号； 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、为空表示无限制；8、是否默认普通政策为是时，该字段不可填写 └ airline String 必须 CA 航司；输入航司二字码 └ depart String 可选 SHA 始发地；空表示所有航线都适用可录入格式： 1) 城市三代如SHA,NYC,SEL 2) 国家二代如CN,US,KR 3) TC区代码如TC1,TC2,TC3 4) 为空表示不限制允许1.2.3. 混合录入，可录入多个用，隔开表示多个最多允许录入100个多个用","分隔. 可输入单个区域和多个城市,支持区域和城市同时输入，以自定义区域表为准，输入自定义名称，系统存入对应城市三字码集合最多输入100个城市是否默认普通政策为是时，该字段不可填写 └ default_od Number 可选 1 航线：1，大陆始发；2，香港始发(香港回大陆，属于香港始发)；3，SOTO回香港(不包括大陆始发)；4，SOTO回大陆(不包括大陆始发)；5，境外到境外；是否默认普通政策为是时，该字段必填；是否默认普通政策为否时，该字段不可填写 sale IntlSaleLimitDTO 必须销售限制信息 └ sale_mode_code Number 可选 1 销售方式：1，普通；2，金牌；3，极速出票；4，当日退；5，延时出票1(起飞前24小时)；6，花呗买家版；7，延时出票2(起飞前168小时)；8，延时出票3(支付后48小时)；默认为1，普通 └ advance_day Number 可选 2 提前销售天数；输入范围：0-365 └ intermodal_airline Number 必须 0 是否允许不同航司联运：0，否；1，是 sale_date DatePair 必须销售起止日期 └ start Date 必须 2022-09-08 10:10:10 销售开始时间 └ end Date 必须 2022-09-08 10:10:10 销售结束时间 baggage IntlBaggageLimitDTO 可选行李限制信息 └ baggage_rule String 可选普通乘客：2件，每件23公斤行李额规定；1、长度小于300字符； 2、是否使用公布运价退改签规则为否时，该字段不能为空； 3、是否使用公布运价退改签规则为是时，该字段不可填写； 4、是否默认普通政策为是时，该字段不可填写 passenger IntlPassengerLimitDTO 可选乘机人限制信息 └ age_limit String 可选 12-99 年龄限制；可录入范围12-99，最低年龄不可超过70，如21-25表示21周岁至25周岁；12- ,表示12岁以上；-99，表示最大99岁；是否默认普通政策为是时，该字段不可填写 └ nationality String 可选 CN 国籍；可录入多个用英文逗号隔开，表示或的关系；可录入国家二字代码，为空表示不限制，最多录20个，不输入为不限制；是否默认普通政策为是时，该字段不可填写 └ nationality_type Number 可选 0 国籍限制：0，排除国籍；1，包含国籍；是否默认普通政策为是时，该字段不可填写 └ min_group Number 可选 0 适用小团：0，否；1，是；2，不限；不填默认为不限 └ passenger_type String [] 可选 [1,2] 成人旅客类型：1，普通；2，学生；多个使用","分隔；是否默认普通政策为否时，该字段必填；是否默认普通政策为是时，该字段不可填写 combine_restrict IntlCombineRestrictLimitDTO 可选组合限制信息 └ fare_combination_formula Number 可选 0 1/2RT计算方式：0，各取各；1，取严；默认为1：取严；是否默认普通政策为是时，该字段不可填写 └ support_gap_type Number 可选 0 是否支持缺口：0，不支持缺口；1，只支持缺口；2，不限；不填默认为0不支持缺口 └ travel_date_formula Number 可选 0 1/2RT旅行日期计算方式：0，各取各；1，取严；默认为1：取严。是否默认普通政策为是时，该字段不可填写 tp IntlPriceDTO 可选出票信息 └ notice String 可选本产品仅限中国大陆国际的乘客预定；成功预定和出票赠送机上WIFI券购票须知；1、长度小于300字符； 2、只在退票规定不为空时才会生效； 3、是否默认普通政策为是时，该字段不可填写 rp IntlLimitDTO 可选退改信息 all_refund IntlRefundDTO 可选全部未使用退票限制信息 └ refund_type Number 可选 0 全部未使用是否可退票：0，否；1，是；是否使用公布运价退改签为否时，该字段必须填写；是否使用公布运价退改签为是时，该字段不可填写；是否默认普通政策为是时，该字段不可填写 └ refund_fee String 可选 200 全部未使用退票费用；包含百分比时，请保证该单元格格式必须为文本全部未使用是否可退票为是时，为必填项；全部未使用是否可退票不为是时，不可填写；可输入格式如: 1) 200 表示退票手续费为200（货币单位在下一个格子里） 2) 20% 表示退票手续费为营销定价的20% 3）* 表示不允许退票 4) 200-0-400 表示起飞前退票手续费200；起飞后退票手续费400 5) 30%-0-* 表示起飞前退票手续费为营销定价的30%；起飞后不允许退票 6）200-72-300-48-1000-0-* 表示72小时前退票手续费200; 48小时到72小时，退票手续费300; 飞机起飞不足48小时; 退票手续费1000; 飞机起飞后不予退票（输入） 7) 10%-72-30%-48-70%-0- 表示72小时前退票手续费为营销定价的10%; 48小时到72小时，退票手续费为营销定价的30%; 飞机起飞不足48小时; 退票手续费为营销定价的70%; 飞机起飞后不予退票（输入） └ refund_fee_type Number 可选 0 全部未使用退票费用收取方式：0，按全程收取；1，按航段收取；全部未使用是否可退票为否时，不可填写；是否默认普通政策为否，且全部未使用是否可退票为是时，默认为0，按全程收取 └ refund_currency String 可选 CNY 全部未使用退票币种；默认值：CNY；全部未使用是否可退票不为是时，不可填写 └ child_refund_fee String 可选 200 全部未使用儿童退票费用；格式同成人。包含百分比时，请保证该单元格格式必须为文本全部未使用是否可退票为是时，为必填项；全部未使用是否可退票不为是时，不可填写；可输入格式如: 1) 200 表示退票手续费为200（货币单位在下一个格子里） 2) 20% 表示退票手续费为营销定价的20% 3）表示不允许退票 4) 200-0-400 表示起飞前退票手续费200；起飞后退票手续费400 5) 30%-0-* 表示起飞前退票手续费为营销定价的30%；起飞后不允许退票 6）200-72-300-48-1000-0-* 表示72小时前退票手续费200; 48小时到72小时，退票手续费300; 飞机起飞不足48小时; 退票手续费1000; 飞机起飞后不予退票（输入） 7) 10%-72-30%-48-70%-0- 表示72小时前退票手续费为营销定价的10%; 48小时到72小时，退票手续费为营销定价的30%; 飞机起飞不足48小时; 退票手续费为营销定价的70%; 飞机起飞后不予退票（输入） modifies IntlModifyDTO [] 可选改期信息 └ modify_type Number 可选 0 是否可改期：0，否；1，是；是否使用公布运价退改签为否时，该字段必须填写；是否使用公布运价退改签为是时，该字段不可填写；是否默认普通政策为是时，该字段不可填写 └ child_modify_fee String 可选 200 儿童改期费用；可否改期为是时，为必填项；可否改期为否时，不可填写；可输入格式如: 1) 200; 表示改期手续费为200（货币单位在下一个格子里）; 2) 表示不允许改期; 3) 200-0-400；表示起飞前改期手续费200；起飞后改期手续费400 4) 30-0-；表示起飞前改期手续费30；起飞后不允许改期； 5）200-72-300-48-1000-0-；表示72小时前改期手续费200; 48小时到72小时，改期手续费300; 飞机起飞不足48小时; 改期手续费1000; 飞机起飞后不予改期（输入） └ index Number 可选 0 行程标记：0，去程；1，回程 └ modify_currency String 可选 CNY 改期费用币种，默认为CNY；去程可否改期为否时，不可填写 └ modify_fee String 可选 200 改期费用；可否改期为是时，为必填项；可否改期为否时，不可填写；可输入格式如: 1) 200; 表示改期手续费为200（货币单位在下一个格子里）; 2) 表示不允许改期; 3) 200-0-400；表示起飞前改期手续费200；起飞后改期手续费400 4) 30-0-；表示起飞前改期手续费30；起飞后不允许改期； 5）200-72-300-48-1000-0-；表示72小时前改期手续费200; 48小时到72小时，改期手续费300; 飞机起飞不足48小时; 改期手续费1000; 飞机起飞后不予改期（输入） └ modify_fee_type Number 可选 0 改期费用收取方式：0，按全程收取；1，按航段收取。去程可否改期为否时，不可填写。是否默认普通政策为否，且去程可否改期为是时，默认为0，按全程收取 └ published_fare_rule Number 可选 0 是否使用公布运价退改签规则：0，否；1，是；是否默认普通政策为否时，该字段默认为0；是否默认普通政策为是时，该字段不可填写；销售方式为金牌时，该字段必须为1 part_refund IntlRefundDTO 可选部分未使用退票限制信息 └ refund_type Number 可选 0 部分未使用是否可退票：0，否；1，是；是否使用公布运价退改签为否时，该字段必须填写；是否使用公布运价退改签为是时，该字段不可填写；是否默认普通政策为是时，该字段不可填写 └ refund_fee String 可选 200 部分未使用退票费用；包含百分比时，请保证该单元格格式必须为文本部分未使用是否可退票为是时，为必填项；部分未使用是否可退票不为是时，不可填写；可输入格式如: 1) 200 表示退票手续费为200（货币单位在下一个格子里）； 2) 20% 表示退票手续费为营销定价的20%； 3）表示不允许退票； 4) 200-0-400 表示起飞前退票手续费200；起飞后退票手续费400； 5) 30%-0-* 表示起飞前退票手续费为营销定价的30%；起飞后不允许退票； 6）200-72-300-48-1000-0-* 表示72小时前退票手续费200; 48小时到72小时，退票手续费300; 飞机起飞不足48小时; 退票手续费1000; 飞机起飞后不予退票（输入） 7) 10%-72-30%-48-70%-0- 表示72小时前退票手续费为营销定价的10%; 48小时到72小时，退票手续费为营销定价的30%; 飞机起飞不足48小时; 退票手续费为营销定价的70%; 飞机起飞后不予退票（输入） └ refund_fee_type Number 可选 0 部分未使用退票费用收取方式：0，按全程收取；1，按航段收取；部分未使用是否可退票为否时，不可填写；是否默认普通政策为否，且部分未使用是否可退票为是时，默认为0，按全程收取 └ refund_currency String 可选 CNY 部分未使用退票币种；默认值：CNY；部分未使用是否可退票不为是时，不可填写 └ child_refund_fee String 可选 200 部分未使用儿童退票费用；包含百分比时，请保证该单元格格式必须为文本部分未使用是否可退票为是时，为必填项；部分未使用是否可退票不为是时，不可填写；可输入格式如: 1) 200 表示退票手续费为200（货币单位在下一个格子里）； 2) 20% 表示退票手续费为营销定价的20%； 3）表示不允许退票； 4) 200-0-400 表示起飞前退票手续费200；起飞后退票手续费400； 5) 30%-0-* 表示起飞前退票手续费为营销定价的30%；起飞后不允许退票； 6）200-72-300-48-1000-0-* 表示72小时前退票手续费200; 48小时到72小时，退票手续费300; 飞机起飞不足48小时; 退票手续费1000; 飞机起飞后不予退票（输入） 7) 10%-72-30%-48-70%-0- 表示72小时前退票手续费为营销定价的10%; 48小时到72小时，退票手续费为营销定价的30%; 飞机起飞不足48小时; 退票手续费为营销定价的70%; 飞机起飞后不予退票（输入*） └ payment_account_code String 可选 1234 开票大客户编码 └ policy_code String 可选 abc123 政策代码；自行输入的ID，只能填写数字或字母，最多50个字符；是否默认普通政策为是时，不可填写 └ office_no String 必须 SDK123 预定的office号 └ memo String 可选备注备注信息，最长不超过300个字符

名称	类型	示例值	描述
result	ResultDO		返回信息
└ msg String 错误描述响应msg └ code String 403 响应code └ success Boolean true 请求成功标识，成功：true，失败：false

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripIntlPolicyNormalParamRequest req = new AlitripIntlPolicyNormalParamRequest();
AlitripIntlPolicyNormalParamRequest.CreateIntlPolicyDTO obj1 = new AlitripIntlPolicyNormalParamRequest.CreateIntlPolicyDTO();
obj1.setSupplySource("1234");
obj1.setAccountCode("1234");
AlitripIntlPolicyNormalParamRequest.IntlNoShowDTO obj2 = new AlitripIntlPolicyNormalParamRequest.IntlNoShowDTO();
obj2.setNoShowFee("100");
obj2.setNoShowCurrency("CNY");
obj2.setNoShowRuleType("0,1");
obj2.setNoShowLimitTime(10L);
obj2.setNoShowType(0L);
obj2.setNoShowLimitTimeUnit(0L);
obj1.setNoShow(obj2);
obj1.setWorkingTime("09:00MON-18:00FRI");
obj1.setCodeShareAirline("KA(CX/CZ)");
obj1.setDefaultType(0L);
obj1.setRestrictAccountCode("1234");
obj1.setRestrictFareBasis("123abc");
obj1.setFareBasis("123abc");
obj1.setCodeShare(0L);
AlitripIntlPolicyNormalParamRequest.IntlPriceDTO obj3 = new AlitripIntlPolicyNormalParamRequest.IntlPriceDTO();
obj3.setSupportFareChannel(1L);
obj3.setChildReturnPrice(20L);
obj3.setMinPriceLimit(10L);
obj3.setInvoiceType(3L);
obj3.setCommission("20.02");
obj3.setChildCommission("20.02");
obj3.setFareSource(2L);
obj3.setReturnPrice(100L);
obj3.setMaxPriceLimit(999999L);
obj3.setSotoReturnPrice(20L);
obj3.setSotoCommission("20.02");
obj3.setBiddFee(10L);
obj3.setBiddFeePercent("2.12");
obj1.setPrice(obj3);
AlitripIntlPolicyNormalParamRequest.IntlPriceDTO obj4 = new AlitripIntlPolicyNormalParamRequest.IntlPriceDTO();
AlitripIntlPolicyNormalParamRequest.IntlFlightLimitDTO obj5 = new AlitripIntlPolicyNormalParamRequest.IntlFlightLimitDTO();
obj5.setDefaultRestrictOd("SHA-NYC");
obj5.setRestrictArrive("SHA");
obj5.setTransitDepot("HKG");
obj5.setRestrictDepart("NYC");
obj5.setTripType(0L);
obj5.setDirectTransferType(0L);
obj5.setArrive("SHA");
List<AlitripIntlPolicyNormalParamRequest.IntlItineraryDTO> list7 = new ArrayList<AlitripIntlPolicyNormalParamRequest.IntlItineraryDTO>();
AlitripIntlPolicyNormalParamRequest.IntlItineraryDTO obj8 = new AlitripIntlPolicyNormalParamRequest.IntlItineraryDTO();
list7.add(obj8);
List<AlitripIntlPolicyNormalParamRequest.DatePair> list11 = new ArrayList<AlitripIntlPolicyNormalParamRequest.DatePair>();
AlitripIntlPolicyNormalParamRequest.DatePair obj12 = new AlitripIntlPolicyNormalParamRequest.DatePair();
list11.add(obj12);
obj12.setStart(StringUtils.parseDateTime("2024-09-08 10:10:10"));
obj12.setEnd(StringUtils.parseDateTime("2024-09-08 10:10:10"));
list9.setAllowTravelDate(list11);
obj8.setFlightIndex(0L);
obj8.setCabin("Y");
obj8.setCabinClass("P,Y");
obj8.setCabinType(0L);
obj8.setAllowFlightNum("CA5512");
obj5.setItineraries(list7);
obj5.setAirline("CA");
obj5.setDepart("SHA");
obj5.setDefaultOd(1L);
obj4.setFlight(obj5);
AlitripIntlPolicyNormalParamRequest.IntlSaleLimitDTO obj13 = new AlitripIntlPolicyNormalParamRequest.IntlSaleLimitDTO();
obj13.setSaleModeCode(1L);
obj13.setAdvanceDay(2L);
obj13.setIntermodalAirline(0L);
AlitripIntlPolicyNormalParamRequest.DatePair obj14 = new AlitripIntlPolicyNormalParamRequest.DatePair();
obj14.setStart(StringUtils.parseDateTime("2022-09-08 10:10:10"));
obj14.setEnd(StringUtils.parseDateTime("2022-09-08 10:10:10"));
obj13.setSaleDate(obj14);
obj4.setSale(obj13);
AlitripIntlPolicyNormalParamRequest.IntlBaggageLimitDTO obj15 = new AlitripIntlPolicyNormalParamRequest.IntlBaggageLimitDTO();
obj15.setBaggageRule("普通乘客：2件， 每件23公斤");
obj4.setBaggage(obj15);
AlitripIntlPolicyNormalParamRequest.IntlPassengerLimitDTO obj16 = new AlitripIntlPolicyNormalParamRequest.IntlPassengerLimitDTO();
obj16.setAgeLimit("12-99");
obj16.setNationality("CN");
obj16.setNationalityType(0L);
obj16.setMinGroup(0L);
obj16.setPassengerType("1,2");
obj4.setPassenger(obj16);
AlitripIntlPolicyNormalParamRequest.IntlCombineRestrictLimitDTO obj17 = new AlitripIntlPolicyNormalParamRequest.IntlCombineRestrictLimitDTO();
obj17.setFareCombinationFormula(0L);
obj17.setSupportGapType(0L);
obj17.setTravelDateFormula(0L);
obj4.setCombineRestrict(obj17);
obj1.setLimit(obj4);
AlitripIntlPolicyNormalParamRequest.IntlPriceDTO obj18 = new AlitripIntlPolicyNormalParamRequest.IntlPriceDTO();
obj18.setNotice("本产品仅限中国大陆国际的乘客预定； 成功预定和出票赠送机上WIFI券");
obj1.setTp(obj18);
AlitripIntlPolicyNormalParamRequest.IntlLimitDTO obj19 = new AlitripIntlPolicyNormalParamRequest.IntlLimitDTO();
AlitripIntlPolicyNormalParamRequest.IntlRefundDTO obj20 = new AlitripIntlPolicyNormalParamRequest.IntlRefundDTO();
obj20.setRefundType(0L);
obj20.setRefundFee("200");
obj20.setRefundFeeType(0L);
obj20.setRefundCurrency("CNY");
obj20.setChildRefundFee("200");
obj19.setAllRefund(obj20);
List<AlitripIntlPolicyNormalParamRequest.IntlModifyDTO> list22 = new ArrayList<AlitripIntlPolicyNormalParamRequest.IntlModifyDTO>();
AlitripIntlPolicyNormalParamRequest.IntlModifyDTO obj23 = new AlitripIntlPolicyNormalParamRequest.IntlModifyDTO();
list22.add(obj23);
obj23.setModifyType(0L);
obj23.setChildModifyFee("200");
obj23.setIndex(0L);
obj23.setModifyCurrency("CNY");
obj23.setModifyFee("200");
obj23.setModifyFeeType(0L);
obj19.setModifies(list22);
obj19.setPublishedFareRule(0L);
AlitripIntlPolicyNormalParamRequest.IntlRefundDTO obj24 = new AlitripIntlPolicyNormalParamRequest.IntlRefundDTO();
obj24.setRefundType(0L);
obj24.setRefundFee("200");
obj24.setRefundFeeType(0L);
obj24.setRefundCurrency("CNY");
obj24.setChildRefundFee("200");
obj19.setPartRefund(obj24);
obj1.setRp(obj19);
obj1.setPaymentAccountCode("1234");
obj1.setPolicyCode("abc123");
obj1.setOfficeNo("SDK123");
obj1.setMemo("备注");
req.setCreateIntlPolicyDto(obj1);
AlitripIntlPolicyNormalParamResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlitripIntlPolicyNormalParamRequest req = new AlitripIntlPolicyNormalParamRequest();
AlitripIntlPolicyNormalParamRequest.CreateIntlPolicyDTODomain obj1 = new AlitripIntlPolicyNormalParamRequest.CreateIntlPolicyDTODomain();
obj1.SupplySource = "1234";
obj1.AccountCode = "1234";
AlitripIntlPolicyNormalParamRequest.IntlNoShowDTODomain obj2 = new AlitripIntlPolicyNormalParamRequest.IntlNoShowDTODomain();
obj2.NoShowFee = "100";
obj2.NoShowCurrency = "CNY";
obj2.NoShowRuleType = "0,1";
obj2.NoShowLimitTime = 10L;
obj2.NoShowType = 0L;
obj2.NoShowLimitTimeUnit = 0L;
obj1.NoShow= obj2;
obj1.WorkingTime = "09:00MON-18:00FRI";
obj1.CodeShareAirline = "KA(CX/CZ)";
obj1.DefaultType = 0L;
obj1.RestrictAccountCode = "1234";
obj1.RestrictFareBasis = "123abc";
obj1.FareBasis = "123abc";
obj1.CodeShare = 0L;
AlitripIntlPolicyNormalParamRequest.IntlPriceDTODomain obj3 = new AlitripIntlPolicyNormalParamRequest.IntlPriceDTODomain();
obj3.SupportFareChannel = 1L;
obj3.ChildReturnPrice = 20L;
obj3.MinPriceLimit = 10L;
obj3.InvoiceType = 3L;
obj3.Commission = "20.02";
obj3.ChildCommission = "20.02";
obj3.FareSource = 2L;
obj3.ReturnPrice = 100L;
obj3.MaxPriceLimit = 999999L;
obj3.SotoReturnPrice = 20L;
obj3.SotoCommission = "20.02";
obj3.BiddFee = 10L;
obj3.BiddFeePercent = "2.12";
obj1.Price= obj3;
AlitripIntlPolicyNormalParamRequest.IntlPriceDTODomain obj4 = new AlitripIntlPolicyNormalParamRequest.IntlPriceDTODomain();
AlitripIntlPolicyNormalParamRequest.IntlFlightLimitDTODomain obj5 = new AlitripIntlPolicyNormalParamRequest.IntlFlightLimitDTODomain();
obj5.DefaultRestrictOd = "SHA-NYC";
obj5.RestrictArrive = "SHA";
obj5.TransitDepot = "HKG";
obj5.RestrictDepart = "NYC";
obj5.TripType = 0L;
obj5.DirectTransferType = 0L;
obj5.Arrive = "SHA";
List<AlitripIntlPolicyNormalParamRequest.IntlItineraryDTODomain> list7 = new List<AlitripIntlPolicyNormalParamRequest.IntlItineraryDTODomain>();
AlitripIntlPolicyNormalParamRequest.IntlItineraryDTODomain obj8 = new AlitripIntlPolicyNormalParamRequest.IntlItineraryDTODomain();
list7.Add(obj8);
List<AlitripIntlPolicyNormalParamRequest.DatePairDomain> list10 = new List<AlitripIntlPolicyNormalParamRequest.DatePairDomain>();
AlitripIntlPolicyNormalParamRequest.DatePairDomain obj11 = new AlitripIntlPolicyNormalParamRequest.DatePairDomain();
list10.Add(obj11);
obj11.Start = DateTime.Parse(2024-09-08 10:10:10");
obj11.End = DateTime.Parse(2024-09-08 10:10:10");
obj8.AllowTravelDate= list10;
obj8.FlightIndex = 0L;
obj8.Cabin = "Y";
obj8.CabinClass = "P,Y";
obj8.CabinType = 0L;
obj8.AllowFlightNum = "CA5512";
obj5.Itineraries= list7;
obj5.Airline = "CA";
obj5.Depart = "SHA";
obj5.DefaultOd = 1L;
obj4.Flight= obj5;
AlitripIntlPolicyNormalParamRequest.IntlSaleLimitDTODomain obj12 = new AlitripIntlPolicyNormalParamRequest.IntlSaleLimitDTODomain();
obj12.SaleModeCode = 1L;
obj12.AdvanceDay = 2L;
obj12.IntermodalAirline = 0L;
AlitripIntlPolicyNormalParamRequest.DatePairDomain obj13 = new AlitripIntlPolicyNormalParamRequest.DatePairDomain();
obj13.Start = DateTime.Parse(2022-09-08 10:10:10");
obj13.End = DateTime.Parse(2022-09-08 10:10:10");
obj12.SaleDate= obj13;
obj4.Sale= obj12;
AlitripIntlPolicyNormalParamRequest.IntlBaggageLimitDTODomain obj14 = new AlitripIntlPolicyNormalParamRequest.IntlBaggageLimitDTODomain();
obj14.BaggageRule = "普通乘客：2件， 每件23公斤";
obj4.Baggage= obj14;
AlitripIntlPolicyNormalParamRequest.IntlPassengerLimitDTODomain obj15 = new AlitripIntlPolicyNormalParamRequest.IntlPassengerLimitDTODomain();
obj15.AgeLimit = "12-99";
obj15.Nationality = "CN";
obj15.NationalityType = 0L;
obj15.MinGroup = 0L;
obj15.PassengerType = "1,2";
obj4.Passenger= obj15;
AlitripIntlPolicyNormalParamRequest.IntlCombineRestrictLimitDTODomain obj16 = new AlitripIntlPolicyNormalParamRequest.IntlCombineRestrictLimitDTODomain();
obj16.FareCombinationFormula = 0L;
obj16.SupportGapType = 0L;
obj16.TravelDateFormula = 0L;
obj4.CombineRestrict= obj16;
obj1.Limit= obj4;
AlitripIntlPolicyNormalParamRequest.IntlPriceDTODomain obj17 = new AlitripIntlPolicyNormalParamRequest.IntlPriceDTODomain();
obj17.Notice = "本产品仅限中国大陆国际的乘客预定； 成功预定和出票赠送机上WIFI券";
obj1.Tp= obj17;
AlitripIntlPolicyNormalParamRequest.IntlLimitDTODomain obj18 = new AlitripIntlPolicyNormalParamRequest.IntlLimitDTODomain();
AlitripIntlPolicyNormalParamRequest.IntlRefundDTODomain obj19 = new AlitripIntlPolicyNormalParamRequest.IntlRefundDTODomain();
obj19.RefundType = 0L;
obj19.RefundFee = "200";
obj19.RefundFeeType = 0L;
obj19.RefundCurrency = "CNY";
obj19.ChildRefundFee = "200";
obj18.AllRefund= obj19;
List<AlitripIntlPolicyNormalParamRequest.IntlModifyDTODomain> list21 = new List<AlitripIntlPolicyNormalParamRequest.IntlModifyDTODomain>();
AlitripIntlPolicyNormalParamRequest.IntlModifyDTODomain obj22 = new AlitripIntlPolicyNormalParamRequest.IntlModifyDTODomain();
list21.Add(obj22);
obj22.ModifyType = 0L;
obj22.ChildModifyFee = "200";
obj22.Index = 0L;
obj22.ModifyCurrency = "CNY";
obj22.ModifyFee = "200";
obj22.ModifyFeeType = 0L;
obj18.Modifies= list21;
obj18.PublishedFareRule = 0L;
AlitripIntlPolicyNormalParamRequest.IntlRefundDTODomain obj23 = new AlitripIntlPolicyNormalParamRequest.IntlRefundDTODomain();
obj23.RefundType = 0L;
obj23.RefundFee = "200";
obj23.RefundFeeType = 0L;
obj23.RefundCurrency = "CNY";
obj23.ChildRefundFee = "200";
obj18.PartRefund= obj23;
obj1.Rp= obj18;
obj1.PaymentAccountCode = "1234";
obj1.PolicyCode = "abc123";
obj1.OfficeNo = "SDK123";
obj1.Memo = "备注";
req.CreateIntlPolicyDto_ = obj1;
AlitripIntlPolicyNormalParamResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlitripIntlPolicyNormalParamRequest;
$create_intl_policy_dto = new CreateIntlPolicyDTO;
$create_intl_policy_dto->supply_source="1234";
$create_intl_policy_dto->account_code="1234";
$no_show = new IntlNoShowDTO;
$no_show->no_show_fee="100";
$no_show->no_show_currency="CNY";
$no_show->no_show_rule_type="[0,1]";
$no_show->no_show_limit_time="10";
$no_show->no_show_type="0";
$no_show->no_show_limit_time_unit="0";
$create_intl_policy_dto->no_show = $no_show;
$create_intl_policy_dto->working_time="09:00MON-18:00FRI";
$create_intl_policy_dto->code_share_airline="KA(CX/CZ)";
$create_intl_policy_dto->default_type="0";
$create_intl_policy_dto->restrict_account_code="1234";
$create_intl_policy_dto->restrict_fare_basis="123abc";
$create_intl_policy_dto->fare_basis="123abc";
$create_intl_policy_dto->code_share="0";
$price = new IntlPriceDTO;
$price->support_fare_channel="1";
$price->child_return_price="20";
$price->min_price_limit="10";
$price->invoice_type="3";
$price->commission="20.02";
$price->child_commission="20.02";
$price->fare_source="2";
$price->return_price="100";
$price->max_price_limit="999999";
$price->soto_return_price="20";
$price->soto_commission="20.02";
$price->bidd_fee="10";
$price->bidd_fee_percent="2.12";
$create_intl_policy_dto->price = $price;
$limit = new IntlPriceDTO;
$flight = new IntlFlightLimitDTO;
$flight->default_restrict_od="SHA-NYC";
$flight->restrict_arrive="SHA";
$flight->transit_depot="HKG";
$flight->restrict_depart="NYC";
$flight->trip_type="0";
$flight->direct_transfer_type="0";
$flight->arrive="SHA";
$itineraries = new IntlItineraryDTO;
$allow_travel_date = new DatePair;
$allow_travel_date->start="2024-09-08 10:10:10";
$allow_travel_date->end="2024-09-08 10:10:10";
$itineraries->allow_travel_date = $allow_travel_date;
$itineraries->flight_index="0";
$itineraries->cabin="Y";
$itineraries->cabin_class="P,Y";
$itineraries->cabin_type="0";
$itineraries->allow_flight_num="CA5512";
$flight->itineraries = $itineraries;
$flight->airline="CA";
$flight->depart="SHA";
$flight->default_od="1";
$limit->flight = $flight;
$sale = new IntlSaleLimitDTO;
$sale->sale_mode_code="1";
$sale->advance_day="2";
$sale->intermodal_airline="0";
$sale_date = new DatePair;
$sale_date->start="2022-09-08 10:10:10";
$sale_date->end="2022-09-08 10:10:10";
$sale->sale_date = $sale_date;
$limit->sale = $sale;
$baggage = new IntlBaggageLimitDTO;
$baggage->baggage_rule="普通乘客：2件， 每件23公斤";
$limit->baggage = $baggage;
$passenger = new IntlPassengerLimitDTO;
$passenger->age_limit="12-99";
$passenger->nationality="CN";
$passenger->nationality_type="0";
$passenger->min_group="0";
$passenger->passenger_type="[1,2]";
$limit->passenger = $passenger;
$combine_restrict = new IntlCombineRestrictLimitDTO;
$combine_restrict->fare_combination_formula="0";
$combine_restrict->support_gap_type="0";
$combine_restrict->travel_date_formula="0";
$limit->combine_restrict = $combine_restrict;
$create_intl_policy_dto->limit = $limit;
$tp = new IntlPriceDTO;
$tp->notice="本产品仅限中国大陆国际的乘客预定； 成功预定和出票赠送机上WIFI券";
$create_intl_policy_dto->tp = $tp;
$rp = new IntlLimitDTO;
$all_refund = new IntlRefundDTO;
$all_refund->refund_type="0";
$all_refund->refund_fee="200";
$all_refund->refund_fee_type="0";
$all_refund->refund_currency="CNY";
$all_refund->child_refund_fee="200";
$rp->all_refund = $all_refund;
$modifies = new IntlModifyDTO;
$modifies->modify_type="0";
$modifies->child_modify_fee="200";
$modifies->index="0";
$modifies->modify_currency="CNY";
$modifies->modify_fee="200";
$modifies->modify_fee_type="0";
$rp->modifies = $modifies;
$rp->published_fare_rule="0";
$part_refund = new IntlRefundDTO;
$part_refund->refund_type="0";
$part_refund->refund_fee="200";
$part_refund->refund_fee_type="0";
$part_refund->refund_currency="CNY";
$part_refund->child_refund_fee="200";
$rp->part_refund = $part_refund;
$create_intl_policy_dto->rp = $rp;
$create_intl_policy_dto->payment_account_code="1234";
$create_intl_policy_dto->policy_code="abc123";
$create_intl_policy_dto->office_no="SDK123";
$create_intl_policy_dto->memo="备注";
$req->setCreateIntlPolicyDto(json_encode($create_intl_policy_dto));
$resp = $c->execute($req, $sessionKey);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=alitrip.intl.policy.normal.param' \
-d 'partner_id=apidoc' \
-d 'session=67427260-348f-4ddc-b65f-67dfd36a9cce' \
-d 'sign=46F25B741DDB2DC425A61EED60F69333' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-04-29+16%3A42%3A54' \
-d 'v=2.0' \
-d 'create_intl_policy_dto=null'

# -*- coding: utf-8 -*-
import top.api

req=top.api.AlitripIntlPolicyNormalParamRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.create_intl_policy_dto="数据结构示例JSON格式"
try:
	resp= req.getResponse(sessionkey)
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"alitrip.intl.policy.normal.param");
add_param(pRequest,"create_intl_policy_dto","数据结构JSON示例");
pResponse = top_execute(pClient,pRequest,sessionKey);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('alitrip.intl.policy.normal.param', {
	'create_intl_policy_dto':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alitrip_intl_policy_normal_param_response>
    <result>
        <msg>错误描述</msg>
        <code>403</code>
        <success>true</success>
    </result>
</alitrip_intl_policy_normal_param_response>

{
    "alitrip_intl_policy_normal_param_response":{
        "result":{
            "msg":"错误描述",
            "code":"403",
            "success":true
        }
    }
}

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>

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码	错误描述	解决方案

API测试工具错误码查询工具 SDK下载

开放平台

机票API

alitrip.intl.policy.normal.param (国际普通政策投放参数查询)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ