国内机票


国内机票

国内机票订单列表查询

通过该接口查询国内机票订单列表。

遵循GDPR要求,默认只返回因公出行的订单。

接口URL

/queryflightorderlist

请求参数定义

参数名参数说明必填参数类型长度值举例备注
CorpCode企业账号YString1000系统提供的企业账号
Timestamp时间戳YString1420180811113019服务方仅允许20分钟内的时间误差。
Version版本号YString3.0固定为3.0。
LoginName操作人帐号YStringHW_0000011、如果是系统维护,写“sysadmin”2、如果是普通员工维护,写员工登录名
OrderID国内机票订单号NStringF0215042408435860475根据订单号查询
StartCreateDate订单生成起始日期NString20130423yyyyMMdd。如果调用者置空,则默认当天,并且从00:00开始
EndCreateDate订单生成截止时间NString20130424yyyyMMdd。如果调用者置空,则默认当天,并且以23:59结束最长查询一个月的数据
EnterpriseTrID企业客户系统审批单编号NStringTA0315012116281300028如果此字段有值,则不考虑StartCreateDate和EndCreateDate查询条件,仅查询该出差申请单号对应的订单数据
PageIndex查询的页码YString
Size每页条数YString建议20,上限50

响应参数定义

参数名参数说明必填参数类型长度值举例备注
ResultCode返回码YString00表示成功,其他值为失败。
Description描述YStringSuccess描述信息,出错时为错误信息即错误原因。
PageIndex当前的页码NString1
Size每页条数NString1
Total总记录数NString1
FlightOrderList机票订单列表NList<FlightOrder>

国内机票订单FlightOrder

参数名参数说明必填参数类型长度值举例备注
OrderID订单号YStringF02130626111647367
CorpOrderID企业自有订单号NStringSL2017122100029企业OA系统上的自有订单号,暂不启用
OrderTime下订单时间NString20180811113019yyyyMMddHHmmss
OrderStatus订单状态YString0:预订失败 1:待支付2:待出票3:已出票4:已取消5:出票失败6:暂缓出票8:价格变化待确认 9:出票中11:预订中3、4为终态,可以获取详细数据
TravelType出行方式NString0:因公出行1:因私出行默认返回因公出行订单
JourneyType行程类型NString0:单程1:普通往返2:联程3:特价往返
TotalPrice订单总价NString115订单总价,退改不更新订单总价。订单总价=总票面价+总机建费+总燃油费+总保险费用+总服务费
Currency币种NStringCNY国内机票目前都为人民币
OrderSource订单产品来源NString0:前台web页面预订1:后台呼叫中心预订20:iOS客户端预订21:Android客户端预订3:PNR导入7:H5预订
PayWay支付方式NString1:个人在线支付 2:个人IVR支付(OP)3:现金 4:POS 6:因公欠款 7:vip欠款 8:担保欠款 10:外部月结
PayStatus支付状态NString0:未支付1:已支付
EnterpriseTrID企业客户系统审批单编号NStringTA0315012116281300028
HtTrID华为云数字化差旅审批单编号NStringTA0315012116281300028

样例

请求示例

{
	"CorpCode": "1234",
	"Timestamp": "20221022150000",
	"Version": "3.0",
	"LoginName": "sysadmin",
	"StartCreateDate": "20220922",
	"EndCreateDate": "20221022",
	"OrderID:"F0215042408435860475",
	"EnterpriseTrID":"TA0315012116281300028",
	"Size": "1",
	"PageIndex": "1"
}

响应示例

{
	"ResultCode": "0",
	"Description": "Success",
	"PageIndex": "11",
	"Size": "40",
	"Total": "436",
	"FlightOrderList": [{
		"OrderID": "F02130626111647367",
		"CorpOrderID": "SL2017122100029",
		"OrderTime": "20220925182102",
		"OrderStatus": "3",
		"TravelType": "0",
		"JourneyType": "0",
		"TotalPrice": "2879.00",
		"Currency": "CNY",
		"OrderSource": "7",
		"PayWay": "10",
		"PayStatus": "0",
		"HtTrID": "TA0315012116281300028",
		"EnterpriseTrID": "TA0315012116281300028"
	}]
}

国内机票订单详情查询

通过该接口查询国内机票订单详情。

接口URL

/queryflightorderdetail

请求参数定义

