This message returns a list of bookings based on the parameters set up in the request message.


Endpointhttps://hotel.new.hotetec.com/webservice/integrations/pull/listBookings 

 


listBookings Request message 

 

The message has the following elements:

 

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.

currencyreference 

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.

reference

N

Alphanumeric

Booking locator

vendorCode

N

Alphanumeric

Company code 

hotelCode

N

Alphanumeric

Hotel/establishment code

dateFrom 

N

Data

Date from which you want to list

dateTo 

N

Data

Date to which you want to list

dateType 

N

Data

Data type (referred to dateFrom and dateTo). Values: Creation, Modification, Cancellation, CheckIn, CheckOut.

bookingStatus 

N

Alphanumeric

Possible values:Confirmed, Cancelled.

contactPersonName 

N

Alphanumeric

Contact name

contactPersonMail 

N

Alphanumeric

Contact email

 


Example of request by reference:



{
    "sessionId": "TES#20727#686697834212905",
    "languageCode": "ES",
    "currency": "EUR",
    "reference": "TES250206MALSHH"
}

 



listHotels Response message 

 

The message has the following elements:



 

Element

Description

sessionId

Unique session identifyer

booking

reference

Booking locator.

creationDate

Creation date. Julian format is used.

hotelCode

Hotel code

hotelName

Full hotel name

vendorCode

Company code

checkIn

Check in date. Julian format is used.

checkOut

Check out date. Julian format is used.

rooms
Number of rooms in the booking
totalAdults
Number of adults in the booking
totalChildren
Number of children in the booking
totalBabies
Number of babies in the booking
status
Booking status. Possible values: Cancelled, Confirmed
cancellationDate
Cancellation date of the booking if the above value is Cancelled. Julian format is used.
contactName
Contact name of the booking
contactMail
Contact email
totalAmount
Total amount of the booking.
paidAmount
Amount already paid of the booking.

currencyCode

Currency code of the booking

 

Example of response:


{
    "sessionId": "TES#20727#686697834212905",
    "booking": [
        {
            "reference": "TES250206MALSHH",
            "creationDate": 1738837450960,
            "hotelCode": "53090",
            "hotelName": "Juana",
            "vendorCode": "TESTHTT",
            "checkIn": 1740006000000,
            "checkOut": 1740351600000,
            "rooms": 1,
            "totalAdults": 2,
            "totalChildren": 0,
            "totalBabies": 0,
            "status": "Confirmed",
            "contactName": "John Smith",
            "contactMail": "jrswork@gmail.com",
            "totalAmount": 960.0,
            "paidAmount": 0.0,
            "currencyCode": "EUR"
        }
    ]
}