Setting/custom booking: Difference between revisions

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