参数名参数说明必填参数类型长度值举例备注
CorpCode企业账号YString1000系统提供的企业账号
Timestamp时间戳YString1420180811113019服务方仅允许20分钟内的时间误差。
Version版本号YString3.0固定为3.0。
LoginName操作人帐号YStringHW_0000011、如本次操作为系统相关,则该字段为固定字符串值:"sysadmin";2、如操作为指定普通员工信息维护或修改,则该字符串为:“<员工登录账户名称>"。
OrderID订单IDYStringF02130626111647367国内机票订单号

响应参数定义

参数名参数说明必填参数类型长度值举例备注
ResultCode返回码YString00表示成功
Description描述YStringSuccess描述信息,出错时为错误信息即错误原因。
OrderID订单号NStringF02130626111647367
CorpOrderID企业自有订单号NStringSL2017122100029企业OA系统上的自有订单号,不启用。
OrderTime下订单时间NString20180811113019yyyyMMddHHmmss
OrderStatus订单状态NString0:预订失败 1:待支付2:待出票3:已出票4:已取消5:出票失败6:暂缓出票8:价格变化待确认 9:出票中11:预订中
TravelType出行方式NString0:因公出行1:因私出行
JourneyType行程类型NString0:单程1:往返2:联程
TotalPrice订单总价NString115订单总价=总票面价+总机建费+总燃油费+总保险费用+总服务费改期会更新总价(总价中不包括改期费),退票不更新总价。
TotalServiceFee总服务费NString115此数据仅供参考,以结算报表数据为准
Currency币种NStringCNY
OrderSource订单产品来源NString0:前台web页面预订1:后台呼叫中心预订20:iOS客户端预订21:Android客户端预订3:PNR导入7:H5预订
PayWay支付方式NString1:个人在线支付 2:个人IVR支付(OP)3:现金 4:POS 6:因公欠款 7:vip欠款 8:担保欠款 10:外部月结
PayChannel支付渠道NStringalipay:支付宝weixin:微信支付yeepay:易宝支付chinapay:银联支付填写alipay等
PayStatus支付状态NString0:未支付1:已支付
PassengerInfoList乘客信息集合NList<PassengerInfo>票挂人下。改会刷新票信息,退不刷新。
AirChangeInfoList改期单详情NList<AirChangeInfo>
AirRefundInfoList申退单详情NList<AirRefundInfo>
EnterpriseTrID企业客户系统审批单编号NStringTA0315012116281300028
HtTrID华为云数字化差旅审批单编号NStringTA0315012116281300028
ContactName联系人姓名NString张三如有多联系人,此为主联系人
ContactMobile联系人手机号NString13710001000
ContactMail联系人邮件NStringzhangsan@huawei.com
BenefitInfoList差旅受益信息NList<BenefitInfo>
Orderer预订人YEmployee包含LoginName /Name/EmployeeNum/EmployeeUID等字段
Creator创建人YCreator
VipLevel订单VIP标识NString1:VIP目前这个字段为1时代表订单是vip订单,否则不是vip订单
DeliveryAddress配送地址NString北京市东城区
TicketPlatform票台NString票台描述信息,暂时无用,后续扩展

PassengerInfo乘机人信息

参数名参数说明必选参数类型长度值举例备注
Passenger乘客信息YEmployee返回Name/EmployeeNum/EmployeeUID
TicketInfoList票信息列表NList<TicketInfo>最新客票信息。
BenefitInfo差旅受益信息NBenefitInfo

TicketInfo票信息

参数名参数说明必填参数类型长度值举例备注
TicketCode票号NString781-1231231连续票号用分号隔开已出票的才有数据,仅占位的不提供
TicketTime出票时间NString20180811113019yyyyMMddHHmmss
TicketStatus客票状态NString0:不可1:可用4:已使用
RefundStatus退票状态NString0:已退票1:未退票2:退票中默认为1:未退票
ChangeStatus改期状态NString0:无改期1:改期中2:已改期默认为0:无改期
TicketPrice票面价NString1000
FDPrice公布运价NString
YFullPrice全价NString
AirConstrnFee机建费NString50国内段使用
FuelFee燃油费NString50国内段使用
Tax税费NString50国际段使用
InsuranceCount保险份数NString2
InsuranceFee总保险费用NString40
InsuranceInfoList保险详细信息NList<InsuranceInfo>
ServiceFee服务费NString预留,通过报表结算
FlightInfoList航班信息集合NList<FlightInfo>
CheckRule退改签NString不可退改文本信息
ViolationInfo违规信息NString按“业务类型:违规原因编码:违规原因描述
PNRNoPNRNStringQSZCAW
SupplierType供应商类型YString提供资源的渠道类型
UatpCardNoUatp卡号YString1975610204

