订单搜索

约 808 字大约 3 分钟

2026-03-27

POST 订单搜索

此 API 用于查询订单信息，支持通过订单号、客户订单号、入住日期等多条件查询。

⚠️ 注意：仅当查单接口（Booking Search）返回的订单状态（Status）为以下三种之一时，才视为订单已达到最终状态。其他任何返回结果（如空返回、或Status为非2/3/4的其他数值）均不会视为订单的最终处理结果：

Status=2：表示订单成功确认，这是该状态的唯一有效确认方式。
Status=3：表示订单成功取消，这是该状态的唯一有效确认方式。
Status=4：表示订单处理失败，这是该状态的唯一有效确认方式。

接口地址

POST /booking/HotelBookingSearch?$format=json

请求参数说明

{
  "SearchBy": {
    "BookingID": "15631283819",
    "BookingInfo": {
      "ClientReference": ""
    }
  }
}

属性	类型	必填	说明
SearchBy	Object	是	查询条件

属性	类型	必填	说明
BookingID	String	否	订单ID
BookingInfo.ClientReference	String	否	商户订单号

请求示例

curl --location --request POST '{{domain}}/booking/HotelBookingSearch?$format=json' \
--header 'Authorization: PHT apikey={{api_key}},signature={{signature}},timestamp={{timestamp}}'  \
--header 'api_key: {{api_key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "SearchBy": {
    "BookingID": "15631283819",
    "BookingInfo": {
      "ClientReference": ""
    }
  }
}'

返回示例

{
  "Success": {
    "BookingDetailsList": [
      {
        "BookingID": "15631283819",
        "Status": 2,
        "CheckInDate": "2025-12-28 00:00:00",
        "CheckOutDate": "2025-12-29 00:00:00",
        "OrderDate": "2025-11-11 15:23:56.473",
        "NumOfRooms": 1,
        "TotalPrice": 1293,
        "GuestList": [
          {
            "RoomNum": 1,
            "GuestInfo": [
              {
                "Name": {
                  "First": "李",
                  "Last": "四"
                },
                "IsAdult": true
              }
            ]
          }
        ],
        "Contact": {
          "Name": {
            "First": "Lucas",
            "Last": "li"
          },
          "Phone": "19909258553",
          "Email": "455407767@qq.com"
        },
        "ClientReference": "FKX-251100082",
        "Hotel": {
          "HotelID": 117274,
          "HotelName": "洲际酒店集团纽约巴克莱洲际酒店",
          "Destination": {
            "CityCode": "178293"
          },
          "TotalPrice": 1293,
          "RatePlanList": [
            {
              "RoomOccupancy": {
                "RoomNum": 1,
                "AdultCount": 2,
                "ChildCount": 0
              },
              "RoomTypeID": 5370256,
              "RatePlanID": "-5601198872135516182",
              "RatePlanName": "尊享房(大床)",
              "Currency": "USD",
              "TotalPrice": 1293,
              "PriceList": [
                {
                  "Price": 1293,
                  "StayDate": "2025-12-28 00:00:00"
                }
              ]
            }
          ],
          "CancellationPolicyList": [
            {
              "LocalFromDate ": "2026-03-24T23:00:00+07:00",
              "Amount": 1293
            }
          ]
        }
      }
    ]
  }
}

返回参数说明

属性	类型	必填	说明
BookingID	String	是	订单ID
Status	number	是	状态
CheckInDate	DateTime	是	入住日期
CheckOutDate	DateTime	是	离店日期
OrderDate	DateTime	是	下单时间
NumOfRooms	number	是	房间数
TotalPrice	Decimal	是	总价
GuestList	List	是	客人信息
Contact	Object	是	联系人
ClientReference	String	否	商户订单号
ConfirmationCode	String	否	酒店确认号
Hotel	Object	是	酒店信息

GuestList说明

属性	类型	必填	说明
RoomNum	number	是	房间序号
GuestInfo	List	是	客人列表

GuestInfo 说明

属性	类型	必填	说明
Name.First	String	否	名
Name.Last	String	否	姓
Gender	String	否	性别
Phone	String	否	电话
Email	String	否	邮箱
Age	number	否	年龄
IsAdult	boolean	是	是否成人

contact说明

属性	类型	必填	说明
Name.First	String	是	名
Name.Last	String	是	姓
Phone	String	是	电话
Email	String	是	邮箱

Hotel说明

属性	类型	必填	说明
HotelID	number	是	酒店ID
HotelName	String	是	酒店名称
Destination	Object	否	目的地
TotalPrice	Decimal	是	酒店总价
RatePlanList	List	是	房价信息
CancellationPolicyList	List	否	取消政策

CancellationPolicyList说明

属性	类型	必填	说明
LocalFromDate	String	否	酒店当地时间
Amount	Decimal	否	罚金

RatePlanList（核心）

属性	类型	必填	说明
RoomOccupancy	Object	是	入住信息
RoomTypeID	number	否	房型ID
RoomName	String	否	房型名
RatePlanID	String	是	房价ID
RatePlanName	String	是	房价名称
BedType	number	否	床型
Currency	String	是	币种
TotalPrice	Decimal	是	房间总价
PriceList	List	是	每日价格
MealType	number	推荐	餐型
MealAmount	number	推荐	餐数

PriceList说明

属性	类型	必填	说明
Price	Decimal	是	价格
StayDate	DateTime	是	日期