Setting/customroom booking: Difference between revisions

From Beds24 Wiki
Jump to navigation Jump to search
Lesley (talk | contribs)
No edit summary
Ella (talk | contribs)
No edit summary
 
(2 intermediate revisions by one other user not shown)
Line 10: Line 10:




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


Additional bathroom features you can add these manually: Go to {{#fas:cog}} (SETTINGS)  CHANNEL MANAGER > BOOKING.COM > CONTENT > SPECIFIC ROOM CONTENT
Examples:
and paste the value into the Custom field.


PRIVATE_BATHROOM
CITYTAX -  citytax applies per stay


SHARED_BATHROOM
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:'''
<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 
 
'''Bathroom Attributes:'''
 
If you want to send additional bathroom features you can add these manually: Copy from the list below and go to {{#fas:cog}} (SETTINGS)  PROPERTIES > ROOMS > SETUP
and paste the value into the Features box.


Bathroom can include attributes.   
Bathroom can include attributes.   
Line 23: Line 165:
Use the context help {{#fas:question-circle}} for information.
Use the context help {{#fas:question-circle}} for information.


'''Bathroom Attributes:'''


TYPE:<br>
TYPE:<br>
Line 45: Line 186:
'''Example:'''
'''Example:'''
<pre>
<pre>
BATHROOM TYPE_PRIVATE LOCATION_ENSUITE GENDER_MIXED
Apartment/Hotels
BATHROOM BATH_SHOWER BATH_TOILET BATH_TUB BATH_BIDET TYPE_PRIVATE LOCATION_ENSUITE
 
Hostels
BATHROOM BATH_SHOWER BATH_TOILET BATH_TUB BATH_BIDET TYPE_SHARED LOCATION_DOWN_THE_HALL
</pre>
</pre>


'''Validation (Booking.com):'''
'''Validation (Booking.com):'''

Latest revision as of 11:17, 20 March 2026

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:

PERMIT

Example:

PERMIT AB01244

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


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

Bathroom Attributes:

If you want to send additional bathroom features you can add these manually: Copy from the list below and go to (SETTINGS) PROPERTIES > ROOMS > SETUP and paste the value into the Features box.

Bathroom can include attributes. Add the attributes' values as a single line in "Custom" in (SETTINGS) > CHANNEL MANAGER > BOOKING.COM > SPECIFIC ROOM CONTENT. Use the context help for information.


TYPE:

 • TYPE_PRIVATE
 • TYPE_SHARED

LOCATION:

 • LOCATION_ENSUITE
 • LOCATION_NEXT_DOOR
 • LOCATION_DOWN_THE_HALL
 • LOCATION_IN_THE_HALLWAY
 • LOCATION_OPPOSITE_THE_ROOM
 • LOCATION_OTHER
 • LOCATION_INSIDE_THE_UNIT

GENDER (hostels):

 • GENDER_MIXED
 • GENDER_MALE
 • GENDER_FEMALE

Example:

Apartment/Hotels
 BATHROOM BATH_SHOWER BATH_TOILET BATH_TUB BATH_BIDET TYPE_PRIVATE LOCATION_ENSUITE

Hostels 
 BATHROOM BATH_SHOWER BATH_TOILET BATH_TUB BATH_BIDET TYPE_SHARED LOCATION_DOWN_THE_HALL


Validation (Booking.com):

  • Hotels: bathrooms count 0–20
  • Homes: bathrooms count 0–20; location optional (allowed values depend on unit_type)
  • Hostels:
    • 0–1 private, 0–5 shared
    • Shared bathrooms require GENDER
    • Must include at least one of SHOWER, TOILET, SINK, BATH
    • Valid locations: ENSUITE | NEXT_DOOR | DOWN_THE_HALL | OPPOSITE_THE_ROOM | IN_THE_HALLWAY | OTHER

For Homes & Hostels, multiple bathrooms can be specified: one bathroom per line.