[Overview]
This article explains the prerequisites, channel creation procedures, and synchronization specifications for integrating AirHost and Rakuten Oyado.
What you will learn from this article:
Required preparations on the Rakuten Oyado side
Channel creation and integration procedure
Synchronization specifications
Common errors and solutions
[Details]
Prerequisites
Before integrating Rakuten Oyado with AirHost, please complete the following preparations:
1. Submit the Integration Request Form
First, submit the integration request form below to enable the connection between AirHost and Rakuten Oyado:
After submitting the form, Rakuten Oyado will send the required channel manager integration details (“AirHost Connection Information”) via email. Please keep this information provided as it will be required during the channel creation process. Do not delete it.
 |
2. Complete Account and Property Setup on Rakuten Oyado
Please complete the following on the Rakuten Oyado side:
Account registration
Property registration
Room type setup
Rate plan setup
For detailed instructions on each setup, please refer to the official manual below: How to integrate with AirHost PMS
The following summarizes the particularly important configuration points when integrating with AirHost.
Do Not Use Auto Inventory Extension
Set [Auto Inventory Extension] in Rakuten Oyado to OFF (Do not use)
If left ON, inventory will be automatically extended each month
This may result in unintended sales for periods not configured in AirHost
.
Set Preparation Time to “None”
For properties under the Minpaku Law or Special Zone Law, set [Preparation Time] in Rakuten Oyado to “None”
If preparation time is needed, configure it on the AirHost side
If preparation time remains set on the Oyado side, synchronization may not function correctly
Disable iCal Integration
AirHost PMS integration and iCal integration cannot be used together
If iCal remains enabled on Rakuten Oyado when starting integration with AirHost, it may cause inconsistencies in availability and reservation data
Be sure to disable iCal before starting the integration
.
For non–Hotel Business Law properties, register one room per room type
If the property is registered under the Minpaku Law or Special Zone Law,
Each room type must have only one room registered
If multiple rooms (including hidden or rejected ones) are registered under the same room type, errors may occur during inventory synchronization with AirHost, and the integration may not function properly.
⚠️ This setting is mandatory for properties other than those under the Hotel Business Law.
If multiple rooms have been registered by mistake, please delete the second and subsequent rooms on the Rakuten Oyado side.
3. Check Maximum Occupancy Settings in AirHost
Rakuten Oyado limits the maximum number of guests per reservation to 15 people.
Therefore, when integrating AirHost with Rakuten Oyado, please ensure the following settings are set to 15 or fewer:
Property → Room Type → [Capacity]
[Number of Guests Included in Base Rate] in the rate plan
⚠️ If the setting exceeds 16 guests, the integration may not function correctly. Before starting the integration, please ensure that the guest capacity settings for the relevant property and rate plan are properly configured.
Channel Creation & Integration Steps
In the [ Channels ] section , click [ Add Channel ], select [Rakuten Oyado (formerly Vacation Stay: Rakuten)] , and click [ Next ].
 |
