国内火车票

火车票订单列表查询

企业可调用此接口获取国内火车票订单列表数据。

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

接口URL

/querytrainorderlist

请求参数定义

参数名	参数说明	必填	参数类型	长度	值举例	备注
CorpCode	企业账号	Y	String		1000	系统提供的企业账号
Timestamp	时间戳	Y	String	14	20180811113019	服务方仅允许20分钟内的时间误差。
Version	版本号	Y	String		3.0	固定为3.0。
LoginName	操作人帐号	Y	String		zhangsan@huawei.com	1、如果是系统维护，写“sysadmin”查询企业下全量数据，用此账号2、如果是普通员工维护，写员工登录名。查询员工名下订单，用此账号
EnterpriseTrID	企业客户系统审批单编号	N	String		TA0315012116281300028	如果此字段有值，则不考虑StartCreateDate和EndCreateDate查询条件，仅查询该出差申请单号对应的订单数据
StartCreateDate	订单生成起始日期	N	String		20130423	yyyyMMdd。如果调用者置空，则默认当天，并且从00:00开始
EndCreateDate	订单生成截止时间	N	String		20130424	yyyyMMdd。如果调用者置空，则默认当天，并且以23:59结束
PageIndex	查询的页码	Y	String		1
Size	每页条数	Y	String			建议20，上限50

响应参数定义

参数名	参数说明	必填	参数类型	值举例	备注
ResultCode	返回码	Y	String	0	0表示成功，其他值为失败。
Description	描述	Y	String	Success	描述信息，出错时为错误信息即错误原因。
PageIndex	当前的页码	N	String
Size	每页条数	N	String
Total	总记录数	N	String
TrainOrderList	火车票订单列表	N	List<TrainOrder>

火车票订单TrainOrder

参数名	参数说明	必填	参数类型	值举例	备注
OrderID	订单号	Y	String	T0215042408435860475
OrderStatus	订单状态	Y	String	0：预定中1：待支付2：待出票3：出票中4：已出票5：出票失败6：订单取消7：预定失败
TravelType	出行方式	N	String	0:因公出行1:因私出行
TotalPrice	总价	Y	String	115.00
TrainNumber	车次号	Y	String	G3647
FromStationName	出发车站	Y	String	北京朝阳
ToStationName	到达车站	Y	String	长春
DepartureTime	出发日期	Y	String	20221031124500	yyyyMMddHHmmss
ArriveTime	到达日期	Y	String	20221031171900	yyyyMMddHHmmss
CreateTime	下订单时间	Y	String	20180811113019	yyyyMMddHHmmss
EnterpriseTrID	企业客户系统审批单编号	N	String	TA0315012116281300028
HtTrID	华为云数字化差旅审批单编号	N	String	TA0315012116281300028

样例

请求示例

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

响应示例

{
	"ResultCode": "0",
	"Description": "Success",
	"PageIndex": "2",
	"Size": "50",
	"Total": "64",
	"TrainOrderList": [{
		"OrderID": "T0215042408435860475",
		"OrderStatus": "4",
		"TravelType": "0",
		"TotalPrice": "777.5",
		"TrainNumber": "G3647",
		"FromStationName": "北京朝阳",
		"ToStationName": "长春",
		"DepartureTime": "20221031124500",
		"ArriveTime": "20221031171900",
		"CreateTime": "20221029094955",
		"EnterpriseTrID": "TA0412074667",
		"HtTrID": "TA0412074667"
	}]
}

火车票订单详情查询

企业可调用此接口获取国内火车票订单数据，订单数据包含该订单内所有出票、改期、退票的详细信息

接口URL

/querytrainorderdetail

请求参数定义

参数名	参数说明	必填	参数类型	长度	值举例	备注
CorpCode	企业账号	Y	String		1000	系统提供的企业账号
Timestamp	时间戳	Y	String	14	20180811113019	服务方仅允许20分钟内的时间误差。
Version	版本号	Y	String		3.0	固定为3.0。
LoginName	操作人帐号	Y	String		zhangsan@huawei.com	1、如本次操作为系统相关，则该字段为固定字符串值："sysadmin";2、如操作为指定普通员工信息维护或修改，则该字符串为:“<员工登录账户名称>"。
TrainOrderID	火车票订单号	Y	String			根据订单号查询

响应参数定义

