Overview
The Oaky 2-way integration with Shiji Enterprise Platform enables real-time synchronisation between Oaky and your Property Management System (PMS). This allows hotels to automate upsell delivery, ensure reservation accuracy, and post charges directly to guest folios in Shiji.
With this integration, Oaky can:
Automatically send upsell emails to your guests
Show only available room upgrades and services
Automatically post approved upgrades/services back into Shiji (no manual re-entry)
Key benefits
Once the connection is live:
Reservations sync: Shiji pushes all reservations up to 1 year in advance to Oaky.
Live availability & pricing: Guests only see available room types; Oaky pulls room availability and prices from Shiji.
2-way room upgrade and services:
Automated room upgrades: When a guest books an upgrade via Oaky, the room type is changed in Shiji, the supplement is added as a package, and a note is added with the details.
Automated services: When a service is booked, the corresponding package is added to the reservation and a note is posted for the team.
No manual approval (if desired): With the 2-way connection, Front Office or Reservations do not need to log into Oaky; all requests can be automatically approved unless you choose manual approval.
Segmentation & dynamic pricing: You can use Shiji data (Rate Code, Market Code, Room Type, etc.) for segmentation, and optionally enable dynamic pricing based on your BAR or base rate.
How to connect?
Contact Shiji
Reach out to your Shiji Account Manager and request the Oaky 2-way integration.
Contact Oaky
Inform your Oaky Partner Success Manager that you would like to connect via Shiji.
If you are not sure who your CSM is, contact us via the in-app chat or email support@oaky.com.
Costs
Any fees on Shiji’s side are set and confirmed by Shiji directly.
Oaky does not charge any additional fee for this connection.
How the integration works
Once the integration is established:
Shiji sends reservations and room-type availability (up to 1 year ahead) to Oaky.
Guests receive Oaky offers and can book room upgrades and services.
When a request is approved (manually or automatically):
Oaky posts a note on the reservation in Shiji
The corresponding package is added to the folio
For room upgrades, the room type is updated accordingly
Configuration in Shiji
In Shiji, Oaky’s deals map to Purchase Elements (Shiji’s term for packages).
Room upgrades
Room upgrade in Oaky should correspond to a single room-upgrade purchase element in Shiji.
Configure the purchase element in Shiji with the correct price type, tax, and posting settings (refer to your Shiji documentation / support for details).
Services
Each service in Oaky should also have a matching purchase element in Shiji.
Make sure the purchase element is set up with the correct product charge mode and posting frequency, so that it can be mapped to the right Oaky price type (refer mapping combination table)
Price-type mapping (Shiji <> Oaky)
For Shiji purchase elements to show on the Oaky Integrations page, the Purchase Elements calculation rule and posting rhythm must be compatible with the Oaky price type you want to use.
Below is a table of the price type mapping according to the Oaky price types:
Shiji Calculation Rule | Shiji Posting Rhythm | Oaky price types |
Per reservation | Every Night | Price per night throughout stay, |
| Arrival Night | Price per person, |
| Last Night | Price per person, |
Per person | Every Night | Unmappable |
| Arrival Night | Unmappable |
| Last Night | Unmappable |
Oaky | Without date sent from Oaky |
Price per person | 1 charge * number of quantity posted on arrival night only |
Price per piece | 1 charge * number of quantity posted on arrival night only |
Price per piece per day | 1 charge * number of quantity posted on arrival night only |
Price per person per night | 1 charge * number of quantity posted on arrival night only |
Price per room | 1 charge * number of quantity posted on arrival night only |
Price per person per night throughout stay | 1 charge * number of quantity posted for each day of the reservation |
Price per night throughout stay | 1 charge * number of quantity posted for each day of the reservation |
Configuration in Oaky
All PMS-side configuration must be completed before this step.
In the Oaky dashboard, go to Hotel Settings → Integrations and locate Shiji 2-way.
Enable the following toggles:
Get reservations – allows Oaky to receive reservations from Shiji.
Get room type availability – allows Oaky to receive room-type availability from Shiji, so only available upgrades are shown and “low availability” labels can be displayed.
2-way room upgrade – enables automatic posting of room upgrades back to Shiji (no manual entry required).
2-way service – enables automatic posting of booked services back to Shiji.
Service mapping: Under Services mapping, link each Oaky service to the correct Shiji purchase element. Only purchase elements with compatible price type mappings (see below) will appear in this list.
Dynamic Pricing from the PMS
💡If you would like to enable Dynamic Pricing for your property, please reach out directly to your Oaky Customer Success Manager or reach out to us via the support chat.
Dynamic pricing is a fluctuating price for a specific room upgrade and/or service. The supplement rates are calculated based on the BAR rate code (or a Base/Standalone rate) which has been provided to Oaky by the hotel team:
Oaky gets the rates based on the BAR for the current (upgrade from) and upgrade (upgrade to) room types.
Oaky calculates the average supplement for both room types (SUM all collected prices and divided by nights of stay) to calculate the upgrade supplement per room type.
Oaky checks if there is a dynamic pricing discount % set up.
Based on the above calculations - Oaky displays the room upgrades with the dynamic pricing rates.
Your Room Price Matrix is the default fallback for the supplement rates in case Oaky doesn't receive the dynamic upgrade rate from the PMS. The rates fallback on the Room Price Matrix when:
if the deal and/or booking doesn't have a room type assigned
if there is no availability for the current and/or upgraded room types for any of the nights of stay
if the calculated price is negative
You can tell if the upgrade price was calculated based on the dynamic pricing from the PMS or the Room Price Matrix by the text under the received price (PMS Price / Room Price Matrix):
Round calculated room-upgrade prices
With dynamic pricing, you can not only offer dynamic rates but also round up the calculated supplement rates. This is possible by enabling the Round calculated room-upgrade prices to full numbers toggle on the Dynamic Pricing tab and saving the changes.
Technical Limitation
Price Handling in Shiji
Due to a limitation in the Shiji PMS, Oaky is required to send package prices as 1 $ [currency unit] per unit instead of a single total amount.
How this works:
The total upsell price is converted into a quantity of $1 units
Prices are rounded to whole numbers
Each upsell is posted as multiple units rather than one line with the full value
Example:
If a guest purchases an Early Check-in for $50, Oaky sends this to Shiji as:
→ $1 × 50 units for Early Check-in
Quantity Limit in Shiji
Because prices are sent as quantities, Shiji’s quantity field limit directly impacts the maximum upsell value that can be posted.
The maximum supported quantity is 500
This means upsells above $500 per night cannot be processed
If this limit is exceeded, the upsell will fail with the following error:
API Error: 'Quantity' must be less than or equal to '500'
As a result, the upsell will not be posted in the PMS.
This is a known limitation on Shiji’s side. While improvements are being explored, no permanent solution is currently available.
Fixed charge for room upgrades (optional workaround)
By default, Oaky posts room upgrades to Shiji as purchase elements. Due to a current Shiji limitation, these purchase elements are sent as multiple “1-unit” lines and cannot exceed a quantity of 500, which can cause issues for high-value upgrades.
To avoid this, hotels can choose to use fixed charges for room upgrades only. When this option is enabled:
Oaky still updates the room type in Shiji and adds a reservation note.
Instead of posting a package/purchase element, Oaky posts one fixed charge line for the total upgrade amount, using your Shiji fixed charge transaction code.
Important limitations when using fixed charges for room upgrades
Fixed charges do not appear in Shiji forecasting reports for room upgrades.
The fixed charge inherits the tax settings of the underlying transaction code; separate tax configuration for the upgrade is not possible.
This option is only available for room upgrades. Services and ECI/LCO will continue to use purchase elements and keep the existing Shiji limitations for now.
What the hotel needs to do
Create a fixed charge transaction code in Shiji for room upgrade.
Ensure the tax and revenue settings on that transaction code are correct, as the fixed charge will copy these settings.
Share the following details with Oaky team during onboarding, migration or update:
Shiji hotel code/ID, tenant and credentials (if not already provided), and
The fixed charge transaction code for room upgrades you want Oaky to use.
Oaky will then configure your Shiji 2-way integration so that room upgrades are posted as fixed charges, while services continue to be handled via purchase elements. This is a temporary workaround until Shiji removes the current price and quantity limitations on purchase elements.
