Arrivals API: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
No edit summary |
||
| Line 10: | Line 10: | ||
For Beds24 the normal channel manager fees apply. | For Beds24 the normal channel manager fees apply. | ||
= Capabilities = | |||
The Arrivals integration allows external services to access data about your upcoming arrivals. | The Arrivals integration allows external services to access data about your upcoming arrivals. | ||
Typical services which can use this data are door lock systems, concierge systems and systems which require access to guest data before or during their stay. | Typical services which can use this data are door lock systems, concierge systems and systems which require access to guest data before or during their stay. | ||
| Line 18: | Line 18: | ||
The integration partner can send info codes back to Beds24 to be stored with individual bookings. | The integration partner can send info codes back to Beds24 to be stored with individual bookings. | ||
= Set Up = | |||
== Beds24 == | |||
*Copy the "Access Key" | *Copy the "Access Key" | ||
*Set how many days before check-in the bookings should be sent. 0 will only send bookings with check-in today only. 1 will send bookings with check-in today and tomorrow. | *Set how many days before check-in the bookings should be sent. 0 will only send bookings with check-in today only. 1 will send bookings with check-in today and tomorrow. | ||
| Line 26: | Line 26: | ||
*Tick "Enable". | *Tick "Enable". | ||
== Integration partner == | |||
*Forward the "Access key" of each property you wish to connect to the integration partner | *Forward the "Access key" of each property you wish to connect to the integration partner | ||
| Line 32: | Line 32: | ||
== Common Problems == | == Common Problems == | ||
= Disconnect= | |||
Untick "Enable" to disconnect the room and stop sending it's bookings. | Untick "Enable" to disconnect the room and stop sending it's bookings. | ||
=== | = Developers = | ||
This API will allow you to read upcoming bookings for a property and to write or modify Booking Info Items in those bookings. | |||
For example, a door access system could read details of upcoming bookings and store a door unlock code in each booking so the code can be communicated to the guest. | |||
== API setup == | |||
Contact Beds24 for a merchant Key for the Arrivals API | |||
Each property can generate an access Key at the menu {{#fas:cog}} (SETTINGS) Apps & Integrations > Arrivals "Access Key' | |||
With the merchant key and the access key the following functions can be called on the property. | |||
Only data from room types that have their synchronise tick box enabled will be included. | |||
== Get Bookings == | |||
https://api.beds24.com/arrivals/getBookings | |||
This function will return all upcoming arrivals in the property as a JSON array. | |||
The number of days in advance of check-in date that bookings are available is set at the menu {{#fas:cog}} (SETTINGS) Apps & Integrations > Arrivals "Days in Advance''' | |||
Personal information like name, email etc. can be included in the data at the menu {{#fas:cog}} (SETTINGS) Apps & Integrations > Arrivals "Allow Personal Info''' | |||
This function is suitable to call once per hour per property. | |||
== Set Booking == | |||
https://api.beds24.com/arrivals/setBooking | |||
This function can write Booking Info Items into a booking. | |||
If the booking info item already exists it will be modified. | |||
Booking Info Items can be used for reporting and for triggering auto actions to perform further operations like sending email. | |||
The room note and status can be set on the room containing the booking | |||
== Commercial == | |||
We can list your integration and product at https://shop.beds24.com | |||
Contact us for details. | |||