Setting/custom booking: Difference between revisions

From Beds24 Wiki
Jump to navigation Jump to search
← Older edit
No edit summary
Lesley (talk | contribs)
3,945 edits
No edit summary
 
(12 intermediate revisions by 4 users not shown)
Line 1: Line 1:
Custom values can be defined to specify specific values for this channel only. This will override the values you have set generally. Add the parameters one per line.
Custom values can be set at Property and Room level for Booking.com
 
At the moment Booking.com only supports custom values for the property.


Custom values can be defined to specify specific values for this channel only. This will override the values you have set generally. Add the parameters one per line. Available parameters are:
Custom values can be defined to specify specific values for this channel only. This will override the values you have set generally. Add the parameters one per line. Available parameters are:
Line 67: Line 65:




'''4. Taxes and fees'''
'''4. Taxes and fees - Values can be set for Property or Room.'''


Taxes and fees can apply per stay, per day, per person and night or as a percentage.  
Taxes and fees can apply per stay, per day, per person and night or as a percentage.  
Line 80: Line 78:
   
   
CITYTAXPERCENT - a percentage is added for citytax.
CITYTAXPERCENT - a percentage is added for citytax.
VATRATEPERCENT - will send the vat rate for your property.




Line 87: Line 87:


CLEANINGFEE
CLEANINGFEE


ELECTRICITYFEE
ELECTRICITYFEE
Line 164: Line 163:


In this example we will send that a fee applies for pets. Booking.com will not display the amount though.
In this example we will send that a fee applies for pets. Booking.com will not display the amount though.
'''4.1 Future Charges'''
The Booking.com Charges API allows setting date-based fees/taxes using '''FROM''' and '''TO'''.
'''Format:'''
<pre>
FEENAME=amount FROM=YYYY-MM-DD TO=YYYY-MM-DD
</pre>
'''Example:'''
<pre>
AIRPORTSHUTTLEFEE=12 FROM=2026-03-09 TO=2026-05-31
</pre>
The fee applies only within the defined date range. Outside this period, the previous value applies.
'''Notes:'''
* '''FROM''' is optional (defaults to today) 
* '''TO''' is optional (applies indefinitely if not set) 
* Both formats are supported:
<pre>
FEENAME 10
FEENAME=10
</pre>
'''Unsetting a charge:'''
<pre>
FEENAME=0 FROM=YYYY-MM-DD
</pre>
'''Rules:'''
* Charges cannot overlap 
* Avoid using past dates (may cause unexpected results) 
* On import, '''FROM''' is only set if it is in the future 
'''Booking.com UI behavior:'''
Updating charges may create duplicate entries instead of replacing existing ones.
Recommended flow:
1. Remove existing charges 
2. Sync 
3. Add new values 
4. Sync again 


'''5. Security deposit'''
'''5. Security deposit'''
The security deposit is constructed of several elements starting with SECURITYDEPOSIT followed by the rules which apply.


SECURITYDEPOSIT
SECURITYDEPOSIT
Payment by:


CASH
CASH
Line 176: Line 230:


PAYPAL
PAYPAL
Due at


CHECKIN
CHECKIN
Line 188: Line 244:


CHECKOUT+14
CHECKOUT+14
Returned to the guest by


RETURNCASH
RETURNCASH
Line 202: Line 260:


Guests needs to pay a security deposit of 100 seven days before check-in by credit card. The deposit is returned 7 days after check-out via Paypal.
Guests needs to pay a security deposit of 100 seven days before check-in by credit card. The deposit is returned 7 days after check-out via Paypal.
SECURITYDEPOSIT 0 will remove the Security deposit from Booking.com.


