火车票订单查询

• 接口（建议后缀）：/order/train/queryOrder
• Method：POST
• 数据格式：Json
• 调用方：每刻
• 接口说明：每刻将通过该接口，获取特定范围的火车票订单数据

[warning] 对接前先看：
目前常见的参数组合（以下例子不包括必填参数）示例：

1. 每日凌晨定时任务：startDate + endDate 拉取该时间范围内对应 externalCorpCode 企业的订单；
   
2. 申请单申请人触发：externalApprovalNo 拉取指定申请单下预定的订单；
   
3. 管理员或者预定人触发丢失订单的补充拉取：externalEmployeeCode + startDate + endDate 拉取指定员工；
   
4. 第三方对接了第三方订单通知实时推送接口：orderId + operationId 直接拉取对应订单；
   

当订单进入每刻后，很快就会生成费用，甚至费用可能已经报销，原则上是不允许第三方订单进行修改（尤其是金额），如果这笔订单传的金额不正确，或者人为因素导致订单金额多了或者少了，可以采取 orderId 保持原单不变，生成一笔新的 operationId 订单，金额为该笔订单多了或少了的金额。

请求参数

[info] 说明：
[1] 非必填参数，至少填写一个，可以填写多个，如果填写了多个，条件是叠加的，比如四个个字段都有值，externalCorpCode 企业、externalEmployeeCode 员工、approval 申请单和 orderId 订单对应的订单信息。
[2] 没有开始与结束日期，默认结束日期为请求日期；只有开始时间，表示从开始日期到调用日期的订单；只有结束日期，开始日期为结束日期的前一个月。
[3] 默认开始时间为00:00，默认结束时间为23:59。

参考时间

响应结构

[warning] 关于请求分页如何结束：
hasNextPage = false 标志着分页结束，success 仅表示请求是否成功。

TrainOrder

[info] 说明：
[4]火车票发生改签与退票操作才会关联原订单号或原操作号，详细信息请阅读订单同步首页的描述。

订单状态

付款方式

TrainTicket

座位定义

Client

[info] 说明：
[5] 乘车人可能不是企业员工，如果填写了该字段，表示为企业员工，如果只有姓名，表示外部同行人。

数据示例

以下示例仅企业支付：

• 原票：全价 1000，票价 1000，TMC服务费 30，保险 20
• 第一次改签：只做改期，未升舱，并退掉了保险，改签手续费 0
• 第二次改签：改签并且升级座等，改签费（改签临期手续费 30 + 票差价 470） 500，并重新买了一份 20 的保险
• 退票：退票手续费 100，TMC服务费 30 是不退的

示例

[warning] 重要：
示例维护并非和文档字段维护一样频繁，如果遇到示例和文档不一致，请以文档为准

请求头:

{
  "tokenId": "eyJhbGciOiJIUzI1NiJ9.eyJqdGkiOiJtYXljdXJfand0X2Rldl9pZCIsInN1YiI6IlBGMjAwNjIwMTI1NU5GTk8iLCJpYXQiOjE2MDQ2MzA5NjYsImF1ZCI6IlBMQVRGT1JNIiwiZXhwIjoxNjA0NjM0NTY2LCJwcm9kdWN0TGluZSI6IkRBVEFfSFVCIn0.AyNIwPtGUXxFMuHO8Bx-4XeXNyWYRcot40MfsL1swr4"
}

请求示例:

1.每日凌晨定时任务

{
  "externalCorpCode": "0123456",
  "startDate": "2024-06-12",
  "endDate": "2024-06-19",
  "pageNo": 1,
  "pageSize": 50
}

2.申请单申请人触发

{
  "externalCorpCode": "0123456",
  "externalApprovalNo": "AE94527002203135xxx",
  "pageNo": 1,
  "pageSize": 50
}

3.管理员或者预定人触发丢失订单的补充拉取

{
  "externalCorpCode": "0123456",
  "externalEmployeeCode": "48edc82xxx",
  "startDate": "2024-06-12",
  "endDate": "2024-06-19",
  "pageNo": 1,
  "pageSize": 50
}

4.第三方对接了第三方订单通知实时推送接口

{
  "externalCorpCode": "021343",
  "orderId": "13406390267",
  "operationId": "13406390267",
  "pageNo": 1,
  "pageSize": 50
}

响应示例:

{
  "success": true,
  "errorMessage": null,
  "data": [
    {
      "orderId": "13406390267",
      "operationId": "13406390267",
      "originalOperationId": null,
      "externalCorpCode": "0123456",
      "externalEmployeeCode": "48edc82xxx",
      "externalEmployeeName": "xxx",
      "externalApprovalNo": "a00a7e3xxxx",
      "status": "O",
      "onBusiness": true,
      "isOnline": true,
      "orderAt": "2024-06-18 15:43:11",
      "operationAt": "2024-06-18 15:45:09",
      "payType": "CORP_ACCOUNT_PAY",
      "totalFee": 48.00,
      "corpPayFee": 48.00,
      "personalPayFee": 0.0,
      "changeFee": 0.0,
      "changeServiceFee": 0.0,
      "refundFee": 0.0,
      "refundServiceFee": 0.0,
      "serviceFee": 6.00,
      "extraServiceFee": 0.0,
      "taxFee": 0.0,
      "deductibleTaxFee": 0.0,
      "nonDeductibleTaxFee": 0.0,
      "currency": "CNY",
      "incompatibleReason": "",
      "remark": "",
      "approver": null,
      "approver2": null,
      "ticketList": [
        {
          "trainNo": "G7139",
          "departureTime": "2024-06-18 16:44:00",
          "arrivalTime": "2024-06-18 17:18:00",
          "tripDuration": "34",
          "departureCity": {
            "code": "CT320500",
            "name": "苏州"
          },
          "arrivalCity": {
            "code": "CT310000",
            "name": "上海"
          },
          "departureStation": "苏州",
          "arrivalStation": "上海虹桥",
          "seat": "SECOND_CLASS",
          "ticketPrice": 42.00,
          "tmcServiceFee": 6.0,
          "insuranceFee": 0.0,
          "client": {
            "externalEmployeeCode": "48edc82xxx",
            "name": "xxx",
            "identityType": "身份证",
            "identityCode": "xxxxxxxxxxxxxxxxxx"
          }
        }
      ],
      "paidAt": "2024-06-18 15:45:09"
    }
  ],
  "hasNextPage": false
}