We have a messaging system that allows you to request availability for a hotel and that generates the deeplink that redirects to the booking engine automatically.
First it is necessary to log into our system with the credentials provided for this purpose. This will return a sessionId that you will need to create the deeplink.
Login message
This message authenticates the user on Hotetec’s platform. A session identifier (hereinafter sessionId) is assigned and must be included in all the request messages sent.
Endpoint: https://hotel.new.hotetec.com/webservice/integrations/pull/openSession
The message has the following elements:
Element | Mandatory | Values/Format | Description |
clientCode | Y | Alphanumeric | Company code or group of agencies to which the user belongs. Request to Hotetec. |
systemCode | Y | Alphanumeric | The same value as in clientCode must be applied. Request to Hotetec. |
username | Y | Alphanumeric | User’s ID. Request to Hotetec. |
password | Y | Alphanumeric | User’s password. Request to Hotetec. |
Example message (JSON):
{
"clientCode":"Request to Hotetec",
"systemCode": "Request to Hotetec",
"username":"Request to Hotetec",
"password": "Request to Hotetec"
}
Response message when logging in
The message has the following elements:
Element | Description |
sessionId | Generated session’s ID |
Example message (JSON):
{
"sessionId": "MST#20077#682164202862402",
}
bookingEngineUrl message
This message allows you to request availability with some parameters and generates a URL that redirects to the booking engine with these parameters already filled in.
Endpoint: https://hotel.new.hotetec.com/webservice/integrations/meta/bookingEngineUrl
Element | Mandatory | Values/Format | Description |
sessionId | Y | Alphanumeric | Generated session’s ID |
languageCode | N | DE, EN, ES, FR, IT, NL, PT | Language in which we want to receive the response. If not indicated, the value that Hotetec has by default for the user will be returned.
ISO 639-1 codes are used. Right know only the codes indicated in values are accepted. |
| customerIsLogged | N | true/false | Parameter that allows us to indicate whether we want the generated URL to redirect us with or without the registration discount. |
currency | N | EUR, USD, GBP, EGP, MXN, CHF, CUP | Currency in which we want to receive the prices of the request. If not indicated, the value that Hotetec has by default for the user will be returned.
ISO 639-1 codes are used. Right know only the codes indicated in values are accepted. |
hotelCode | Y | Alphanumeric | Single’s hotel/establishment code |
vendorCode | N | Alphanumeric | Company code of a hotel/establishment set |
dateFrom | Y | Date + Time | Check in date Example: "2023-01-15T00:00:00.000Z” |
dateTo | Y | Date + Time | Check out date Example: "2023-01-15T00:00:00.000Z” |
| |||
distribution | Y | "distribution": [{ "id": 1, "person": [ { "age": 30 }, { "age": 30 } ] | Here we will set up all the rooms and occupancy configuration |
id | Y | Room’s IDs, for each room we will add a new ID | |
age | Y | We will set up the age of each occupant. For adults we can set up 30 by default. For children it is compulsory to set up the real age in order to have the correct rates. | |
| |||
mealPlanCode | N | Alphanumeric | Meal plan’s code that we want to have by default. |
promotionalCode | N | Alphanumeric | This is used to launch the request with an associated promotional code |
Example of a request message (JSON):
{
"sessionId": "MST#20077#682164202862402" ,
"languageCode": "ES",
"currency" : "EUR",
"hotelCode": "30621",
"vendorCode": "DEMOHTT",
"dateFrom": "2023-01-15T00:00:00.000Z",
"dateTo": "2023-01-16T00:00:00.000Z",
"distribution": [{
"id": 1,
"person": [
{ "age": 30 },
{ "age": 30 }
]
]
}],
"mealPlanCode": "BB",
"promotionalCode": "TEST"
}
Once we launch this request the system returns a URL that redirects to the booking engine.
Example of a response message (JSON):
{
"bookingEngineUrl": "https://public4.new.hotetec.com/commonAvailability.meta/?bookingEngine=120&systemCode=WHP&hotelCode=53089&dateFrom=07%2F05%2F2024&dateTo=11%2F05%2F2024&mealPlanCode=BB&distribution=ad-2&language=EN¤cy=EUR&customerIsLogged=true"
}
IMPORTANT NOTE: Do not send incorrect parameter values, such as ‘null’, as this will ne add to the URL and will cause conflicts and availability problems.