Booking

The Booking operation requests a reservation confirmation for the specified ratekey or ratekeys.

BookingAPI does not support on-request confirmations. All confirmations are instant confirmations.

Booking Request

Endpoint

Please take into account that at the booking step the endpoint is different between bookings with payment details (for AT_HOTEL rates) and without payment details (for AT_WEB rates).

When sending credit card details:

POST https://api-secure.test.hotelbeds.com/hotel-api/1.0/bookings

TIMEOUT: 60 seconds

When NOT sending credit card details:

POST https://api.test.hotelbeds.com/hotel-api/1.0/bookings

TIMEOUT: 60 seconds

Holder and pax names

The booking holder’s name and surname are mandatory. Regarding the passenger names we recommend at least one adult name (and surname) per room. Please remember that some destinations (for example Las Vegas or some cities in Russia) require all the names to avoid check in problems.

Parameters
XML
JSON

Request parameters

Node/Attribute	Value	Description
bookingRQ	Element	Top level
bookingRQ/@language	String	Response language
bookingRQ/holder	Element	Booking holder information element
bookingRQ/holder/@name	String	Booking holder name for all the rooms of the booking (max length = 50 characters)
bookingRQ/holder/@surname	String	Booking holder surname for all rooms of the booking (max length = 50 characters)
bookingRQ/rooms	Array of room elements	List of the rooms to be confirmed
bookingRQ/rooms/room	Element	Room to be confirmed
bookingRQ/rooms/room/@rateKey	String	Rate key to be confirmed taken from the previous step
bookingRQ/rooms/room/paxes	Array of pax elements	List of paxes for the room
bookingRQ/rooms/room/paxes/pax	Element	Element that describes pax information
bookingRQ/rooms/room/paxes/pax/@roomId	Int	Room where the pax is located
bookingRQ/rooms/room/paxes/pax/@type	String	Pax type Two values are permitted for the attribute: AD for adults CH for child
bookingRQ/rooms/room/paxes/pax/@name	String	Pax name (max length = 50 characters)
bookingRQ/rooms/room/paxes/pax/@surname	String	Pax surname (max length = 50 characters)
bookingRQ/clientReference	String	Your internal booking reference
bookingRQ/remark	String	Free comments text that is sent to the hotelier. It can be used to request or inform of special requests to hotelier like: “Non-smoking room preferred”, “Twin bed please”, “Upper floor preferred”, “Late arrival”…. NOTE: The character limit in this field is 2000 characters.
bookingRQ/tolerance	Double	Margin of price difference (as percentage) accepted when a price difference occurs between Availability/CheckRate and Booking operations. This overrides the default tolerance of 2%. Do not use more than two decimal characters when defining tolerance. Example: to input a tolerance of 5%, you should input 5.00. NOTE: Check with your sales manager before using this tag.
bookingRQ/paymentData	Element	Payment information. NOTE: This node must be used if paymentType='AT_HOTEL', only the pay at hotel model (liberate) uses payment data nodes. For other pricing models, these node must not be used.
bookingRQ/paymentData/paymentCard	Element	Credit card information
bookingRQ/paymentData/paymentCard/cardType	String	Credit card type VISA - VI MASTER CARD - MC AMEX - AE MAESTRO - MA
bookingRQ/paymentData/paymentCard/cardHolderName	String	Credit card holder
bookingRQ/paymentData/paymentCard/cardNumber	Int	Credit card number
bookingRQ/paymentData/paymentCard/expiryDate	Int	Credit card expiration date
bookingRQ/paymentData/paymentCard/cardCVC	Int	Credit card CVC security code
bookingRQ/paymentData/contactData	Element	Contact data of the holder
bookingRQ/paymentData/contactData/email	String	Customer e-mail
bookingRQ/paymentData/contactData/phoneNumber	String	Customer phone number

Request XML Example

