Setting/custom booking: Difference between revisions

From Beds24 Wiki
Jump to navigation Jump to search
No edit summary
Lesley (talk | contribs)
No edit summary
 
(41 intermediate revisions by 4 users not shown)
Line 1: Line 1:
'''Meals'''
Custom values can be set at Property and Room level for Booking.com


If you offer meals you can set these in SETTINGS-CHANNEL MANAGER-BOOKING.COM-SPECIFIC PROPERTY CONTENT in "Custom".  
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. Types of breakfast available'''
'''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
BREAKFASTTYPES
Line 25: Line 50:




'''2. Meal prices'''
'''3.2. Meal prices'''


BREAKFASTFEE
BREAKFASTFEE
Line 37: Line 62:
BREAKFAST 10
BREAKFAST 10


In this example guests will be able to book breaffast for the price of 10 at Booking.com.
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


'''3. Pet fee'''
TRANSFERFEE


Example:  
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
PETFEE 10


In this example a fee of 10 will apply for pets.
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'''
 
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 {{#fas:cog}} (SETTINGS) > CHANNEL MANAGER > BOOKING.COM > SPECIFIC PROPERTY CONTENT. 
Use the context help {{#fas:question-circle}} for information.
 
'''Parking Attributes:'''
 
TYPE:<br>
:&nbsp;• UNKNOWN_PARKING_TYPE<br>
:&nbsp;• PARKING_GARAGE<br>
:&nbsp;• PARKING_LOT<br>
:&nbsp;• STREET_PARKING<br>
 
LOCATION:<br>
:&nbsp;• ON_SITE<br>
:&nbsp;• NEARBY<br>
 
ACCESS:<br>
:&nbsp;• ONLY_GUESTS<br>
:&nbsp;• GENERAL_PUBLIC<br>
 
RESERVATION:<br>
:&nbsp;• RESERVATION_NEEDED<br>
:&nbsp;• RESERVATION_NOT_NEEDED<br>
:&nbsp;• RESERVATION_NOT_POSSIBLE<br>
 
NAME:<br>
:&nbsp;• NAME=Your_text<br>
 
FEE:<br>
:&nbsp;• PARKINGFEE=xx.xx<br>
:&nbsp;• PARKINGFEEHOURLY=xx.xx<br>
:&nbsp;• PARKINGFEEDAILY=xx.xx<br>
 
'''Example:'''
<pre>
PARKING_INCLUDED NAME=Parking_1 NEARBY ONLY_GUESTS RESERVATION_NEEDED
</pre>
 
'''Example:'''
<pre>
PARKING_PAID PARKINGFEEDAILY=16.99 NAME=THIS_CAR_PARK2b UNKNOWN_PARKING_TYPE NEARBY ONLY_GUESTS RESERVATION_NEEDED
</pre>
 
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>
 
<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.
 
''' Parking Default Values '''
 
{| class="wikitable" style="width:100%; font-size:90%; white-space:normal;"
 
! 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
 
<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