酒店订单查询

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

HotelOrder

[info] 说明：
[4] 酒店取消预订的订单才会关联原操作号，详细信息请阅读订单同步首页的描述。

订单状态

付款方式

是否预付

HotelInfo

[info] 说明：
[5] 酒店中文名与英文名至少传一个。

酒店星级

Room

RoomPrice

HotelMeal

Client

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

数据示例

以下示例为混合支付：

• 原订单：每间夜 500，预订了两天，TMC服务费 30，其中企业支付了 630（服务费企业支付），因为超标自付，个人支付了 400
• 退订：房间退掉，酒店服务费、TMC服务费不退
• 扣费退订：房间退掉，扣除 10% 费用，即 100，其中企业退了 550，个人退了 350（假设扣费平分，实际根据 TMC 业务来定），TMC服务费不退
• 提前离店：入住了一天，退 1 间*夜，酒店收取未入住的 1 间*夜 20% 罚金，即 100，总退款 400，其中企业退了 250，个人退了 150（假设扣费平分），TMC 服务费不退

示例

[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 15:16:24",
      "operationAt": "2024-06-19 15:18:40",
      "payType": "CORP_ACCOUNT_PAY",
      "prepaid": true,
      "totalFee": 227.00,
      "corpPayFee": 227.00,
      "personalPayFee": 0.00,
      "refundFee": 0.0,
      "refundServiceFee": 0.0,
      "serviceFee": 4.00,
      "extraServiceFee": 0.0,
      "taxFee": 0.0,
      "deductibleTaxFee": 0.0,
      "nonDeductibleTaxFee": 0.0,
      "currency": "CNY",
      "incompatibleReason": "",
      "remark": "",
      "approver": null,
      "approver2": null,
      "hotelInfo": {
        "hotelName": "汉庭酒店(长春重庆路活力城店)",
        "hotelNameEn": "HantingHotel(ChongqingRoadHuolichengBranch)",
        "hotelTel": "8643181877677",
        "hotelAddress": "西四马路398号",
        "hotelCityCode": "CT220100",
        "hotelCityName": "长春",
        "starRating": 2
      },
      "room": {
        "roomName": "高级双床房",
        "roomNameEn": null,
        "roomPrice": [
          {
            "effectiveDate": "2024-06-19",
            "invalidDate": "2024-06-19",
            "price": 223.0
          }
        ],
        "roomTotalFee": 223.0000,
        "currency": "CNY",
        "checkInDate": "2024-06-19",
        "checkOutDate": "2024-06-20"
      },
      "clientList": [
        {
          "externalEmployeeCode": "48edc82xxx",
          "name": "xxx",
          "identityType": null,
          "identityCode": null
        }
      ],
      "paidAt": "2024-06-19 15:18:40"
    }
  ],
  "hasNextPage": false
}