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.

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

bookingRQ/holder/@surname

String

Booking holder surname for all rooms of the booking

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

bookingRQ/rooms/room/paxes/pax/@surname

String

Pax surname

bookingRQ/clientReference

String

Your internal booking reference

bookingRQ/remark String Comments.

NOTE: The character limit in this field is 2000 characters.

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>
</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"
}

 

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

<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>
</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."
}

 

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

<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>
</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."
}

 

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.

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 lenght = 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/@sellingPrice

Float

Room gross price, if it is included

bookingRS/booking/hotel/rooms/room/rates/rate/@comission

Float

Commission

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/@agComission

Float

Agency commission

bookingRS/booking/hotel/rooms/room/rates/rate/rateBreakDown/@comissionPct

Float

Commission percentage

bookingRS/booking/hotel/rooms/room/rates/rate/rateBreakDown/@comissionVat

Float

Commission taxes

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 Booking comments

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:

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

Docs Navigation