用车订单查询

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

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

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

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

请求参数

[info] 说明：
[2] 没有开始与结束日期，默认结束日期为请求日期；只有开始时间，表示从开始日期到调用日期的订单；只有结束日期，开始日期为结束日期的前一个月。
[3] 默认开始时间为00:00，默认结束时间为23:59。

参考时间

响应结构

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

CarOrder

[info] 说明：
[5] 订单发生状态变更若会变更订单号，则需要关联原操作号,详细信息请阅读订单同步首页的描述。
[6] 对于totalFee/corpPayFee/personalPayFee三个金额详细阐述，对于不同状态（已支付、已退款、已取消）的订单给不同的值。
已支付：totalFee = 总实际支付，corpPayFee=公司实际支付，personalPayFee=个人实际支付
已退款：totalFee = 总实际退款，corpPayFee=公司实际退款，personalPayFee=个人实际退款，如退款20，此处应该是 -20
已取消：totalFee = 总实际取消费，corpPayFee=公司实际取消费，personalPayFee=个人实际取消费

Client

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

订单状态

订单类型

付款方式

车型枚举

示例

[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": "COMPLETED",
      "type": "RT",
      "onBusiness": true,
      "isOnline": true,
      "callPhone": "139xxxxxxxx",
      "clientList": [
        {
          "externalEmployeeCode": "48edc82xxx",
          "name": "戈佳琦"
        }
      ],
      "orderAt": "2024-06-19 14:30:11",
      "operationAt": "2024-06-19 14:53:55",
      "paidAt": "2024-06-19 00:00:00",
      "payType": "CORP_ACCOUNT_PAY",
      "departureTime": "2024-06-19 14:30:11",
      "arrivalTime": "2024-06-19 14:53:55",
      "departureCity": null,
      "arrivalCity": null,
      "departureAddress": "时代金融广场",
      "arrivalAddress": "中国工商银行(吾角广场支行)",
      "totalDistance": 6.0,
      "totalDuration": 24,
      "originalTotalFee": 0.0,
      "couponFee": 0.0,
      "totalFee": 19.77,
      "corpPayFee": 19.77,
      "personalPayFee": 0.0,
      "serviceFee": 0.0,
      "extraServiceFee": 0.0,
      "deliveryFee": 0.0,
      "insuranceFee": 0.0,
      "currency": "CNY",
      "carType": "ECONOMY",
      "incompatibleReason": "",
      "remark": null,
      "settlementBatchNo": null,
      "regulationId": null,
      "is_invoice": false,
      "invoiceId": ""
    }
  ],
  "hasNextPage": false
}