2. Enter a Name of your choice (a name that allows you to identify the Rakuten Oyado account). For [Username] and [Password], enter the “ID” and “PW” provided in the “AirHost Connection Information” sent by Rakuten Oyado during the prerequisites step, then click [Next].
|
3. The Rakuten Oyado account will be added, and after a short while, the Rakuten Oyado properties will be imported.
|
💡 If the properties are not imported after about 20–30 minutes, please perform a channel refresh.
For instructions on how to refresh a channel, please refer to the help guide below:
Reservation Import Specifications for Initial Integration
When AirHost is connected with Rakuten Oyado for the first time,
confirmed future reservations made within the past 7 months from the connection date will be automatically imported.
Reservations to Be Imported
Reservations with future check-in dates at the time of connection
Reservations confirmed within the past 7 months from the connection date
Reservations Not Imported
The following reservations will not be automatically imported:
Past reservations (before the connection date)
Future reservations confirmed more than 7 months before the connection date
How to handle ineligible reservations
If you have future reservations that are confirmed more than 7 months before the connection date,
they will not be automatically imported into AirHost.
In that case, we apologize for the inconvenience, but please create and manage it as a manual reservation .
⚠️ After the initial integration, please make sure to verify that all future reservations have been successfully imported.
Synchronization Specifications
Availability & Rates
Availability and rates set in AirHost are synchronized to Rakuten Oyado.
About Booking Availability Period
Rakuten Oyado performs a calendar update on the 25th of each month.
However, when integrated with AirHost, the AirHost “Booking Acceptance Period” takes priority.
As a result, the monthly automatic update on the Rakuten Oyado side (on the 25th) will not override dates that have already been opened for sale in AirHost.
Actual availability is managed based on the settings in AirHost.
Cleaning Fee
Cleaning fees cannot be synchronized from AirHost. Please configure them directly in Rakuten Oyado.
Reservation Changes & Cancellations
Reservation changes and cancellations made in Rakuten Oyado are automatically synchronized to AirHost. Cancellation fees are also synchronized when a reservation is canceled.
Handling of Immediately Canceled Reservations
In Rakuten Oyado, reservations that are canceled immediately after being made:
Do not send a “new reservation” notification to AirHost
Only a cancellation notification is sent
Therefore, in AirHost, these reservations are not created as confirmed bookings and are imported directly as canceled reservations.
Additionally, immediately canceled reservations are not imported in real time.
AirHost performs data synchronization from Rakuten Oyado every hour. As a result, there may be a delay of up to 1 hour before the reservation appears in AirHost.
If the reservation does not appear immediately after booking, please wait about one hour and check again.
Tentative Reservations (Temporary Inventory Holds)
During integration with Rakuten Oyado, if a guest abandons the booking process midway, a temporary reservation (inventory hold) may still be sent to AirHost.
This behavior is based on Rakuten Oyado’s API specification.
Characteristics of Tentative Reservations
They are not created as official reservations in Rakuten Oyado
They may appear in AirHost as a temporarily canceled reservation
Cancellation fees shown in reservation details may differ from the actual cancellation policy
They do not affect inventory, revenue, or compensation calculations
Even if such reservations appear in AirHost, they are not actual confirmed bookings, and no action is required from the property.
In addition, even if cancellation fee information differs, the reservation itself was never confirmed in Rakuten Oyado, so there are no operational issues.
⚠️ This is temporary data generated by system behavior. Therefore, no deletion or investigation request is required.
OTA Commission (Service Fee)
Starting from January 20, 2026, OTA commission from Rakuten Oyado is synchronized to AirHost.
About Fee Data via Rakuten Oyado API
The Rakuten Oyado API provides only guest service fees.
Host fees are not provided via the API
There are currently no plans to support host fee data via API
Therefore, the fee information automatically synchronized to AirHost includes guest service fees only, and host fees are not included.
OTA Commission Sync Eligibility
OTA commission is only synchronized for reservations with a check-in date on or after January 20, 2026.
Even if the reservation was created before January 20, 2026, it is still eligible as long as the check-in date is on or after January 20, 2026.
Reservations with a check-in date on or before January 19, 2026 will not have OTA commission synchronized.
Handling Reservations Without OTA Commission Sync
For reservations where OTA commission is not synchronized:
Please add an adjustment item such as “OTA Commission” under Hotel Items, and manually apply a negative adjustment per reservation to reflect the fee.
Messages
Messages sent from AirHost for Rakuten Oyado reservations are delivered to the virtual email address provided by Rakuten Oyado (@guest.vacation-stay.jp).
Rakuten Oyado then forwards these messages to the guest’s actual email address.
Therefore, AirHost does not have access to the guest’s real email address.
Guest Replies
When a guest replies to a message, the reply is sent via Rakuten Oyado and delivered to the property email address registered in Rakuten Oyado. These replies are not displayed in the AirHost inbox or message screen.
Even when using AirHost’s automated messaging, guest replies must be checked via the property email address registered in Rakuten Oyado.
To avoid missing replies, it is recommended to verify your email reception and notification settings in advance.
Common Errors and Solutions
If an error occurs during Rakuten Oyado integration, please check the following:
Error 1: Multiple rooms are registered under one room type
Error message:
{"not_one_room":["the room that has been approved and published has to be only one room."]}
Cause
This error occurs when both of the following conditions are met:
The property type in Rakuten Oyado is not under the Hotel Business Law, such as:
Minpaku Law
Special Zone Law
Multiple rooms are registered under a single room type
⚠️ For non–Hotel Business Law properties, only one room per room type is allowed.
Resolution
Please delete the second and any additional rooms in Rakuten Oyado.
The following are also included in the items to be deleted:
Hidden rooms
Rejected rooms
Under-review rooms
Previously created backup or unused rooms
After deletion is completed, please perform a channel refresh in AirHost.
Error 2: Inventory Count Mismatch
Error message:
{"inventories":[" should be a value of 0 or greater.
Cause
This error occurs in the following situation:
The number of rooms was increased in AirHost
The base inventory count in Rakuten Oyado has not been updated
In other words, the number of rooms in AirHost does not match the base inventory count in Rakuten Oyado.
Resolution
Log in to the Rakuten Oyado management system and update the “Base Inventory Count” for the relevant room type so that it matches the number of rooms set in AirHost.
 |
After making the changes, please perform a manual channel refresh from the AirHost management screen.
Frequently Asked Questions (FAQ)
Q. I want to stop resale (listing on Rakuten Oyado). What should I do?
A. Please contact Rakuten Oyado support.
Q. I changed the number of rooms in AirHost. Do I also need to update the base inventory in Oyado?
A. Yes. If the number of rooms is changed in AirHost, you must also update the base inventory count in Rakuten Oyado to the same value. If the values do not match, inventory synchronization errors may occur.