Arrivals API: Difference between revisions
Jump to navigation
Jump to search
Created page with "Category:Apps ''This page is about the menu SETTINGS->APPS & INTEGRATIONS->ARRIVALS This page explains how to connect to a system which has set up a connection to Beds24..." |
No edit summary |
||
| (12 intermediate revisions by 4 users not shown) | |||
| Line 1: | Line 1: | ||
[[Category: | [[Category:Marketplace]] | ||
[[Category:API]] | |||
[[Category:Automation]] | |||
This page | <div class="heading">Arrivals API</div> | ||
This page is about the menu {{#fas:cog}} (SETTINGS) MARKETPLACE > ARRIVALS | |||
For Beds24 the normal channel | This page explains how to connect to a system which has set up a connection to Beds24 via the Beds24 Arrivals API. | ||
For Beds24 the normal channel manager fees apply. | |||
= Capabilities = | |||
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. | |||
Beds24 will send booking data to the integration partner. | Beds24 will send booking data to the integration partner. | ||
The integration partner can send info codes back to Beds24. | 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. | ||
*Set if you want to include personal data in in the data transfer. | *Set if you want to include personal data in in the data transfer. | ||
*Tick " | *Tick "Enable". | ||
== Integration partner == | |||
*Forward the "Access key" of each property you wish to connect to the integration partner. They will be able to use the key to access the property. | |||
For further instructions contact the integration partners support. | |||
== Common Problems == | == Common Problems == | ||
= Disconnect= | |||
Untick " | 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) MARKETPLACE > 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) MARKETPLACE > Arrivals "Days in Advance''' | |||
Personal information like name, email etc. can be included in the data at the menu {{#fas:cog}} (SETTINGS) MARKETPLACE > 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. | |||