[Overview]
This section provides instructions on how to create a channel through [Admin Console] → [Channels] → [Add Channel] button. It also outlines the specifications and important points regarding synchronization.
[Details]
Requesting Integration with Rakuten Oyado (formerly known as Rakuten Vacation Stay)
To integrate AirHost with "Rakuten Oyado / formerly Rakuten Vacation Stay", you must submit the "AirHost × Rakuten Oyado Integration Request Form" to Vacation STAY.
AirHost × Vacation STAY Integration Request Form:
After submission, you will receive a "Cooperation Account" from Vacation STAY. Use this account to proceed with adding the channel in AirHost PMS.
Channel Creation Procedure
Add each Rakuten Oyado account as a separate channel in AirHost. If a property has already been added to an existing account in AirHost, there is no need to create a new channel. Instead, perform "Channel Refresh for Property Import".
For the channel creation procedure, please refer to this video:
■ AirHost Connection Information
When you submit the AirHost × Rakuten Oyado linking request form, you will receive a PDF containing the following "AirHost Connection Information." Enter the ID and password marked in yellow.
Please fill in the username (ID) and password (PW) in the channel details below.
※ This password is specifically for the API and is different from your Rakuten Oyado login credentials. Please do not change it.
Importing Properties via Channel Refresh
When a new property is added to your Rakuten Oyado account, you can import the property by refreshing the channel.
Please refer to the following video tutorial for the steps:
After a few minutes, refresh the list to confirm that the property has been added.
Importing Confirmed Reservations Before AirHost Connection
When linking with AirHost, confirmed future reservations made within the past 7 months from the connection date will be imported.
(Only future reservations are imported; past reservations are not included.)
If there are future reservations created more than 7 months before the connection date, they will not be imported.
In such cases, please manually create and manage them as new reservations.
About Message Synchronization
Messages are sent using a virtual address provided by Oyado (e.g., @guest.vacation-stay.jp). Oyado then forwards these messages to the guest.
Due to this system:
The guest's actual email address cannot be retrieved.
Guest replies are also routed through Oyado and delivered in email format to the facility's registered email address.
Additionally, due to Oyado's API specifications, guest replies to automated messages will not be reflected in AirHost.
OTA Commission Fees
Currently, the reservation information provided by the Rakuten Oyado API does not include information about OTA commission fees. As a result, the OTA commission fee amount will always be displayed as 0. We will address this issue once the Rakuten Oyado API is updated.
In the meantime, please add an "adjustment amount" such as "OTA commission fee" under the "Hotel Product" section. You can then manually adjust the negative fee for each reservation.
Booking Availability Period
In the case of Rakuten Oyado, the AirHost calendar open takes priority. When the calendar is updated on the 25th of each month, it is already opened by AirHost.
Therefore, Rakuten Oyado has informed us that it will result in a no-action behavior (i.e., no further changes or openings).
Since the calendar is already open by AirHost, if a reservation is made on another linked OTA, that period will be blocked by AirHost.
Maximum Occupancy Settings
The maximum occupancy for Rakuten Oyado is set at 15 guests. Therefore, when integrating with Rakuten Oyado, the number of guests (i.e., maximum occupancy) set on each listing's room detail page and the number of guests for whom the base rate applies in each pricing plan must be set to 15 or fewer.
Property Registration on Rakuten Oyado
Only one property should be registered on Rakuten Oyado. If multiple rooms (including unpublished or rejected rooms) are set for a single property, there may be issues with inventory synchronization. Please delete any unpublished or rejected rooms to avoid these issues.
Rakuten Oyado Manual
Please refer to the manual for various setup instructions and iCal integration.
iCal (iCalendar) Integration:
Click here for more information
Example from the Manual:
AirHost PMS integration and iCal integration cannot be used simultaneously.
If you start integrating with AirHost PMS while still using iCal integration on Rakuten LIFULL/Rakuten Oyado, inventory discrepancies may occur. Please make sure to disable iCal integration before starting the integration with AirHost PMS.