航班信息FlightInfo

参数名参数说明必填参数类型长度值举例备注
JourneyIndex航程YString0:去程1:返程
Segmentindex航段idYString1:第1段2:第2段去程、返程均从1开始编码
Airways航空公司二字码YStringCA
AirwaysName航空公司名称YString中国国际航空公司
ActualAirways实际承运航空公司二字码NStringY8
ActualAirwaysName实际承运航空公司名称NString金鹏航空
DepartAirport起飞机场三字码YStringSZX
DepartAirportName起飞机场名称YString深圳宝安国际机场
ArrivalAirport到达机场三字码YStringCKG
ArrivalAirportName到达机场名称YString重庆江北机场
DepartTime起飞时间YString20180811113019yyyyMMddHHMMss
DepartCityThreeCode出发城市三字码NStringSZX城市三字码,实际出发城市三字码
DepartCityChineseName出发城市中文名称NString深圳实际出发城市
ArriveTime到达时间YString20180811113019yyyyMMddHHMMss
ArriveCityThreeCode到达城市三字码NStringCKG城市三字码
ArriveCityChineseName到达城市中文名称NString重庆
Flight航班号YStringZC12312
ActualFlight实际承运航班号NStringY87537
Aircraft机型NString20738机型代码
Cabin舱位编码NStringF
CabinLevel舱位等级NString0: 头等舱 1: 商务舱 2: 经济舱 3: 高端经济舱
CabinDiscount舱位折扣NString1.5国内段使用
DepartTerminal起飞航站楼NStringT3
ArrivalTerminal到达航站楼NStringT2B
FreeLuggage免费行李额NString暂不支持
Tpm里程信息NString1226单位:KM

改期单信息AirChangeInfo

参数名参数说明必填参数类型长度值举例备注
ChangeID改期单号YStringC124829391
OrderID订单号YStringF02130626111647367
PayWay支付方式NString1:个人在线支付 2:个人IVR支付(OP)3:现金 4:POS 6:因公欠款 7:vip欠款 8:担保欠款 10:外部月结
PayStatus支付状态NString0:未支付1:已支付
PayChannel支付渠道NStringalipay:支付宝weixin:微信支付yeepay:易宝支付chinapay:银联支付填写alipay等
ChangeStatus改期单状态YString2:改期处理中3:已取消4:已完成5:待支付6:待改期7:待退款3、4为终态,可以获取详细数据
ChangeSource改期单来源YString0:前台web页面预订1:后台呼叫中心预订20:iOS客户端预订21:Android客户端预订3:PNR导入7:H5预订
TotalChangeFee总改期费NString370.00改期总费用=总改期费+总服务费+票价差价总额+购保差价总额
ChangeRemark用户备注NString误机员工填写
ChangeReason改期原因NString误机或出行计划变更员工选择:误机或出行计划变更,航班取消,航班时间变更,肺炎疫情
ChangeAppTime改期申请时间YString20180811113019yyyyMMddHHMMss
ChangeCompleteTime改期完成时间NString20180811113019yyyyMMddHHMMss
Creator创建人YCreator提交改期单的人员信息
ChangeDetailList改期单NList<ChangeDetail>

改期单详情ChangeDetail

参数名参数说明必填参数类型长度值举例备注
PassengerInfo乘客信息YEmployee一个改期详情一个乘客
OldTicket原客票YChangeTicketInfo
NewTicket新客票YChangeTicketInfo
OrgFlightInfo原航班YList<FlightInfo>
NewFlightInfo新航班YList<FlightInfo>
PlatformChangeFee改期费YString130.00
ServiceFee改期服务费YString0.00
RefInsuranceFee退保费用YString0.00

改期ChangeTicketInfo

参数名参数说明必填参数类型长度值举例备注
TicketNo票号YString880-1234678590
PNRNoPNRNStringASDQWS
FDPrice公布运价NString500
YFullPrice全价NString500
TicketPrice票面价YString500
FuelFee燃油费YString50
AirConstrFee基建费YString50
InsuranceFee总保险费用NString40
SupplierPayType供应商支付方式YStringUATP:uatp卡CASH:现金

机票申退单AirRefundInfo

