淘宝开放平台 - 文档中心

请求地址：

环境	HTTP请求地址
正式环境	http://qimen.api.taobao.com/router/qm
测试环境	http://qimen.api.taobao.com/router/qmtest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
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。
customerId	String	是	WMS颁发给用户的ID
sign_method	String	是	签名的摘要算法，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。

名称	类型	是否必须	示例值	更多限制	描述
token	String	必须	0aece10e82c2438c9dc2cdd7f646db37		本次请求token，会随着跳转的url带过去
operator	Operator	必须			本次操作人，也就是跳转到供应商的人
└ username String 可选王兵姓名，有可能传花名 └ employeeNo String 可选 135976 工号，有可能不传 └ htUserId String 必须 1007659 欢行用户id └ email String 可选 135976@alibaba.com 邮箱
taHead	TaHead	必须			差旅单头信息
└ remark String 可选 demo 备注 └ endDate String 可选 2019-07-28 00:00:00 差旅单结束日期 └ beginDate String 可选 2019-06-17 00:00:00 差旅单开始日期 └ createdByXuserId String 必须 1007659 差旅申请人欢行用户id └ approveStatus String 可选 demo 审批状态，仅保存 └ timeOffset Number 可选 -480 格林威治相差分钟，不判断 └ creatorEnName String 可选 demo 申请人英文名 └ otherStaffTicketName String 可选 demo 外部人员预定资源用的名字 └ isClosed String 可选 n 是否关闭，仅保存 └ buCode String 必须 AD 财务BUCode └ createdDate String 可选 2019-06-11 10:49:58 创建时间 └ submitDepartmentDesc String 可选阿x集x-x零x技x事x群-企x智x事x部-企x运x平x部-差x报x 实际申请人部门描述 └ autoApproveTime String 可选 demo 自动审批时间 └ corpId Number 必须 9243 租户id └ createdUserTicketName String 可选王x 申请人证件名 └ submitXuserOrdernum Number 必须 0 兼职序号 └ outerEnName String 可选 demo 外部人员英文名 └ finRegionDesc String 可选杭州-西溪园区（行政采购专用）财务区域描述 └ submitDate String 可选 2019-06-11 10:49:58 提交时间 └ travelType String 可选 Training_Ali_Institute_Lecture 差旅性质,Training_Ali_Institute_Lecture-探亲 └ isReimburse String 可选 n 是否报销 └ taHeadId String 必须 100287400 差旅单号 └ platformId Number 可选 1 单据创建的平台id └ isActive String 可选 Y 是否有效，仅保存 └ finRegionCode String 可选 B1019801 财务区域Code └ copyUser String 可选 demo 抄送人员 └ modifier String 可选 1007659 修改人欢行用户id └ outerId String 可选 demo 当差旅申请单从外部系统同步过来时存储的外部差旅单id └ submitterEnName String 可选 demo 实际申请人国际机票预订名称 └ projectCode String 可选 demo 项目Code └ changeOuReason String 可选 demo 修改默认OU的原因 └ fileids String 可选 demo 附件id └ submitDevice String 可选 P 提交差旅设备类型 └ projectId String 可选 demo 项目段id └ travelPurpose String 可选 CWT机票项目测试出差目的 └ transferToXuserId String 可选 demo 移交人欢行用户id └ creator String 可选 1007659 申请人欢行用户id └ isStrategyapprove String 可选 n 是否策略审批 └ lastUpdatedByXuserId String 可选 1007659 最后更新人的欢行用户id └ isModified String 可选 demo 修改行程会撤回单据，重新提交后，只需业务审批 └ submitXuserId String 必须 1007659 实际申请人的欢行用户id └ ouCode String 必须 A50 实际申请人的签约ouCode └ otherStaff String 可选张三@李四@Wang/Wu@Zhao/Liu 外部同行人，@是分隔符 └ submitCostcenter String 可选阿里健康-医药电商申请人成本中心描述 └ submitType String 可选 SELF 提交类别(SELF/OTHER) └ submitDepartmentKey String 可选 59467 申请人所在部门key，不同平台格式不同 └ lastUpdateDate String 可选 2019-06-11 10:49:58 最后更新日期 └ processInstenceId String 可选 demo 审批流实例ID └ costcenterCode String 可选 350120000901 费用归属部门/成本中心代码 └ submitUserTicketName String 可选 demo 实际申请人证件名 └ closedType String 可选 demo 关闭原因
itinerarys	Itinerary []	必须		最大列表长度：999999	差旅单中的行程信息
└ fromSiteLevelCode String 可选 LEVEL2 出发地levelCode └ toCityNameEn String 可选 Hangzhou 目的地城市英文 └ toSiteId String 可选 153 目的地siteId └ fromCityNameCn String 必须北京出发地城市中文 └ endDate String 可选 2019-06-23 00:00:00 行程结束日期 └ beginDate String 可选 2019-06-17 00:00:00 行程开始日期 └ travelPurpose String 可选 demo 本行程目的 └ toCityNameCn String 必须杭州目的地城市中文 └ fromSiteId String 可选 67 出发地siteId └ fromApproveArea String 可选 ChinaMainLand 出发地审批区域 └ fromCityThreeCode String 可选 demo 出发地城市三字码 └ fromCityNameEn String 可选 Beijing 出发地城市英文 └ toCountryNameCn String 可选中国目的地国家中文 └ toCountryNameEn String 可选 China 目的地国家英文 └ travelRegion String 可选 INTERNAL 行程区域 └ toCityThreeCode String 可选 demo 目的地城市三字码 └ createdDate String 可选 2019-06-11 10:50:00 创建日期 └ taLineId String 必须 10256360 持久化行程id，可作为唯一键使用 └ toApproveArea String 可选 ChinaMainLand 目的地审批区域 └ fromCountryNameCn String 可选中国出发地国家中文 └ fromCountryNameEn String 可选 China 出发地国家英文 └ taHeadId String 必须 100287400 差旅单号 └ lastUpdateDate String 可选 2019-06-11 10:50:00 最后更新日期 └ toSiteLevelCode String 可选 LEVEL4 目的地levelCode └ lineNumber Number 必须 1 行程序号 └ uuid String 必须 57c38b98b3b248eda3ecdcd186f8065b 行程uuid，非持久化，仅用于关联travelStandards对象，每次请求均不同 └ itineraryType String 可选 ROUND_TRIP ONE_WAY、ROUND_TRIP └ transportType String 可选 PLANE PLANE,TRAIN,AUTOMOTIVE,STEAMSHIP,OTHER └ version String 可选 1 数据版本号，业务根据实际情况使用 └ canBookEndTime String 可选 2019-07-03 00:00:00 可预订结束时间 └ canBookStartTime String 可选 2019-06-13 00:00:00 可预订的开始时间 └ selectedFlag String 可选 y 行程被选择标记,y\|n
tourists	Tourist []	必须		最大列表长度：999999	出行人信息（无持久化id）
└ middleName String 可选 demo 中间名 └ birthday String 可选 demo 生日 └ sex String 可选 M 性别 └ htUserId String 可选 1007659 欢行用户id，可能存在空，比如外部人员无用户id只有姓名 └ touristType Number 可选 0 出行人类型，-1-未知，0-成人，1-儿童，2-婴儿 └ certType String 可选 demo 证件类型,-1-未知，0-身份证，1-护照 └ surname String 可选 demo 姓 └ certNation String 可选 demo 证件签发国 └ taHeadId String 必须 100287400 差旅单号 └ employeeNo String 可选 135976 工号 └ certValidDate String 可选 demo 证件有效期 └ certNum String 可选 demo 证件号 └ email String 可选 135976@alibaba.com 出行人邮箱 └ nationalityEn String 可选 demo 国籍英文 └ name String 必须王兵全名 └ nationalityCn String 可选中国国籍中文 └ uuid String 必须 f5eabd69173348cf89205dfbbec6f1cc 出行人uuid，非持久化，仅用于关联travelStandards对象，每次请求均不同 └ firstName String 可选 demo 名 └ travelBusinessType Number 必须 0 人员业务类型，-1-未知类型，0-出行人（有欢行用户id），1-同行人（有欢行用户id），2-外部人员（无工号，无欢行用户id，无邮箱）
financeInfos	FinanceInfo []	可选		最大列表长度：999999	财务信息，用List防止未来出现多个的场景，需求不对人，则默认取第一个即可
└ ouCode String 可选 A50 差旅单实际申请人的签约ouCode，也就是差旅单中的ouCode信息 └ paymentOuCode String 可选 A50 差旅单实际申请人的BU对应的付款OU └ buCode String 可选 AD 差旅单实际申请人的BU，也就是差旅单的BUCode └ accountOuCode String 可选 A50 差旅单实际申请人的签约OU对应的记账OU └ costcenterCode String 可选 a123121a 成本中心code └ projectCode String 可选 asd12312312 项目段code └ finRegionCode String 可选 asad123213 财务区域code
travelStandards	TravelStandard []	可选		最大列表长度：999	差标对象数组
└ itineraryUuid String 可选 57c38b98b3b248eda3ecdcd186f8065b 行程uuid └ touristUuid String 可选 f5eabd69173348cf89205dfbbec6f1cc 出行人uuid flightStandard FlightStandard 可选机票差标 └ cabinUpgradeRuleJson String [] 可选特殊规则，特殊航班规则，这里定义成Json字符串，目的是防止不同的租户对差标有不同的诉求，导致对外接口不稳定定义为List表示存在多个组合，对象对象之间是或的关系，对象内是且的关系 { "originCabinClass":"Y", "effectiveDateRange":"12", "effectiveDateRangeUnit":"month", "numOfTimes":, "duration":"480", "durationUnit":"minute", "targetCabinClass":"C" } premiumEconomyClass CabinStandard 可选超经舱标准（null代表不符合此标准） └ canReserve Boolean 可选 true 是否可以预定（null代表不可预定） └ cabinDiscount String 可选 100 舱等折扣（null代表不限制） economyClass CabinStandard 可选经济舱标准（null代表不符合此标准） └ canReserve Boolean 可选 true 是否可以预定（null代表不可预定） └ cabinDiscount String 可选 100 舱等折扣（null代表不限制） businessClass CabinStandard 可选商务舱标准（null代表不符合此标准） └ canReserve Boolean 可选 false 是否可以预定（null代表不可预定） └ cabinDiscount String 可选 90 舱等折扣（null代表不限制） firstClass CabinStandard 可选头等舱标准（null代表不符合此标准） └ canReserve Boolean 可选 false 是否可以预定（null代表不可预定） └ cabinDiscount String 可选 75 舱等折扣（null代表不限制） └ levelCode String 可选 G1 差旅等级Code hotelStandard HotelStandard 可选酒店差旅标准 └ isOutOfControl Boolean 可选 false 是否不收标准限值 └ amoutUpper Number 可选 600.00 标准金额上限 └ amountLower Number 可选 400.00 标准金额下限 └ starUpper String 可选 aaa 星级限值上限 └ starLower String 可选 aaa 星级限值下限 └ isMealStandardEnable Boolean 可选 false 是否允许使用餐标 mealStandard MealStandard 可选餐饮标准 └ amount Number 可选 150.00 金额