'''6. Legal'''
'''6. Legal'''
Line 213: Line 274:
LEGALTAXCATEGORY 11  (France only city tax category. If your answer to any of the above is (yes) you do NOT need this - 11=Palaces, 12=Hôtels de tourisme 5 étoiles, résidences de tourisme 5 étoiles, meublés de tourisme 5 étoiles, 13=Hôtels de tourisme 4 étoiles, résidences de tourisme 4 étoiles, meublés de tourisme 4 étoiles, 14=Hôtels de tourisme 3 étoiles, résidences de tourisme 3 étoiles, meublés de tourisme 3 étoiles, 15=Hôtels de tourisme 2 étoiles, résidences de tourisme 2 étoiles, meublés de tourisme 2 étoiles, villages de vacances 4 et 5 étoiles, 16=Hôtels de tourisme 1 étoile, résidences de tourisme 1 étoile, meublés de tourisme 1 étoile, villages de vacances 1,2 et 3 étoiles, chambres d'hôtes, emplacements dans des aires de camping-cars et des parcs de stationnement touristiques par tranche de 24 heures, 17=Terrains de camping et terrains de caravanage classés en 3,4 et 5 étoiles, 18=Terrains de camping et terrains de caravanage classés en 1 et 2 étoiles, ports de plaisance, 19=Hébergements en attente de classement ou sans classement)
LEGALTAXCATEGORY 11  (France only city tax category. If your answer to any of the above is (yes) you do NOT need this - 11=Palaces, 12=Hôtels de tourisme 5 étoiles, résidences de tourisme 5 étoiles, meublés de tourisme 5 étoiles, 13=Hôtels de tourisme 4 étoiles, résidences de tourisme 4 étoiles, meublés de tourisme 4 étoiles, 14=Hôtels de tourisme 3 étoiles, résidences de tourisme 3 étoiles, meublés de tourisme 3 étoiles, 15=Hôtels de tourisme 2 étoiles, résidences de tourisme 2 étoiles, meublés de tourisme 2 étoiles, villages de vacances 4 et 5 étoiles, 16=Hôtels de tourisme 1 étoile, résidences de tourisme 1 étoile, meublés de tourisme 1 étoile, villages de vacances 1,2 et 3 étoiles, chambres d'hôtes, emplacements dans des aires de camping-cars et des parcs de stationnement touristiques par tranche de 24 heures, 17=Terrains de camping et terrains de caravanage classés en 3,4 et 5 étoiles, 18=Terrains de camping et terrains de caravanage classés en 1 et 2 étoiles, ports de plaisance, 19=Hébergements en attente de classement ou sans classement)


'''7. Addiotional policies and House Rules'''
'''7. Addiontional policies and House Rules'''


AREA_BUSY
AREA_BUSY
Line 268: Line 329:




'''8 Cancellation Policies'''
'''8. Parking'''
 
Each cancellation policy Booking.com supports has a number. You can sent one or more cancellation policies and define specific policies for each offer in Beds24.
 
Examples:
 
CANCELPOLICY 15
 
In this example cancellaction policy 15 which is "The guest can cancel free of charge until 7 days before arrival. The guest will be charged the total price if they cancel in the 7 days before arrival." will be sent.
 
Codes for policies are:
 
'''Free cancellation'''
 
12 — The guest can cancel free of charge until 42 days before arrival. The guest will be charged the total price if they cancel in the 42 days before arrival.
 
14 — The guest can cancel free of charge until 14 days before arrival. The guest will be charged the total price if they cancel in the 14 days before arrival.
 
15 — The guest can cancel free of charge until 7 days before arrival. The guest will be charged the total price if they cancel in the 7 days before arrival.
 
16 — The guest can cancel free of charge until 5 days before arrival. The guest will be charged the total price if they cancel in the 5 days before arrival.
 
29 — The guest can cancel free of charge until 2 days before arrival. The guest will be charged the total price if they cancel in the 2 days before arrival.
 
30 — The guest can cancel free of charge until 14 days before arrival. The guest will be charged the first night if they cancel in the 14 days before arrival.
 
31 — The guest can cancel free of charge until 3 days before arrival. The guest will be charged the total price if they cancel in the 3 days before arrival.
 
33 — The guest can cancel free of charge until 3 days before arrival. The guest will be charged the first night if they cancel in the 3 days before arrival.
 
34 — The guest can cancel free of charge until 2 days before arrival. The guest will be charged the first night if they cancel in the 2 days before arrival.
 
36 — The guest can cancel free of charge until 1 day before arrival. The guest will be charged the first night if they cancel within 1 day before arrival.
 
37 — The guest can cancel free of charge until 7 days before arrival. The guest will be charged the first night if they cancel in the 7 days before arrival.
 
38 — The guest can cancel free of charge until 1 day before arrival. The guest will be charged the total price if they cancel within 1 day before arrival.
 
41 — The guest can cancel free of charge until 6 pm on the day of arrival. The guest will be charged the total price if they cancel after 6 pm on the day of arrival.
 
42 — The guest can cancel free of charge until 6 pm on the day of arrival. The guest will be charged the first night if they cancel after 6 pm on the day of arrival.
 
43 — The guest can cancel free of charge until 2 pm on the day of arrival. The guest will be charged the first night if they cancel after 2 pm on the day of arrival.
 
44 — The guest can cancel free of charge until 2 pm on the day of arrival. The guest will be charged 30% of the total price if they cancel after 2 pm on the day of arrival.
 
45 — The guest can cancel free of charge until 2 pm on the day of arrival. The guest will be charged 50% of the total price if they cancel after 2 pm on the day of arrival.
 
46 — The guest can cancel free of charge until 2 pm on the day of arrival. The guest will be charged 70% of the total price if they cancel after 2 pm on the day of arrival.
 
47 — The guest can cancel free of charge until 2 pm on the day of arrival. The guest will be charged the total price if they cancel after 2 pm on the day of arrival.
 
48 — The guest can cancel free of charge until 6 pm on the day of arrival. The guest will be charged 30% of the total price if they cancel after 6 pm on the day of arrival.
 
49 — The guest can cancel free of charge until 6 pm on the day of arrival. The guest will be charged 50% of the total price if they cancel after 6 pm on the day of arrival.
 
50 — The guest can cancel free of charge until 6 pm on the day of arrival. The guest will be charged 70% of the total price if they cancel after 6 pm on the day of arrival.
 
51 — The guest can cancel free of charge until 1 day before arrival. The guest will be charged 30% of the total price if they cancel within 1 day before arrival.
 
52 — The guest can cancel free of charge until 1 day before arrival. The guest will be charged 50% of the total price if they cancel within 1 day before arrival.
 
53 — The guest can cancel free of charge until 1 day before arrival. The guest will be charged 70% of the total price if they cancel within 1 day before arrival.
 
54 — The guest can cancel free of charge until 2 days before arrival. The guest will be charged 30% of the total price if they cancel in the 2 days before arrival.
 
55 — The guest can cancel free of charge until 2 days before arrival. The guest will be charged 50% of the total price if they cancel in the 2 days before arrival.
 
56 — The guest can cancel free of charge until 2 days before arrival. The guest will be charged 70% of the total price if they cancel in the 2 days before arrival.
 
57 — The guest can cancel free of charge until 3 days before arrival. The guest will be charged 30% of the total price if they cancel in the 3 days before arrival.
 
58 — The guest can cancel free of charge until 3 days before arrival. The guest will be charged 50% of the total price if they cancel in the 3 days before arrival.
 
59 — The guest can cancel free of charge until 3 days before arrival. The guest will be charged 70% of the total price if they cancel in the 3 days before arrival.
 
60 — The guest can cancel free of charge until 5 days before arrival. The guest will be charged the first night if they cancel in the 5 days before arrival.
 
61 — The guest can cancel free of charge until 5 days before arrival. The guest will be charged 30% of the total price if they cancel in the 5 days before arrival.
 
62 — The guest can cancel free of charge until 5 days before arrival. The guest will be charged 50% of the total price if they cancel in the 5 days before arrival.
 
63 — The guest can cancel free of charge until 5 days before arrival. The guest will be charged 70% of the total price if they cancel in the 5 days before arrival.
 
64 — The guest can cancel free of charge until 7 days before arrival. The guest will be charged 30% of the total price if they cancel in the 7 days before arrival.
 
65 — The guest can cancel free of charge until 7 days before arrival. The guest will be charged 50% of the total price if they cancel in the 7 days before arrival.
 
66 — The guest can cancel free of charge until 7 days before arrival. The guest will be charged 70% of the total price if they cancel in the 7 days before arrival.
 
67 — The guest can cancel free of charge until 14 days before arrival. The guest will be charged 30% of the total price if they cancel in the 14 days before arrival.
 
68 — The guest can cancel free of charge until 14 days before arrival. The guest will be charged 50% of the total price if they cancel in the 14 days before arrival.
 
69 — The guest can cancel free of charge until 14 days before arrival. The guest will be charged 70% of the total price if they cancel in the 14 days before arrival.
 
70 — The guest can cancel free of charge until 30 days before arrival. The guest will be charged the first night if they cancel in the 30 days before arrival.
 
71 — The guest can cancel free of charge until 30 days before arrival. The guest will be charged 30% of the total price if they cancel in the 30 days before arrival.
 
72 — The guest can cancel free of charge until 30 days before arrival. The guest will be charged 50% of the total price if they cancel in the 30 days before arrival.
 
73 — The guest can cancel free of charge until 30 days before arrival. The guest will be charged 70% of the total price if they cancel in the 30 days before arrival.
 
74 — The guest can cancel free of charge until 30 days before arrival. The guest will be charged the total price if they cancel in the 30 days before arrival.
 
113 — The guest can cancel free of charge until 42 days before arrival. The guest will be charged the first night if they cancel in the 42 days before arrival.
 
114 — The guest can cancel free of charge until 42 days before arrival. The guest will be charged 30% of the total price if they cancel in the 42 days before arrival.
 
115 — The guest can cancel free of charge until 42 days before arrival. The guest will be charged 50% of the total price if they cancel in the 42 days before arrival.
 
116 — The guest can cancel free of charge until 42 days before arrival. The guest will be charged 70% of the total price if they cancel in the 42 days before arrival.
 
117 — The guest can cancel free of charge until 60 days before arrival. The guest will be charged the first night if they cancel in the 60 days before arrival.
 
118 — The guest can cancel free of charge until 60 days before arrival. The guest will be charged 30% of the total price if they cancel in the 60 days before arrival.
 
119 — The guest can cancel free of charge until 60 days before arrival. The guest will be charged 50% of the total price if they cancel in the 60 days before arrival.
 
120 — The guest can cancel free of charge until 60 days before arrival. The guest will be charged 70% of the total price if they cancel in the 60 days before arrival.
 
121 — The guest can cancel free of charge until 60 days before arrival. The guest will be charged the total price if they cancel in the 60 days before arrival.
'''
Non-Free Cancellation'''
 
2 — The guest will be charged 50% of the total price if they cancel after reservation and the total price if they cancel in the 42 days before arrival.
 
4 — The guest will be charged 50% of the total price if they cancel after reservation and the total price if they cancel in the 14 days before arrival.
 
5 — The guest will be charged 50% of the total price if they cancel after reservation and the total price if they cancel in the 7 days before arrival.
 
6 — The guest will be charged 50% of the total price if they cancel after reservation and the total price if they cancel in the 5 days before arrival.
 
7 — The guest will be charged 30% of the total price if they cancel after reservation and the total price if they cancel in the 42 days before arrival.
 
9 — The guest will be charged 30% of the total price if they cancel after reservation and the total price if they cancel in the 14 days before arrival.
 
10 — The guest will be charged 30% of the total price if they cancel after reservation and the total price if they cancel in the 7 days before arrival.
 
11 — The guest will be charged 30% of the total price if they cancel after reservation and the total price if they cancel in the 5 days before arrival.
 
75 — The guest will be charged 30% of the total price if they cancel after reservation and a further 20% of the total price if they cancel within 1 day before arrival.
 
76 — The guest will be charged 30% of the total price if they cancel after reservation and a further 40% of the total price if they cancel within 1 day before arrival.
 
77 — The guest will be charged 50% of the total price if they cancel after reservation and a further 20% of the total price if they cancel within 1 day before arrival.
 
78 — The guest will be charged 70% of the total price if they cancel after reservation and the total price if they cancel within 1 day before arrival.
 
79 — The guest will be charged 30% of the total price if they cancel after reservation and a further 20% of the total price if they cancel in the 2 days before arrival.
 
80 — The guest will be charged 30% of the total price if they cancel after reservation and a further 40% of the total price if they cancel in the 2 days before arrival.
 
81 — The guest will be charged 50% of the total price if they cancel after reservation and a further 20% of the total price if they cancel in the 2 days before arrival.
 
82 — The guest will be charged 70% of the total price if they cancel after reservation and the total price if they cancel in the 2 days before arrival.
 
83 — The guest will be charged 30% of the total price if they cancel after reservation and a further 20% of the total price if they cancel in the 3 days before arrival.
 
84 — The guest will be charged 30% of the total price if they cancel after reservation and a further 40% of the total price if they cancel in the 3 days before arrival.
 
85 — The guest will be charged 50% of the total price if they cancel after reservation and a further 20% of the total price if they cancel in the 3 days before arrival.
 
86 — The guest will be charged 70% of the total price if they cancel after reservation and the total price if they cancel in the 3 days before arrival.
 
87 — The guest will be charged 30% of the total price if they cancel after reservation and a further 20% of the total price if they cancel in the 5 days before arrival.
 
88 — The guest will be charged 30% of the total price if they cancel after reservation and a further 40% of the total price if they cancel in the 5 days before arrival.
 
89 — The guest will be charged 50% of the total price if they cancel after reservation and a further 20% of the total price if they cancel in the 5 days before arrival.
 
90 — The guest will be charged 70% of the total price if they cancel after reservation and the total price if they cancel in the 5 days before arrival.
 
91 — The guest will be charged 30% of the total price if they cancel after reservation and a further 20% of the total price if they cancel in the 7 days before arrival.
 
92 — The guest will be charged 30% of the total price if they cancel after reservation and a further 40% of the total price if they cancel in the 7 days before arrival.
 
93 — The guest will be charged 50% of the total price if they cancel after reservation and a further 20% of the total price if they cancel in the 7 days before arrival.
 
94 — The guest will be charged 70% of the total price if they cancel after reservation and the total price if they cancel in the 7 days before arrival.
 
95 — The guest will be charged 30% of the total price if they cancel after reservation and a further 20% of the total price if they cancel in the 14 days before arrival.
 
96 — The guest will be charged 30% of the total price if they cancel after reservation and a further 40% of the total price if they cancel in the 14 days before arrival.


97 — The guest will be charged 50% of the total price if they cancel after reservation and a further 20% of the total price if they cancel in the 14 days before arrival.
PARKING_INCLUDED


98 — The guest will be charged 70% of the total price if they cancel after reservation and the total price if they cancel in the 14 days before arrival.
PARKING_POSSIBLE


99 — The guest will be charged 30% of the total price if they cancel after reservation and a further 20% of the total price if they cancel in the 30 days before arrival.
PARKING_PAID


100 — The guest will be charged 30% of the total price if they cancel after reservation and a further 40% of the total price if they cancel in the 30 days before arrival.


101 — The guest will be charged 50% of the total price if they cancel after reservation and a further 20% of the total price if they cancel in the 30 days before arrival.
PARKING INCLUDED, PARKING POSSIBLE and PARKING PAID can include attributes. 
Add the attributes' values as a single line in "Custom" in {{#fas:cog}} (SETTINGS) > CHANNEL MANAGER > BOOKING.COM > SPECIFIC PROPERTY CONTENT. 
Use the context help {{#fas:question-circle}} for information.


102 — The guest will be charged 70% of the total price if they cancel after reservation and the total price if they cancel in the 30 days before arrival.
'''Parking Attributes:'''


122 — The guest will be charged 30% of the total price if they cancel after reservation and the total price if they cancel within 1 day before arrival.
TYPE:<br>
:&nbsp;• UNKNOWN_PARKING_TYPE<br>
:&nbsp;• PARKING_GARAGE<br>
:&nbsp;• PARKING_LOT<br>
:&nbsp;• STREET_PARKING<br>


123 — The guest will be charged 50% of the total price if they cancel after reservation and the total price if they cancel within 1 day before arrival.
LOCATION:<br>
:&nbsp;• ON_SITE<br>
:&nbsp;• NEARBY<br>


124 — The guest will be charged 30% of the total price if they cancel after reservation and the total price if they cancel in the 2 days before arrival.
ACCESS:<br>
:&nbsp;• ONLY_GUESTS<br>
:&nbsp;• GENERAL_PUBLIC<br>


125 — The guest will be charged 50% of the total price if they cancel after reservation and the total price if they cancel in the 2 days before arrival.
RESERVATION:<br>
:&nbsp;• RESERVATION_NEEDED<br>
:&nbsp;• RESERVATION_NOT_NEEDED<br>
:&nbsp;• RESERVATION_NOT_POSSIBLE<br>


126 — The guest will be charged 30% of the total price if they cancel after reservation and the total price if they cancel in the 3 days before arrival.
NAME:<br>
:&nbsp;• NAME=Your_text<br>


127 — The guest will be charged 50% of the total price if they cancel after reservation and the total price if they cancel in the 3 days before arrival.
FEE:<br>
:&nbsp;• PARKINGFEE=xx.xx<br>
:&nbsp;• PARKINGFEEHOURLY=xx.xx<br>
:&nbsp;• PARKINGFEEDAILY=xx.xx<br>


128 — The guest will be charged 30% of the total price if they cancel after reservation and the total price if they cancel in the 30 days before arrival.
'''Example:'''
<pre>
PARKING_INCLUDED NAME=Parking_1 NEARBY ONLY_GUESTS RESERVATION_NEEDED
</pre>


129 — The guest will be charged 50% of the total price if they cancel after reservation and the total price if they cancel in the 30 days before arrival.
'''Example:'''
<pre>
PARKING_PAID PARKINGFEEDAILY=16.99 NAME=THIS_CAR_PARK2b UNKNOWN_PARKING_TYPE NEARBY ONLY_GUESTS RESERVATION_NEEDED
</pre>


130 — The guest will be charged 30% of the total price if they cancel after reservation and a further 20% of the total price if they cancel in the 42 days before arrival.
This will configure a Car Park where:<br>
:&nbsp;• parking costs 16.99 per day<br>
:&nbsp;• the name is "THIS CAR PARK2b"<br>
:&nbsp;• indoor/outdoor type is not specified<br>
:&nbsp;• it is located NEARBY<br>
:&nbsp;• a reservation is required<br>


131 — The guest will be charged 30% of the total price if they cancel after reservation and a further 40% of the total price if they cancel in the 42 days before arrival.
<span style="color:#555;">{{#fas:info-circle}}</span>
By default, Beds24 applies predefined parking attribute values when a parking facility is added via the Features box. 
You can change these defaults by adding specific parking attributes in the "Custom" in  (SETTINGS) CHANNEL MANAGER > BOOKING.COM > SPECIFIC PROPERTY CONTENT.


132 — The guest will be charged 50% of the total price if they cancel after reservation and a further 20% of the total price if they cancel in the 42 days before arrival.
''' Parking Default Values '''


133 — The guest will be charged 70% of the total price if they cancel after reservation and the total price if they cancel in the 42 days before arrival.
{| class="wikitable" style="width:100%; font-size:90%; white-space:normal;"


134 — The guest will be charged 30% of the total price if they cancel after reservation and a further 20% of the total price if they cancel in the 60 days before arrival.
! Parking Type
! Parking Type / Kind
! Location
! Access
! Reservation
|-
| PARKING_POSSIBLE
| STREET_PARKING
| NEARBY
| GENERAL_PUBLIC
| RESERVATION_NOT_POSSIBLE
|-
| PARKING_POSSIBLE
| PARKING_LOT
| NEARBY
| GENERAL_PUBLIC
| RESERVATION_NOT_POSSIBLE
|-
| PARKING_POSSIBLE
| PARKING_GARAGE
| ON_SITE
| ONLY_GUESTS
| RESERVATION_NEEDED
|-
| PARKING_PAID
| —
| NEARBY
| ONLY_GUESTS
| RESERVATION_NEEDED
|-
| PARKING_INCLUDED
| —
| ON_SITE
| ONLY_GUESTS
| RESERVATION_NOT_NEEDED
|}


135 — The guest will be charged 30% of the total price if they cancel after reservation and a further 40% of the total price if they cancel in the 60 days before arrival.


136 — The guest will be charged 30% of the total price if they cancel after reservation and the total price if they cancel in the 60 days before arrival.
PARKING_INDOOR


137 — The guest will be charged 50% of the total price if they cancel after reservation and a further 20% of the total price if they cancel in the 60 days before arrival.
PARKING_VALET


138 — The guest will be charged 50% of the total price if they cancel after reservation and the total price if they cancel in the 60 days before arrival.
PARKING_DISABLED


139 — The guest will be charged 70% of the total price if they cancel after reservation and the total price if they cancel in the 60 days before arrival.
<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}}  </span>  If there is a fee for parking you need to add the fee in "Custom" in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > BOOKING.COM > SPECIFIC ROOM CONTENT.
Use the context help<span style="color:#019cde;“ >{{#far:question-circle}}  </span> for information

Latest revision as of 12:09, 24 April 2026

Custom values can be set at Property and Room level for Booking.com

Custom values can be defined to specify specific values for this channel only. This will override the values you have set generally. Add the parameters one per line. Available parameters are:

1. Permit

PERMIT

Example:

PERMIT AB01244

This will send AB01244 as permit ID for this room to this channel instead of the one defined per property.


2. Starrating

STARRATING

Example:

STARRATING 3

In this example a 3 star rating will be sent.


3. Meals

3.1 Types of breakfast available

BREAKFASTTYPES

CO = Continental IT = Italian EN =/Full english VE = Vegetarian VG = Vegan HA = Halal GF = Gluten free KO = Kosher AS = Asian

Example:

BREAKFASTTYPES CONTINENTAL ASIAN

In this example Booking.com will show that you offer Continental and Asian breakfast.


3.2. Meal prices

BREAKFASTFEE

LUNCHFEE

DINNERFEE

Example:

BREAKFAST 10

In this example guests will be able to book breakfast for the price of 10 at Booking.com.


4. Taxes and fees - Values can be set for Property or Room.

Taxes and fees can apply per stay, per day, per person and night or as a percentage.

Examples:

CITYTAX - citytax applies per stay

CITYTAXDAILY - citytax applies per day

CITYTAXPERSONNIGHT - citytax applies per person and night.

CITYTAXPERCENT - a percentage is added for citytax.

VATRATEPERCENT - will send the vat rate for your property.


AIRCONDITIONINGFEE

AIRPORTSHUTTLEFEE

CLEANINGFEE

ELECTRICITYFEE

GASFEE

GOODSANDSERVICESTAX

GOVERNMENTTAX

HEATINGFEE

INTERNETFEE

LINENFEE

LOCALCOUNCILTAX

MUNICIPALITYFEE

OILFEE

RESIDENTIALTAX

PARKINGFEE

PARKINGFEEDAILY

PARKINGFEEHOURLY

PETFEE

RESORTFEE

SERVICEFEE

TOURISMFEE

TOWELFEE

TRANSFERFEE

WATERUSAGEFEE

WOODFEE


Examples:


RESORTFEEPERCENT 5

In this example 5% will be added as resortfee.


LINENFEEDAILY 10

In this example a fee of 10 per day will apply for linen.


LINENFEEPERSON 10

In this example a fee of 10 per person will for the whole stay will apply for linen.


LINENFEEPERSONNIGHT 10

In this example a fee of 10 per person and night will apply for linen.


PARKINGFEEHOURLY 5

In this example the fee for parking is 5 per hour.

PETFEE 10

In this example we will send that a fee applies for pets. Booking.com will not display the amount though.


4.1 Future Charges

The Booking.com Charges API allows setting date-based fees/taxes using FROM and TO.

Format: 

FEENAME=amount FROM=YYYY-MM-DD TO=YYYY-MM-DD

Example: 

AIRPORTSHUTTLEFEE=12 FROM=2026-03-09 TO=2026-05-31

The fee applies only within the defined date range. Outside this period, the previous value applies.

Notes:

  • FROM is optional (defaults to today)
  • TO is optional (applies indefinitely if not set)
  • Both formats are supported:
FEENAME 10
FEENAME=10

Unsetting a charge: 

FEENAME=0 FROM=YYYY-MM-DD

Rules:

  • Charges cannot overlap
  • Avoid using past dates (may cause unexpected results)
  • On import, FROM is only set if it is in the future

Booking.com UI behavior:

Updating charges may create duplicate entries instead of replacing existing ones.

Recommended flow: 1. Remove existing charges 2. Sync 3. Add new values 4. Sync again


5. Security deposit

The security deposit is constructed of several elements starting with SECURITYDEPOSIT followed by the rules which apply.

SECURITYDEPOSIT

Payment by:

CASH

CARD

BANK

PAYPAL

Due at

CHECKIN

CHECKIN-7

CHECKIN-14

CHECKOUT

CHECKOUT+7

CHECKOUT+14

Returned to the guest by

RETURNCASH

RETURNCARD

RETURNBANK

RETURNPAYPAL

Example:

SECURITYDEPOSIT 100 CARD CHECKIN-7 CHECKOUT+7 RETURNPAYPAL

Guests needs to pay a security deposit of 100 seven days before check-in by credit card. The deposit is returned 7 days after check-out via Paypal.

SECURITYDEPOSIT 0 will remove the Security deposit from Booking.com.


6. Legal

LEGALHASVAT 1 (France only, you are registered/not registered for VAT for this activity 0 = No, 1 = Yes)

LEGALREGISTERED 1 (France only registered/not registered in the Trade and Companies Register as a professional 0 = No, 1 = Yes)

LEGALDECLARESREVENUE 1 (France only you declare/not declaree professional income for direct tax purposes (see Article 155 IV of the CGI) 0 = No, 1 = Yes)

LEGALTAXCATEGORY 11 (France only city tax category. If your answer to any of the above is (yes) you do NOT need this - 11=Palaces, 12=Hôtels de tourisme 5 étoiles, résidences de tourisme 5 étoiles, meublés de tourisme 5 étoiles, 13=Hôtels de tourisme 4 étoiles, résidences de tourisme 4 étoiles, meublés de tourisme 4 étoiles, 14=Hôtels de tourisme 3 étoiles, résidences de tourisme 3 étoiles, meublés de tourisme 3 étoiles, 15=Hôtels de tourisme 2 étoiles, résidences de tourisme 2 étoiles, meublés de tourisme 2 étoiles, villages de vacances 4 et 5 étoiles, 16=Hôtels de tourisme 1 étoile, résidences de tourisme 1 étoile, meublés de tourisme 1 étoile, villages de vacances 1,2 et 3 étoiles, chambres d'hôtes, emplacements dans des aires de camping-cars et des parcs de stationnement touristiques par tranche de 24 heures, 17=Terrains de camping et terrains de caravanage classés en 3,4 et 5 étoiles, 18=Terrains de camping et terrains de caravanage classés en 1 et 2 étoiles, ports de plaisance, 19=Hébergements en attente de classement ou sans classement)

7. Addiontional policies and House Rules

AREA_BUSY

AREA_PEDESTRIANZONE

AREA_RESIDENTIAL

DEPARTUREEARLYFEE

FUNCTIONS_ONSITE

GUESTIDENTIFICATION

HALFBOARD_NODRINKS

INFORMARRIVALTIME

INVOICE_REQUIRED

HENSTAGPARTY_NO

LINENFEE 50

LONGSTAY_DISCLAIMER

PARKING_LIMITED

PAYMENT_ADVANCE

POLICY_UNDER18

PUBLICTRANSPORT_NO

QUIETHOURSTART 13

QUIETHOUREND 14

Start and end date for quiet hours. In this example a quite hour from 13:00 to 14:00 applies.

Allowed values are 1-23.

RENOVATION

RENTALAGREEMENT

ROAD_UNPAVED

TATOORESTRICTION

TAX_EXTRA

WATERCRISIS


8. Parking

PARKING_INCLUDED

PARKING_POSSIBLE

PARKING_PAID


PARKING INCLUDED, PARKING POSSIBLE and PARKING PAID can include attributes. Add the attributes' values as a single line in "Custom" in (SETTINGS) > CHANNEL MANAGER > BOOKING.COM > SPECIFIC PROPERTY CONTENT. Use the context help for information.

Parking Attributes:

TYPE:

 • UNKNOWN_PARKING_TYPE
 • PARKING_GARAGE
 • PARKING_LOT
 • STREET_PARKING

LOCATION:

 • ON_SITE
 • NEARBY

ACCESS:

 • ONLY_GUESTS
 • GENERAL_PUBLIC

RESERVATION:

 • RESERVATION_NEEDED
 • RESERVATION_NOT_NEEDED
 • RESERVATION_NOT_POSSIBLE

NAME:

 • NAME=Your_text

FEE:

 • PARKINGFEE=xx.xx
 • PARKINGFEEHOURLY=xx.xx
 • PARKINGFEEDAILY=xx.xx

Example: 

PARKING_INCLUDED NAME=Parking_1 NEARBY ONLY_GUESTS RESERVATION_NEEDED

Example: 

PARKING_PAID PARKINGFEEDAILY=16.99 NAME=THIS_CAR_PARK2b UNKNOWN_PARKING_TYPE NEARBY ONLY_GUESTS RESERVATION_NEEDED

This will configure a Car Park where:

 • parking costs 16.99 per day
 • the name is "THIS CAR PARK2b"
 • indoor/outdoor type is not specified
 • it is located NEARBY
 • a reservation is required

By default, Beds24 applies predefined parking attribute values when a parking facility is added via the Features box. You can change these defaults by adding specific parking attributes in the "Custom" in (SETTINGS) CHANNEL MANAGER > BOOKING.COM > SPECIFIC PROPERTY CONTENT.

Parking Default Values

Parking Type Parking Type / Kind Location Access Reservation
PARKING_POSSIBLE STREET_PARKING NEARBY GENERAL_PUBLIC RESERVATION_NOT_POSSIBLE
PARKING_POSSIBLE PARKING_LOT NEARBY GENERAL_PUBLIC RESERVATION_NOT_POSSIBLE
PARKING_POSSIBLE PARKING_GARAGE ON_SITE ONLY_GUESTS RESERVATION_NEEDED
PARKING_PAID — NEARBY ONLY_GUESTS RESERVATION_NEEDED
PARKING_INCLUDED — ON_SITE ONLY_GUESTS RESERVATION_NOT_NEEDED


PARKING_INDOOR

PARKING_VALET

PARKING_DISABLED

If there is a fee for parking you need to add the fee in "Custom" in (SETTINGS) CHANNEL MANAGER > BOOKING.COM > SPECIFIC ROOM CONTENT. Use the context help for information

Retrieved from "https://wiki.beds24.com/index.php?title=Setting/custom_booking&oldid=27973"