火车票订单状态查询接口

火车票订单状态查询接口，可查询订单状态，本接口不扣次数，请合理控制查询频率。

接口名称：火车票订单状态查询接口

接口平台：聚合数据

接口地址：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
}

转载于:https://my.oschina.net/u/2556621/blog/601796