Skip to main content

[Channel] "Rakuten Oyado (formerly Rakuten Vacation Stay)" channel creation and synchronization specifications

J
Written by Joelly See Toh
Updated yesterday

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


Rakuten Oyado Manual

Please also check this page for information on various settings and iCal integration.

About iCal (iCalendar) integration:

AirHost PMS integration and iCal integration cannot be used together.

If you start integrating with AirHost PMS while still integrating with iCal on Rakuten LIFULL/Rakuten Oyado, there will be inconsistencies in inventory, so be sure to unlink iCal before starting integration with AirHost PMS.


Rakuten Oyado 's property registration is one property

If multiple rooms (including private or rejected rooms) are set for a property on Rakuten Oyado, inventory synchronization may not work properly. Please delete any private or rejected rooms.


Channel Creation Procedure

The Airbnb channel is added for each Rakuten Oyado account.
If a property is added to an account that has already been added to AirHost, there is no need to create a new channel. Simply perform the operation for "Importing Properties via Channel Refresh".

Please refer to the video below for the channel creation procedure:

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


Maximum occupancy setting

The maximum number of guests allowed on the Rakuten Oyado site is 15. Therefore, when linking with Rakuten Oyado, the number of guests (= maximum number of guests) set on the room details page of each listing and the number of guests that can stay at the basic rate set for each rate plan must be set to 15 or less.


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.


Causes of inventory errors and how to fix them

You may see the following inventory error message on the Rakuten Oyado channel:

{"inventories":[" must be a value greater than or equal to 0.

This is because the "Basic inventory" setting on Rakuten Oyado has not been updated after you increased the number of rooms on AirHost.

How to respond

1. Log in to the Rakuten Oyado admin page and adjust the "Basic Inventory Quantity" for the relevant room type to match the number of rooms set in AirHost.

2. After changing the settings, please manually refresh the channel from the AirHost admin panel.

If you get the error "{"not_one_room":["the room that has been approved and published has to be only one room."]}" on your Airhost,

It is possible that the publishing settings on Rakuten Oyado have not been completed.


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.


Did this answer your question?