Connect PMS with API - Revision history

Annette at 10:32, 23 October 2024

2024-10-23T10:32:13Z

← Older revision		Revision as of 10:32, 23 October 2024
Line 1:		Line 1:
	[[Category:~~API~~]]		[[Category:API_V1_deprecated]]
	<div class="heading">API V1: Connect PMS or OTA</div>		<div class="heading">API V1: Connect PMS or OTA</div>
	<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> This page is about API V1 which is depreciated. We recommend using [https://wiki.beds24.com/index.php/Category:API_V2 API V2] instead.		<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> This page is about API V1 which is depreciated. We recommend using [https://wiki.beds24.com/index.php/Category:API_V2 API V2] instead.

Asher at 02:23, 22 October 2024

2024-10-22T02:23:17Z

← Older revision		Revision as of 02:23, 22 October 2024
Line 1:		Line 1:
	[[Category:API]]		[[Category:API]]
	<div class="heading">API V1: Connect PMS or OTA</div>		<div class="heading">API V1: Connect PMS or OTA</div>
	~~This page explains how to connect a PMS or OTA to Beds24 using API V1 for Channel Management~~

	<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> This page is about API V1 which is depreciated. We recommend using [https://wiki.beds24.com/index.php/Category:API_V2 API V2] instead.		<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> This page is about API V1 which is depreciated. We recommend using [https://wiki.beds24.com/index.php/Category:API_V2 API V2] instead.
			This page explains how to connect a PMS or OTA to Beds24 using API V1 for Channel Management
	__Toc__		__Toc__
	= Introduction =		= Introduction =

Asher at 02:11, 22 October 2024

2024-10-22T02:11:07Z

← Older revision		Revision as of 02:11, 22 October 2024
Line 1:		Line 1:
	[[Category:API]]		[[Category:API]]
	<div class="heading">API: Connect PMS or OTA</div>		<div class="heading">API V1: Connect PMS or OTA</div>
	This page explains how to connect a PMS or OTA to ~~the~~ Beds24 API V1 for Channel Management		This page explains how to connect a PMS or OTA to Beds24 using API V1 for Channel Management

	<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> This page is about API V1 which is depreciated. We recommend using [https://wiki.beds24.com/index.php/Category:API_V2 API V2] instead.		<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> This page is about API V1 which is depreciated. We recommend using [https://wiki.beds24.com/index.php/Category:API_V2 API V2] instead.

Asher at 02:10, 22 October 2024

2024-10-22T02:10:43Z

← Older revision		Revision as of 02:10, 22 October 2024
Line 1:		Line 1:
	[[Category:API]]		[[Category:API]]
	<div class="heading">API: Connect PMS or OTA</div>		<div class="heading">API: Connect PMS or OTA</div>
	This page explains how to connect a PMS or OTA to the Beds24 API ~~Version 1~~ for Channel Management		This page explains how to connect a PMS or OTA to the Beds24 API V1 for Channel Management

			<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> This page is about API V1 which is depreciated. We recommend using [https://wiki.beds24.com/index.php/Category:API_V2 API V2] instead.
	__Toc__		__Toc__
	= Introduction =		= Introduction =

Annette at 09:06, 9 October 2024

2024-10-09T09:06:27Z

← Older revision		Revision as of 09:06, 9 October 2024
Line 3:		Line 3:
	This page explains how to connect a PMS or OTA to the Beds24 API Version 1 for Channel Management		This page explains how to connect a PMS or OTA to the Beds24 API Version 1 for Channel Management
	__Toc__		__Toc__
	== Introduction ==		= Introduction =

	To better understand the operation of Beds24 it is good to start by setting up a test property including prices and other data you will be using manually in the Beds24 control panel.		To better understand the operation of Beds24 it is good to start by setting up a test property including prices and other data you will be using manually in the Beds24 control panel.
Line 15:		Line 15:
	See the notes at each endpoint for more information.		See the notes at each endpoint for more information.

	== 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 26:		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 35:		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 46:		Line 46:
	We recommend using only Daily Prices for this type of connection.		We recommend using only Daily Prices for this type of connection.

	== 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 60:		Line 60:
	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 67:		Line 67:
	The notify push expects an HTTP 200 response and will retry after a delay if this is not received.		The notify push expects an HTTP 200 response and will retry after a delay if this is not received.

	== 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 74:		Line 74:
	This will allow you to check for any bookings which are new or modified where the notify push was missed.		This will allow you to check for any bookings which are new or modified where the notify push was missed.

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

	==Retrieve Content==		=Retrieve Content=
	Use JSON getProperties to retrieve properties and their rooms via API.		Use JSON getProperties to retrieve properties and their rooms via API.


	== OTA channel ==		= OTA channel =
	The OTA channel can be used to connect an OTA to Beds24.		The OTA channel can be used to connect an OTA to Beds24.
	It functions like any other OTA connected to the Beds24 channel manager.		It functions like any other OTA connected to the Beds24 channel manager.

Markkinchin at 12:49, 9 July 2024

2024-07-09T12:49:39Z

← Older revision		Revision as of 12:49, 9 July 2024
Line 1:		Line 1:
	[[Category:API]]		[[Category:API]]
	<div class="heading">API: Connect PMS or OTA</div>		<div class="heading">API: Connect PMS or OTA</div>
	This page explains how to connect a PMS or OTA to the Beds24 API for Channel Management		This page explains how to connect a PMS or OTA to the Beds24 API Version 1 for Channel Management
	__Toc__		__Toc__
	== Introduction ==		== Introduction ==

Annette at 22:46, 8 January 2024

2024-01-08T22:46:54Z

← Older revision		Revision as of 22:46, 8 January 2024
Line 44:		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.

	We recommend using only ~~daily prices instead of rates~~ for this type of connection ~~and for simplicity not using both daily prices and rates~~.		We recommend using only Daily Prices for this type of connection.

	== Send Price and Availability ==		== Send Price and Availability ==

Markkinchin: /* OTA channel */

2021-11-12T08:20:33Z

OTA channel

← Older revision		Revision as of 08:20, 12 November 2021
Line 84:		Line 84:

	== OTA channel ==		== OTA channel ==
	The OTA channel functions like any other OTA connected to the Beds24 channel manager.		The OTA channel can be used to connect an OTA to Beds24.
	The OTA API functions can be used to read prices and availability assigned to the channel ~~for enabled rooms~~ and to push bookings back into the rooms.		It functions like any other OTA connected to the Beds24 channel manager.
			The OTA API functions can be used by the OTA system to read prices and availability assigned to the OTA channel from Beds24 and to push bookings back into the rooms in Beds24.

	https://wiki.beds24.com/index.php/OTA		https://wiki.beds24.com/index.php/OTA

Markkinchin: /* Setup Price and Channel Mapping */

2021-11-12T08:17:26Z

Setup Price and Channel Mapping

← Older revision		Revision as of 08:17, 12 November 2021
Line 43:		Line 43:

	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.

			We recommend using only daily prices instead of rates for this type of connection and for simplicity not using both daily prices and rates.

	== Send Price and Availability ==		== Send Price and Availability ==

Markkinchin: /* OTA channel */

2021-10-06T14:02:54Z

OTA channel

← Older revision		Revision as of 14:02, 6 October 2021
Line 84:		Line 84:
	The OTA channel functions like any other OTA connected to the Beds24 channel manager.		The OTA channel functions like any other OTA connected to the Beds24 channel manager.
	The OTA API functions can be used to read prices and availability assigned to the channel for enabled rooms and to push bookings back into the rooms.		The OTA API functions can be used to read prices and availability assigned to the channel for enabled rooms and to push bookings back into the rooms.

			https://wiki.beds24.com/index.php/OTA