参数名	参数说明	必填	参数类型	值举例	备注
ResultCode	返回码	Y	String	0	0表示成功
Description	描述	Y	String	Success	描述信息，出错时为错误信息即错误原因。
TrainOrderID	订单号	N	String	T0215042408435860475
OrderTime	下订单时间	N	String	20180811113019	yyyyMMddHHmmss
OrderStatus	订单状态	N	String	0：预定中1：待支付2：待出票3：出票中4：已出票5：出票失败6：订单取消7：预定失败
TravelType	出行方式	N	String	0：因公出行1：因私出行
TotalPrice	订单总价	N	String	115	原始订单的费用
Currency	币种	N	String	CNY
OrderSource	订单产品来源	N	String	0：前台页面预订1：后台呼叫中心预订20：iOS客户端21：Android客户端7：H5预订
PayWay	支付方式	N	String	1：个人在线支付 2：个人IVR支付（OP）3:现金 4:POS 6:因公欠款 7:vip欠款 8:担保欠款 10：外部月结
PayChannel	支付渠道	N	String	alipay:支付宝weixin:微信支付yeepay:易宝支付chinapay:银联支付	填写alipay等
PayStatus	支付状态	N	String	0：未支付1：已支付	原始订单支付方式
ContactInfoList	联系人信息列表	Y	List<ContactInfo >		第一个为主联系人
TrainInfoList	车次信息	Y	List<TrainInfo>
PassengerInfoList	乘客信息	Y	List<PassengerInfo>
TicketInfoList	客票信息	N	List<TicketInfo>
FeeItemList	费用项	N	List<FeeItem>
EnterpriseTrID	企业客户系统审批单编号	N	String	TA0315012116281300028
HtTrID	华为云数字化差旅审批单编号	N	String	TA0315012116281300028
BenefitInfoList	差旅受益信息	N	List<BenefitInfo>
Orderer	预订人	Y	Employee		包含LoginName /Name/EmployeeNum/EmployeeUID等字段
Creator	创建人	Y	Creator

联系人信息ContactInfo

参数名	参数说明	必填	参数类型	值举例	备注
ContactName	联系人姓名	N	String	张三
ContactMobile	联系人手机号	N	String	13710001000
ContactMail	联系人邮件	N	String		zhangsan@huawei.com

车次信息TrainInfo

参数名	参数说明	必填	参数类型	值举例	备注
TrainInfoID	火车信息ID	N	String	274735
ArrivalTime	到达时间	N	String	20221031135700	yyyyMMddHHmmss
ArriveCity	到达城市名称	N	String	太原
ArriveCityID	到达城市ID	N	String	156140100
DepartCity	出发城市名称	N	String	天津
DepartCityID	出发城市ID	N	String	156120100
DepartTime	出发时间	N	String	20221031103900	yyyyMMddHHmmss
FromStationName	出发车站名称	N	String	天津西
SeatName	首选坐席	N	String	二等座
ToStationName	到达车站名称	N	String	太原南
TrainNumber	车次号	N	String	G2609

乘客信息PassengerInfo

参数名	参数说明	必填	参数类型	值举例	备注
PassgID	乘客ID	Y	String	276581
AdultPssgID	成人乘客ID	N	String	276581	乘客为儿童时才涉及
Employee	乘客信息	N	Employee
BenefitInfo	差旅受益信息	N	BenefitInfo

客票信息TicketInfo

参数名	参数说明	必填	参数类型	值举例	备注
TicketID	客票ID	Y	String	TKT2022102913523201235
TicketNo	电子票Id		String
TrainInfoID	火车信息ID	Y	String	274735
PassgID	乘客ID	Y	String	276581
TicketStatus	客票状态	Y	String	10：待出票11：已出票12：出票失败13：出票取消20：待改期21：已改期22：改期失败30：待退票31：已退票
SeatNo	座位号	N	String	07车01D号
TicketPrice	实际票面价格	N	String	202
TicketSeat	坐席类型	N	String	二等座
TicketingTime	出票时间	N	String	20180811113019	yyyyMMddHHmmss
Creator	出票操作人	N	Creator
OrgTicketID	原客票ID	N	String	TKT2022102913523201235	改期前原票ID，如果非改期票，则为null，对应TicketID字段
ServiceFee	服务费	N	String	7
PackageFee	套餐费	N	String	7	抢票时预订才涉及
ChangeFee	改期手续费	N	String		改期客票才涉及
TicketDiffPrice	改期差价	N	String		改期客票才涉及
ChangeTime	改期时间	N	String	20180811113019	提交改签的时间
ChangeCreator	改期操作人		Creator
RefundFee	实际退票费	N	String		退票才涉及
EstimatedRefundFee	估算退票费	N	String		退票才涉及
RefundTime	退票时间	N	String	20180811113019	提交退票的时间
RefundStatus	退款状态	N	String	0：未退款1：已退款	退票退款状态
RefundCreator	退票操作人	N	Creator		退票才涉及