参数名参数说明必填参数类型长度值举例备注
RefundNO申退单号YStringR124829391
OrderID订单号YStringF02130626111647367
PayWay支付方式YString1:个人在线支付 2:个人IVR支付(OP)3:现金 4:POS 6:因公欠款 7:vip欠款 8:担保欠款 10:外部月结
RefundStatus申退状态YString1:退票申请中2:完成退票等待退款3:退票失败4:完成退款5:退款中6:自动退票中2、4为终态,可以获取详细数据
RefundTime申退时间YString20180811113019
RefundCompleteTime退票完成时间NString20180811113019
RefundPoundageTotal退票手续费总计NString120.00
ActualRefundTotal实际退款总计NString1203.00实际退款总计=订单价格(票面价+基建+燃油) - 退票手续费总计 + 退保费用总计
RefundInsuranceTotal退保费用总计NString0.00
RefundReason退票原因NString自愿放弃行程用户选择的退票文字原因:自愿放弃行程,航班取消或时间变更,航班备降,其他(自愿),已支付未出票退款,误机,病退,其他(非自愿),肺炎疫情
Remark客户备注NString航班取消
Creator创建人YCreator提交申退单的人员信息
RefundDetailInfoList申退详情列表NList<RefundDetailInfo>

申退详情RefundDetailInfo

参数名参数说明必填参数类型长度值举例备注
TicketNo票号YString880-1234678590
TicketAmount票面价YString1200.00
TicketFee客票税费YString200.00
RefundPoundageRate退票手续费率YString5.00
RefundFee退票手续费YString60.00
RefundServiceFee退票服务费YString
RefundInsuranceFee申退保险金额YString
PassengerInfo乘客信息YEmployee一张票一个乘客
SupplierPayType供应商支付方式YStringUATP:uatp卡CASH:现金

保险详细信息InsuranceInfo

参数名参数说明必填参数类型长度值举例备注
InsuranceNum保险单号NString50BX201810241805140000003371
InsuranceProductName保险产品名称YString50航意险
InsuranceProductNum保险产品编号NString50ZAXQ20
InsuranceFee保险金额YString
InsuranceStatus保险状态NString10:不可用1:购保成功2:购保失败3:购保中
RefInsuranceStatus退保状态NString10:退保成功1:未退2:退保失败3:退保中
PayWay支付方式NString21:个人在线支付 2:个人IVR支付(OP)3:现金 4:POS 6:因公欠款 7:vip欠款 8:担保欠款 10:外部月结
PayStatus支付状态NString10:未支付1:已支付
PayChannel支付渠道NString20alipay:支付宝weixin:微信支付yeepay:易宝支付chinapay:银联支付填写alipay等

样例

请求示例

{
	"CorpCode": "1234",
	"Timestamp": "20221022150000",
	"Version": "3.0",
	"LoginName": "sysadmin",
	"OrderID:"F0215042408435860475"
}

响应示例