<bookingRQ xmlns="http://www.hotelbeds.com/schemas/messages" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	<holder name="Holder Name" surname="Holder Surname"/>
	<rooms>
		<room rateKey="126177|SGL-E10|CG-MERCHANT|1|ST|BB-E10||1~1~0|20150427#1033102103">
			<paxes>
				<pax roomId=1 type="AD" name="Adult Name" surname="Adult Surname"/>
			</paxes>
		</room>
	</rooms>
	<paymentData>
		<paymentCard>
			<cardHolderName>Holder name</cardHolderName>
			<cardType>VI</cardType>
			<cardNumber>4444333322221111</cardNumber>
			<expiryDate>0615</expiryDate>
			<cardCVC>123</cardCVC>
		</paymentCard>
		<contactData>
			<email>integration@test.com</email>
			<phoneNumber>654654654</phoneNumber>
		</contactData>
	</paymentData>
	<clientReference>My booking reference</clientReference>
	<remark>Booking remarks are to be written here.</remark>
	<tolerance>2.00</tolerance>
</bookingRQ>

Request JSON Example

{
	"holder": {
		"name": "IntegrationTestFirstName",
		"surname": "IntegrationTestLastName"
	},
	"rooms": [{
		"rateKey": "20160628|20160702|W|102|569|TPL.ST|CG-OPAQUE|RO||1~1~2|11~11|N@1816912017",
		"paxes": [{
			"roomId": "1",
			"type": "AD",
			"name": "First Adult Name",
			"surname": "Surname"
		},
		{
			"roomId": "1",
			"type": "CH",
			"name": "First Child Name",
			"surname": "Surname"
		},
		{
			"roomId": "1",
			"type": "CH",
			"name": "First Child Name",
			"surname": "Surname"
		}]
	}],
	"clientReference": "IntegrationAgency",
	"remark": "Booking remarks are to be written here.",
	"tolerance" : 2.00
}

Examples

Here You can find additional request examples for some of the uses of the Booking operation in both XML and JSON:

Bookings with multiple rooms of the same type

To book multiple rooms of the same type you just have to add the additional pax elements while increasing the roomId attribute for the passengers of each subsequent room. This is done to assign this extra passengers (for which there would normally be no space) to additional rooms of the same type.

You can observe this in the below example. The room type being booked is a Double Standard, with room for two passengers. The two first passengers are assigned to the first room with roomId = 1, and the two additional passengers are assigned to a second room of the same type, with roomId = 2.

XML
JSON

XML

<bookingRQ xmlns="http://www.hotelbeds.com/schemas/messages" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	<holder name="IntegrationTestFirstName" surname="IntegrationTestLastName"/>
	<clientReference>IntegrationAgency</clientReference>
	<rooms>
		<room rateKey="20180708|20180709|W|1|1070|DBT.ST|NRF- MERCHANT|BB||2~2~0||N@7D54E8910CD145D1528444426321AAES00000120002000207210120">
			<paxes>
				<pax roomId="1" type="AD" name="First Adult Name"/>
				<pax roomId="1" type="AD" name="Second Adult Name"/>
				<pax roomId="2" type="AD" name="Thid Adult Name"/>
				<pax roomId="2" type="AD" name="Fourth Adult Name"/>
			</paxes>
		</room>
	</rooms>
	<remark>Booking remarks are to be written here.</remark>
	<tolerance>2.00</tolerance>
</bookingRQ>

JSON

{
	"holder": {
		"name": "IntegrationTestFirstName",
		"surname": "IntegrationTestLastName"
	},
	"rooms": [{
		"rateKey": "20180708|20180709|W|1|1070|DBT.ST|NRF- MERCHANT|BB||2~2~0||N@7D54E8910CD145D1528444426321AAES00000120002000207210120",
		"paxes": [{
			"roomId": "1",
			"type": "AD",
			"name": "First Adult Name"
		},
		{
			"roomId": "1",
			"type": "AD",
			"name": "Second Adult Name"
		},
		{
			"roomId": "2",
			"type": "AD",
			"name": "Third Adult Name"
		},
		{
			"roomId": "2",
			"type": "AD",
			"name": "Fourth Adult Name"
		}]
	}],
	"clientReference": "IntegrationAgency",
	"remark": "Booking remarks are to be written here.",
	"tolerance" : 2.00
}

