火车票订单状态查询接口
火车票订单状态查询接口，可查询订单状态，本接口不扣次数，请合理控制查询频率。
接口名称：火车票订单状态查询接口
接口平台：聚合数据
接口地址：http://op.juhe.cn/trainTickets/orderStatus
支持格式：json/xml
请求方式：http get/post
请求示例：http://op.juhe.cn/trainTickets/orderStatus?key=您申请到的appkey&orderid=1433243990111
请求参数说明：
名称 |
类型 |
必填 | 说明 |
| dtype | string |
否 |
返回的格式，json或xml，默认json |
key |
string |
是 |
您申请到的APPKEY |
orderid |
string |
是 |
订单号 |
返回参数说明：
名称 |
类型 |
说明 |
error_code |
int |
返回码 |
reason |
string |
返回说明 |
result |
string |
返回结果集 |
火车票订单状态查询接口调用JSON返回示例：
/*刚提交订单，正在处理*/
{
"reason": "成功的返回",
"result": {
"orderid": "1444357324918", /*订单号*/
"user_orderid": "5678", /*您自定义的订单号*/
"msg": "订单提交成功，正在处理", /*订单描述信息*/
"orderamount": null, /*订单金额，该订单正在处理，所以为null*/
"status": "0", /*0表示正在处理*/
"passengers": [ /*该订单下的乘客的信息*/
{
"passengerid": "1123", /*您自定义的乘客编号*/
"passengersename": "聚小二", /*乘客姓名*/
"piaotype": "1", /*票类型编码*/
"piaotypename": "成人票", /*票类型*/
"passporttypeseid": "1", /*证件类型编码*/
"passporttypeseidname": "二代身份证", /*证件类型*/
"passportseno": "321201200512120415", /*证件号码*/
"price": "763.5", /*票价，如果真实票价为100元，您将此字段设为1元，处理完订单会更正为100元*/
"zwcode": "O", /*座次编码*/
"zwname": "二等座" /*座次*/
}
],
"checi": "G7027", /*车次*/
"ordernumber": null, /*12306的订单号，该订单正在处理，所以为null*/
"submit_time": "2015-10-09 10:22:05", /*您提交订单的时间*/
"deal_time": null, /*处理完占座的时间*/
"cancel_time": null, /*您主动取消订单的时间*/
"pay_time": null, /*您请求出票（支付）的时间*/
"finished_time": null, /*完成出票时间*/
"refund_time": null, /*此订单最后一次申请退票的时间（退票针对乘客不针对订单）*/
"juhe_refund_time": null, /*最后一次处理完退票的时间*/
"train_date": "2015-10-13", /*乘车日期*/
"from_station_name": "苏州", /*出发站名字*/
"from_station_code": "SZH", /*出发站简码*/
"to_station_name": "上海", /*到达站名字*/
"to_station_code": "SHH", /*到达站简码*/
"refund_money": null /*累积退款金额*/
},
"error_code": 0
}
/*处理完占座请求，处理结果为占座失败*/
{
"reason": "成功的返回",
"result": {
"orderid": "1444357324918",
"user_orderid": "5678",
"msg": "乘客身份信息未通过验证_订票失败 添加乘客 未通过身份效验 聚小二121201193210080015",
"orderamount": null,
"status": "1",
"passengers": [
{
"passengerid": "1123",
"passengersename": "聚小二",
"piaotype": "1",
"piaotypename": "成人票",
"passporttypeseid": "1",
"passporttypeseidname": "二代身份证",
"passportseno": "121201193210080015",
"price": "763.5",
"zwcode": "O",
"zwname": "二等座"
}
],
"checi": "G7027",
"ordernumber": null,
"submit_time": "2015-10-09 10:22:05",
"deal_time": "2015-10-09 10:22:21",
"cancel_time": null,
"pay_time": null,
"finished_time": null,
"refund_time": null,
"juhe_refund_time": null,
"train_date": "2015-10-13",
"from_station_name": "苏州",
"from_station_code": "SZH",
"to_station_name": "上海",
"to_station_code": "SHH",
"refund_money": null
},
"error_code": 0
}
/*处理完占座请求，处理结果为占座成功，占座成功才会有cxin（车厢、座位号）*/
{
"reason": "成功的返回",
"result": {
"orderid": "1441700054308",
"user_orderid": "",
"msg": "处理或操作成功;待支付",
"orderamount": "14.50",
"status": "2",
"passengers": [
{
"passengerid": "1123",
"passengersename": "聚小二",
"piaotype": "1",
"piaotypename": "成人票",
"passporttypeseid": "1",
"passporttypeseidname": "二代身份证",
"passportseno": "370827199101015265",
"price": "14.5",
"zwcode": "1",
"zwname": "硬座",
"reason": 0,
"ticket_no": "E5263400701170048", /*票号，占座成功才会有*/
"cxin": "17车厢,048座" /*占座成功才会有*/
}
],
"checi": "K372",
"ordernumber": "E526340070",
"submit_time": "2015-09-08 16:14:15",
"deal_time": "2015-09-08 16:14:44",
"cancel_time": null,
"pay_time": null,
"finished_time": null,
"refund_time": null,
"juhe_refund_time": null,
"train_date": "2015-09-18",
"from_station_name": "上海",
"from_station_code": "SHH",
"to_station_name": "苏州",
"to_station_code": "SZH",
"refund_money": null
},
"error_code": 0
}
/*出票成功*/
{
"reason": "成功的返回",
"result": {
"orderid": "1435902140362", /*订单号，此订单号仅用于您的订票产品和聚合之间的交互*/
"user_orderid": "20150825134207", /*您自定义的订单号，仅用于您的订票产品和您的用户之间的交互*/
"msg": "出票成功", /*订单信息概况*/
"orderamount": "1.00", /*此订单的总金额*/
"status": "4", /*0：刚提交，待处理；1：失败／失效／取消的订单；2：占座成功待支付（此时可取消订单，超时不支付将失效）；3：支付成功待出票；4：出票成功；
5：出票失败；6：正在处理线上退票请求；7：有乘客退票（改签）成功（status保存的是最后一次操作该订单后的状态，先有乘客退票失败，
然后有乘客退票成功，那么status为7）；8：有乘客退票失败*/
"passengers": [ /*乘客信息，不同状态的订单此字段有所不同，请以您实际得到的结果为准*/
{
"piaotype": "1",
"reason": 0,
"passporttypeseidname": "二代身份证",
"passporttypeseid": "1",
"zwname": "硬座",
"price": "1.0",
"piaotypename": "成人票",
"ticket_no": "E1162394841080090", /*车票编号，退票时会用到。注意和取票订单号order number的区别*/
"passengersename": "黄晓明",
"zwcode": "1",
"passportseno": "370817198901012343",
"passengerid": 413,
"cxin": "08车厢,010座"
}
],
"checi": "6253",
"ordernumber": "E116239484", /*取票订单号，等同于您在12306官网订票时提供的订单编号*/
"submit_time": "2015-07-03 13:42:20", /*提交订单的时间*/
"deal_time": "2015-07-03 13:42:45", /*处理完订单的时间*/
"pay_time": "2015-07-03 13:44:14", /*请求出票（从聚合账户扣款）时间*/
"finished_time": "2015-07-03 13:44:23", /*出票成功时间*/
"refund_time": null",
"juhe_refund_time": null,
"refund_money":null,
"train_date": "2015-07-09",
"from_station_name": "哈尔滨东",
"from_station_code": "VBB",
"to_station_name": "滨江",
"to_station_code": "BJB"
},
"error_code": 0
}
/*有乘客退票成功*/
{
"reason": "成功的返回",
"result": {
"orderid": "1441696917857",
"user_orderid": "",
"msg": "有乘客退票成功，相关款项已退还至您的账户",
"orderamount": "8.50", /*该订单总金额*/
"status": "7",
"passengers": [
{
"passengerid": "1123",
"passengersename": "杨颖",
"piaotype": "1",
"piaotypename": "成人票",
"passporttypeseid": "1",
"passporttypeseidname": "二代身份证",
"passportseno": "370827199109123212",
"price": "8.5",
"zwcode": "O",
"zwname": "二等座",
"reason": 0,
"ticket_no": "EC07095328101001B",
"cxin": "01车厢,01B座",
"returntickets": { /*退票的相关信息*/
"returnsuccess": true, /*退票是否成功*/
"returnmoney": "6.5", /*退票（改签差价）金额，退票要收手续费，所以此金额小于票价*/
"returntime": "2015-09-08 15:28:10",
"returnfailid": "", /*退票失败原因ID*/
"returnfailmsg": "", /*退票失败原因描述*/
"returntype": "1" /*1:线上退票；0:线下退票，即用户持票去火车站窗口退票*/
},
}
],
"checi": "G7213",
"ordernumber": "EC07095328",
"submit_time": "2015-09-08 15:21:58",
"deal_time": "2015-09-08 15:22:18",
"cancel_time": null,
"pay_time": "2015-09-08 15:23:46",
"finished_time": "2015-09-08 15:24:02",
"refund_time": "2015-09-08 15:24:44", /*此订单最后一次申请退票的时间*/
"juhe_refund_time": "2015-09-08 15:26:28", /*此订单最后一次完成退票的时间*/
"train_date": "2015-09-13",
"from_station_name": "上海西",
"from_station_code": "SXH",
"to_station_name": "上海",
"to_station_code": "SHH",
"refund_money": "6.50" /*累积退款金额（包含退票金额、改签退差价金额）。请阅读常见问题中关于退票退款的说明：http://code.juhe.cn/docs/201*/
},
"error_code": 0
}