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
 
(26 intermediate revisions by 4 users not shown)
Line 1: Line 1:
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'''
'''1. Permit'''


Line 61: 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 67: Line 71:
Examples:
Examples:


CITIYTAX -  citytax applies per stay
CITYTAX -  citytax applies per stay


CITYTAXDAILY  - citytax applies per day
CITYTAXDAILY  - citytax applies per day
Line 75: 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 84: Line 87:


CLEANINGFEE
CLEANINGFEE
CREDITCARDFEE


ELECTRICITYFEE
ELECTRICITYFEE
Line 110: Line 111:


PARKINGFEE
PARKINGFEE
PARKINGFEEDAILY
PARKINGFEEHOURLY


PETFEE
PETFEE
Line 129: Line 134:


Examples:  
Examples:  
PETFEE 10
In this example a fee of 10 per stay  will apply for pets.




Line 150: 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 159: Line 160:
In this example the fee for parking is 5 per hour.
In this example the fee for parking is 5 per hour.


PETFEE 10


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


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
'''4.1 Future Charges'''


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.  
The Booking.com Charges API allows setting date-based fees/taxes using '''FROM''' and '''TO'''.


Codes for policies are:
'''Format:'''
<pre>
FEENAME=amount FROM=YYYY-MM-DD TO=YYYY-MM-DD
</pre>


'''Free cancellation'''
'''Example:'''
<pre>
AIRPORTSHUTTLEFEE=12 FROM=2026-03-09 TO=2026-05-31
</pre>


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 fee applies only within the defined date range. Outside this period, the previous value applies.


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.
'''Notes:'''


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.
* '''FROM''' is optional (defaults to today) 
* '''TO''' is optional (applies indefinitely if not set) 
* Both formats are supported:
<pre>
FEENAME 10
FEENAME=10
</pre>


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.
'''Unsetting a charge:'''
<pre>
FEENAME=0 FROM=YYYY-MM-DD
</pre>


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.
'''Rules:'''


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.
* Charges cannot overlap 
* Avoid using past dates (may cause unexpected results) 
* On import, '''FROM''' is only set if it is in the future 


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


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.
Updating charges may create duplicate entries instead of replacing existing ones.


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.
Recommended flow:
1. Remove existing charges 
2. Sync 
3. Add new values 
4. Sync again 


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


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


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


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


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


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


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


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


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


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


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


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


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


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


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


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


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


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


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


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


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


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


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


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


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


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


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


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


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


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


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


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


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


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


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


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


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


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


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


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


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


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


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


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


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


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


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


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"