How to Connect Simphony POS Integration – Duve

The Simphony POS integration allows hotels and vacation rentals to seamlessly manage guest orders by connecting their POS system directly with Duve. This integration ensures real-time synchronization of menu items, pricing, and orders, eliminating manual data entry and reducing errors. With a simple setup and secure connection, hosts can enhance their operational efficiency and guest experience.

A host must have a Simphony License in order to connect it to Duve. To purchase one, please inquire with your Oracle contact or a verified reseller. Duve only supports Simphony 19.2 and newer versions.

Pricing

To integrate Simphony, customers must purchase the POS Add-on. Simphony is an add-on feature that will be available upon request with a 500 EUR setup fee and at an additional monthly cost of 0.5 EUR per unit with a monthly minimum of 50 EUR required. For more information contact our Support Team or your dedicated Customer Success Manager.

How to Connect Your Duve Account to Simphony

1. Log in to your Simphony account

Inquire with the Oracle contact or certified reseller to get the following credentials.

Oracle must create a user for the connection in Duve. The email will be available for a later reset request in the future.

Ensure that the Transaction Services Gen2 API is licensed
Have the customer create their own STSG2 API account (this is a self-setup process according to Oracle)

* The following credentials are mandatory to insert into the Duve connection:

Username
Password
Employee ID (POS Sign in Number)
API URL
Authentication URL
Enterprise Short Name

How to create or access the credentials for the Duve Connection

Username - For the creation of user - need to perform these actions:

Administrator > System > API accounts > Add API account:
Type: Simphony transaction services
Account name = username - advised: DUVE_STS_"ENTERPRISE-SHORT-NAME-CODE" (for example DUVE_STS_DUV).
Email: Adjust an email for a Duve specific API user

If you need to give only for a specific revenue center, do the following steps:

Location Authorization scope
Click on Selected
Choose locations
Pick the one that you want to apply

2. Password - After the creation of the username is done, please contact support to create the password and to complete the creation of the user.

3. API URL - this can be found in:

EMC (platform) > Enterprise level > Search > Enterprise parameters: Simphony App URL > Applications - Here you can find the STSG2 URL = API URL - Which is the "Transaction services generation 2 services" (in Duve, need to add in the connection page, without /api/v1/).

4. Authentication URL and ClientID - Will be created once the user is created (the Authentication URL will be named "Authentication server" in Simphony. Please note that the URL must be without the "/oidc-provider"

5. Employee ID for Order Push - The Employee ID (POS Sign-in Number) is stored in People Management (from Simphony 19.6 and above) https://docs.oracle.com/en/industries/food-beverage/simphony/simcg/c_employees.htm
One of the existing IDs can be used.
To retrieve the Employee ID: People > Search the relevant user (which was created before) > Press on "Point of sale" > Settings > under the POS client > POS sign-in number

6. Enterprise Short Name

2. Setup in Duve

On the Connections page, Add a New source under the POS tab and select 'Simphony'.

Once Duve enables the integration for you, select Simphony and insert the credentials:

Once the connection is made, you can fill in the following fields from the POS:

Mandatory: On Bill/Room Charge Identifier Code - Add the "Payment tender" value with type "ServiceTotal" (Ask Simphony team)

Payment Tenders Codes for Cash, Visa, Mastercard, Maestro, American Express, Diners in each field* (each field in the list is mandatory)
- Recommended: Create designated payment methods for Duve transactions for easier tracking
Other/Kiosk Payment Type - This is for payment methods that Duve cannot recognize. Simphony should provide the type of code for "Other" charges. This is the "fallback" value code for payments that we cannot recognize as the CC provider. This value is mandatory for the account to use CC payments with Simphony.

Note: There is a toggle for "Push Orders to PMS" which should only be turned on if there is no integration in the POS for pushing the orders to the folio in Opera. Enable the toggle to send the POS orders directly from Duve to Opera.

How to Set up Stores in Duve

Once the connection is made, scroll down to connect a Store

If Duve finds stores in your account, it will be presented and hosts can select the menu they want:

When the stores are added, they will show at the bottom of the page. If a host needs to edit, remove or add new stores, click 'Edit Synced Stores'

Set Up the Menu in Duve

Once the Stores are added, go to the Upsells > Manage page to create the Menus from the POS.

Click '+New Upsell'' and select Menu.

image (292).png

Click 'Sync from POS' from the pop up and select the store you want a Menu upsell to be created for.

Click Next. The Store will now be created into a Duve Menu, where all items in the Store will be synced. image (293).png

All names, pictures, description and prices are pulled from the POS system. A user can edit each field that was synced from the POS except the price.

For further details on how to set up Menu Products, please see: Menu Upsells Product Builder

Configure Menus with Service Charges

Go to the Menu settings in the Duve POS page.
Navigate to the "Payment Options" section.
Under the Currency settings, you will now see a list of Service Charges synced from Simphony.

Note: Multiple service charges can be added to a single menu product, and will be applied to every product purchased.

Advanced

Guest Notes - Allow guests to add notes

Public Guest App - Show the Menu Product in the Public Guest App (Note: Guests must log in to purchase menu products)

Emails and Notifications

Pop Ups - enable pop ups to users in the account

Emails - add email addresses for who should receive the order request, confirmation and cancellation emails

Connect&Sync

Set 'Billing Identifier (POS)' -> set it to ״3״ or can leave blank

Billing Identifier - set up codes (transaction ID or package code) for sync back to PMS

Condiments Setup

If Items are showing SubItems or Condiments that are not relevant for the Item, please set up the 'Required Condiments' on each Item:

In the Simphony EMC, go to Configuration > Menu Item Classes > double click the specific item.

Select all relevant sub-items from the 'Required Condiment Groups'

Lastly, select the toggle in Duve under Advanced to show 'Mandatory Sub-items only'

Automatic Updates from the POS

New Stores - any new stores or items within an existing store will be synced automatically every 10 minutes from the POS
New Items within an Existing Store - Any new item in an existing store will be synced to the Menu in 'draft mode' - where the toggle for that item is off
Out of Stock Items - When a guest is browsing and selected items which are out of stock, Duve checks the availability in the POS when the guest clicks to Pay
Changes made to Store Names or Items in the POS - In case the host changes the item or the Menu details in the POS, those new details will not overwrite the display details the host implemented in Duve’s Product builder.
Excluded Items or SubItems - A host can exclude items in a menu from showing in Duve. To do this, please create a tag filter called "Duve Exclude" and add the tag to all items and subitems in Simphony that should not be synced to Duve. For further instructions for how to create a tag in Simphony, please see here.
- To assign a tag to an item, see here.