费用项FeeItem

参数名	参数说明	必填	参数类型	值举例	备注
ServiceOptType	业务操作类型	Y	String	0：出1：改2：退	改期产生的票费用记录为1：改
FeeItemType	费用项类型	Y	String	0：服务费1：票费用2：手续费3：估算票费用4：保险费用5：套餐费6：线下退款金额
Amount	费用金额	Y	String		退给用户费用使用负值
Currency	费用币种	Y	String	CNY	默认CNY
PayWay	支付方式	Y	String	1：个人在线支付 2：个人IVR支付（OP）3:现金 4:POS 6:因公欠款 7:vip欠款 8:担保欠款 10：外部月结
Status	状态	Y	String	0：未支付/未退款1：已处理
TicketID	客票ID	N	String	TKT2022102913523201235

样例

请求示例

{
    "CorpCode": "0008",
    "LoginName": "sysadmin",
    "Timestamp": "20221027111200",
    "TrainOrderID": "T0215042408435860475",
    "Version":"3.0"
}

响应示例

{
	"ResultCode": "0",
	"Description": "Success",
	"TrainOrderID": "T0215042408435860475",
	"OrderTime": "20221029135232",
	"OrderStatus": "4",
	"TravelType": "0",
	"TotalPrice": "210",
	"Currency": "CNY",
	"OrderSource": "7",
	"PayWay": "10",
	"PayStatus": "1",
	"PayChannel": "",
	"BenefitInfoList": [{
		"ApproveTime": "",
		"BenefitType": "0",
		"CostCenterName": "市场部",
		"CostCenterNum": "123456789",
		"CostCenterOne": "",
		"CostCenterTwo": "",
		"Opinion": "",
		"Percentage": "100",
		"Approver": {
			"EmployeeNum": "",
			"Name": "",
			"Birthday": "",
			"Cellphone": "",
			"CertificateInfoList": [],
			"DeptName": "",
			"DeptNum": "",
			"EmployeeLevel": "",
			"EmployeeVIPLevel": "",
			"Gender": "",
			"GivenName": "",
			"LoginName": "",
			"Mailbox": "",
			"Remark": "",
			"Role": "",
			"Surname": "",
			"Telephone": "",
			"Type": ""
		}
	}],
	"ContactInfoList": [{
		"ContactName": "张三",
		"ContactMobile": "13710001000",
		"ContactMail": "zhangsan@huawei.com"
	}],
	"TrainInfoList": [{
		"TrainInfoID": "274735",
		"ArrivalTime": "20221031135700",
		"ArriveCity": "太原",
		"ArriveCityID": "156140100",
		"DepartCity": "天津",
		"DepartCityID": "156120100",
		"DepartTime": "20221031103900",
		"FromStationName": "天津西",
		"SeatName": "二等座",
		"ToStationName": "太原南",
		"TrainNumber": "G2609"
	}],
	"PassengerInfoList": [{
		"PassgID": "276581",
		"AdultPssgID": null,
		"Employee": {
			"LoginName": "zhangsan",
			"Name": "张三",
			"Surname": "Zhang",
			"GivenName": "San",
			"Gender": "M",
			"Type": "",
			"Nationality": "CN",
			"Birthday": "19930101",
			"Mailbox": "zhangsan@huawei.com",
			"Cellphone": "13710001000",
			"Telephone": "",
			"CertificateInfoList": [{
				"CertificateType": "",
				"CertificateNum": "123456789123456",
				"ExpiredDate": "",
				"IssuePlace": "",
				"PassportIssueDate": "",
				"PassportIssueCountry": "",
				"PassportIssueProvince": ""
			}],
			"DeptNum": "123456",
			"DeptName": "市场部",
			"EmployeeNum": "123456789",
			"EmployeeVIPLevel": "",
			"Remark": "",
			"EmployeeUID": "ID123456789"
		},
		"BenefitInfo": {
			"BenefitType": "0",
			"CostCenterNum": "123456789",
			"CostCenterName": "市场部"
		}
	}],
	"TicketInfoList": [{
		"TicketID": "TKT2022102913523201235",
		"TicketNo": "TKT2022102913523201235",
		"TrainInfoID": "274735",
		"PassgID": "276581",
		"TicketStatus": "11",
		"SeatNo": "07车01D号",
		"TicketPrice": "202",
		"TicketSeat": "二等座",
		"TicketingTime": "20221029135234",
		"OrgTicketID": null,
		"Creator": {
			"Type": "0",
			"EmployeeNum": "123456789",
			"EmployeeUID": "ID123456789",
			"Name": "张三"
		},
		"ServiceFee": "8",
		"PackageFee": "8",
		"ChangeFee": null,
		"TicketDiffPrice": null,
		"ChangeTime": null,
		"ChangeCreator": null,
		"RefundFee": null,
		"EstimatedRefundFee": null,
		"RefundTime": null,
		"RefundStatus": null,
		"RefundCreator": null
	}],
	"FeeItemList": [{
		"ServiceOptType": "0",
		"FeeItemType": "0",
		"Amount": "8",
		"Currency": "CNY",
		"PayWay": "10",
		"Status": "1",
		"TicketID": "TKT2022102913523201235"
	},
	{
		"ServiceOptType": "0",
		"FeeItemType": "1",
		"Amount": "202",
		"Currency": "CNY",
		"PayWay": "10",
		"Status": "1",
		"TicketID": "TKT2022102913523201235"
	},
	{
		"ServiceOptType": "0",
		"FeeItemType": "4",
		"Amount": "0",
		"Currency": "CNY",
		"PayWay": "10",
		"Status": "1",
		"TicketID": "TKT2022102913523201235"
	}],
	"HtTrID": "TA0412078932",
	"EnterpriseTrID": "TA0412078932",
	"Orderer": {
		"LoginName": "zhangsan",
		"Name": "张三",
		"Surname": "Zhang",
		"GivenName": "San",
		"Gender": "M",
		"Type": "",
		"Nationality": "CN",
		"Birthday": "19930101",
		"Mailbox": "zhangsan@huawei.com",
		"Cellphone": "13710001000",
		"Telephone": "",
		"CertificateInfoList": [{
			"CertificateType": "",
			"CertificateNum": "123456789123456",
			"ExpiredDate": "",
			"IssuePlace": "",
			"PassportIssueDate": "",
			"PassportIssueCountry": "",
			"PassportIssueProvince": ""
		}],
		"DeptNum": "123456",
		"DeptName": "市场部",
		"EmployeeNum": "123456789",
		"EmployeeVIPLevel": "",
		"Remark": "",
		"EmployeeUID": "ID123456789"
	},
	"Creator": {
		"Type": "0",
		"EmployeeNum": "123456789",
		"EmployeeUID": "ID123456789",
		"Name": "张三"
	}
}

