该接口用于查询火车票明细的信息。一般通过列表接口获取对应的订单号。
接口说明
- 详情接口只支持订单号查询的方式。
- 火车票订单数据只返回因公订单的数据，不包含手工单数据。
- 订单详情不提供实付金额金额。变价实际出票金额暂不提供。
- 订单详情不建议作为报销数据。
- order_info下is_pay是已支付的状态下，可以使用对应带real_的金额字段处理对应逻辑。
|
操作 |
费用 |
公式 |
|---|---|---|
|
预订+抢票 |
订单总价=火车票票款（预收）、抢票票款、 平台使用费（实时）、抢票服务费 |
order_amount=∑（ticket_info.sale_price+ticket_info.service_fee)=total_grab_price+total_service_fee+total_grab_service_fee |
|
|
平台使用费（异步） |
asynchronous_service_fee |
|
|
订单公司支付+订单个人支付 |
company_pay+personal_pay=order_amount |
|
出票 |
订单总价=火车票实际出票价格，平台使用费（实时），抢票服务费 |
order_amount=∑（ticket_info.sale_price+ticket_info.service_fee)+price_info.grab_service_fee |
|
|
平台使用费（异步） |
asynchronous_service_fee |
|
|
订单公司支付+订单个人支付 |
company_pay+personal_pay=order_amount（按照实际出票价格会变） |
|
支付 |
订单实际应付=订单公司支付金额+订单个人支付金额 |
company_real_pay（包含异步服务费）+personal_real_pay=order_amount+asynchronous_service_fee |
|
改签+退票 |
order_amount=出票时的订单总价 |
order_amount与出票时保持一致 部分改签不影响 |
|
使用ticket_unique_key关联计算改签关联原票主键 |
订单公司支付+订单个人支付 |
与出票时保持一致 部分改签不影响 |
|
|
改签总花费【改签新票款（change_company_pay+change_personal_pay）+改签服务费-原票款+改签手续费】 |
=∑【change_ticket_price（change_company_pay+change_personal_pay）+change_service_fee-原票款+change_handing_fee】 |
|
|
订单实际应付=订单公司支付金额+订单个人支付金额 |
实际订单应付=company_real_pay（包含异步服务费）+personal_real_pay=order_amount+asynchronous_service_fee+改签总花费 |
|
退票 |
退票总花费 |
=∑（company_refund+personal_refund）= ∑user_refund |
|
|
订单实际应付=订单公司支付金额+订单个人支付金额 |
实际订单应付=company_real_pay（包含异步服务费）+personal_real_pay - company_real_refund - personal_real_refund |
基本信息
|
HTTP URL |
/api-gateway/g/train/orderDetail |
|---|---|
|
HTTP Method |
POST |
|
权限要求 |
|
请求头
|
参数名称 |
参数值 |
|---|---|
|
Content-Type |
application/json |
请求参数
|
字段名 |
字段说明 |
字段类型必填 |
必填 |
|---|---|---|---|
|
client_id |
申请应用时分配的AppKey |
string |
Y |
|
access_token |
授权后的access token |
string |
Y |
|
company_id |
企业ID |
string |
Y |
|
timestamp |
当前时间戳(精确到秒级) |
int |
Y |
|
sign |
签名 |
string |
Y |
|
order_ids |
订单号，多个订单用英文逗号连接，最多支持查询100个订单 |
string |
Y |
请求示例
{
"company_id": "1125925003706429",
"sign": "51bee74bb61867cb164e7bf224b2e6c1",
"order_ids": "1125925678290613",
"client_id": "00daa54918b9efbbb83e8c113bd10d9b_test",
"access_token": "MJUXZDDKOTQTOTUYMS0ZOTZILTK4NGQTZJLMMTC3YMU4ZGNK",
"timestamp": "1698746024"
}
响应参数
返回结构：
返回参数：
|
字段名 |
字段说明 |
字段类型 |
必填 |
备注必填 |
|---|---|---|---|---|
|
errno |
错误，0表示成功，非0表示失败 |
int |
Y |
|
|
errmsg |
成功返回"SUCCESS",失败返回对应的错误信息 |
string |
Y |
|
|
data |
数据 |
object |
Y |
|
|
data.total |
符合查询条件的数据总数 |
int |
Y |
|
|
data.domestictrain_data |
国内火车票数据 |
object |
N |
国内订单返回有值 |
|
data.domestictrain_data.order_list |
国内火车票数据-订单列表 |
string |
N |
国内订单返回有值 |
orderlist国内火车票信息
|
字段名 |
字段说明 |
字段类型 |
|---|---|---|
|
data.domestictrain_data.order_list[0].order_info |
订单基础信息 |
object |
|
data.domestictrain_data.order_list[0].price_info |
价格信息 |
object |
|
data.domestictrain_data.order_list[0].ticket_list |
火车票基本信息 |
array |
|
data.domestictrain_data.order_list[0].ticket_list[0].ticket_info |
火车票基本信息 |
object |
|
data.domestictrain_data.order_list[0].grab_info |
抢票基本信息 |
object |
|
data.domestictrain_data.order_list[0].change_list[0].change_info |
改签信息 |
object |
|
data.domestictrain_data.order_list[0].refund_list |
退票信息 |
array |
|
data.domestictrain_data.order_list[0].refund_list[0].refund_info |
退票信息 |
object |
|
data.domestictrain_data.order_list[0].passenger_list[0].passenger_info |
出行人信息 |
object |
|
data.domestictrain_data.order_list[0].rc_list |
管控信息 |
array |
|
data.domestictrain_data.order_list[0].rc_list[0].rc_info |
管控信息 |
object |
order_info
|
字段名 |
字段中文说明 |
字段类型 |
必填 |
备注 |
|---|---|---|---|---|
|
order_id |
订单号 |
string |
Y |
主订单号 |
|
trip_type |
订单类型 |
int |
Y |
0：直达，1：中转 |
|
order_number |
12306电子订单号 |
string |
Y |
|
|
is_grab_order |
是否抢票订单 |
string |
Y |
枚举值数字 0：否 1：是 |
|
company_name |
企业名称 |
string |
Y |
在滴滴注册的企业名称 |
|
company_id |
企业ID |
string |
Y |
滴滴企业ID |
|
booker_name |
预订人姓名 |
string |
Y |
下单人 |
|
booker_employee_id |
预订人员工编号 |
string |
N |
客户维护或者外部对接的数据 |
|
booker_member_id |
预订人滴滴ID |
string |
Y |
内部员工 |
|
booker_phone |
预订人手机号 |
string |
Y |
脱敏展示 |
|
department_name |
预订人部门名称 |
string |
N |
部门链路 |
|
department_id |
预订人部门ID |
string |
N |
末级部门ID |
|
institution_name |
制度名称 |
string |
Y |
滴滴制度名称 |
|
institution_id |
制度ID |
string |
Y |
|
|
approval_id |
差旅申请单ID |
string |
N |
滴滴申请单ID |
|
out_approval_id |
外部申请单ID |
string |
N |
系统对接外部的申请单号 |
|
order_status |
订单状态 |
string |
Y |
枚举英文code： |
|
create_time |
订单创建时间 |
string |
Y |
格式：yyyy-MM-dd HH:mm:ss |
|
is_pay |
支付状态 |
int |
Y |
枚举数字：0 未支付 1 已支付 |
|
pay_type |
订单支付类型 |
int |
Y |
枚举数字：0 企业支付 1 个人支付 2 混合支付 |
|
change_time |
订单更新时间 |
string |
N |
格式：yyyy-MM-dd HH:mm:ss 查询条件 |
|
cancel_time |
取消时间 |
string |
N |
格式：yyyy-MM-dd HH:mm:ss |
|
budget_center_list |
多成本中心 |
array |
N |
参考budget_center_list对象 |
budget_center_list
|
字段 |
字段说明 |
字段类型 |
必填 |
备注 |
|---|---|---|---|---|
|
app_name |
字段员工侧展示名称 |
string |
Y |
|
|
sequence |
字段序号 |
int |
Y |
字段序号 支持从1到9 |
|
id |
滴滴主键 |
string |
N |
sequence为1时，生效 |
|
value |
对应成本中心的值 |
string |
N |
对应成本中心的值。sequence为1时与name字段一致，sequence为2时，对应extend_field_01，sequence为3时，对应extend_field_02，sequence为4时，对应extend_field_03 |
|
code |
对应成本中心的编码 |
string |
N |
对应成本中心的编码。sequence为1时与out_budget_id字段一致 |
price_info
|
字段名 |
字段中文说明 |
字段类型 |
必填 |
备注 |
|---|---|---|---|---|
|
order_amount |
订单总价 |
int |
Y |
单位：分 金额字段下同 ，预订时的价格，不包含异步服务费，包含实时服务费，会变更到实际预订支付价格。 出票完成时订单总花费=order_amount+asynchronous_service_fee |
|
company_pay |
公司支付金额 |
int |
Y |
单位：分预订时的价格，不包含异步服务费，会变更到实际预订支付价格。 出票完成时公司支付金额=company_pay |
|
personal_pay |
个人支付金额 |
int |
Y |
单位：分预订时的价格，不包含异步服务费，会变更到实际预订支付价格。 |
|
service_fee |
平台使用费 |
int |
Y |
单位：实时收取的服务费 |
|
asynchronous_service_fee |
出票平台使用费（异步） |
int |
Y |
单位：分 |
|
grab_service_fee |
抢票服务费 |
int |
Y |
单位：抢票成功后收取的抢票服务费 包含个人+公司 |
|
company_real_pay |
订单公司支付金额 |
int |
Y |
单位：分 ，订单的公司支付金额会变更。 |
|
personal_real_pay |
订单个人支付金额 |
int |
Y |
单位：分 ，订单的个人支付金额会变更。 |
|
company_real_refund |
企业实退 |
int |
Y |
|
|
personal_real_refund |
个人实退 |
int |
Y |
|
|
currency |
币种 |
string |
Y |
默认 CNY |
ticket_list.ticket_info
|
字段名 |
字段中文说明 |
字段类型 |
必填 |
备注 |
|---|---|---|---|---|
|
ticket_unique_key |
火车票ID |
string |
Y |
非票号, 不包含改签票信息，预订时的票张信息 |
|
passenger_traveler_id |
乘客ID |
string |
Y |
滴滴ID或travelerId用于关联乘客信息 |
|
sequence |
行程次序 |
string |
Y |
枚举数字 0：直达，1：第一程，2：第二程 行程按照每个人编排 0 1 2 顺序 |
|
entrance |
候车信息 |
string |
Y |
可为空，会更新，可能不准 |
|
start_time |
预计发车时间 |
string |
Y |
格式：yyyy-MM-dd HH:mm:ss |
|
arrive_time |
预计到达时间 |
string |
Y |
格式：yyyy-MM-dd HH:mm:ss |
|
train_code |
车次编号 |
string |
Y |
|
|
ticket_status |
车票状态 |
string |
Y |
枚举英文code： |
|
seat_type |
座位席别 |
string |
Y |
展示中文名，无返回时，显示“其他”，参考坐席列表 |
|
coach_number |
车厢号 |
string |
Y |
车厢号，示例：09车厢 |
|
seat_no |
座位号 |
string |
Y |
车票座位号，示例：03D号 |
|
departure_city_name |
出发城市名称 |
string |
Y |
城市中文名 |
|
departure_city_id |
出发城市ID |
string |
Y |
滴滴城市ID |
|
arrival_city_name |
到达城市名称 |
string |
Y |
城市中文名 |
|
arrival_city_id |
到达城市ID |
string |
Y |
滴滴城市ID |
|
departure_station_name |
出发车站名称 |
string |
Y |
|
|
arrival_station_name |
到达车站名称 |
string |
Y |
|
|
sale_price |
车票票面价 |
int |
Y |
单位：分 票面销售费用 ，实际出票价格 |
|
service_fee |
出票平台使用费 |
int |
Y |
单位：分 实时收取的服务费 |
|
asynchronous_service_fee |
出票平台使用费（异步） |
int |
Y |
单位：分 |
|
grab_service_fee |
抢票服务费 |
int |
Y |
单位：分 抢票成功时收取的服务费 |
|
company_pay |
车票企业支付金额 |
int |
Y |
单位：分 车票公司支付部分 |
|
personal_pay |
车票个人支付金额 |
int |
Y |
单位：分 车票个人支付部分 |
|
print_ticket_time |
出票时间 |
string |
N |
格式：yyyy-MM-dd HH:mm:ss |
|
|
|
|
|
|
grab_info
|
字段名 |
字段中文说明 |
字段类型 |
必填 |
备注 |
|---|---|---|---|---|
|
passenger_traveler_id |
乘客ID |
list |
Y |
滴滴ID或travelerId用于关联乘客信息，多个英文逗号隔开 |
|
selected_time |
抢票日期 |
list |
Y |
格式：yyyy-MM-dd ，多个英文逗号隔开，包含主选，主选是第一个。 |
|
selected_train_code |
抢票车次 |
list |
Y |
多个英文逗号隔开 |
|
selected_seat_type |
抢票座位席别 |
list |
Y |
多个英文逗号隔开，字母 |
|
seat_type_name |
抢票座位席别名称 |
list |
Y |
多个英文逗号隔开，名称 |
|
departure_city_name |
出发城市名称 |
string |
Y |
城市中文名，主选 |
|
departure_city_id |
出发城市ID |
string |
Y |
滴滴城市ID，主选 |
|
arrival_city_name |
到达城市名称 |
string |
Y |
城市中文名，主选 |
|
arrival_city_id |
到达城市ID |
string |
Y |
滴滴城市ID，主选 |
|
departure_station_name |
出发车站名称 |
string |
Y |
主选 |
|
arrival_station_name |
到达车站名称 |
string |
Y |
主选 |
|
total_grab_price |
抢票票款 |
int |
Y |
单位：分 按照每人每种抢票情况最高价汇总 |
|
total_service_fee |
出票平台使用费 |
int |
Y |
单位：分 实时收取的服务费 抢票按照百分比收时，该字段会变更 |
|
total_grab_service_fee |
抢票服务费 |
int |
Y |
单位：分 抢票成功时收取的服务费 包含个人和公司支付 |
|
grab_service_fee_c |
抢票服务费公司部分 |
int |
Y |
单位：分 抢票成功时收取的服务费 公司支付 |
|
grab_service_fee_p |
抢票服务费个人部分 |
int |
Y |
单位：分 抢票成功时收取的服务费 个人支付 |
|
company_pay |
企业支付金额 |
int |
Y |
单位：分 total_grab_price+total_service_fee+total_grab_service_fee总和的公司支付部分 |
|
personal_pay |
个人支付金额 |
int |
Y |
单位：分 total_grab_price+total_service_fee+total_grab_service_fee总和的个人支付部分 |
change_list.change_info
|
字段名 |
字段中文说明 |
字段类型 |
必填 |
备注 |
|---|---|---|---|---|
|
ticket_unique_key |
火车票ID |
string |
Y |
滴滴火车票内部唯一主键，改签新票 改签成功的信息，包含0元改签 |
|
passenger_traveler_id |
乘客ID |
string |
Y |
滴滴ID或travelerId用于关联乘客信息 |
|
pre_ticket_unique_key |
改签前火车票ID |
string |
Y |
被改签的火车票ID |
|
change_order_id |
改签处理订单号 |
string |
Y |
滴滴内部的改签订单号 |
|
sequence |
行程次序 |
string |
Y |
枚举数字 0：直达，1：第一程，2：第二程 行程按照每个人编排 0 1 2 顺序 |
|
entrance |
候车信息 |
string |
Y |
可为空，会更新，可能不准 |
|
reason_for_change |
改签原因 |
string |
Y |
|
|
changed_time |
改签成功时间 |
string |
Y |
格式：yyyy-MM-dd HH:mm:ss |
|
start_time |
预计发车时间 |
string |
Y |
格式：yyyy-MM-dd HH:mm:ss |
|
arrive_time |
预计到达时间 |
string |
Y |
格式：yyyy-MM-dd HH:mm:ss |
|
train_code |
车次编号 |
string |
Y |
|
|
ticket_status |
车票状态 |
string |
Y |
枚举英文code： |
|
seat_type |
座位席别 |
string |
Y |
展示中文名，无返回时，显示“其他” |
|
coach_number |
车厢号 |
string |
Y |
车厢号，示例：09车厢 |
|
seat_no |
座位号 |
string |
Y |
车票座位号，示例：03D号 |
|
departure_city_name |
出发城市名称 |
string |
Y |
城市中文名 |
|
departure_city_id |
出发城市ID |
string |
Y |
滴滴城市ID |
|
arrival_city_name |
到达城市名称 |
string |
Y |
城市中文名 |
|
arrival_city_id |
到达城市ID |
string |
Y |
滴滴城市ID |
|
departure_station_name |
出发车站名称 |
string |
Y |
|
|
arrival_station_name |
到达车站名称 |
string |
Y |
|
|
change_handing_fee |
改签手续费 |
int |
Y |
单位：分 改签总手续费包含改签费和退票差价费 |
|
is_personal |
手续费承担方 |
int |
Y |
枚举数字 1 个人承担 2 公司承担 0 默认 |
|
change_ticket_price |
改签新票票款 |
int |
Y |
单位：分 |
|
change_service_fee |
改签平台使用费 |
int |
Y |
单位：分 |
|
change_company_pay |
改签企业支付金额 |
int |
Y |
单位：分 改签车票公司支付部分 |
|
change_personal_pay |
改签个人支付金额 |
int |
Y |
单位：分 改签车票个人支付部分 |
refund_list.refund_info
|
字段名 |
字段中文说明 |
字段类型 |
必填 |
备注 |
|---|---|---|---|---|
|
ticket_unique_key |
火车票ID |
string |
Y |
滴滴火车票内部唯一主键，退票成功的信息 |
|
refund_handle_fee |
退票手续费 |
int |
Y |
单位：分 |
|
user_refund |
退还用户金额 |
int |
Y |
单位：分 |
|
refund_service_fee |
退票平台使用费 |
int |
Y |
单位：分 |
|
refunded_time |
退票成功时间 |
string |
Y |
格式：yyyy-MM-dd HH:mm:ss |
|
reason_for_refund |
退票原因 |
string |
Y |
|
|
is_personal |
手续费承担方 |
int |
Y |
枚举数字 1 个人承担 2 公司承担 0 默认 |
|
company_refund |
企业退款金额 |
int |
Y |
单位：分 |
|
personal_refund |
个人退款金额 |
int |
Y |
单位：分 |
passenger_list.passenger_info
|
字段名 |
字段说明 |
字段类型 |
必填 |
备注 |
|---|---|---|---|---|
|
passenger_name |
乘客姓名 |
string |
Y |
|
|
passenger_phone |
乘客手机号 |
string |
Y |
掩码 |
|
passenger_traveler_id |
乘客唯一值 |
string |
Y |
内部员工同memberId |
|
passenger_employee_id |
乘客员工编号 |
string |
N |
|
|
is_traveler |
外部员工标记 |
int |
Y |
枚举值数字：1 外部员工 0 内部员工 |
|
out_traveler_id |
乘客外部唯一值 |
string |
N |
|
|
budget_center_name |
成本中心名称 |
string |
N |
建议使用budget_center_list |
|
budget_center_code |
成本中心code |
string |
N |
外部项目或部门code，建议使用budget_center_list |
|
budget_center_id |
成本中心id |
string |
N |
滴滴内部主键，建议使用budget_center_list |
|
budget_center_list |
多成本中心 |
array |
N |
参考budget_center_list对象 |
rc_list.rc_info
|
字段名 |
字段说明 |
字段类型 |
必填 |
备注 |
|---|---|---|---|---|
|
rc_id |
RC审批单ID |
string |
N |
|
|
rc_type |
RC类型 |
string |
N |
枚举值文本：超标说明 |
|
rc_code |
RCcode |
string |
N |
|
|
rc_reason |
RC原因 |
string |
N |
|
|
ticket_unique_key |
适用的车票ID |
string |
N |
适用对应RC的车票号，空是全部适用 |
响应示例
正常示例
{
"errno": 0,
"errmsg": "SUCCESS",
"data": {
"total": 1,
"trace": "0a4ac63a6540cce467d7b5aa44e7dd02",
"domestictrain_data": {
"order_list": [
{
"rc_list": [
{
"rc_info": {
"rc_id": "",
"rc_tank": "",
"rc_tank_reason": "",
"ticket_unique_key": ""
}
}
],
"passenger_list": [
{
"passenger_info": {
"budget_center_name": "法德火车票预发测试",
"passenger_name": "姜秋羽",
"passenger_phone": "198****7093",
"passenger_traveler_id": "1125925011414783",
"passenger_employee_id": "",
"is_traveler": 1,
"budget_center_list": []
}
},
{
"passenger_info": {
"is_traveler": 1,
"budget_center_name": "法德火车票预发测试",
"passenger_name": "吴超凡",
"passenger_phone": "198****7093",
"passenger_traveler_id": "1125925011049847",
"passenger_employee_id": "",
"budget_center_list": []
}
}
],
"order_info": {
"department_id": "1125925003712921",
"institution_id": "1125925569989359",
"create_time": "2023-10-26 15:09:05",
"booker_phone": "000****9529",
"department_name": "法德火车票预发测试",
"company_id": "1125925003706429",
"booker_name": "曹法德",
"is_pay": "1",
"pay_type": "2",
"cancel_time": "",
"order_id": "1125925571051704",
"company_name": "法德火车票预发测试",
"approval_id": "1125925570915913",
"out_approval_id": "",
"order_status": "Refunded",
"booker_member_id": "1125925003676458",
"institution_name": "出差申请单",
"booker_employee_id": "99999"
"budget_center_list": [
{
"app_name": "第一个成本中心",
"sequence": 1,
"id": "1125915909135294",
"value": "秋羽3",
"code": "3"
},
{
"app_name": "第二个要选填",
"sequence": 2,
"id": "1125910746575674",
"value": "火车票线上测试",
"code": ""
},
{
"app_name": "第三个要手动填",
"sequence": 3,
"id": "",
"value": "测试",
"code": ""
},
{
"app_name": "第四个是自定义",
"sequence": 4,
"id": "",
"value": "七七七",
"code": ""
}
]
},
"price_info": {
"service_fee": 0,
"order_amount": 154200,
"company_pay": 134800,
"personal_pay": 19400,
"currency": "CNY"
},
"ticket_list": [
{
"ticket_info": {
"ticket_status": "Refoundedother",
"coach_number": "02车厢",
"seat_no": "08D座",
"arrival_station_name": "上海虹桥",
"personal_pay": 9700,
"print_ticket_time": "2023-10-26 15:12:27",
"arrive_time": "2023-11-07 11:58:00",
"departure_city_id": "11",
"sale_price": 23800,
"service_fee": 0,
"company_pay": 14100,
"start_time": "2023-11-07 10:43:00",
"train_code": "G103",
"seat_type": "一等座",
"departure_city_name": "南京市",
"departure_station_name": "南京南",
"passenger_traveler_id": "1125925011414783",
"arrival_city_name": "上海市",
"arrival_city_id": "4",
"ticket_unique_key": "1125925571045575"
}
},
{
"ticket_info": {
"train_code": "G1",
"departure_city_id": "1",
"departure_station_name": "北京南",
"arrival_station_name": "南京南",
"personal_pay": 0,
"start_time": "2023-11-07 07:00:00",
"arrive_time": "2023-11-07 10:24:00",
"seat_type": "二等座",
"seat_no": "04B座",
"arrival_city_id": "11",
"service_fee": 0,
"print_ticket_time": "2023-10-26 15:12:27",
"ticket_unique_key": "1125925571051692",
"passenger_traveler_id": "1125925011049847",
"coach_number": "13车厢",
"departure_city_name": "北京市",
"arrival_city_name": "南京市",
"ticket_status": "Changed",
"sale_price": 53300,
"company_pay": 53300
}
},
{
"ticket_info": {
"arrival_city_name": "上海市",
"service_fee": 0,
"company_pay": 14100,
"seat_type": "一等座",
"coach_number": "02车厢",
"ticket_status": "Refunded",
"departure_city_id": "11",
"arrival_station_name": "上海虹桥",
"personal_pay": 9700,
"arrive_time": "2023-11-07 11:58:00",
"train_code": "G103",
"print_ticket_time": "2023-10-26 15:12:27",
"ticket_unique_key": "1125925571075017",
"passenger_traveler_id": "1125925011049847",
"departure_city_name": "南京市",
"arrival_city_id": "4",
"departure_station_name": "南京南",
"sale_price": 23800,
"start_time": "2023-11-07 10:43:00",
"seat_no": "08C座"
}
},
{
"ticket_info": {
"arrival_station_name": "南京南",
"print_ticket_time": "2023-10-26 15:12:27",
"ticket_unique_key": "1125925571097526",
"ticket_status": "Refoundedother",
"seat_type": "二等座",
"arrival_city_id": "11",
"company_pay": 53300,
"personal_pay": 0,
"start_time": "2023-11-07 07:00:00",
"departure_city_name": "北京市",
"departure_city_id": "1",
"departure_station_name": "北京南",
"service_fee": 0,
"sale_price": 53300,
"passenger_traveler_id": "1125925011414783",
"arrive_time": "2023-11-07 10:24:00",
"train_code": "G1",
"coach_number": "13车厢",
"seat_no": "04C座",
"arrival_city_name": "南京市"
}
}
],
"change_list": [
{
"change_info": {
"arrive_time": "2023-11-07 10:24:00",
"departure_city_id": "1",
"arrival_city_name": "南京市",
"ticket_unique_key": "1125925576983301",
"pre_ticket_unique_key": "1125925571051692",
"change_order_id": "1125925576978950",
"changed_time": "2023-10-26 18:52:57",
"start_time": "2023-11-07 07:00:00",
"departure_station_name": "北京南",
"change_personal_pay": 0,
"reason_for_change": "购票信息错误",
"departure_city_name": "北京市",
"change_company_pay": 53300,
"train_code": "G1",
"seat_type": "二等座",
"seat_no": "05A号",
"arrival_station_name": "南京南",
"change_service_fee": 0,
"passenger_traveler_id": "1125925011049847",
"ticket_status": "Refunded",
"coach_number": "13车厢",
"arrival_city_id": "11",
"change_handing_fee": 0
}
}
],
"refund_list": [
{
"refund_info": {
"refund_handle_fee": 0,
"user_refund": 23800,
"refund_service_fee": 0,
"refunded_time": "2023-10-26 17:03:08",
"reason_for_refund": "",
"company_refund": 14100,
"personal_refund": 9700,
"ticket_unique_key": "1125925571045575"
}
},
{
"refund_info": {
"refunded_time": "2023-10-30 10:49:33",
"reason_for_refund": "出行时间选择错误",
"company_refund": 14100,
"personal_refund": 9700,
"ticket_unique_key": "1125925571075017",
"refund_handle_fee": 0,
"user_refund": 23800,
"refund_service_fee": 0
}
},
{
"refund_info": {
"company_refund": 53300,
"personal_refund": 0,
"ticket_unique_key": "1125925571097526",
"refund_handle_fee": 0,
"user_refund": 53300,
"refund_service_fee": 0,
"refunded_time": "2023-10-26 17:02:10",
"reason_for_refund": ""
}
},
{
"refund_info": {
"personal_refund": 0,
"ticket_unique_key": "1125925576983301",
"refund_handle_fee": 0,
"user_refund": 53300,
"refund_service_fee": 0,
"refunded_time": "2023-10-26 18:59:38",
"reason_for_refund": "行程变更",
"company_refund": 53300
}
}
]
}
]
}
},
"request_id": "202310311746130a4ac63a6540cce467d7b5aa44e7dd02"
}
异常示例
{
"errno": 401,
"errmsg": "access_token不合法或已过期",
"request_id": "202311010956450ab68d336541b05d4add9cabab572002"
}
错误码
附录
坐席
|
坐席名称 |
|---|
|
硬座 |
|
硬卧代硬座 |
|
软座 |
|
软卧代软座 |
|
硬卧 |
|
软卧 |
|
包厢硬卧 |
|
高级软卧 |
|
一等软座 |
|
二等软座 |
|
商务座 |
|
高级动卧 |
|
混编硬座 |
|
混编硬卧 |
|
优选一等座 |
|
特等软座 |
|
动卧 |
|
二人软包 |
|
一人软包 |
|
一等卧 |
|
二等卧 |
|
混编软座 |
|
混编软卧 |
|
一等座 |
|
卧代一等座 |
|
二等座 |
|
卧代二等座 |
|
软卧代二等座 |
|
特等座 |
|
多功能座 |
|
二等包座 |
|
无座 |
版本记录
|
日期 |
更新人 |
更新内容 |
上线时间 |
|---|---|---|---|
|
2023.10.24 |
陈继诗 |
新建文档 |
2023.11.1 |
|
2023.12.04 |
陈继诗 |
字段修改。coach_number ，退改：company_pay |
2024.04.09 |
|
2023.12.19 |
陈继诗 |
增加抢票对象data.domestictrain_data.order_list[0].grab_info，priceinfo和出票ticketinfo增加grab_service_fee |
2024.04.09 |
|
2023.12.20 |
陈继诗 |
增加人员信息内的成本中心CODE和成本中心id,oderinfo增加is_grab_order字段，增加订单状态枚举：grabbing 抢票中 |
2024.04.09 |
|
2023.12.21 |
陈继诗 |
priceinfo，ticket_list.ticket_info增加asynchronous_service_fee |
2024.04.09 |
|
2023.12.22 |
陈继诗 |
priceinfo增加company_real_pay，personal_real_pay, company_real_refund，personal_real_refund |
2024.04.09 |
|
2023.12.25 |
陈继诗 |
orderinfo增加change_time,change_info增加change_ticket_price |
2024.04.09 |
|
2024.04.02 |
陈继诗 |
grab_info中增加seat_type_name |
2024.04.09 |
|
2024.09.02 |
陈继诗 |
增加orderinfo passenger info下budget_center_list信息 |
2024.09.13 |
|
2025.07.19 |
陈继诗 |
orderinfo下增加trip_type，order_number ticket_list.ticket_info，下增加：sequence，entrance， change_list.change_info下增加sequence,entrance， |
2025.07.19 |
|
2025.08.29 |
高洋洋 |
外部出行人外部主键支持返回 |
2025.08.29 |
|
2025.09.10 |
陈继诗 |
标记火车票退改手续费承担标记 |
2025.09.10 |
|
2025.09.16 |
陈继诗 |
抢票服务费支持个人支付 |
2025.09.16 |