单程/联程预定下单

预定下单

请求参数

Body 参数application/json

bookType

integer

可选

1:非候补 2:候补

queryKey

string

可选

请求key（必填）（站站查询返回的queryKey）

journeyType

string

(固定必传)

可选

outOrderNo

string

可选

外部订单号（必填）且下单时必须唯一

trainNo

string

车次号（必填）

可选

trainLongNo

string

长车次号

可选

fromStation

string

可选

具体车次的出发车站中文或拼音(车站列表查询结果为准)（必填）

toStation

string

可选

具体车次的到达车站中文或拼音(车站列表查询结果为准)，（必填）

fromStationCode

string

出发code

可选

toStationCode

string

到达code

可选

noticeType

integer

可选

占座和出票通知是否合并 (请固定传0，合并模式已废弃)

isProduction

string

可选

分销占座信息推送地址环境设置 0：测试环境 1：生产环境无特殊需求请传1（必填）

ticketModel

string

可选

购票模式 0：代购模式 1：自购模式不传默认0（必填）

accountNo

string

可选

12306账号(密文)，（ticketModel为1时必填）

accountPwd

string

可选

12306密码(密文)，（ticketModel为1时必填）

acceptNoSeat

string

可选

是否接受无座，0：不接受 1：接受，（必填）. 接受无座后，如果传的是卧铺，会按照卧铺 >硬座>无座的顺序占座；如果传的是一等座，会按照一等座>二等座>无座的顺序占座

chooseSeats

string

可选

在线选座选择坐席,传值规则见接口相关说明-电子票在线选座参数说明

chooseSeatsTwo

string

可选

联程第二段车次座位在线选座选择坐席,传值规则见接口相关说明-电子票在线选座参数说明

travelNo

string

可选

出差申请单号（用来获取出差申请单信息）

vehicleId

string

行程单号

可选

transferCombination

string

火车联程信息

可选

middleType

string

1 单程 2 联程

可选

passengerId

array[string]

乘车人id

可选

passengerNo

array[string]

可选

travelNos

array[string]

出差申请单号

可选

vehicleIds

array[string]

行程单号

可选

payCustom

number

公司需支付金额

可选

payPerson

number

个人支付金额

可选

orederPrice

number

票价总金额

可选

message

string

可选

seatVos

array[object (SeatVo) {8}]

可选

先接字符串座位信息集合

seatName

string

可选

price

number

可选

seatState

integer

可选

seats

string

可选

upPrice

number

可选

midPrice

number

可选

downPrice

number

可选

waitBuyFlag

string

可选

seatVo

string

可选

priceOne

string

第一张票的价格

可选

priceTwo

string

第二章票的价格

可选

kfRemark

string

客服备注

可选

commonMark

string

可选

fromTime

string

出发时间

可选

toTime

string

到达时间

可选

trainDate

string

出发日期

可选

endDate

string

到达日期

可选

voyageType

string

1因私,2因公

可选

seatName

string

座位名字

可选

price

string

价格

可选

trainUserCode

string

新增12306账号

可选

trainPassword

string

12306密码

可选

name

array[string]

乘客姓名

可选

passengerType

array[string]

可选

乘客类型，1成人、2儿童、3婴儿

cardType

array[string]

证件类型

可选

cardNo

array[string]

证件号码

可选

gender

array[string]

性别

可选

passengerBirth

array[string]

出生日期

可选

telPhone

array[string]

联系方式

可选

country

array[string]

国籍

可选

idValidity

array[string]

证件有效期

可选

contactInfo

object (ContactInfo)

联系人信息

可选

person

string

联系人姓名（必填）

可选

cellphone

string

联系人手机（必填）

可选

string

可选

联系人邮箱（可不填）

passengers

array[object (TrainPassenger) {28}]

乘客信息

可选

passengerId

string

常旅客id

可选

passengerNo

string

常旅客no

可选

passengerType

string

可选

'乘客类型：1成人 2儿童'

passengerName

string

可选

乘客姓名，规则看“乘客姓名输入说明”（必填）

idType

string

可选

证件类型:1、一代身份证、 2、二代身份证、 3、港澳居民来往内地通行证、 4、台湾居民来往大陆通行证、 5、护照 6 港澳台居民居住证 7 外国人永久居留身份证

idCard

string

证件号（必填）

可选

phone

string

可选

乘客手机（代购必填）

mail

string

可选

乘客邮箱（外国护照，台胞证，港澳通行证必填）

birthday

string

可选

生日（非身份证必填）

insureCount

integer

可选

是否购买保险 1购买 0不购买（非必填，购保时必填）

insurePrice

integer

可选

保险价格（insureCount为0时insurePrice为0）（非必填，购保时必填）

insurNo

string

可选

保险ID（insureCount为0时为""）（非必填，购保时必填）

sex

string

可选

'性别:M男，F女'

seatClass

string

坐席类别（必填）

可选

ticketPrice

string

票面价（必填）

可选

idValidity

string

可选

证件有效期（代购模式下，港澳通行证、台胞证类型和外国永久居留证乘客必填）

country

string

可选

国籍：1中国，2日本，3美国，4英国，5法国

userId

string

user表id

可选

verifyStandard

integer

新增

可选

highest

number

个人最高标准

可选

companyFee

number

公司支付金额

可选

personFee

number

个人支付金额

可选

linkId

integer <int64>

审批单id

可选

vehicleId

integer <int64>

行程单id

可选

travelNo

string

可选

出差申请单号（用来获取出差申请单信息）

trainNo

string

车次号

可选

departure

string

出发地

可选

arrival

string

到达地

可选

userId

integer <int64>

用户userId

可选

customerId

string

大客户号

