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
 
(17 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 81: Line 79:
CITYTAXPERCENT - a percentage is added for citytax.
CITYTAXPERCENT - a percentage is added for citytax.


 
VATRATEPERCENT - will send the vat rate for your property.  
Fees for parking can also apply per hour.




Line 90: Line 87:


CLEANINGFEE
CLEANINGFEE


ELECTRICITYFEE
ELECTRICITYFEE
Line 115: Line 111:


PARKINGFEE
PARKINGFEE
PARKINGFEEDAILY
PARKINGFEEHOURLY


PETFEE
PETFEE
Line 151: Line 151:




LINENFEEPERSOONNIGHT 10
LINENFEEPERSONNIGHT 10


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




'''5. Legal'''


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


LEGALREGISTERED 1  (France only registered/not registered  in the Trade and Companies Register as a professional 0 = No, 1 = Yes)
The Booking.com Charges API allows setting date-based fees/taxes using '''FROM''' and '''TO'''.


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)
'''Format:'''
<pre>
FEENAME=amount FROM=YYYY-MM-DD TO=YYYY-MM-DD
</pre>


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)
'''Example:'''
<pre>
AIRPORTSHUTTLEFEE=12 FROM=2026-03-09 TO=2026-05-31
</pre>


'''6. Policies and House Rules'''
The fee applies only within the defined date range. Outside this period, the previous value applies.


QUIETHOURSTART 13
'''Notes:'''


QUIETHOUREND 14
* '''FROM''' is optional (defaults to today) 
* '''TO''' is optional (applies indefinitely if not set) 
* Both formats are supported:
<pre>
FEENAME 10
FEENAME=10
</pre>


Start and end date for quiet hours. In this example a quite hour from 13:00 to 14:00 applies.
'''Unsetting a charge:'''
<pre>
FEENAME=0 FROM=YYYY-MM-DD
</pre>


Allowed values are 1-23.
'''Rules:'''


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


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.
'''Booking.com UI behavior:'''


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


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


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'''
'''5. Security deposit'''


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.
The security deposit is constructed of several elements starting with SECURITYDEPOSIT followed by the rules which apply.


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.
SECURITYDEPOSIT


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.
Payment by:


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.
CASH


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.
CARD


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.
BANK


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.
PAYPAL


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.
Due at


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.
CHECKIN


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.
CHECKIN-7


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.
CHECKIN-14


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.
CHECKOUT


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.
CHECKOUT+7


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.
CHECKOUT+14


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.
Returned to the guest by


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.
RETURNCASH


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.
RETURNCARD


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.
RETURNBANK


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.
RETURNPAYPAL


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.
Example:


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.
SECURITYDEPOSIT 100 CARD CHECKIN-7 CHECKOUT+7 RETURNPAYPAL


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.
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.


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.
SECURITYDEPOSIT 0 will remove the Security deposit from Booking.com.  


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.
'''6. Legal'''


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.
LEGALHASVAT 1  (France only, you are registered/not registered for VAT for this activity 0 = No, 1 = Yes)


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.
LEGALREGISTERED 1  (France only registered/not registered  in the Trade and Companies Register as a professional 0 = No, 1 = Yes)


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.
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)


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.
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)


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.
'''7. Addiontional policies and House Rules'''


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.
AREA_BUSY


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.
AREA_PEDESTRIANZONE


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.
AREA_RESIDENTIAL


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.
DEPARTUREEARLYFEE


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.
FUNCTIONS_ONSITE


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.
GUESTIDENTIFICATION


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.
HALFBOARD_NODRINKS


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.
INFORMARRIVALTIME


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.
INVOICE_REQUIRED


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.
HENSTAGPARTY_NO


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.
LINENFEE 50


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.
LONGSTAY_DISCLAIMER


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.
PARKING_LIMITED


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.
PAYMENT_ADVANCE


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.
POLICY_UNDER18


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.
PUBLICTRANSPORT_NO


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.
QUIETHOURSTART 13


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.
QUIETHOUREND 14


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.
Start and end date for quiet hours. In this example a quite hour from 13:00 to 14:00 applies.


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.
Allowed values are 1-23.  
 
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.
RENOVATION


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.
RENTALAGREEMENT


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.
ROAD_UNPAVED


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.
TATOORESTRICTION


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.
TAX_EXTRA


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.
WATERCRISIS


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.
'''8. Parking'''


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"