机票订单查询

• 接口（建议后缀）：/order/flight/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 仅表示请求是否成功。

FlightOrder

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

订单状态

付款方式

FlightTicket

[info] 说明：
[5] 当该机票所属订单为改签或退票订单，则该机票中需要填写原票号，表示被改签或被退票的原票号。
[6] 默认时间为本地时间。

舱位枚举

Client

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

数据示例

以下示例为仅企业支付：

• 原票：全价 2000，票价 1000，折扣 50%，TMC服务费 30，基建 50，保险 20
• 第一次改签：只做改期，未升舱，航司手续费 200，保险退保 20
• 第二次改签：改签并且升舱，票全价 2000，票价 1500，折扣 75%，航司手续费 300，航司升舱费 500，重新购买保险 50
• 退票：退票手续费 500，两次航司改签的手续费共 500 是不退的，TMC服务费 30 是不退的，即收取 1030，退原票 500，退基建 50，退第二次改签的航司升舱费 500，退第二次重新购买的保险 50

[warning] 重要：
所有金额字段如果表示的是需要客户（企业或者个人）付给第三方的，就是正值，反之，如果是第三方退回给客户的，则是负值。

示例

[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-19 13:41:23",
      "operationAt": "2024-06-19 13:41:24",
      "payType": "CORP_ACCOUNT_PAY",
      "totalFee": 1353.0,
      "corpPayFee": 1353.0,
      "personalPayFee": 0.0,
      "changeFee": 0.0,
      "changeDiffFee": 0.0,
      "changeCommisionFee": 0.0,
      "changeServiceFee": 0.0,
      "refundFee": 0.0,
      "refundServiceFee": 0.0,
      "serviceFee": 13.0,
      "extraServiceFee": 0.0,
      "deliveryFee": 0.0,
      "insuranceFee": 0.0,
      "taxFee": 100.0,
      "deductibleTaxFee": 0.0,
      "nonDeductibleTaxFee": 0.0,
      "currency": "CNY",
      "incompatibleReason": null,
      "remark": "",
      "approver": null,
      "approver2": null,
      "settlementBatchNo": null,
      "ticketList": [
        {
          "ticketNo": "8918812xxx",
          "originalTicketNo": "",
          "flightNo": "GJ8871",
          "airlineName": "长龙航空",
          "airlineCode": "GJ",
          "aircraftType": "空客 320 (中型)",
          "departureTime": "2024-06-22 08:50:00",
          "departureTimeZone": "+8:00",
          "arrivalTime": "2024-06-22 14:50:00",
          "arrivalTimeZone": "+8:00",
          "flyDuration": "360",
          "departureCity": {
            "code": "CT530100",
            "name": "昆明",
            "adminDivCode": null
          },
          "arrivalCity": {
            "code": "CT220100",
            "name": "长春",
            "adminDivCode": null
          },
          "departurePort": "长水国际机场",
          "arrivalPort": "龙嘉国际机场",
          "departurePortCode": "KMG",
          "arrivalPortCode": "CGQ",
          "cabin": "Y",
          "ticketPrice": 1240.0,
          "discount": 35,
          "tmcServiceFee": 13.0,
          "airlineServiceFee": 0.0,
          "insuranceFee": 0.0,
          "oilFee": 50.0,
          "taxFee": 50.0,
          "currency": "CNY",
          "internationalFlight": false,
          "printNo": null,
          "client": {
            "externalEmployeeCode": "48edc82xxx",
            "name": "xxx"
          }
        }
      ],
      "paidAt": "2024-06-19 13:41:23"
    }
  ],
  "hasNextPage": false
}