~~~[api] get:http://op.juhe.cn/trainTickets/orderStatus string:dtype=json#說明文字 *string:key=84ac11bf14594fd4450741f02f42e95a#您申請到的APPKEY *string:orderid=JH151238172439832#訂單號 <<< 我測試的 { "reason": "查詢訂單狀態成功", "result": { "orderid": "JH151117251243259", "user_orderid": "201711200607243274380", "msg": "處理或操作成功;待支付", "orderamount": "933.00", "status": "2", "passengers": [ { "passengerid": 1, "passengersename": "楊紅偉", "piaotype": "1", "piaotypename": "成人票", "passporttypeseid": "1", "passporttypeseidname": "二代身份證", "passportseno": "142201198311174558", "price": "933.0", "zwcode": "M", "zwname": "一等座", "ticket_no": "E960281705103001A", "cxin": "03車廂,01A座", "reason": 0 } ], "checi": "G101", "ordernumber": "E960281705", "submit_time": "2017-11-20 18:08:32", "deal_time": "2017-11-20 18:09:11", "cancel_time": null, "pay_time": null, "finished_time": null, "refund_time": null, "juhe_refund_time": null, "start_time": "2017-11-25 06:43:00", "arrive_time": "2017-11-25 12:39:00", "runtime": "05:56", "train_date": "2017-11-25", "from_station_name": "北京南", "from_station_code": "VNP", "to_station_name": "上海虹橋", "to_station_code": "AOH", "refund_money": null }, "error_code": 0 } <<< success /*以下示例僅作為格式上的參考，請以您實際得到的數據為準，也不代表此接口返回的全部狀態*/ /*另外，部分字段的值可能為空，將來也有可能會增加字段（但不會減少），請您在程序中做好兼容性處理*/ /*訂單的所有的可能的狀態為 0：剛提交，待處理；處理完將變成1或2； 1：失敗／失效／取消的訂單； 2：占座成功待支付（此時可取消訂單，超時不支付將失效）； 3：支付成功待出票； 4：出票成功； 5：出票失敗；關于出票失敗的問題，請閱讀 http://code.juhe.cn/docs/201 中第33條 6：正在處理線上退票請求；請閱讀 http://code.juhe.cn/docs/201 中第16、17、18條 7：有乘客退票（改簽）成功（status保存的是最后一次操作該訂單后的狀態，先有乘客退票失敗， 然后有乘客退票成功，那么status為7）； 8：有乘客退票失敗（status保存的是最后一次操作該訂單后的狀態，先有乘客退票成功， 然后有乘客退票失敗，那么status為8）； 將來可能會增加狀態，但不會減少，請您在程序中做好兼容性處理。 */ /*1、剛提交訂單，正在處理*/ { "reason": "成功的返回", "result": { "orderid": "1444357324918", /*訂單號*/ "user_orderid": "5678", /*您自定義的訂單號，請務必閱讀 http://code.juhe.cn/docs/201 中第14條關于各個訂單號的說明*/ "msg": "訂單提交成功，正在處理", /*訂單描述信息*/ "orderamount": null, /*訂單金額，聚合會根據此字段的值扣除您的賬戶余額；該訂單正在處理，所以為null*/ "status": "0", /*0表示正在處理*/ "passengers": [ /*該訂單下的乘客的信息*/ { "passengerid": "1", /*您自定義的乘客編號，用于區分一個訂單下的多個乘客，建議設為1-5的正整數*/ "passengersename": "聚小二", /*乘客姓名*/ "piaotype": "1", /*票類型編碼*/ "piaotypename": "成人票", /*票類型*/ "passporttypeseid": "1", /*證件類型編碼*/ "passporttypeseidname": "二代身份證", /*證件類型*/ "passportseno": "321201200512120415", /*證件號碼*/ "price": "763.5", /*票價，如果真實票價為100元，您提交訂單時將此字段設為1元，處理完訂單會更正為100元*/ "zwcode": "O", /*座次編碼，此處示例為大寫字母O，不是數字0*/ "zwname": "二等座" /*座次*/ } ], "checi": "G7027", /*車次*/ "ordernumber": null, /*12306的訂單號，該訂單正在處理，所以為null；請務必閱讀 http://code.juhe.cn/docs/201 中第14條關于各個訂單號的說明*/ "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 /*累積退款金額，請務必閱讀 http://code.juhe.cn/docs/201 中第18條關于refund_money的說明*/ }, "error_code": 0 } /*2、處理完占座請求，處理結果為占座失敗*/ { "reason": "成功的返回", "result": { "orderid": "1444357324918", "user_orderid": "5678", "msg": "乘客身份信息未通過驗證_訂票失敗 添加乘客 未通過身份效驗 聚小二121201193210080015", "orderamount": null, "status": "1", /*失敗／失效／取消的訂單*/ "passengers": [ { "passengerid": "1", "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 } /*3、處理完占座請求，處理結果為占座成功，占座成功才會有cxin（車廂、座位號）*/ { "reason": "成功的返回", "result": { "orderid": "1441700054308", "user_orderid": "", "msg": "處理或操作成功;待支付", "orderamount": "14.50", /*將要從您的聚合賬戶扣除的金額*/ "status": "2", "passengers": [ { "passengerid": "1", "passengersename": "聚小二", "piaotype": "1", "piaotypename": "成人票", "passporttypeseid": "1", "passporttypeseidname": "二代身份證", "passportseno": "370827199101015265", "price": "14.5", "zwcode": "1", "zwname": "硬座", "reason": 0, "ticket_no": "E5263400701170048", /*票號，占座成功才會有；請務必閱讀 http://code.juhe.cn/docs/201 中第14條關于各個訂單號的說明*/ "cxin": "17車廂,048座" /*占座成功才會有*/ } ], "checi": "K372", "ordernumber": "E526340070", /*12306的訂單號；請務必閱讀 http://code.juhe.cn/docs/201 中第14條關于各個訂單號的說明*/ "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 } /*4、出票成功*/ { "reason": "成功的返回", "result": { "orderid": "1435902140362", /*訂單號，此訂單號僅用于您的訂票產品和聚合之間的交互*/ "user_orderid": "20150825134207", /*您自定義的訂單號*/ "msg": "出票成功", /*訂單信息概況*/ "orderamount": "1.00", /*此訂單的總金額*/ "status": "4", /*4：出票成功*/ "passengers": [ /*乘客信息，不同狀態的訂單此字段有所不同，請以您實際得到的結果為準*/ { "piaotype": "1", "reason": 0, "passporttypeseidname": "二代身份證", "passporttypeseid": "1", "zwname": "硬座", "price": "1.0", "piaotypename": "成人票", "ticket_no": "E1162394841080090", /*車票編號，退票時會用到。請務必閱讀 http://code.juhe.cn/docs/201 中第14條關于各個訂單號的說明*/ "passengersename": "黃曉明", "zwcode": "1", "passportseno": "370817198901012343", "passengerid": 1, "cxin": "08車廂,010座" } ], "checi": "6253", "ordernumber": "E116239484", /*取票訂單號，等同于您在12306官網訂票時提供的訂單編號；請務必閱讀 http://code.juhe.cn/docs/201 中第14條關于各個訂單號的說明*/ "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 } /*5、有乘客退票成功*/ { "reason": "成功的返回", "result": { "orderid": "1441696917857", "user_orderid": "", "msg": "有乘客退票成功，相關款項已退還至您的賬戶", "orderamount": "8.50", /*該訂單總金額*/ "status": "7", "passengers": [ { "passengerid": "1", "passengersename": "楊穎", "piaotype": "1", "piaotypename": "成人票", "passporttypeseid": "1", "passporttypeseidname": "二代身份證", "passportseno": "370827199109123212", "price": "8.5", "zwcode": "O", "zwname": "二等座", "reason": 0, "ticket_no": "EC07095328101001B", "cxin": "01車廂,01B座", "returntickets": { /*退票的相關信息，只有申請過退票的乘客才有此字段。如您于2016年2月1日后初次看到此文檔， 請忽略此字段，并從下面的refundTimeline中讀取退票信息*/ "returnsuccess": true, /*退票是否成功*/ "returnmoney": "6.5", /*退票（改簽差價）金額，退票要收手續費，所以此金額小于等于票價*/ "returntime": "2015-09-08 15:28:10",/*完成此退票的時間*/ "returnfailid": "", /*退票失敗原因ID*/ "returnfailmsg": "", /*退票失敗原因描述*/ "returntype": "1" /*1:線上退票；0:線下退票，即用戶持票去火車站窗口退票*/ }, "refundTimeline": /*請注意，此字段新增于2016年2月1日，此日期前的訂單無此字段*/ [ { "time": "2016-01-28 20:51:55", /*時間發生的日期*/ "msg": "線上申請退票" /*事件概要*/ }, { "time": "2016-01-28 20:54:13", "msg": "線上退票成功", "detail": { /*事件詳情*/ "returnsuccess": true, /*退票是否成功*/ "returnmoney": "6.5", /*退款金額*/ "returnfailid": "", /*失敗原因ID，退票失敗時有值*/ "returnfailmsg": "", /*失敗原因，退票失敗時有值*/ "returntype": "1", /*1，線上退票；0，線下退票*/ "ticket_no": "E886597309101005D", "passengername": "小黃", "passporttypeseid": "1", /*退票乘客的證件類型*/ "passportseno": "321088789512071236" /*退票乘客的證件號*/ } } ] } ], "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 } <<< error ~~~ ## 如圖