Connect PMS with API: Difference between revisions

Jump to navigation Jump to search
No edit summary
No edit summary
Line 1: Line 1:
[[Category:API]]
[[Category:API]]


<div class="heading">API: Connect PMS</div>
<div class="heading">API: Connect PMS or OTA</div>
  This page explains how to connect a PMS to the Beds24 API for Channel Management
  This page explains how to connect a PMS to the Beds24 API for Channel Management
__Toc__
__Toc__
Line 17: Line 17:


== API setup ==
== API setup ==
Create an API Key for your Beds24 account at Settings  >  Account  > Account Access  
Create an API Key for your Beds24 account at Settings  >  Account  > Account Access  


Line 27: Line 26:


The JSON API functions are recommended https://api.beds24.com
The JSON API functions are recommended https://api.beds24.com


== Create Properties ==
== Create Properties ==
Use JSON createProperties to create properties and their rooms via API.
Use JSON createProperties to create properties and their rooms via API.


Line 38: Line 35:


Descriptive content can optionally be added to a property and it's rooms with JSON setPropertyContent
Descriptive content can optionally be added to a property and it's rooms with JSON setPropertyContent


== Setup Price and Channel Mapping ==
== Setup Price and Channel Mapping ==
Prices are defined in up to 16 daily price rows per room type.
Prices are defined in up to 16 daily price rows per room type.


Line 49: Line 44:


Use JSON setDailyPriceSetup to create the daily price rows and map them to channels, including any rate codes.
Use JSON setDailyPriceSetup to create the daily price rows and map them to channels, including any rate codes.


== Send Price and Availability ==
== Send Price and Availability ==
Price and availability can be set per room type with JSON setRoomDates
Price and availability can be set per room type with JSON setRoomDates


For each date, up to 16 prices, the number of rooms available, minimum stay (room level), maximum stay (room level) and check-in check-out restrictions can be sent.
For each date, up to 16 prices, the number of rooms available, minimum stay (room level), maximum stay (room level) and check-in check-out restrictions can be sent.


== Bookings ==
== Bookings ==
There is no need to send bookings to Beds24, it is better to manage inventory by setting number of rooms available with JSON setRoomDates
There is no need to send bookings to Beds24, it is better to manage inventory by setting number of rooms available with JSON setRoomDates


Line 67: Line 58:


Make sure to adjust your inventory levels to account for the channel booking in Beds24.
Make sure to adjust your inventory levels to account for the channel booking in Beds24.


== Booking Notification ==
== Booking Notification ==
When a booking is created, modified or cancelled by a channel, we will send a notification push to a URL specified by you.
When a booking is created, modified or cancelled by a channel, we will send a notification push to a URL specified by you.


Line 79: Line 68:


== Booking Detail ==
== Booking Detail ==
Booking can be read with JSON getBookings by specifying the booking number from the notify push.
Booking can be read with JSON getBookings by specifying the booking number from the notify push.


Line 88: Line 76:


== Booking Modification ==
== Booking Modification ==
If a booking is modified by a channel, you will receive a notify push and you can read the new booking detail.
If a booking is modified by a channel, you will receive a notify push and you can read the new booking detail.


It is up to your system to compare the new booking detail with the original and determine what actually changed.
It is up to your system to compare the new booking detail with the original and determine what actually changed.


 
==Content==
== Questionnaire ==
The JSON functions getPropertyContenyt and setPropertyContent allow you to pull/push content.
 
So we can best support you and if desired promote your system, please send us the answer to these questions.
 
1) What is your Beds24 account number?
 
2) What is the name of your system?
 
3) Main contact person at your system for technical issues?
 
4) Number of properties you intend to connect?
 
5) Names of the API functions you are using and estimated number of unique calls per hour?
 
6) Do you want to be listed as a Beds24 partner and promoted by us?
 
7) Unique function or selling point to promote your system?