Skip to main content

Shiji Enterprise Platform 2-way

CS - Oaky avatar
Written by CS - Oaky
Updated over 3 months ago

Great news! Now it's possible to send upsell emails to all your guests and automate your ancillary revenue with Oaky via Shiji Enterprise Platform!

✔️Benefits of the connection:

  • Shiji pushes all reservations up to 1 year in the future to Oaky.

  • Guests only see available rooms (Room Availability and Pricing are pulled from Shiji)

    • When a Room Upgrade is selected by a guest, the Room type is automatically modified in Shiji by Oaky. The supplement is added as a package and a note is added about the upgrade details.

  • When a Service is selected by a guest, the corresponding package is automatically added to the reservation in Shiji by Oaky. A note is added to inform about the extra service.

  • With the 2-way connection, Front Office or Reservations employees don’t have to use Oaky, all requests are automatically approved (unless manual approval is set).

  • Segmentation using PMS data (Rate Code, Market Code, Room type, etc.)

  • Dynamic Pricing (activated on demand).

How to connect?

If you are interested in connecting to Oaky via Shiji, get in touch with your dedicated Shiji Account Manager and inform your Oaky Customer Success Manager. In case you are not aware of who your Oaky CSM is, no worries, get in touch with us via the chat to confirm or send us an email at support@oaky.com.

Costs for the connection on Shiji's end vary and can only be confirmed by Shiji directly. There are no costs for the connection on Oaky's side.

How does it work?

Once the connection is established, Oaky receives all reservation data and room type availability for up to 1 year in the future.

When a room upgrade or service is requested via Oaky, we post a note for the front desk in Shiji.

The approved Oaky request is then added to the guest bill in Shiji.

Setting up Room Upgrade and Services in Shiji

In Shiji, packages are called Purchase Elements. Each Oaky Service should have a corresponding Purchase Element in Shiji. Room upgrade in Oaky is mapped to a single room upgrade service (purchase element) in Shiji. The mapping of the Oaky deals (services and room upgrades) to their corresponding Shiji purchase elements is done on the Hotel Settings > Integrations page on the Oaky dashboard.

Note: Refer to the current integration limitation between Oaky and Shiji here.

Room Upgrade Purchase Element configuration in Shiji:

Service Purchase Element configuration in Shiji (refer mapping combination below):

On the Oaky Integrations page:

Switch the Shiji 2-way settings on:

  • Get reservations: this needs to be switched for Oaky to be able to receive reservations from Shiji

  • Get room type availability: This needs to be switched on for Oaky to be able to receive room type availability from Shiji

    • Oaky will only offer available room upgrades

    • Oaky will show a label when there are a few rooms available to encourage the guest to book the room upgrade

  • 2-way room upgrade: This needs to be switched on so Oaky can send the booked room upgrade to the PMS and the hotel does not have to add it manually to the reservation in Shiji. Room type mapping needs to be done in Oaky.

  • 2-way service: This needs to be switched on so Oaky can send the booked services to the PMS and the hotel does not have to add it manually to the reservation in Shiji. The services should be mapped.

Oaky Services Mapping with Shiji Purchase Elements

For the Shiji purchase elements to show up on the Oaky dashboard's Integration page, they should have the correct price type mapping. Below is a table of the price type mapping according to the Oaky price types:

Product charge mode

Product posting frequency

Oaky mapped price types

Per reservation

EveryNight

Price per night throughout stay,
Price per person per night throughout stay

ArrivalNight

Price per person,
Price per piece,
Price per piece per day,
Price per person per night,
Price per room

LastNight

Price per person,
Price per piece,
Price per piece per day,
Price per person per night,
Price per room

Per person

EveryNight

Unmappable

ArrivalNight

Unmappable

LastNight

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

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:

  1. Oaky gets the rates based on the BAR for the current (upgrade from) and upgrade (upgrade to) room types.

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

  3. Oaky checks if there is a dynamic pricing discount % set up.

  4. 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 Limitations of the Connection between Shiji and Oaky

Oaky needs to send the price of the packages as 1 EUR to Shiji. Due to this limitation:

  • packages are sent as many times as the rounded price of the deal is.

  • the prices are always rounded.

For example, if the hotel upsells 1x Early Check-in for 50 EUR, Oaky sends this to Shiji PMS as 50 x 1 EUR for Early Check-in.

Unfortunately, this is a limitation on Shiji's end. Our teams are working on improving this in the future. As a customer, feel free to also reach out to Shiji support directly to request developments in this direction in case it causes procedural issues for the hotel while working with Oaky.

Important Update – Quantity Limit Introduced by Shiji

Shiji recently introduced a platform-wide limit where the 'quantity' field must not exceed 99. This change inadvertently affected the Oaky integration, causing an error when the upsell price exceeded 99 EUR per night:

API Error: 'Quantity' must be less than or equal to '99'.

Shiji has since rolled out a fix to increase this limit to 500, resolving the issue for most upsell scenarios.

However, please note:
If the upsell price exceeds 500 EUR per night, the same error will still occur, and the upsell will fail to post in the PMS, until until Shiji fully removes this limitation or implement a permanent solution.

This is pretty much it! In case of any other questions, feel free to reach out to us via the chat or contact your dedicated Oaky CSM directly.

Did this answer your question?