火车票订单增量查询

企业可调用此接口获取火车票订单增量数据。

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

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

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

接口URL

/querytrainincrorderlist

请求参数定义

参数名	参数说明	必填	参数类型	长度	值举例	备注
CorpCode	企业账号	Y	String		1000	系统提供的企业账号
Timestamp	时间戳	Y	String	14	20180811113019	服务方仅允许20分钟内的时间误差。
Version	版本号	Y	String		3.0	固定为3.0。
LoginName	操作人帐号	Y	String		zhangsan@huawei.com	1、如果是系统维护，写“sysadmin”查询企业下全量数据，用此账号2、如果是普通员工维护，写员工登录名。查询员工名下订单，用此账号
TrainOrderID	火车票订单号	N	String		T0215042408435860475	根据订单号查询，有OrderID的前提下不考虑StartTime和EndTime
StartTime	开始更新时间	N	String		20180811113019	yyyyMMddHHmmss包含当前时间
EndTime	截止更新时间	N	String		20180811113019	yyyyMMddHHmmss不包含当前时间查询跨度不超过24小时
PageIndex	查询的页码	Y	String
Size	每页条数	Y	String			建议20，上限50

响应参数定义

参数名	参数说明	必填	参数类型	值举例	备注
ResultCode	返回码	Y	String	0	0表示成功，其他值为失败。
Description	描述	Y	String	Success	描述信息，出错时为错误信息即错误原因。
PageIndex	当前的页码	N	String
Size	每页条数	N	String
Total	总记录数	N	String
TrainIncrOrderList	火车票增量订单列表	N	List<TrainIncrOrder>