{
	"ResultCode": "0",
	"Description": "Success",
	"OrderID": "F02130626111647367",
	"CorpOrderID": "SL2017122100029",
	"OrderTime": "20221019185628",
	"OrderStatus": "3",
	"TravelType": "0",
	"JourneyType": "0",
	"TotalPrice": "550.00",
	"TotalServiceFee": "0.0",
	"Currency": "CNY",
	"OrderSource": "21",
	"PayWay": "10",
	"PayStatus": "0",
	"PassengerInfoList": [{
		"Passenger": {
			"LoginName": "HW_000001",
			"Name": "张三",
			"Surname": "ZHANG",
			"GivenName": "SAN",
			"Gender": "M",
			"Type": "0",
			"Nationality": "156",
			"Birthday": "19881111",
			"Mailbox": "zhangsan@huawei.com",
			"Cellphone": "13710001000",
			"Telephone": "075528560000",
			"CertificateInfoList": [{
				"CertificateType": "1",
				"CertificateNum": "35222519771081001X",
				"ExpiredDate": "20180811",
				"PassportIssueDate": "20180811113019",
				"PassportIssueCountry": "156",
				"PassportIssueProvince": "Jiangsu"
			}],
			"DeptNum": "1234",
			"DeptName": "市场部",
			"EmployeeNum": "12345",
			"Role": "2",
			"EmployeeLevel": "1",
			"Remark": "员工",
			"EmployeeVIPLevel": "2",
			"EmployeeUID": "20"
		},
		"TicketInfoList": [{
			"TicketCode": "781-1231231",
			"TicketTime": "20221019185652",
			"TicketStatus": "4",
			"RefundStatus": "1",
			"ChangeStatus": "0",
			"TicketPrice": "350.00",
			"FDPrice": "350.00",
			"YFullPrice": "2340",
			"AirConstrnFee": "50.00",
			"FuelFee": "120.00",
			"Tax": "50.00",
			"InsuranceCount": "1",
			"InsuranceFee": "30.00",
			"InsuranceInfoList": [{
				"InsuranceNum": "BX201810241805140000003371",
				"InsuranceProductName": "航空意外险",
				"InsuranceProductNum": "149160099",
				"InsuranceFee": "30.00",
				"InsuranceStatus": "1",
				"RefInsuranceStatus": "1",
				"PayWay": "1",
				"PayStatus": "1",
				"PayChannel": "alipay"
			}],
			"ServiceFee": "0.00",
			"FlightInfoList": [{
				"JourneyIndex": "0",
				"Segmentindex": "1",
				"Airways": "CA",
				"AirwaysName": "中国国际航空公司",
				"DepartAirport": "SZX",
				"DepartAirportName": "深圳宝安国际机场",
				"ArrivalAirport": "CKG",
				"ArrivalAirportName": "重庆江北机场",
				"DepartTime": "20221021091500",
				"DepartCityThreeCode": "SZX",
				"DepartCityChineseName": "深圳",
				"ArriveTime": "20221021113000",
				"ArriveCityThreeCode": "CKG",
				"ArriveCityChineseName": "重庆",
				"Flight": "CA7537",
				"Cabin": "F",
				"CabinLevel": "2",
				"CabinDiscount": "1.5",
				"DepartTerminal": "T3",
				"ArrivalTerminal": "T2B",
				"FreeLuggage": "",
				"Aircraft": "738",
				"ActualAirways": "Y8",
				"ActualAirwaysName": "金鹏航空",
				"ActualFlight": "Y87537"
			}],
			"CheckRule": "不可退改",
			"ViolationInfo": "国内机票:2:临时安排",
			"PNRNo": "KY05C3",
			"SupplierType": "BSP-PEK916",
			"UatpCardNo": "1975610204"
		}],
		"BenefitInfo": {
			"BenefitType": "0",
			"CostCenterNum": "5678",
			"CostCenterName": "企业侧的成本中心或项目名称",
			"Percentage": "50",
			"Approver": {
				"LoginName": "HW_000001",
				"Name": "张三",
				"Surname": "ZHANG",
				"GivenName": "SAN",
				"Gender": "M",
				"Type": "0",
				"Nationality": "156",
				"Birthday": "19881111",
				"Mailbox": "zhangsan@huawei.com",
				"Cellphone": "13710001000",
				"Telephone": "075528560000",
				"CertificateInfoList": [{
					"CertificateType": "1",
					"CertificateNum": "35222519771081001X",
					"ExpiredDate": "20180811",
					"PassportIssueDate": "20180811113019",
					"PassportIssueCountry": "156",
					"PassportIssueProvince": "Jiangsu"
				}],
				"DeptNum": "1234",
				"DeptName": "市场部",
				"EmployeeNum": "12345",
				"Role": "2",
				"EmployeeLevel": "1",
				"Remark": "员工",
				"EmployeeVIPLevel": "2",
				"EmployeeUID": "20"
			},
			"ApproveTime": "20130423101011",
			"Opinion": "同意",
			"CostCenterOne": null,
			"CostCenterTwo": null
		}
	}],
	"AirChangeInfoList": [{
		"ChangeID": "C124829391",
		"OrderID": "F124829390",
		"PayWay": "10",
		"PayChannel": "",
		"PayStatus": "0",
		"ChangeStatus": "4",
		"Creator": {
			"LoginName": "HW_000001",
			"Name": "张三",
			"EmployeeUID": "ID200403105920854590",
			"EmployeeNum": "12345"
		},
		"ChangeSource": "7",
		"TotalChangeFee": "370.00",
		"ChangeRemark": "误机",
		"ChangeReason": "误机或出行计划变更",
		"ChangeAppTime": "20221019094122",
		"ChangeCompleteTime": "20221019094200",
		"ChangeDetailList": [{
			"PassengerInfo": {
				"LoginName": "HW_000001",
				"Name": "张三",
				"Surname": "ZHANG",
				"GivenName": "SAN",
				"Gender": "M",
				"Type": "0",
				"Nationality": "156",
				"Birthday": "19881111",
				"Mailbox": "zhangsan@huawei.com",
				"Cellphone": "13710001000",
				"Telephone": "075528560000",
				"CertificateInfoList": [{
					"CertificateType": "1",
					"CertificateNum": "35222519771081001X",
					"ExpiredDate": "20180811",
					"PassportIssueDate": "20180811113019",
					"PassportIssueCountry": "156",
					"PassportIssueProvince": "Jiangsu"
				}],
				"DeptNum": "1234",
				"DeptName": "市场部",
				"EmployeeNum": "12345",
				"Role": "2",
				"EmployeeLevel": "1",
				"Remark": "员工",
				"EmployeeVIPLevel": "2",
				"EmployeeUID": "20"
			},
			"OldTicket": {
				"TicketNo": "880-1234678590",
				"TicketPrice": "260.00",
				"FuelFee": "120.00",
				"AirConstrFee": "50.00",
				"PNRNo": "HW7MF1",
				"FDPrice": "",
				"YFullPrice": "",
				"SupplierPayType": "CASH",
				"InsuranceFee": "0.00"
			},
			"NewTicket": {
				"TicketNo": "880-1234678591",
				"TicketPrice": "500.00",
				"FuelFee": "120.00",
				"AirConstrFee": "50.00",
				"PNRNo": "JFTRQJ",
				"FDPrice": "",
				"YFullPrice": "",
				"SupplierPayType": "CASH",
				"InsuranceFee": "0.00"
			},
			"OrgFlightInfo": {
				"JourneyIndex": "0",
				"Segmentindex": "1",
				"Airways": "CA",
				"AirwaysName": "中国国际航空公司",
				"DepartAirport": "SZX",
				"DepartAirportName": "深圳宝安国际机场",
				"ArrivalAirport": "CKG",
				"ArrivalAirportName": "重庆江北机场",
				"DepartTime": "20221021091500",
				"DepartCityThreeCode": "SZX",
				"DepartCityChineseName": "深圳",
				"ArriveTime": "20221021113000",
				"ArriveCityThreeCode": "CKG",
				"ArriveCityChineseName": "重庆",
				"Flight": "CA7537",
				"Cabin": "F",
				"CabinLevel": "2",
				"CabinDiscount": "1.5",
				"DepartTerminal": "T3",
				"ArrivalTerminal": "T2B",
				"FreeLuggage": "",
				"Aircraft": "738",
				"ActualAirways": "Y8",
				"ActualAirwaysName": "金鹏航空",
				"ActualFlight": "Y87537"
			},
			"NewFlightInfo": {
				"JourneyIndex": "0",
				"Segmentindex": "1",
				"Airways": "CA",
				"AirwaysName": "中国国际航空公司",
				"DepartAirport": "SZX",
				"DepartAirportName": "深圳宝安国际机场",
				"ArrivalAirport": "CKG",
				"ArrivalAirportName": "重庆江北机场",
				"DepartTime": "20221022091500",
				"DepartCityThreeCode": "SZX",
				"DepartCityChineseName": "深圳",
				"ArriveTime": "20221022113000",
				"ArriveCityThreeCode": "CKG",
				"ArriveCityChineseName": "重庆",
				"Flight": "CA7537",
				"Cabin": "F",
				"CabinLevel": "2",
				"CabinDiscount": "1.5",
				"DepartTerminal": "T3",
				"ArrivalTerminal": "T2B",
				"FreeLuggage": "",
				"Aircraft": "738",
				"ActualAirways": "Y8",
				"ActualAirwaysName": "金鹏航空",
				"ActualFlight": "Y87537"
			},
			"PlatformChangeFee": "130.00",
			"ServiceFee": "0.00",
			"RefInsuranceFee": "0"
		}]
	}],
	"AirRefundInfoList": [{
		"Creator": {
			"LoginName": "HW_000001",
			"Name": "张三",
			"EmployeeUID": "ID200403105920854590",
			"EmployeeNum": "12345"
		},
		"RefundNO": "R124829391",
		"OrderID": "F124829390",
		"PayWay": "10",
		"RefundStatus": "4",
		"RefundTime": "20221020074311",
		"RefundCompleteTime": "20221020182601",
		"RefundPoundageTotal": "260.00",
		"ActualRefundTotal": "410.00",
		"RefundInsuranceTotal": "0.00",
		"RefundDetailInfoList": [{
			"TicketNo": "999-6769587083",
			"TicketAmount": "500.00",
			"TicketFee": "170.00",
			"RefundPoundageRate": "52.00",
			"RefundFee": "260.00",
			"RefundServiceFee": "0.00",
			"RefundInsuranceFee": "0.00",
			"PassengerInfo": {
				"LoginName": "HW_000001",
				"Name": "张三",
				"Surname": "ZHANG",
				"GivenName": "SAN",
				"Gender": "M",
				"Type": "0",
				"Nationality": "156",
				"Birthday": "19881111",
				"Mailbox": "zhangsan@huawei.com",
				"Cellphone": "13710001000",
				"Telephone": "075528560000",
				"CertificateInfoList": [{
					"CertificateType": "1",
					"CertificateNum": "35222519771081001X",
					"ExpiredDate": "20180811",
					"PassportIssueDate": "20180811113019",
					"PassportIssueCountry": "156",
					"PassportIssueProvince": "Jiangsu"
				}],
				"DeptNum": "1234",
				"DeptName": "市场部",
				"EmployeeNum": "12345",
				"Role": "2",
				"EmployeeLevel": "1",
				"Remark": "员工",
				"EmployeeVIPLevel": "2",
				"EmployeeUID": "20"
			}
		}],
		"RefundReason": "自愿放弃行程",
		"Remark": "武汉突发疫情,无法接待"
	}],
	"EnterpriseTrID": "TA0315012116281300028",
	"HtTrID": "TA0315012116281300028",
	"ContactName": "张三",
	"ContactMobile": "13710001000",
	"ContactMail": "zhangsan@huawei.com",
	"PayChannel": "alipay",
	"VipLevel": "1",
	"Creator": {
		"LoginName": "HW_000001",
		"Name": "张三",
		"EmployeeUID": "ID200403105920854590",
		"EmployeeNum": "12345"
	},
	"Orderer": {
		"LoginName": "HW_000001",
		"Name": "张三",
		"Surname": "ZHANG",
		"GivenName": "SAN",
		"Gender": "M",
		"Type": "0",
		"Nationality": "156",
		"Birthday": "19881111",
		"Mailbox": "zhangsan@huawei.com",
		"Cellphone": "13710001000",
		"Telephone": "075528560000",
		"CertificateInfoList": [{
			"CertificateType": "1",
			"CertificateNum": "35222519771081001X",
			"ExpiredDate": "20180811",
			"PassportIssueDate": "20180811113019",
			"PassportIssueCountry": "156",
			"PassportIssueProvince": "Jiangsu"
		}],
		"DeptNum": "1234",
		"DeptName": "市场部",
		"EmployeeNum": "12345",
		"Role": "2",
		"EmployeeLevel": "1",
		"Remark": "员工",
		"EmployeeVIPLevel": "2",
		"EmployeeUID": "20"
	},
	"BenefitInfoList": [{
		"ApproveTime": "",
		"BenefitType": "0",
		"CostCenterName": "",
		"CostCenterNum": "",
		"CostCenterOne": "",
		"CostCenterTwo": "",
		"Opinion": "",
		"Percentage": "",
		"Approver": {
			"EmployeeNum": "",
			"Name": "",
			"Birthday": "",
			"Cellphone": "",
			"CertificateInfoList": [],
			"DeptName": "",
			"DeptNum": "",
			"EmployeeLevel": "",
			"EmployeeVIPLevel": "",
			"Gender": "",
			"GivenName": "",
			"LoginName": "",
			"Mailbox": "",
			"Remark": "",
			"Role": "",
			"Surname": "",
			"Telephone": "",
			"Type": ""
		}
	}],
	"DeliveryAddress": "幸福小区三单元402",
	"TicketPlatform": "",
	
}

