验价

约 976 字大约 3 分钟

POST 预定前验价

POST /v1.0/precheck

请求参数

{
  "hotel": "25605276",
  "roomId": "E218127878",
  "name": "华丽双人房（2 张单人床）, 无烟房",
  "checkIn": "2023-07-04",
  "checkOut": "2023-07-05",
  "occupancy": {
    "rooms": 1,
    "adults": 1,
    "childrenAges": []
  },
  "ratePlanCode": "14C5E538AB655473F7CCF6A70B634D83E26022C93095B0DC86CA952CC182FE2DF93DFA5BFE5E62527143669BAD3BE345",
  "totalPrice": 483.93,
  "language": "zh-cn",
  "countryCodes": ["CN"],
  "bedGroupId": "",
  "hotelPackage": "",
  "currency": ""
}

属性	类型	必填	说明
hotel	string	必填	酒店id
roomId	string	必填	房型编号
name	string	必填	房型名称
checkIn	string	必填	入住日期
checkOut	string	必填	离店日期
occupancy	object	必填	入住信息
rooms	int	必填	房间数
adults	int	必填	成人人数
childrenAges	List	非必填	小孩年龄
ratePlanCode	string	必填	售卖计划编号
totalPrice	decimal	必填	总价
language	string	非必填	语言
countryCodes	List	非必填	国籍代码，暂时支持一个国籍
bedGroupId	string	非必填	床型编号
hotelPackage	string	非必填	酒店打包价，打包价：hotel_package
currency	string	非必填	货币单位

请求示例

curl --location --request POST '{{domain}}/v1.0/precheck' \
--header 'Authorization: PHT apikey={{api_key}},signature={{signature}},timestamp={{timestamp}}'  \
--header 'api_key: {{api_key}}' \
--header 'Content-Type: application/json' \
--header 'Accept: */*' \
--header 'Connection: keep-alive' \
--data-raw '{
  "hotel": "25605276",
  "roomId": "E218127878",
  "name": "华丽双人房（2 张单人床）, 无烟房",
  "checkIn": "2023-07-04",
  "checkOut": "2023-07-05",
  "occupancy": {
    "rooms": config.js,
    "adults": config.js,
    "childrenAges": [
    ]
  },
  "ratePlanCode": "14C5E538AB655473F7CCF6A70B634D83E26022C93095B0DC86CA952CC182FE2DF93DFA5BFE5E62527143669BAD3BE345",
  "totalPrice": 483.93,
  "language": "zh-cn",
  "countryCodes": [
    "CN"
  ],
  "bedGroupId": "",
  "hotelPackage": "",
  "currency": ""
}'

返回示例

{
  "responseStatus": "SUCCESS",
  "version": "v1.0",
  "checkIn": "2023-07-04",
  "checkOut": "2023-07-05",
  "currency": "",
  "hotel": {
    "code": "25605276",
    "name": "IP City Hotel Osaka",
    "rooms": [
      {
        "code": "E218127878",
        "name": "Deluxe Twin Room, Non Smoking",
        "rates": [
          {
            "roomId": "E218127878",
            "name": "华丽双人房（2 张单人床）, 无烟房",
            "boardCode": "RO",
            "ratePlanCode": "14C5E538AB655473F7CCF6A70B634D83E26022C93095B0DC86CA952CC182FE2DF93DFA5BFE5E62527143669BAD3BE345",
            "channel": 1,
            "allotment": 5,
            "price": 483.93,
            "taxes": [],
            "dailyPrices": [
              {
                "date": "2023-07-04",
                "price": 67.31,
                "priceRSP": 67.31,
                "currency": "USD",
                "taxes": [
                  {
                    "type": "base_rate",
                    "value": 60.51,
                    "currency": "USD"
                  },
                  {
                    "type": "tax_and_service_fee",
                    "value": 6.8,
                    "currency": "USD"
                  }
                ]
              }
            ],
            "cancellationPolicy": null,
            "cancel_penalties": [
              {
                "start": "2023-07-03T23:59:00.000+09:00",
                "end": "2023-07-04T23:59:00.000+09:00",
                "amount": null,
                "nights": null,
                "percent": "100%",
                "currency": "USD"
              }
            ],
            "adult": 1,
            "childAges": [],
            "bedtypeName": "",
            "extendProperty": "{\"fees\":\"null\",\"bed_groups\":\"[{\\\"id\\\":\\\"37431\\\",\\\"description\\\":\\\"2 张大号单人床\\\"}]\",\"hotelPackage\":\"hotel_only\",\"mealList\":\"[]\"}"
          }
        ]
      }
    ]
  },
  "remark": null
}

属性	类型	必填	说明
responseStatus	string	必填	状态
version	string	必填	版本号
remark	string	非必填	备注
checkIn	string	必填	入住日期
checkOut	string	必填	离店日期
hotel	object	必填	酒店价格信息
code	string	必填	酒店编号
name	string	必填	酒店名称
rooms	list	必填	房型列表
code	string	必填	房型编号
name	string	必填	房型名称
rates	List	必填	售卖价格列表
roomId	string	非必填	房型编号
name	string	必填	房型名称
boardCode	string	必填	餐卷编号
ratePlanCode	string	必填	售卖价格编号
channel	string	必填	面纱，默认值1, 1=裸卖 23=面纱
allotment	int	必填	可预订的房间总数暂时为固定值5
currency	string	必填	货币单位
price	decimal	必填	多天总价
priceRSP	decimal	必填	多天RSP总价
dailyPrices	List	必填	每天价格列表
date	string	必填	每天日期
price	decimal	必填	每天价格
priceRSP	decimal	必填	每天RSP价格
currency	string	必填	货币单位
taxes	List	非必填	每天税费价格列表
type	string	必填	税费类型
value	decimal	必填	税费价格
currency	string	必填	货币单位
taxes	List	非必填	税费价格列表
type	string	必填	税费类型
value	decimal	必填	税费价格
currency	string	必填	货币单位
adult	int	必填	成人人数
childAges	List	非必填	小孩年龄列表
bedtypeName	string	非必填	床型编号
cancellationPolicy	object	非必填	取消政策
policies	List	必填	取消政策列表
amount	object	必填	取消罚金
daysBeforeCheckIn	int	必填	入住前多少天可取消
cancel_penalties	List	非必填	原取消政策列表
start	string	必填	开始时间
end	string	必填	结束时间
amount	罚金	非必填	取消罚金
nights	string	非必填	晚数
percent	百分比	非必填	扣款百分比
currency	string	必填	货币单位
extendProperty	string	非必填	扩展字段：fees节点到店费用，bed_groups节点床型列表，mealList节点餐卷列表，hotelPackage节点价格种类（零售或打包）

状态码

编码	说明
SUCCESS	成功
NO_ALLOTMENT	没有可用性
UNAUTHORIZED	认证校验失败
SUPPLIER_SERVER_ERROR	系统或接口异常