Bookings with multiple rooms of different type

In order to book multiple rooms of different type you just have to add as many room elements as rooms you want to book, with their corresponding rateKeys and the appropriate pax elements for each room.

This structure can also be used to book multiple rooms of the same type if you use the same rateKey, but will result in bigger requests in size.

XML
JSON

XML

<bookingRQ xmlns="http://www.hotelbeds.com/schemas/messages" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	<holder name="IntegrationTestFirstName" surname="IntegrationTestLastName"/>
	<clientReference>IntegrationAgency</clientReference>
	<rooms>
		<room rateKey="20180708|20180709|W|1|1070|DBT.ST|NRF- MERCHANT|BB||1~2~0||N@9F3C3CAC02ED4D01528443411841AAES000000800020002071890">
			<paxes>
				<pax roomId="1" type="AD" name="First Adult Name" surname="Surname"/>
				<pax roomId="1" type="AD" name="Second Adult Name" surname="Surname"/>
			</paxes>
		</room>
		<room rateKey="20180708|20180709|W|1|1070|JSU.ST|NRF- MERCHANT|HB||1~1~1|2|N@9F3C3CAC02ED4D01528443411841AAES0000008000200020722de7">
			<paxes>
				<pax roomId="1" type="AD" name="Third Adult Name" surname="Surname"/>
				<pax roomId="1" type="CH" name="First Child Name" surname="Surname"/>
			</paxes>
		</room>
	</rooms>
	<remark>Booking remarks are to be written here.</remark>
	<tolerance>2.00</tolerance>
</bookingRQ>

JSON

{
	"holder": {
		"name": "IntegrationTestFirstName",
		"surname": "IntegrationTestLastName"
	},
	"rooms": [{
		"rateKey": "20180708|20180709|W|1|1070|DBT.ST|NRF- MERCHANT|BB||1~2~0||N@9F3C3CAC02ED4D01528443411841AAES000000800020002071890",
		"paxes": [{
			"roomId": 1,
			"type": "AD",
			"name": "First Adult Name",
			"surname": "Surname"
		},
		{
			"roomId": 1,
			"type": "AD",
			"name": "Second Adult Name",
			"surname": "Surname"
		}]
	},
	{
		"rateKey": "20180708|20180709|W|1|1070|JSU.ST|NRF- MERCHANT|HB||1~1~1|2|N@9F3C3CAC02ED4D01528443411841AAES0000008000200020722de7",
		"paxes": [{
			"roomId": 1,
			"type": "AD",
			"name": "Third Adult Name",
			"surname": "Surname"
		},
		{
			"roomId": 1,
			"type": "CH",
			"name": "First Child Name"
		}]
	}],
	"clientReference": "IntegrationAgency",
	"remark": "Booking remarks are to be written here.",
	"tolerance" : 2.00
}

Booking Response

When the confirmation of a rateKey is successful; the booking reference is provided, along with key information of the booking, which includes:

Hotel confirmed
Holder and pax confirmed
Rate confirmed with the confirmed amounts and dates

The response also contains the price breakdown, cancellation policies, supplements, and discounts.

Please make sure to keep the booking reference of all bookings performed with your credentials, as they are needed for post booking operations such as modification or cancellation.

Parameters
XML
JSON

Response parameters