国内机票订单增量查询

企业可调用此接口获取国内机票订单增量数据。

遵循GDPR要求,默认只返回因公出行的订单。

订单相关数据的任何变更,都会将订单输出至增量列表中,不仅仅是订单状态变化。

如果收到相同状态的更新,可以是状态的内部变化或者订单其他数据发生了变化,通过调用订单详情接口获取详细变更信息。

接口URL

/queryflightincrorderlist

请求参数定义

参数名参数说明必填参数类型长度值举例备注
CorpCode企业账号YString1000系统提供的企业账号
Timestamp时间戳YString1420180811113019服务方仅允许20分钟内的时间误差。
Version版本号YString3.0固定为3.0。
LoginName操作人帐号YStringzhangsan@huawei.com1、如果是系统维护,写“sysadmin”查询企业下全量数据,用此账号2、 如果是普通员工维护,写员工登录名。查询员工名下订单,用此账号
OrderID国内机票订单号NStringF02130626111647367根据订单号查询,有OrderID的前提下不考虑StartTime和EndTime
MsgID唯一标识YString1000020150511190411000001企业账号+消息方向+YYYYMMDDHHMMSS+NNNNNN
StartTime开始更新时间NString20180811113019yyyyMMddHHmmss包含当前时间
EndTime截止更新时间NString20180811113019yyyyMMddHHmmss不包含当前时间查询跨度不超过24小时
PageIndex查询的页码YString1
Size每页条数YString20建议20,上限50

