飞猪 - 开放平台

请求地址：

环境	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。

名称	类型	是否必须	示例值	更多限制	描述
rq	OpenApiApplyRq	必须			请求对象
└ thirdpart_apply_id String 必须 12345 外部申请单id └ thirdpart_business_id String 可选 12345 用户展示的外部审批单id信息 └ corp_id String 必须 corp1 第三方企业id └ corp_name String 可选阿里巴巴企业名称 └ depart_id String 可选 dept1 部门id，如果不传，会根据user相关信息去获取对应的部门信息，如果传的是错误的部门信息，后面无法做部门的费用归属；部门ID只能是数字 └ depart_name String 可选淘宝部门名称 itinerary_list OpenItineraryInfo [] 可选行程列表行程列表 └ arr_city String 可选北京到达城市 └ arr_city_code String 可选 BJS 必填，到达城市编码。传0时，不管控到达城市。注意：出发/到达地点只能都不限，或者都限制。不限城市情况，请注意酒店差标的传参，确保所有城市都有传入差标 └ arr_date Date 可选 2017-01-01 00:00:00 到达日期 └ cost_center_id Number 可选 123 商旅成本中心id，若不填则第三方成本中心id必填 └ dep_city String 可选杭州出发城市 └ dep_city_code String 可选 HGH 必填，出发城市编码。传0时，不管控出发城市。注意：出发/到达地点只能都不限，或者都限制。不限城市情况，请注意酒店差标的传参，确保所有城市都有传入差标 └ dep_date Date 可选 2017-01-01 00:00:00 出发日期 └ invoice_id Number 可选 1234 商旅发票id，和第三方发票id选填一个即可 └ itinerary_id String 可选 123456 行程id └ project_code String 可选 xm1 项目编码 └ project_title String 可选项目1 项目名称 └ thirdpart_cost_center_id String 可选 12345 第三方成本中心id，若不填则商旅成本中心id必填 └ traffic_type Number 可选 0 交通方式： 0 飞机、酒店、用车, 1 火车、酒店、用车, 2 用车、酒店, 3 用车、酒店，4 用车、酒店，6 飞机、用车，7 火车、用车，9 飞机、火车、酒店、用车，10 飞机、火车、用车，11 仅用车，21 飞机、酒店，22 火车、酒店，24 酒店，25 飞机，26 火车，27 飞机、火车、酒店，28 飞机、火车 └ trip_way Number 可选 0 行程类型：0单程，1往返 └ third_part_invoice_id String 可选 1234 第三方发票id，和商旅发票id选填一个即可 └ need_hotel Boolean 可选 true 行程是否需要预定酒店，不传默认需要 └ need_traffic Boolean 可选 true 行程是否需要预定交通工具，不传默认需要 └ status Number 可选 0 审批单状态，不传入默认为0：0审批中，1同意，2拒绝 traveler_list OpenUserInfo [] 可选出行人列表 └ user_id String 可选 user1 出行人id（第三方用户id） └ user_name String 可选张三出行人名称 └ trip_cause String 必须北京出差出差事由 └ trip_day Number 可选 1 出差天数 └ trip_title String 必须北京出差申请单标题 └ user_id String 必须 user1 申请人Id（第三方用户id） └ user_name String 可选张三用户名称，如果要传必须传真实姓名，如果不传则会以系统当前维护userId对应的名称进行预订 └ version Number 可选 2 1、老版本2、isv对外版本 external_traveler_list OpenUserInfo [] 可选外部出行人列表 └ user_name String 可选张三出行人名称，英文姓名请用“/”分隔，中间不能含有空格，顺序：姓/名（last-name/first-name） └ hotel_budget Number 可选 1000 审批单酒店预算，单位分。注意：特殊授权人住店产生的杂费（用餐、房间内商品等）将在退房时扣款，由企业支付 └ flight_budget Number 可选 1000 审批单机票预算，单位分 └ train_budget Number 可选 1000 审批单火车票预算，单位分。注意：例如坐席同为”硬卧“，上/中/下铺存在价格差异的情况，预订时将按照其中最高价格，校验预算余额 └ vehicle_budget Number 可选 1000 审批单用车预算，单位分。注意：打车场景存在不可控因素，会超出原预估价格：1. 乘客线下修改目的地；2. 堵车等道路意外情况；3. 司机添加附加费，如过路费、高速费、等待费等 └ budget Number 可选 1000 审批单总预算，单位分 └ union_no String 可选 tste1 关联单号 └ budget_merge Number 可选 1 多个申请单预算合并。1：否，【union_no】相同的【申请单(apply id)】，每个的【预算】仅对本申请单生效。2：是，所有【union_no】相同的【申请单(apply id)】，其中全部【预算】合并求和，可以混用。 └ limit_traveler Number 可选 1 0：不限制出行人，1：限申请单内的出行人。注意：不限出行人，实际出行人也不限制差标，而且传入的出行人信息也不会存储 └ together_book_rule Number 可选 1 同时预订(机票&火车票)规则。1：就高；2：就低。 hotel_share HotelShareInfo 可选酒店合住规则 └ type String 可选 1 合住公式。1-"(A+B)param%",2-"Aparam%",3-"A+B*param%",4-"A+param元",5-"(A+B)/2+param元" └ param String 可选 70 请传入整数即可，当合住方式为1/2/3时接口会处理成x% external_traveler_standard ExternalUserStandard 可选外部出行人差标 └ flight_cabins String 可选 Y 国内机票舱等，多值逗号分隔。F：头等舱，C：商务舱，Y：经济舱，P：超级经济舱 └ economy_discount Number 可选 1 经济舱折扣。1到10的整数 └ business_discount Number 可选 1 商务舱折扣。1到10的整数 └ first_discount Number 可选 1 头等舱折扣。1到10的整数 └ train_seats String 可选 1 火车票坐席，多值逗号分隔。0：硬座，1：硬卧，2：软座，3：软卧，4：高级软卧，5：商务座，6：一等座，7：二等座，8：动卧 hotel_citys HotelCityFee [] 可选酒店城市费用列表 └ city_code String 可选 330100 城市编码，传0代表其他全部城市 └ city_name String 可选北京城市名称 └ fee Number 可选 10000 酒店间夜金额，单位(分)，如需不限请传99999999。注意：差标只能管控到元，角、分会被抹掉，请避免传入角、分的值。 └ reserve_type Number 可选 1 限制差标类型。0-不限差标，1-限制差标。注意：同一审批单的所有出行人只能都限制差标/都不限制差标，否则会调用失败 └ international_flight_cabins String 可选 Y 国际机票舱等，多值逗号分隔。F：头等舱，C：商务舱，Y：经济舱，P：超级经济舱 └ premium_economy_discount Number 可选 1 超级经济舱折扣。1到10的整数 traveler_standard InternalUserStandard [] 可选内部人员差标列表 └ flight_cabins String 可选 Y 国内机票舱等，多值逗号分隔。F：头等舱，C：商务舱，Y：经济舱，P：超级经济舱 └ economy_discount Number 可选 1 经济舱折扣。1到10的整数 └ business_discount Number 可选 1 商务舱折扣。1到10的整数 └ first_discount Number 可选 1 头等舱折扣。1到10的整数 └ train_seats String 可选 1 火车票坐席，多值逗号分隔。0：硬座，1：硬卧，2：软座，3：软卧，4：高级软卧，5：商务座，6：一等座，7：二等座，8：动卧 hotel_citys HotelCityFee [] 可选酒店城市费用列表 └ city_code String 可选 330100 城市编码，传0代表其他全部城市 └ city_name String 可选北京城市名称 └ fee Number 可选 10000 酒店间夜金额，单位(分)，如需不限请传99999999。注意：差标只能管控到元，角、分会被抹掉，请避免传入角、分的值。 └ reserve_type Number 可选 1 限制差标类型。0-不限差标，1-限制差标。注意：同一审批单的所有出行人只能都限制差标/都不限制差标，否则会调用失败 └ user_id String 可选 weifeng 出行人id（第三方用户id） └ international_flight_cabins String 可选 Y 国际机票舱等，多值逗号分隔。F：头等舱，C：商务舱，Y：经济舱，P：超级经济舱 └ premium_economy_discount Number 可选 1 超级经济舱折扣。1到10的整数 itinerary_set_list OpenItinerarySetInfo [] 可选城市集行程列表城市集行程列表 └ itinerary_id String 可选 asdfgh 行程id └ traffic_type Number 可选 0 交通方式： 0 飞机、酒店、用车, 1 火车、酒店、用车, 2 用车、酒店, 3 用车、酒店，4 用车、酒店，6 飞机、用车，7 火车、用车，9 飞机、火车、酒店、用车，10 飞机、火车、用车，11 仅用车，21 飞机、酒店，22 火车、酒店，24 酒店，25 飞机，26 火车，27 飞机、火车、酒店，28 飞机、火车 └ city_set String 可选北京，上海离抵城市名称，多个城市请用中文“，”隔开 └ city_code_set String 可选 BJS，SHA 离抵城市code，多个城市请用中文“，”隔开当允许预订的类目为1/3/7/9时，仅传行政区划citycode允许通过当允许预订的类目为0/6时，仅传城市三字码允许通过 └ dep_date String 可选 2017-01-01 00:00:00 出发日期 └ arr_date String 可选 2017-01-01 00:00:00 到达日期 └ cost_center_id Number 可选 234567 商旅成本中心id，和第三方成本中心id二者选择其一即可 └ thirdpart_cost_center_id String 可选第三方成本中心id 第三方成本中心id，和商旅成本中心id二者选择其一即可 └ invoice_id Number 可选 23456 商旅发票id，和第三方发票Id二者选择其一即可 └ third_part_invoice_id String 可选第三方发票id 第三方发票id，和商旅发票id二者选择其一即可 └ project_code String 可选项目编号项目编号 └ project_title String 可选项目名称项目名称 └ itinerary_rule Number 可选 0 申请单城市规则： 0出发&目的地一对一，按列表传行程 1多选N个地点，城市集行程不传默认为0 会根据商旅管理后台-通用差旅设置-行程城市规则中的设置，校验申请单本字段的值是否正确当行程城市规则中设置的是“1对1行程”时，必须传0 当行程城市规则中设置的是“多对多城市集行程”时，必须传1 会根据此字段传入的值，校验行程传参是否正确当申请单城市规则为0，itinerary_list行程列表必填当申请单城市规则为1，城市集行程必填 └ extend_field String 可选 {"cost_center":"成本中心"} 可将补充描述传入此字段，账单中将会体现此字段的值。可以用于企业的统计和对账