火车票增量订单TrainIncrOrder

参数名	参数说明	必填	参数类型	值举例	备注
OrderID	订单号	Y	String	T0215042408435860475
OrderStatus	订单状态	Y	String	0：预定中1：待支付2：待出票3：出票中4：已出票5：出票失败6：订单取消7：预定失败
TravelType	出行方式	N	String	0:因公出行1:因私出行
TotalPrice	总价	Y	String	115.00
TrainNumber	车次号	Y	String	G3647
FromStationName	出发车站	Y	String	北京朝阳
ToStationName	到达车站	Y	String	长春
DepartureTime	出发日期	Y	String	20221031124500	yyyyMMddHHmmss
ArriveTime	到达日期	Y	String	20221031171900	yyyyMMddHHmmss
CreateTime	下订单时间	Y	String	20180811113019	yyyyMMddHHmmss
EnterpriseTrID	企业客户系统审批单编号	N	String	TA0315012116281300028
HtTrID	华为云数字化差旅审批单编号	N	String	TA0315012116281300028
ChangeTime	变更时间	Y	String	20221031124500	yyyyMMddHHmmss
OrderTotalReceivePrice	订单应收总价	Y	String	200

样例

请求示例

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

响应示例

{
	"ResultCode": "0",
	"Description": "Success",
	"PageIndex": "3",
	"Size": "50",
	"Total": "104",
	"TrainIncrOrderList": [{
		"OrderID": "T0122102913523338369",
		"OrderStatus": "0",
		"TravelType": "0",
		"TotalPrice": "210",
		"TrainNumber": "G2609",
		"FromStationName": "天津西",
		"ToStationName": "太原南",
		"DepartureTime": "20221031103900",
		"ArriveTime": "20221031135700",
		"CreateTime": "20221029135233",
		"EnterpriseTrID": "TA0315012116281300028",
		"HtTrID": "TA0412070257",
		"ChangeTime": "20221029135233",
		"OrderTotalReceivePrice": "210"
	}]
}

查询账号token(12306)

企业可调用此接口获取火车票12306账号token

接口URL

/openapi/token/query

请求参数定义

参数名	参数说明	必填	参数类型	长度	值举例	备注
EnterpriseId	企业Id, 注：账户是在企业配置的		String

响应参数定义

参数名	参数说明	必填	参数类型	值举例	备注
ResultCode	返回码	Y	String	0	0表示成功，其他值为失败。
Description	描述	Y	String	Success	描述信息，出错时为错误信息即错误原因。
Token	token		String		火车票12306账号token

样例

请求示例

{
	"EnterpriseId": "00001"
}

响应示例

{
	"ResultCode": "0",
	"Description": "Success",
	"Token": ""
}

错误码

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

国内火车票

# 国内火车票

# 火车票订单列表查询

# 接口URL

# 请求参数定义

# 响应参数定义

# 火车票订单TrainOrder

# 样例

# 火车票订单详情查询

# 接口URL

# 请求参数定义

# 响应参数定义

# 联系人信息ContactInfo

# 车次信息TrainInfo

# 乘客信息PassengerInfo

# 客票信息TicketInfo

# 费用项FeeItem

# 样例

# 火车票订单增量查询

# 接口URL

# 请求参数定义

# 响应参数定义

# 火车票增量订单TrainIncrOrder

# 样例

# 查询账号token(12306)

# 接口URL

# 请求参数定义

# 响应参数定义

# 样例

# 错误码

国内火车票

火车票订单列表查询

接口URL

请求参数定义

响应参数定义

火车票订单TrainOrder

样例

火车票订单详情查询

接口URL

请求参数定义

响应参数定义

联系人信息ContactInfo

车次信息TrainInfo

乘客信息PassengerInfo

客票信息TicketInfo

费用项FeeItem

样例

火车票订单增量查询

接口URL

请求参数定义

响应参数定义

火车票增量订单TrainIncrOrder

样例

查询账号token(12306)

接口URL

请求参数定义

响应参数定义

样例

错误码