响应参数定义

参数名参数说明必填参数类型长度值举例备注
ResultCode返回码YString00表示成功,其他值为失败。
Description描述YStringSuccess描述信息,出错时为错误信息即错误原因。
PageIndex当前的页码YString1
Size每页条数YString20
Total总记录数YString50
FlightIncrOrderList国内机票订单NList<FlightIncrOrder>

国内机票增量订单FlightIncrOrder

参数名参数说明必填参数类型长度值举例备注
OrderID订单号YStringF02130626111647367
OrderTime下订单时间NString20180811113019yyyyMMddHHmmss
OrderStatus订单状态YString0:预订失败 1:待支付 2:待出票 3:已出票 4:已取消 5:出票失败 6:暂缓出票 8:价格变化待确认 9:出票中 11:预订中3、4为终态,可以获取详细数据
TravelType出行方式NString0:因公出行 1:因私出行默认返回因公出行订单
JourneyType行程类型NString0:单程 1:普通往返 2:联程 3:特价往返
TotalPrice订单总价NString115订单总价,退改不更新订单总价=总票面价+总机建费+总燃油费+总保险费用+总服务费)
Currency币种NStringCNY
OrderSource订单产品来源NString0:前台web页面预订 1:后台呼叫中心预订 20:iOS客户端预订 21:Android客户端预订 3:PNR导入 7:H5预订
PayWay支付方式NString1:个人在线支付 2:个人IVR支付(OP)3:现金 4:POS 6:因公欠款 7:vip欠款 8:担保欠款 10:外部月结
PayStatus支付状态NString0:未支付1:已支付
EnterpriseTrID企业客户系统审批单编号NStringTA0315012116281300028
HtTrID华为云数字化差旅审批单编号NStringTA0315012116281300028
ChangeTime变更时间NString20180811113019yyyyMMddHHmmss

