Difference between revisions of "Arrivals API"

From Beds24 Wiki
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...")
 
(8 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
[[Category:Apps]]
 
[[Category:Apps]]
  ''This page is about the menu SETTINGS->APPS & INTEGRATIONS->ARRIVALS
+
[[Category:API]]
 +
[[Category:Automation]]
 +
 
 +
<div class="heading">Arrivals API</div>
 +
  This page is about the menu {{#fas:cog}} (SETTINGS) APPS & INTEGRATIONS > ARRIVALS
  
 
This page explains how to connect to a system which has set up a connection to Beds24 via the [https://wiki.beds24.com/index.php/Connect_Access_System_with_API Beds24 Arrivals API].  
 
This page explains how to connect to a system which has set up a connection to Beds24 via the [https://wiki.beds24.com/index.php/Connect_Access_System_with_API Beds24 Arrivals API].  
  
For Beds24 the normal channel manger fees apply.
+
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.
  
== Capabilities ==
 
 
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 ==
+
= Set Up =
  
=== Beds24 ===
+
== 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 "Bookings".
+
*Tick "Enable".
  
=== Integration partner ===
+
== Integration partner ==
*Forward the "Access key" to the integration partner
+
*Forward the "Access key" of each property you wish to connect to the integration partner
  
 
For further instructions contact the integration partners support.  
 
For further instructions contact the integration partners support.  
 
== Common Problems ==
 
== Common Problems ==
  
== Disconnect==
+
= Disconnect=
Untick "Bookings" to stop sending 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.

Revision as of 09:03, 24 September 2021


Arrivals API
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 via the Beds24 Arrivals API.

For Beds24 the normal channel manager fees apply.

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

The integration partner can send info codes back to Beds24 to be stored with individual bookings.

2 Set Up

2.1 Beds24

  • 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 if you want to include personal data in in the data transfer.
  • Tick "Enable".

2.2 Integration partner

  • Forward the "Access key" of each property you wish to connect to the integration partner

For further instructions contact the integration partners support.

2.3 Common Problems

3 Disconnect

Untick "Enable" to disconnect the room and stop sending it's bookings.

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

4.1 API setup

Contact Beds24 for a merchant Key for the Arrivals API

Each property can generate an access Key at the menu (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.

4.2 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 (SETTINGS) Apps & Integrations > Arrivals "Days in Advance

Personal information like name, email etc. can be included in the data at the menu (SETTINGS) Apps & Integrations > Arrivals "Allow Personal Info

This function is suitable to call once per hour per property.

4.3 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

4.4 Commercial

We can list your integration and product at https://shop.beds24.com

Contact us for details.