Node/Attribute	Type	Description
bookingRS	Element	Top Element
bookingRS/auditData	Element	Relevant internal information
bookingRS/auditData/@processTime	Float	Server process time in milliseconds
bookingRS/auditData/@timestamp	Date	Date/time when the requests have been processed
bookingRS/auditData/@requestHost	String	IP address of the system host
bookingRS/auditData/@serverId	String	Server code or ID (for internal use)
bookingRS/auditData/@environment	String	Environment where the request has been sent and processed
bookingRS/auditData/@release	String	Release version identifier
bookingRS/auditData/@token	String	Token identifier of the operation
bookingRS/auditData/@internal	String	Internal identifier of the parameters of the operation
bookingRS/booking	Element	Element that contains the information of the booking
bookingRS/booking/@reference	String	Booking reference Format: XXX-XXXXXX
bookingRS/booking/@clientReference	String	Client internal booking reference
bookingRS/booking/@creationDate	Date	Booking creation date Format: YYYY-MM-DD
bookingRS/booking/@status	String	Booking status: CONFIRMED CANCELLED
bookingRS/booking/@creationUser	String	apiKey used to make the booking
bookingRS/booking/@totalNet	Float	Total amount of the booking
bookingRS/booking/@pendingAmount	Float	Remaining amount to be paid
bookingRS/booking/@currency	String	Currency of the amount to be paid
bookingRS/booking/modificationPolicies	Element	Information regarding the allowed modifications to the booking
bookingRS/booking/modificationPolicies/@cancellation	Boolean	Indicates if the booking can be cancelled
bookingRS/booking/modificationPolicies/@modification	Boolean	Indicates if the booking can be modified
bookingRS/booking/holder	Element	Information of the booking holder
bookingRS/booking/holder/@name	String	Booking holder name
bookingRS/booking/holder/@surname	String	Booking holder surname
bookingRS/booking/hotel	Element	Element that contains information about the hotel and associated rates
bookingRS/booking/hotel/@checkOut	Date	Check-out date Format: YYYY-MM-DD
bookingRS/booking/hotel/@checkIn	Date	Check-in date Format: YYYY-MM-DD
bookingRS/booking/hotel/@code	Int	Hotebeds internal hotel code
bookingRS/booking/hotel/@name	String	Hotel name
bookingRS/booking/hotel/@categoryCode	String	Hotel category code
bookingRS/booking/hotel/@categoryName	String	Category name
bookingRS/booking/hotel/@destinationCode	String	Destination code for hotel location
bookingRS/booking/hotel/@destinationName	String	Destination name for hotel location
bookingRS/booking/hotel/@zoneCode	Int	Zone code for hotel location
bookingRS/booking/hotel/@zoneName	String	Zone name for hotel location
bookingRS/booking/hotel/@latitude	Float	Latitude data for geolocation
bookingRS/booking/hotel/@longitude	Float	Longitude data for geolocation
bookingRS/booking/hotel/@totalSellingRate	Float	Total amount of the booking in hotelCurrency (for the pay at hotel model
bookingRS/booking/hotel/@totalNet	Float	Total amount of the booking
bookingRS/booking/hotel/@currency	String	Client currency
bookingRS/booking/hotel/rooms	Array of room elements	List of rooms booked for the hotel of the reservation
bookingRS/booking/hotel/rooms/room	Element	Element that contains information about the room and associated rates
bookingRS/booking/hotel/rooms/room/@status	String	Room booking status: CONFIRMED CANCELLED
bookingRS/booking/hotel/rooms/room/@id	Int	Room reservation identifier
bookingRS/booking/hotel/rooms/room/@code	Int	Internal room code
bookingRS/booking/hotel/rooms/room/@name	String	Room name/description
bookingRS/booking/hotel/rooms/room/@supplierReference	String	Booking reference of the booking/room for external product supplier bookings
bookingRS/booking/hotel/rooms/room/paxes	Array of pax elements	List of paxes for the room
bookingRS/booking/hotel/rooms/room/paxes/pax	Element	Element that describes passenger information
bookingRS/booking/hotel/rooms/room/paxes/pax/@roomId	Int	Room where the pax is located
bookingRS/booking/hotel/rooms/room/paxes/pax/@type	String	Pax type Two values are permitted for the attribute: AD for adults CH for child
bookingRS/booking/hotel/rooms/room/paxes/pax/@age	Int	Pax age
bookingRS/booking/hotel/rooms/room/paxes/pax/@name	String	Pax name
bookingRS/booking/hotel/rooms/room/paxes/pax/@surname	String	Pax surname
bookingRS/booking/hotel/rooms/room/rates	Array of rate elements	List of rates for a particular hotel
bookingRS/booking/hotel/rooms/room/rates/rate	Element	Price information for a room type and board
bookingRS/booking/hotel/rooms/room/rates/rate/@rateClass	String	Internal rate class type (NOR, NRF, SPE, OFE, PAQ...)
bookingRS/booking/hotel/rooms/room/rates/rate/@net	Float	Room net price
bookingRS/booking/hotel/rooms/room/rates/rate/@rateComments	String	Rate comments that contain important information (max length = 4000 characters)
bookingRS/booking/hotel/rooms/room/rates/rate/@paymentType	String	Identifies if it is pay at hotel or merchant
bookingRS/booking/hotel/rooms/room/rates/rate/@packaging	String	Identifies if the rate is for packaging
bookingRS/booking/hotel/rooms/room/rates/rate/@boardCode	String	Internal board code
bookingRS/booking/hotel/rooms/room/rates/rate/@boardName	String	Board name/description
bookingRS/booking/hotel/rooms/room/rates/rate/@sellingRate	Float	Room gross price, if it is included
bookingRS/booking/hotel/rooms/room/rates/rate/@commission	Float	Profit margin the agency takes (commissionable model)
bookingRS/booking/hotel/rooms/room/rates/rate/@hotelSellingRate	Float	Room gross price in hotelCurrency (for the pay at hotel model)
bookingRS/booking/hotel/rooms/room/rates/rate/@hotelCurrency	String	Hotel currency (for the pay at hotel model)
bookingRS/booking/hotel/rooms/room/rates/rate/@hotelMandatory	Boolean	Identifies if the selling rate is recommended
bookingRS/booking/hotel/rooms/room/rates/rate/@rooms	Int	Number of rooms requested with the same occupancy
bookingRS/booking/hotel/rooms/room/rates/rate/@adults	Int	Number of adults requested per room
bookingRS/booking/hotel/rooms/room/rates/rate/@children	Int	Number of children requested per room
bookingRS/booking/hotel/rooms/room/rates/rate/cancellationPolicies	Array of policies elements	List of cancellation policies
bookingRS/booking/hotel/rooms/room/rates/rate/cancellationPolicies/policy	Element	Cancellation policies
bookingRS/booking/hotel/rooms/room/rates/rate/cancellationPolicies/policy/@amount	Float	Amount that will be charged after '@from' date
bookingRS/booking/hotel/rooms/room/rates/rate/cancellationPolicies/policy/@from	String	Date from which the amount will be charged in ISO 8601 format (yyyy-MM-ddTHH:mm:ssZ)
bookingRS/booking/hotel/rooms/room/rates/rate/cancellationPolicies/policy/@hotelAmount	Float	Amount that will be charged after '@from' date, provided in hotel currency (for the pay at hotel model)
bookingRS/booking/hotel/rooms/room/rates/rate/cancellationPolicies/policy/@hotelCurrency	String	Currency in which the booking must be paid on arrival
bookingRS/booking/hotel/rooms/room/rates/rate/rateBreakDown	Element	Rate breakdown element
bookingRS/booking/hotel/rooms/room/rates/rate/rateBreakDown/@commission	Float	Profit margin the agency takes (commissionable model)
bookingRS/booking/hotel/rooms/room/rates/rate/rateBreakDown/@commissionPCT	Float	Percentual share of the price corresponding to commision
bookingRS/booking/hotel/rooms/room/rates/rate/rateBreakDown/@commissionVAT	Float	Share of the commission corresponding to the Value Added Tax
bookingRS/booking/hotel/rooms/room/rates/rate/rateBreakDown/rateDiscounts	Array of rateDiscounts elements	List of discounts for a particular rate
bookingRS/booking/hotel/rooms/room/rates/rate/rateBreakDown/rateDiscounts/rateDiscount	Element	Discount element
bookingRS/booking/hotel/rooms/room/rates/rate/rateBreakDown/rateDiscounts/rateDiscount/@code	Int	Discount internal code
bookingRS/booking/hotel/rooms/room/rates/rate/rateBreakDown/rateDiscounts/rateDiscount/@name	String	Discount name/description
bookingRS/booking/hotel/rooms/room/rates/rate/rateBreakDown/rateDiscounts/rateDiscount/@amount	Float	Amount of the discount
bookingRS/booking/hotel/rooms/room/rates/rate/rateBreakDown/rateSupplements	Array of rateSupplements elements	List of supplements for a particular rate
bookingRS/booking/hotel/rooms/room/rates/rate/rateBreakDown/rateSupplements/rateSupplement	Element	Rate supplements element
bookingRS/booking/hotel/rooms/room/rates/rate/rateBreakDown/rateSupplements/rateSupplement/@code	Int	Supplement code
bookingRS/booking/hotel/rooms/room/rates/rate/rateBreakDown/rateSupplements/rateSupplement/@name	String	Supplement name
bookingRS/booking/hotel/rooms/room/rates/rate/rateBreakDown/rateSupplements/rateSupplement/@from	Date	Date from when the supplement begins to apply
bookingRS/booking/hotel/rooms/room/rates/rate/rateBreakDown/rateSupplements/rateSupplement/@to	Date	Date that the supplement no longer applies
bookingRS/booking/hotel/rooms/room/rates/rate/rateBreakDown/rateSupplements/rateSupplement/@amount	Float	Supplement amount
bookingRS/booking/hotel/rooms/room/rates/rate/rateBreakDown/rateSupplements/rateSupplement/@nights	Int	Number of nights the supplement applies
bookingRS/booking/hotel/rooms/room/rates/rate/rateBreakDown/rateSupplements/rateSupplement/@paxNumber	Int	Number of paxes to whom the supplement applies
bookingRS/booking/hotel/rooms/room/rates/rate/rateBreakDown/rateSupplements/rateSupplement/@paxType	String	Type of pax
bookingRS/booking/hotel/rooms/room/rates/rate/taxes	Array of tax elements	List of prices with taxes included or excluded
bookingRS/booking/hotel/rooms/room/rates/rate/taxes/@allIncluded	Boolean	Indicates if all taxes are included or not
bookingRS/booking/hotel/rooms/room/rates/rate/taxes/tax	Element	Element that contains the information about the tax
bookingRS/booking/hotel/rooms/room/rates/rate/taxes/tax/@included	Boolean	Indicates if the tax is included in the price or not
bookingRS/booking/hotel/rooms/room/rates/rate/taxes/tax/@percent	Float	Value of the tax as a percentage
bookingRS/booking/hotel/rooms/room/rates/rate/taxes/tax/@amount	Float	Value of the tax in hotel currency if the tax is not included in the price
bookingRS/booking/hotel/rooms/room/rates/rate/taxes/tax/@currency	String	Currency of the tax amount
bookingRS/booking/hotel/rooms/room/rates/rate/taxes/tax/@type	String	Type of the tax: TAX FEE TAXESANDFEES
bookingRS/booking/hotel/rooms/room/rates/rate/taxes/tax/@clientAmount	Float	Net amount of the tax in the client configured currency, returned in case the currency of the hotel is different from the client currency
bookingRS/booking/hotel/rooms/room/rates/rate/taxes/tax/@clientCurrency	String	Client configured currency in case the currency of the hotel is different from the client currency
bookingRS/booking/hotel/supplier	Element	Element that contains supplier information
bookingRS/booking/hotel/supplier/@name	String	Supplier name
bookingRS/booking/hotel/supplier/@vatNumber	String	Supplier VAT number
bookingRS/booking/invoiceCompany	Element	Element that contains information about the invoice company
bookingRS/booking/invoiceCompany/@code	String	Code of the invoice company
bookingRS/booking/invoiceCompany/@name	String	Name of the invoice company
bookingRS/booking/invoiceCompany/@registrationNumber	String	Registration number of the invoice company
bookingRS/booking/remark	String	Free comments text that is sent to the hotelier. It can be used to request or inform of special requests to hotelier like: “Non-smoking room preferred”, “Twin bed please”, “Upper floor preferred”, “Late arrival”…. NOTE: The character limit in this field is 2000 characters.

Response XML Example

<?xml version="1.0" encoding="UTF-8"?>
<bookingRS xmlns="http://www.hotelbeds.com/schemas/messages" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" schemaLocation="http://www.hotelbeds.com/schemas/messages">
	<auditData processTime="1096" timestamp="2018-03-23 09:45:12.518" requestHost="212.66.164.12" serverId="sa3RKSJACHXE79K.env#PL" environment="[int]" release="5c2a98762e8da116cf86a57a17c9db9d2e4d80eb" token="6d71245c-dc5b-4a40-aab3-554b3ad8f7d5" internal="0|A8FAFF47CABB439894D7DF039FABE2260934|UK|07|16|354|||||||||11.26|C|R|311|1|1~1~2~0|0|8||3|wuupfvswdqfz342cejxfv3ku|||"/>
	<booking reference="1-3816249" clientReference="BRUNOTESTBOOKING" creationDate="2018-03-23" status="CONFIRMED" creationUser="wuupfvswdqfz342cejxfv3ku" totalNet="250.19" pendingAmount="250.19" currency="EUR">
		<modificationPolicies cancellation="true" modification="true"/>
		<holder name="HOLDERFIRSTNAME" surname="HOLDERLASTNAME"/>
		<hotel checkOut="2018-04-24" checkIn="2018-04-23" code="229318" name="Hotel Hostal Cuba" categoryCode="4EST" categoryName="4 STARS" destinationCode="PMI" destinationName="Majorca" zoneCode="10" zoneName="Palma" latitude="39.570177" longitude="2.639077" totalNet="250.19" currency="EUR">
			<rooms>
				<room status="CONFIRMED" id="1" code="JSU.ST" name="JUNIOR SUITE STANDARD" supplierReference="18431999M-MJ">
					<paxes>
						<pax roomId="1" type="AD" name="Second Adult Name" surname="Surname"/>
						<pax roomId="1" type="AD" name="First Adult Name" surname="Surname"/>
					</paxes>
					<rates>
						<rate rateClass="NOR" net="250.19" sellingRate="280.00" hotelMandatory="true" rateComments="1x JUNIOR SUITE Estimated total amount of taxes &amp; fees for this booking: 6.60 Euro   payable on arrival  &#xd;. Car park NO   . Key Collection 15:00 – . Check-in hour 15:00 – 00:00. No hen/stag or any other parties allowed  – . " paymentType="AT_WEB" packaging="false" boardCode="BB" boardName="BED AND BREAKFAST" rooms="1" adults="2" children="0">
							<cancellationPolicies>
								<cancellationPolicy amount="250.19" from="2018-04-19T23:59:00+02:00"/>
							</cancellationPolicies>
							<taxes allIncluded="false">
								<tax included="false" amount="6.60" currency="EUR"/>
							</taxes>
						</rate>
					</rates>
				</room>
			</rooms>
			<supplier name="HOTELBEDS PRODUCT,S.L.U." vatNumber="ESB38877676"/>
		</hotel>
		<remark>Booking remarks are to be written here.</remark>
		<invoiceCompany code="E14" name="HOTELBEDS SPAIN, S.L.U" registrationNumber="ESB57218372"/>
	</booking>
</bookingRS>

Response JSON Example

{
	"auditData": {
		"processTime": "2083",
		"timestamp": "2018-03-23 09:35:20.383",
		"requestHost": "212.66.164.12",
		"serverId": "sa3RKSJACHXE79K.env#PL",
		"environment": "[int]",
		"release": "5c2a98762e8da116cf86a57a17c9db9d2e4d80eb",
		"token": "8d42450b-f463-4bc3-aae8-fc0b030c0e37",
		"internal": "0|A8FAFF47CABB439894D7DF039FABE2260934|UK|07|16|354|||||||||11.26|C|R|311|1|1~1~2~0|0|8||3|wuupfvswdqfz342cejxfv3ku|||"
	},
	"booking": {
		"reference": "1-3816248",
		"clientReference": "BRUNOTESTBOOKING",
		"creationDate": "2018-03-23",
		"status": "CONFIRMED",
		"modificationPolicies": {
			"cancellation": true,
			"modification": true
		},
		"creationUser": "wuupfvswdqfz342cejxfv3ku",
		"holder": {
			"name": "HOLDERFIRSTNAME",
			"surname": "HOLDERLASTNAME"
		},
		"hotel": {
			"checkOut": "2018-04-24",
			"checkIn": "2018-04-23",
			"code": 229318,
			"name": "Hotel Hostal Cuba",
			"categoryCode": "4EST",
			"categoryName": "4 STARS",
			"destinationCode": "PMI",
			"destinationName": "Majorca",
			"zoneCode": 10,
			"zoneName": "Palma",
			"latitude": "39.570177",
			"longitude": "2.639077",
			"rooms": [{
				"status": "CONFIRMED",
				"id": 1,
				"code": "JSU.ST",
				"name": "JUNIOR SUITE STANDARD",
				"supplierReference": "16923904M-MJ",
				"paxes": [{
					"roomId": 1,
					"type": "AD",
					"name": "Second Adult Name",
					"surname": "Surname"
				},
				{
					"roomId": 1,
					"type": "AD",
					"name": "First Adult Name",
					"surname": "Surname"
				}],
				"rates": [{
					"rateClass": "NOR",
					"net": "250.19",
					"sellingRate": "280.00",
					"hotelMandatory": true,
					"rateComments": "1x JUNIOR SUITE Estimated total amount of taxes & fees for this booking: 6.60 Euro   payable on arrival  \r. Car park NO   . Key Collection 15:00 – . Check-in hour 15:00 – 00:00. No hen/stag or any other parties allowed  – . ",
					"paymentType": "AT_WEB",
					"packaging": false,
					"boardCode": "BB",
					"boardName": "BED AND BREAKFAST",
					"cancellationPolicies": [{
						"amount": "250.19",
						"from": "2018-04-19T23:59:00+02:00"
					}],
					"taxes": {
						"taxes": [{
							"included": false,
							"amount": "6.60",
							"currency": "EUR"
						}],
						"allIncluded": false
					},
					"rooms": 1,
					"adults": 2,
					"children": 0
				}]
			}],
			"totalNet": "250.19",
			"currency": "EUR",
			"supplier": {
				"name": "HOTELBEDS PRODUCT,S.L.U.",
				"vatNumber": "ESB38877676"
			}
		},
		"remark": "Booking remarks are to be written here.",
		"invoiceCompany": {
			"code": "E14",
			"company": "HOTELBEDS SPAIN, S.L.U",
			"registrationNumber": "ESB57218372"
		},
		"totalNet": 250.19,
		"pendingAmount": 250.19,
		"currency": "EUR"
	}
}

Post Booking Operations

Once you have confirmed bookings, there's a series of operations that can be performed:

BookingList: To retrieve a list of the performed bookings.
BookingDetail: To retrieve the information of a specific booking.
BookingChange: To update and modify a booking.
BookingCancellation: To cancel a booking.

Bear in mind that except for BookingList you will need the booking reference of the bookings you carried out to perform this operations.

version 47 as of 3 days ago by Bruno Rodriguez