样例

请求示例

{
    "Timestamp": "20220830110000",
    "LoginName": "sysadmin",
    "Version": "3.0",
    "OrderID": "F118695410",
    "MsgID": "1000020150511190411000001",
    "CorpCode": "Comp",
    "PageIndex": "1",
    "Size": "20",
    "StartTime": "20220823000000",
    "EndTime": "20220824000000"
}

响应示例

{
    "ResultCode": "0",
    "Description": "Success",
    "PageIndex": "1",
    "Size": "20",
    "Total": "1",
    "FlightIncrOrderList": [
        {
            "OrderID": "F118695410",
            "OrderTime": "20220823100142",
            "OrderStatus": "3",
            "TravelType": "0",
            "JourneyType": "0",
            "TotalPrice": "880.00",
            "Currency": "CNY",
            "OrderSource": "0",
            "PayWay": "10",
            "PayStatus": "0",
            "HtTrID": "TA312055223",
            "ChangeTime": "20220823100201",
            "EnterpriseTrID": "TA312055223"
        }
    ]
}

错误码

错误码错误描述解决方案
10011公司编号不能为空检查入参
3404时间戳信息错误,请确认后重试检查入参
3401企业账号不存在,请确认后重试检查账号或者联系技术支持人员
10012操作人帐号不能为空检查入参
10013操作人帐号不合法检查账号或者联系技术支持人员
4000系统繁忙,请稍后重试未知错误,联系技术支持人员
4001系统繁忙,请稍后重试数据库错误,联系技术支持人员
4002参数错误根据描述信息检查入参
10109页码设置错误,请确认后重试检查入参
10110每页条数需要在1~50之间检查入参
10511开始时间不能为空检查入参
10512结束时间不能为空检查入参
10513开始时间格式错误检查入参
10514结束时间格式错误检查入参
10515结束时间不能大于当前时间检查入参
10516结束时间距离开始时间不能超过24小时检查入参
10518该集团下无对应公司检查是否集团查询
10519集团编号不存在,请确认后重试检查账号或者联系技术支持人员
230000100系统繁忙,请稍后重试未知错误,联系技术支持人员