可选

示例

{"customerId":1864482218838913024,
"classification": 302,
"enterpriseNo": "",
"queryKey": "",
"journeyType": 1,
"outOrderNo": "",
"trainNo": "G6902",
"trainLongNo": "",
"fromStation": "青岛",
"fromStationCode":"QDK",
"trainDate":"2025-04-07",
"endDate":"2025-04-07",
"toStationCode":"QHK",
"toStation": "青岛北",
"seatVo": {"hardseat":null,"noseat":null,"hardsleepermid":null,"softsleeperdown":null,"softseat":null,"firstseat":{"seatName":"一等座","price":10,"seatState":0,"seats":"8","upPrice":0,"midPrice":0,"downPrice":0,"waitBuyFlag":null,"seatDiscount":null},"secondseat":{"seatName":"二等座","price":6,"seatState":0,"seats":"100","upPrice":0,"midPrice":0,"downPrice":0,"waitBuyFlag":null,"seatDiscount":null},"hardsleeperup":null,"hardsleeperdown":null,"softsleeperup":null,"businessseat":{"seatName":"商务座","price":19,"seatState":0,"seats":"5","upPrice":0,"midPrice":0,"downPrice":0,"waitBuyFlag":null,"seatDiscount":null},"firstsoftdown":null,"secondsoftmid":null,"dsleeperdown":null,"preferredfirstseat":null,"specialseat":null,"advancedsoftsleeper":null,"otherseat":null},
"noticeType": 0,
"isProduction": 1,
"ticketModel": 1,
"accountNo": "ZLsom5",
"accountPwd": "zl0105_",
"acceptNoSeat": 1,
"chooseSeats": "",
"loginFlag": 1,
"price": 6,
"seatName": "二等座",
"userPhone": "13791937711",
"fromTime": "05:37",
"toTime": "05:55",
"bookType": "1",
"middleType": "1",
"name":["张璐"],
"cardType": ["NI"],
"cardNo": ["370285200001052019"],
"passengerBirth": ["2000-01-09"],
"telPhone": ["15192581298"],
"gender": ["1"],
"country": ["CN"],
"idValidity": [],
"customerCare": "您好，领导。",
"travelNos": [],
"vehicleIds": [],
"passengerNo": ["1904106297159069698"],
"passengerId": [1864482218838913024],
"chooseSeats": "1C",
"contactInfo":{
    "person": "吴从磊",
    "cellphone": "13791937711"
},
"voyageType": 2,
"commonMark":"" ,
"kfRemark": "222:s;333:s;"}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/ops/train/bookTrain' \
--header 'Content-Type: application/json' \
--data-raw '{"customerId":1864482218838913024,
"classification": 302,
"enterpriseNo": "",
"queryKey": "",
"journeyType": 1,
"outOrderNo": "",
"trainNo": "G6902",
"trainLongNo": "",
"fromStation": "青岛",
"fromStationCode":"QDK",
"trainDate":"2025-04-07",
"endDate":"2025-04-07",
"toStationCode":"QHK",
"toStation": "青岛北",
"seatVo": {"hardseat":null,"noseat":null,"hardsleepermid":null,"softsleeperdown":null,"softseat":null,"firstseat":{"seatName":"一等座","price":10,"seatState":0,"seats":"8","upPrice":0,"midPrice":0,"downPrice":0,"waitBuyFlag":null,"seatDiscount":null},"secondseat":{"seatName":"二等座","price":6,"seatState":0,"seats":"100","upPrice":0,"midPrice":0,"downPrice":0,"waitBuyFlag":null,"seatDiscount":null},"hardsleeperup":null,"hardsleeperdown":null,"softsleeperup":null,"businessseat":{"seatName":"商务座","price":19,"seatState":0,"seats":"5","upPrice":0,"midPrice":0,"downPrice":0,"waitBuyFlag":null,"seatDiscount":null},"firstsoftdown":null,"secondsoftmid":null,"dsleeperdown":null,"preferredfirstseat":null,"specialseat":null,"advancedsoftsleeper":null,"otherseat":null},
"noticeType": 0,
"isProduction": 1,
"ticketModel": 1,
"accountNo": "ZLsom5",
"accountPwd": "zl0105_",
"acceptNoSeat": 1,
"chooseSeats": "",
"loginFlag": 1,
"price": 6,
"seatName": "二等座",
"userPhone": "13791937711",
"fromTime": "05:37",
"toTime": "05:55",
"bookType": "1",
"middleType": "1",
"name":["张璐"],
"cardType": ["NI"],
"cardNo": ["370285200001052019"],
"passengerBirth": ["2000-01-09"],
"telPhone": ["15192581298"],
"gender": ["1"],
"country": ["CN"],
"idValidity": [],
"customerCare": "您好，领导。",
"travelNos": [],
"vehicleIds": [],
"passengerNo": ["1904106297159069698"],
"passengerId": [1864482218838913024],
"chooseSeats": "1C",
"contactInfo":{
    "person": "吴从磊",
    "cellphone": "13791937711"
},
"voyageType": 2,
"commonMark":"" ,
"kfRemark": "222:s;333:s;"}'

返回响应

🟢200成功

application/json

Body

success

boolean

可选

errCode

string

可选

errMsg

string

可选

traceId

string

可选

data

object (TrainOrderVo)

可选

orderNo

string

可选

transactionOrderNo

string

可选

outOrderNo

string

可选

示例

{
  "success": false,
  "errCode": "",
  "errMsg": "",
  "traceId": "",
  "data": {
    "orderNo": "",
    "transactionOrderNo": "",
    "outOrderNo": ""
  }
}

单程/联程 预定下单

请求参数

示例代码

返回响应