名称	类型	示例值	描述
result	HisvResult	result	结果对象
module OpenApiApplyRs module 结果对象 └ apply_id Number 123 商旅申请单ID └ thirdpart_apply_id String 12345 外部申请单ID └ result_code Number 0 错误码 └ result_msg String 成功错误信息 └ is_success Boolean true 成功标识

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripBtripCorpopApplyModifyRequest req = new AlitripBtripCorpopApplyModifyRequest();
AlitripBtripCorpopApplyModifyRequest.OpenApiApplyRq obj1 = new AlitripBtripCorpopApplyModifyRequest.OpenApiApplyRq();
obj1.setThirdpartApplyId("12345");
obj1.setThirdpartBusinessId("12345");
obj1.setCorpId("corp1");
obj1.setCorpName("阿里巴巴");
obj1.setDepartId("dept1");
obj1.setDepartName("淘宝");
List<AlitripBtripCorpopApplyModifyRequest.OpenItineraryInfo> list3 = new ArrayList<AlitripBtripCorpopApplyModifyRequest.OpenItineraryInfo>();
AlitripBtripCorpopApplyModifyRequest.OpenItineraryInfo obj4 = new AlitripBtripCorpopApplyModifyRequest.OpenItineraryInfo();
list3.add(obj4);
obj4.setArrCity("北京");
obj4.setArrCityCode("BJS");
obj4.setArrDate(StringUtils.parseDateTime("2017-01-01 00:00:00"));
obj4.setCostCenterId(123L);
obj4.setDepCity("杭州");
obj4.setDepCityCode("HGH");
obj4.setDepDate(StringUtils.parseDateTime("2017-01-01 00:00:00"));
obj4.setInvoiceId(1234L);
obj4.setItineraryId("123456");
obj4.setProjectCode("xm1");
obj4.setProjectTitle("项目1");
obj4.setThirdpartCostCenterId("12345");
obj4.setTrafficType(0L);
obj4.setTripWay(0L);
obj4.setThirdPartInvoiceId("1234");
obj4.setNeedHotel(true);
obj4.setNeedTraffic(true);
obj1.setItineraryList(list3);
obj1.setStatus(0L);
List<AlitripBtripCorpopApplyModifyRequest.OpenUserInfo> list6 = new ArrayList<AlitripBtripCorpopApplyModifyRequest.OpenUserInfo>();
AlitripBtripCorpopApplyModifyRequest.OpenUserInfo obj7 = new AlitripBtripCorpopApplyModifyRequest.OpenUserInfo();
list6.add(obj7);
obj7.setUserId("user1");
obj7.setUserName("张三");
obj1.setTravelerList(list6);
obj1.setTripCause("北京出差");
obj1.setTripDay(1L);
obj1.setTripTitle("北京出差");
obj1.setUserId("user1");
obj1.setUserName("张三");
obj1.setVersion(2L);
List<AlitripBtripCorpopApplyModifyRequest.OpenUserInfo> list9 = new ArrayList<AlitripBtripCorpopApplyModifyRequest.OpenUserInfo>();
AlitripBtripCorpopApplyModifyRequest.OpenUserInfo obj10 = new AlitripBtripCorpopApplyModifyRequest.OpenUserInfo();
list9.add(obj10);
obj10.setUserName("张三");
obj1.setExternalTravelerList(list9);
obj1.setHotelBudget(1000L);
obj1.setFlightBudget(1000L);
obj1.setTrainBudget(1000L);
obj1.setVehicleBudget(1000L);
obj1.setBudget(1000L);
obj1.setUnionNo("tste1");
obj1.setBudgetMerge(1L);
obj1.setLimitTraveler(1L);
obj1.setTogetherBookRule(1L);
AlitripBtripCorpopApplyModifyRequest.HotelShareInfo obj11 = new AlitripBtripCorpopApplyModifyRequest.HotelShareInfo();
obj11.setType("1");
obj11.setParam("70");
obj1.setHotelShare(obj11);
AlitripBtripCorpopApplyModifyRequest.ExternalUserStandard obj12 = new AlitripBtripCorpopApplyModifyRequest.ExternalUserStandard();
obj12.setFlightCabins("Y");
obj12.setEconomyDiscount(1L);
obj12.setBusinessDiscount(1L);
obj12.setFirstDiscount(1L);
obj12.setTrainSeats("1");
List<AlitripBtripCorpopApplyModifyRequest.HotelCityFee> list14 = new ArrayList<AlitripBtripCorpopApplyModifyRequest.HotelCityFee>();
AlitripBtripCorpopApplyModifyRequest.HotelCityFee obj15 = new AlitripBtripCorpopApplyModifyRequest.HotelCityFee();
list14.add(obj15);
obj15.setCityCode("330100");
obj15.setCityName("北京");
obj15.setFee(10000L);
obj12.setHotelCitys(list14);
obj12.setReserveType(1L);
obj12.setInternationalFlightCabins("Y");
obj12.setPremiumEconomyDiscount(1L);
obj1.setExternalTravelerStandard(obj12);
List<AlitripBtripCorpopApplyModifyRequest.InternalUserStandard> list17 = new ArrayList<AlitripBtripCorpopApplyModifyRequest.InternalUserStandard>();
AlitripBtripCorpopApplyModifyRequest.InternalUserStandard obj18 = new AlitripBtripCorpopApplyModifyRequest.InternalUserStandard();
list17.add(obj18);
obj18.setFlightCabins("Y");
obj18.setEconomyDiscount(1L);
obj18.setBusinessDiscount(1L);
obj18.setFirstDiscount(1L);
obj18.setTrainSeats("1");
List<AlitripBtripCorpopApplyModifyRequest.HotelCityFee> list21 = new ArrayList<AlitripBtripCorpopApplyModifyRequest.HotelCityFee>();
AlitripBtripCorpopApplyModifyRequest.HotelCityFee obj22 = new AlitripBtripCorpopApplyModifyRequest.HotelCityFee();
list21.add(obj22);
obj22.setCityCode("330100");
obj22.setCityName("北京");
obj22.setFee(10000L);
list19.setHotelCitys(list21);
obj18.setReserveType(1L);
obj18.setUserId("weifeng");
obj18.setInternationalFlightCabins("Y");
obj18.setPremiumEconomyDiscount(1L);
obj1.setTravelerStandard(list17);
List<AlitripBtripCorpopApplyModifyRequest.OpenItinerarySetInfo> list24 = new ArrayList<AlitripBtripCorpopApplyModifyRequest.OpenItinerarySetInfo>();
AlitripBtripCorpopApplyModifyRequest.OpenItinerarySetInfo obj25 = new AlitripBtripCorpopApplyModifyRequest.OpenItinerarySetInfo();
list24.add(obj25);
obj25.setItineraryId("asdfgh");
obj25.setTrafficType(0L);
obj25.setCitySet("北京，上海");
obj25.setCityCodeSet("BJS，SHA");
obj25.setDepDate("2017-01-01 00:00:00");
obj25.setArrDate("2017-01-01 00:00:00");
obj25.setCostCenterId(234567L);
obj25.setThirdpartCostCenterId("第三方成本中心id");
obj25.setInvoiceId(23456L);
obj25.setThirdPartInvoiceId("第三方发票id");
obj25.setProjectCode("项目编号");
obj25.setProjectTitle("项目名称");
obj1.setItinerarySetList(list24);
obj1.setItineraryRule(0L);
obj1.setExtendField("{\"cost_center\":\"成本中心\"}");
req.setRq(obj1);
AlitripBtripCorpopApplyModifyResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlitripBtripCorpopApplyModifyRequest req = new AlitripBtripCorpopApplyModifyRequest();
AlitripBtripCorpopApplyModifyRequest.OpenApiApplyRqDomain obj1 = new AlitripBtripCorpopApplyModifyRequest.OpenApiApplyRqDomain();
obj1.ThirdpartApplyId = "12345";
obj1.ThirdpartBusinessId = "12345";
obj1.CorpId = "corp1";
obj1.CorpName = "阿里巴巴";
obj1.DepartId = "dept1";
obj1.DepartName = "淘宝";
List<AlitripBtripCorpopApplyModifyRequest.OpenItineraryInfoDomain> list3 = new List<AlitripBtripCorpopApplyModifyRequest.OpenItineraryInfoDomain>();
AlitripBtripCorpopApplyModifyRequest.OpenItineraryInfoDomain obj4 = new AlitripBtripCorpopApplyModifyRequest.OpenItineraryInfoDomain();
list3.Add(obj4);
obj4.ArrCity = "北京";
obj4.ArrCityCode = "BJS";
obj4.ArrDate = DateTime.Parse(2017-01-01 00:00:00");
obj4.CostCenterId = 123L;
obj4.DepCity = "杭州";
obj4.DepCityCode = "HGH";
obj4.DepDate = DateTime.Parse(2017-01-01 00:00:00");
obj4.InvoiceId = 1234L;
obj4.ItineraryId = "123456";
obj4.ProjectCode = "xm1";
obj4.ProjectTitle = "项目1";
obj4.ThirdpartCostCenterId = "12345";
obj4.TrafficType = 0L;
obj4.TripWay = 0L;
obj4.ThirdPartInvoiceId = "1234";
obj4.NeedHotel = true;
obj4.NeedTraffic = true;
obj1.ItineraryList= list3;
obj1.Status = 0L;
List<AlitripBtripCorpopApplyModifyRequest.OpenUserInfoDomain> list6 = new List<AlitripBtripCorpopApplyModifyRequest.OpenUserInfoDomain>();
AlitripBtripCorpopApplyModifyRequest.OpenUserInfoDomain obj7 = new AlitripBtripCorpopApplyModifyRequest.OpenUserInfoDomain();
list6.Add(obj7);
obj7.UserId = "user1";
obj7.UserName = "张三";
obj1.TravelerList= list6;
obj1.TripCause = "北京出差";
obj1.TripDay = 1L;
obj1.TripTitle = "北京出差";
obj1.UserId = "user1";
obj1.UserName = "张三";
obj1.Version = 2L;
List<AlitripBtripCorpopApplyModifyRequest.OpenUserInfoDomain> list9 = new List<AlitripBtripCorpopApplyModifyRequest.OpenUserInfoDomain>();
AlitripBtripCorpopApplyModifyRequest.OpenUserInfoDomain obj10 = new AlitripBtripCorpopApplyModifyRequest.OpenUserInfoDomain();
list9.Add(obj10);
obj10.UserName = "张三";
obj1.ExternalTravelerList= list9;
obj1.HotelBudget = 1000L;
obj1.FlightBudget = 1000L;
obj1.TrainBudget = 1000L;
obj1.VehicleBudget = 1000L;
obj1.Budget = 1000L;
obj1.UnionNo = "tste1";
obj1.BudgetMerge = 1L;
obj1.LimitTraveler = 1L;
obj1.TogetherBookRule = 1L;
AlitripBtripCorpopApplyModifyRequest.HotelShareInfoDomain obj11 = new AlitripBtripCorpopApplyModifyRequest.HotelShareInfoDomain();
obj11.Type = "1";
obj11.Param = "70";
obj1.HotelShare= obj11;
AlitripBtripCorpopApplyModifyRequest.ExternalUserStandardDomain obj12 = new AlitripBtripCorpopApplyModifyRequest.ExternalUserStandardDomain();
obj12.FlightCabins = "Y";
obj12.EconomyDiscount = 1L;
obj12.BusinessDiscount = 1L;
obj12.FirstDiscount = 1L;
obj12.TrainSeats = "1";
List<AlitripBtripCorpopApplyModifyRequest.HotelCityFeeDomain> list14 = new List<AlitripBtripCorpopApplyModifyRequest.HotelCityFeeDomain>();
AlitripBtripCorpopApplyModifyRequest.HotelCityFeeDomain obj15 = new AlitripBtripCorpopApplyModifyRequest.HotelCityFeeDomain();
list14.Add(obj15);
obj15.CityCode = "330100";
obj15.CityName = "北京";
obj15.Fee = 10000L;
obj12.HotelCitys= list14;
obj12.ReserveType = 1L;
obj12.InternationalFlightCabins = "Y";
obj12.PremiumEconomyDiscount = 1L;
obj1.ExternalTravelerStandard= obj12;
List<AlitripBtripCorpopApplyModifyRequest.InternalUserStandardDomain> list17 = new List<AlitripBtripCorpopApplyModifyRequest.InternalUserStandardDomain>();
AlitripBtripCorpopApplyModifyRequest.InternalUserStandardDomain obj18 = new AlitripBtripCorpopApplyModifyRequest.InternalUserStandardDomain();
list17.Add(obj18);
obj18.FlightCabins = "Y";
obj18.EconomyDiscount = 1L;
obj18.BusinessDiscount = 1L;
obj18.FirstDiscount = 1L;
obj18.TrainSeats = "1";
List<AlitripBtripCorpopApplyModifyRequest.HotelCityFeeDomain> list20 = new List<AlitripBtripCorpopApplyModifyRequest.HotelCityFeeDomain>();
AlitripBtripCorpopApplyModifyRequest.HotelCityFeeDomain obj21 = new AlitripBtripCorpopApplyModifyRequest.HotelCityFeeDomain();
list20.Add(obj21);
obj21.CityCode = "330100";
obj21.CityName = "北京";
obj21.Fee = 10000L;
obj18.HotelCitys= list20;
obj18.ReserveType = 1L;
obj18.UserId = "weifeng";
obj18.InternationalFlightCabins = "Y";
obj18.PremiumEconomyDiscount = 1L;
obj1.TravelerStandard= list17;
List<AlitripBtripCorpopApplyModifyRequest.OpenItinerarySetInfoDomain> list23 = new List<AlitripBtripCorpopApplyModifyRequest.OpenItinerarySetInfoDomain>();
AlitripBtripCorpopApplyModifyRequest.OpenItinerarySetInfoDomain obj24 = new AlitripBtripCorpopApplyModifyRequest.OpenItinerarySetInfoDomain();
list23.Add(obj24);
obj24.ItineraryId = "asdfgh";
obj24.TrafficType = 0L;
obj24.CitySet = "北京，上海";
obj24.CityCodeSet = "BJS，SHA";
obj24.DepDate = "2017-01-01 00:00:00";
obj24.ArrDate = "2017-01-01 00:00:00";
obj24.CostCenterId = 234567L;
obj24.ThirdpartCostCenterId = "第三方成本中心id";
obj24.InvoiceId = 23456L;
obj24.ThirdPartInvoiceId = "第三方发票id";
obj24.ProjectCode = "项目编号";
obj24.ProjectTitle = "项目名称";
obj1.ItinerarySetList= list23;
obj1.ItineraryRule = 0L;
obj1.ExtendField = "{\"cost_center\":\"成本中心\"}";
req.Rq_ = obj1;
AlitripBtripCorpopApplyModifyResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlitripBtripCorpopApplyModifyRequest;
$rq = new OpenApiApplyRq;
$rq->thirdpart_apply_id="12345";
$rq->thirdpart_business_id="12345";
$rq->corp_id="corp1";
$rq->corp_name="阿里巴巴";
$rq->depart_id="dept1";
$rq->depart_name="淘宝";
$itinerary_list = new OpenItineraryInfo;
$itinerary_list->arr_city="北京";
$itinerary_list->arr_city_code="BJS";
$itinerary_list->arr_date="2017-01-01 00:00:00";
$itinerary_list->cost_center_id="123";
$itinerary_list->dep_city="杭州";
$itinerary_list->dep_city_code="HGH";
$itinerary_list->dep_date="2017-01-01 00:00:00";
$itinerary_list->invoice_id="1234";
$itinerary_list->itinerary_id="123456";
$itinerary_list->project_code="xm1";
$itinerary_list->project_title="项目1";
$itinerary_list->thirdpart_cost_center_id="12345";
$itinerary_list->traffic_type="0";
$itinerary_list->trip_way="0";
$itinerary_list->third_part_invoice_id="1234";
$itinerary_list->need_hotel="true";
$itinerary_list->need_traffic="true";
$rq->itinerary_list = $itinerary_list;
$rq->status="0";
$traveler_list = new OpenUserInfo;
$traveler_list->user_id="user1";
$traveler_list->user_name="张三";
$rq->traveler_list = $traveler_list;
$rq->trip_cause="北京出差";
$rq->trip_day="1";
$rq->trip_title="北京出差";
$rq->user_id="user1";
$rq->user_name="张三";
$rq->version="2";
$external_traveler_list = new OpenUserInfo;
$external_traveler_list->user_name="张三";
$rq->external_traveler_list = $external_traveler_list;
$rq->hotel_budget="1000";
$rq->flight_budget="1000";
$rq->train_budget="1000";
$rq->vehicle_budget="1000";
$rq->budget="1000";
$rq->union_no="tste1";
$rq->budget_merge="1";
$rq->limit_traveler="1";
$rq->together_book_rule="1";
$hotel_share = new HotelShareInfo;
$hotel_share->type="1";
$hotel_share->param="70";
$rq->hotel_share = $hotel_share;
$external_traveler_standard = new ExternalUserStandard;
$external_traveler_standard->flight_cabins="Y";
$external_traveler_standard->economy_discount="1";
$external_traveler_standard->business_discount="1";
$external_traveler_standard->first_discount="1";
$external_traveler_standard->train_seats="1";
$hotel_citys = new HotelCityFee;
$hotel_citys->city_code="330100";
$hotel_citys->city_name="北京";
$hotel_citys->fee="10000";
$external_traveler_standard->hotel_citys = $hotel_citys;
$external_traveler_standard->reserve_type="1";
$external_traveler_standard->international_flight_cabins="Y";
$external_traveler_standard->premium_economy_discount="1";
$rq->external_traveler_standard = $external_traveler_standard;
$traveler_standard = new InternalUserStandard;
$traveler_standard->flight_cabins="Y";
$traveler_standard->economy_discount="1";
$traveler_standard->business_discount="1";
$traveler_standard->first_discount="1";
$traveler_standard->train_seats="1";
$hotel_citys = new HotelCityFee;
$hotel_citys->city_code="330100";
$hotel_citys->city_name="北京";
$hotel_citys->fee="10000";
$traveler_standard->hotel_citys = $hotel_citys;
$traveler_standard->reserve_type="1";
$traveler_standard->user_id="weifeng";
$traveler_standard->international_flight_cabins="Y";
$traveler_standard->premium_economy_discount="1";
$rq->traveler_standard = $traveler_standard;
$itinerary_set_list = new OpenItinerarySetInfo;
$itinerary_set_list->itinerary_id="asdfgh";
$itinerary_set_list->traffic_type="0";
$itinerary_set_list->city_set="北京，上海";
$itinerary_set_list->city_code_set="BJS，SHA";
$itinerary_set_list->dep_date="2017-01-01 00:00:00";
$itinerary_set_list->arr_date="2017-01-01 00:00:00";
$itinerary_set_list->cost_center_id="234567";
$itinerary_set_list->thirdpart_cost_center_id="第三方成本中心id";
$itinerary_set_list->invoice_id="23456";
$itinerary_set_list->third_part_invoice_id="第三方发票id";
$itinerary_set_list->project_code="项目编号";
$itinerary_set_list->project_title="项目名称";
$rq->itinerary_set_list = $itinerary_set_list;
$rq->itinerary_rule="0";
$rq->extend_field="{\"cost_center\":\"成本中心\"}";
$req->setRq(json_encode($rq));
$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.btrip.corpop.apply.modify' \
-d 'partner_id=apidoc' \
-d 'session=93468f39-d2eb-4654-9c04-a0737e97fceb' \
-d 'sign=45BCE4B943162AF208128A83E37284DB' \
-d 'sign_method=hmac' \
-d 'timestamp=2024-04-19+16%3A26%3A07' \
-d 'v=2.0' \
-d 'rq=null'

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

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

req.rq=""
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.btrip.corpop.apply.modify");
add_param(pRequest,"rq","数据结构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.btrip.corpop.apply.modify', {
	'rq':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alitrip_btrip_corpop_apply_modify_response>
    <result>
        <module>
            <apply_id>123</apply_id>
            <thirdpart_apply_id>12345</thirdpart_apply_id>
        </module>
        <result_code>0</result_code>
        <result_msg>成功</result_msg>
        <is_success>true</is_success>
    </result>
</alitrip_btrip_corpop_apply_modify_response>

{
    "alitrip_btrip_corpop_apply_modify_response":{
        "result":{
            "module":{
                "apply_id":123,
                "thirdpart_apply_id":"12345"
            },
            "result_code":0,
            "result_msg":"成功",
            "is_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"
	}
}

错误码	错误描述	解决方案
-204	找不到申请人信息	在商旅企业管理后台维护申请人信息，或者通过同步企业人员接口同步申请人
9012	出行人列表用户ID（user_id）缺失	传入traveler_list的user_id字段
9002	找不到申请人信息	在商旅企业管理后台维护申请人信息，或者通过同步企业人员接口同步申请人
9016	总预算与类目预算不能同时存在	酒店预算，机票预算，火车票预算，用车预算不能与申请单总预算同时存在。 hotel_budget，flight_budget，train_budget，vehicle_budget（单类目预算）这一组值，和budget（总预算）这一组，只能存在一组，不能同时存在
9017	union_no和单类目预算不能同时存在	传入union_no代表是按照总预算来管控，不可以传单类目预算。传入union_no的情况，如果需要预算管控，只能通过总预算（budget）来管控
9020	酒店城市费用列表不能超过50个	外部出行人差标中的酒店城市费用列表过长，超过了50个限制。 external_traveler_standard的hotel_citys列表长度，不能超过50个
9019	酒店城市费用列表(city_code,fee)不能为空	出行人差标中（包括内部出行人以及外部出行人）的酒店城市费用列表的城市编码和酒店间夜金额不能为空。 external_traveler_standard/traveler_standard的hotel_citys中city_code和fee需要传值
9022	同一审批单中的所有出行人只能都限制/都不限制差标"	如果出行人差标中有出行人不限制差标，那审批单中所有出行人都需要不限制差标。反之，如果出行人差标中有出行人限制差标，那审批单中所有出行人都需要限制差标。 external_traveler_standard/traveler_standard的reserveTypeCount都为0或者都为1
9007	用户成本中心缺失	传入的行程列表中有的没传成本中心。 itinerary_list中的cost_center_id或thirdpart_cost_center_id必传其一
9023	用户(%s)没有操作成本中心:%s的权限	传入的行程列表中的成本中心，申请单提交人没有权限使用。检查行程列表中的成本中心是否归属于该申请单提交人
9008	用户发票抬头缺失	传入的行程列表中有的没传发票抬头。 itinerary_list中的invoice_id或third_part_invoice_id必传其一
9021	行程到达城市编码和出发城市编码只能都不限，或者都限制	行程的到达城市编码和出发城市编码只能都传0或者都是具体城市
9014	新增外部出行人失败	系统原因，需要重试一次
1020	原审批单不存在预算,不允许新增预算	修改审批单的时候新增了预算，但是原审批单不存在预算，不允许新增。不能传入预算相关字段
1022	审批单预算使用规则不允许修改	描述：有以下集中情况 1. 原审批单只有budget（总预算），修改审批单不允许新增hotel_budget，flight_budget，train_budget，vehicle_budget（单类目预算）这一组值 2. 原审批单只有hotel_budget，flight_budget，train_budget，vehicle_budget（单类目预算）这一组值，修改审批单不允许新增budget（总预算）这一组值 3. 修改了审批单的budget_merge，budget_merge不允许修改

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

开放平台

商旅API

alitrip.btrip.corpop.apply.modify (【商旅】修改出差审批单（行程）)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