Pricing
How to Connect Your Duve Account to Simphony
1. Log in to your Simphony account
- 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)
- 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
- 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
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


Set Up the Menu in Duve
Click Next. The Store will now be created into a Duve Menu, where all items in the Store will be synced.
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.
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.
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.

Comments
0 comments
Please sign in to leave a comment.