名称	类型	示例值	描述
errno	String	0	错误码，0为通知成功，非0为通知失败
errmsg	String	success	错误信息描述

{"itinerarys":[{"selectedFlag":"y","fromCityThreeCode":"demo","endDate":"2019-06-23 00:00:00","lastUpdateDate":"2019-06-11 10:50:00","toCityNameEn":"Hangzhou","fromSiteId":"67","toCityNameCn":"杭州","taLineId":"10256360","fromCityNameCn":"北京","uuid":"57c38b98b3b248eda3ecdcd186f8065b","fromCityNameEn":"Beijing","itineraryType":"ROUND_TRIP","toApproveArea":"ChinaMainLand","toCityThreeCode":"demo","fromCountryNameEn":"China","fromSiteLevelCode":"LEVEL2","fromApproveArea":"ChinaMainLand","transportType":"PLANE","fromCountryNameCn":"中国","toSiteId":"153","travelPurpose":"demo","toCountryNameCn":"中国","canBookEndTime":"2019-07-03 00:00:00","version":"1","beginDate":"2019-06-17 00:00:00","createdDate":"2019-06-11 10:50:00","travelRegion":"INTERNAL","toSiteLevelCode":"LEVEL4","toCountryNameEn":"China","taHeadId":"100287400","lineNumber":1,"canBookStartTime":"2019-06-13 00:00:00"}],"taHead":{"approveStatus":"demo","endDate":"2019-07-28 00:00:00","lastUpdateDate":"2019-06-11 10:49:58","modifier":"1007659","ouCode":"A50","processInstenceId":"demo","isActive":"Y","submitXuserOrdernum":0,"closedType":"demo","isModified":"demo","submitCostcenter":"阿里健康-医药电商","finRegionCode":"B1019801","changeOuReason":"demo","submitDevice":"P","otherStaffTicketName":"demo","submitterEnName":"demo","corpId":9243,"outerEnName":"demo","submitDepartmentDesc":"阿x集x-x零x技x事x群-企x智x事x部-企x运x平x部-差x报x","buCode":"AD","travelPurpose":"CWT机票项目测试","fileids":"demo","taHeadId":"100287400","submitDepartmentKey":"59467","copyUser":"demo","isStrategyapprove":"n","autoApproveTime":"demo","projectId":"demo","submitXuserId":"1007659","submitType":"SELF","isReimburse":"n","submitDate":"2019-06-11 10:49:58","remark":"demo","otherStaff":"张三@李四@Wang/Wu@Zhao/Liu","transferToXuserId":"demo","createdByXuserId":"1007659","createdUserTicketName":"王x","travelType":"Training_Ali_Institute_Lecture","creatorEnName":"demo","costcenterCode":"350120000901","projectCode":"demo","submitUserTicketName":"demo","creator":"1007659","timeOffset":-480,"platformId":1,"finRegionDesc":"杭州-西溪园区（行政采购专用）","beginDate":"2019-06-17 00:00:00","createdDate":"2019-06-11 10:49:58","isClosed":"n","outerId":"demo","lastUpdatedByXuserId":"1007659"},"financeInfos":[{"costcenterCode":"a123121a","projectCode":"asd12312312","finRegionCode":"asad123213","ouCode":"A50","paymentOuCode":"A50","buCode":"AD","accountOuCode":"A50"}],"travelStandards":[{"touristUuid":"f5eabd69173348cf89205dfbbec6f1cc","levelCode":"G1","itineraryUuid":"57c38b98b3b248eda3ecdcd186f8065b","hotelStandard":{"starLower":"aaa","isMealStandardEnable":false,"amoutUpper":0,"isOutOfControl":false,"amountLower":0,"starUpper":"aaa"},"flightStandard":{"premiumEconomyClass":{"cabinDiscount":"100","canReserve":true},"firstClass":{"cabinDiscount":"75","canReserve":false},"economyClass":{"cabinDiscount":"100","canReserve":true},"businessClass":{"cabinDiscount":"90","canReserve":false},"cabinUpgradeRuleJson":[""]},"mealStandard":{"amount":0}}],"tourists":[{"birthday":"demo","certType":"demo","sex":"M","employeeNo":"135976","certNation":"demo","uuid":"f5eabd69173348cf89205dfbbec6f1cc","htUserId":"1007659","touristType":0,"firstName":"demo","travelBusinessType":0,"nationalityEn":"demo","surname":"demo","taHeadId":"100287400","nationalityCn":"中国","name":"王兵","certValidDate":"demo","middleName":"demo","certNum":"demo","email":"135976@alibaba.com"}],"operator":{"employeeNo":"135976","email":"135976@alibaba.com","username":"王兵","htUserId":"1007659"},"token":"0aece10e82c2438c9dc2cdd7f646db37"}

{
    "errno":"0",
    "errmsg":"success"
}

错误码	错误描述	解决方案

错误码查询工具 SDK下载

开放平台

欢行开发平台API

qimen.alibaba.happytrip.ta.send (差旅单同步接口)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