How to configure a combo meal with sizes for Oracle STSG2

Pontus Ridderström
  • Updated
Follow

Overview

This combo meal combines a sized main item with add-on groups, a single-choice side, and a single-choice drink into one product with its own combo price — the worked example here is a Nugget Meal (nuggets in a chosen size, two dip choices, a side, and a drink). Configuration spans three phases: building the combo meal building blocks in Oracle Simphony EMC and configuring the Combo Meal Groups, importing the menu and verifying the blocks in Rule Manager, and publishing the meal with an Enable Product rule.

Prerequisites

  • EMC access — you need access to Oracle Simphony EMC at the Enterprise level to create menu item definitions, Combo Meal Groups, and tags.
  • Navigator access — the operator needs access to the relevant Navigator app (Orchestrator and Rule Manager); see Managing access to Navigator applications.
  • A working STSG2 menu import — a configured STSG2 import flow in Orchestrator that generates Future Ordering Masterdata for the menu; see Orchestrator navigator app.
  • All combined products already configured — every product that the meal combines must already be configured as its own product type before the meal is built: the nuggets (Product with sizes), the dip options, the side options (for example Fries as a Product with sizes), and the drink options (Single products and Product with sizes). See Configure product types for STSG2 and Creating the first menu building blocks.
  • Base EMC configuration done — the Future Ordering tags must already exist at the Enterprise level; see Configure EMC Enterprise level for the Future Ordering platform.
  • Parent reference articles — Combo Meals describes what a combo meal is and what each combo meal datafield does, and Configure product types for STSG2 describes the size building-block pattern this meal reuses.

Steps

This guide configures a combo meal with a sized main item and add-on groups — nuggets in a chosen size, two dip choices, a single-choice side, and a single-choice drink, published for STSG2. The steps below reference Future Ordering-specific terms and datafields (Combo Meal, Menu Item Master, Combo Group, Container, the FO_ data extension fields, Rule Manager, the Enable Product rule, and the configurator tags). For the full definition, constraints, and examples of each, see the linked Feature article Combo Meals and the building-block reference Configure product types for STSG2; they are not re-explained here.

Phase 1 — Build the combo meal in Oracle Simphony EMC

This phase builds the combo meal building blocks and configures the Combo Meal Groups in Oracle Simphony EMC. The Sequence number (#), Menu Item Class, Main Level, and Sub Level follow the customer's existing EMC POS menu setup and are not specific to Future Ordering. All sequence numbers, FO_UniqueIdentifiers, FO_LinkedToDefinition, and FO_SelectedItem values shown below are examples that depend on the customer's specific environment — they illustrate the pattern and are not prescribed values.

Important: a container does not need a Price record, and the Menu Item Class used for a container must allow a 0.00 cost. A product must use a Menu Item Class configured as a Product (not a Condiment); condiment items must use a Menu Item Class configured as a condiment.

  1. Create the main item container — this is the nuggets size container; it acts as the main item container, except that it contains multiple options (the sizes) rather than one fixed item. Set the following datafields:
    • Consumer Item Name — Nuggets size container
    • FO_UniqueIdentifiers — 920010 - Nuggets size container (example)
    • FO_LinkedToDefinition — 4001,4002 (example — the 6pcs and 9pcs nugget size products)
    • FO_SelectedItem — 4001 (example — the default size)
    • FO_SelectionOptions — {"max":1,"min":1}
    • FO_IsContainer — Checked
    • Tags — fo:web:configurator:ignore (not required on a size container, but hides the size configuration when the guest is in the Meal ordering flow; the size is instead chosen from the category view via the meal product's quick configurator — see step 5)
  2. Create the dip container and set the following datafields:
    • Consumer Item Name — Choose dip
    • FO_UniqueIdentifiers — 920011 - Dip container (example)
    • FO_LinkedToDefinition — 4201,4202,4203 (example — the dip products)
    • FO_SelectedItem — leave empty (no default option is set; the guest must choose)
    • FO_SelectionOptions — {"max":1,"min":1}
    • FO_IsContainer — Checked
    • Tags — fo:web:configurator:climbtotop (surfaces the dip choice alongside the side and drink rather than nested under the nuggets)
    • Note: for the two dip choices in this meal you can either reuse this dip container multiple times or create a separate container for the second dip. The real products in the container must match the products linked to its Combo Meal Group one to one; the same container can then be reused across both dip groups.
  3. Create the side container and set the following datafields:
    • Consumer Item Name — Choose side
    • FO_UniqueIdentifiers — 920013 - Combo side container (example)
    • FO_LinkedToDefinition — 2100,2200,2300,2400 (example — the side products)
    • FO_SelectedItem — 2100 (example — the default side)
    • FO_SelectionOptions — {"max":1,"min":1}
    • FO_IsContainer — Checked
  4. Create the drink container and set the following datafields:
    • Consumer Item Name — Choose drink
    • FO_UniqueIdentifiers — 920014 - Combo drink container (example)
    • FO_LinkedToDefinition — 1001,1002,1003,1004,1005,1006 (example — the drink products)
    • FO_SelectedItem — leave empty (no default option is set; the guest must choose)
    • FO_SelectionOptions — {"max":1,"min":1}
    • FO_IsContainer — Checked
  5. Create the combo meal product (the Menu Item Master that carries the meal price). The sized nuggets are represented by this combo meal product directly, not by a separate virtual product. Set the following datafields:
    • Consumer Item Name — Nugget Meal
    • Consumer Item Description — Combine to create a complete product meal
    • FO_UniqueIdentifiers — 9200002 - Nugget Meal (example)
    • FO_LinkedToDefinition — 920010,920011,920011,920013,920014 (example — the five containers: nuggets size/main, dip 1, dip 1, side, drink — the dip container is reused for both dip choices)
    • Price record - Price — 11.00 (example — the combo meal price for all combined choices)
    • Price record - Active On Level — 0 - All Levels
    • Tags — fo:web:configurator:meal, fo:services:tagconventions:disable:display:quickadd, fo:web:display:quickconfigurator (the quick configurator presents the nugget size choice from the category view)
    • Images — Product image
  6. Save the Menu Item maintenance.
  7. Open Combo Meal Groups in the Menu Level configuration and create one Combo Meal Group for each combo group in the meal (nuggets, dip 1, dip 2, side, drink). When adding items to a Combo Meal Group:
    • Only add main items — no virtual products or containers may be added as Combo Group Items.
    • The real products in a container must match the products linked to its Combo Meal Group one to one. [SCREENSHOT: the Combo Meal Groups area in Menu Level configuration with the groups listed]
  8. Configure the primary Combo Meal Group (the nuggets group): set the Primary Menu Item to the referred menu item, add the nugget size products to Add Combo Group Item, and mark this group as Primary. [SCREENSHOT: the Items tab of the nuggets Combo Meal Group with the size products added and the group marked Primary]
  9. Configure the dip 1, dip 2, side, and drink Combo Meal Groups: add each choice as a Combo Group Item.
  10. In the nuggets Combo Meal Group, ensure the Price configuration reflects the additional cost when the larger nugget size is chosen — set the additive price on the larger-size Combo Group Item.
  11. Open Combo Meal configuration and create the combo meal: set the Menu Item Master to the combo meal product created in step 5, add each Combo Meal Group, and confirm the nuggets group is set to Primary. [SCREENSHOT: the Combo Meal configuration screen showing the Menu Item Master and the combo groups with the nuggets group marked Primary]
  12. Link the combo meal to its category by adding the combo meal product's sequence number to the category's FO_LinkedToDefinition.

Phase 2 — Import the menu and verify the combo meal

This phase imports the menu and confirms the combo meal building blocks reached Future Ordering Masterdata. The work is done in the Orchestrator and Rule Manager Navigator apps.

  1. In Orchestrator, run the STSG2 menu import flow, or wait for the scheduled run to complete.
  2. Confirm the run finished successfully — the run result shows Finished with no failed jobs.
  3. Open Rule Manager, select Add Rule +, choose the Enable Product rule type under Select Rule Type, and select Continue.
  4. In the Products field, search by name or by FO_UniqueIdentifiers and confirm each block is present: the combo meal product, the nuggets size/main container, the nugget size products, the dip container, the side container, the drink container, and every option product. [SCREENSHOT: the Products search in Rule Manager listing the combo meal product and its containers]

Phase 3 — Publish the combo meal with an Enable Product rule

This phase publishes the combo meal to the Frontend with an Enable Product rule in Rule Manager. Create a new rule or add to an existing Enable Product rule.

  1. In Rule Manager, select Add Rule +, choose Enable Product under Select Rule Type, and select Continue.
  2. Set a Name for the rule and an Index.
  3. Set the Publish start and Publish stop dates for the period the meal should be available.
  4. Select the relevant Order classes for the meal.
  5. Under Stores, select Specific and choose the stores that should offer the meal, rather than All.
  6. In the Products field, select every block that makes up the meal as a Product: the combo meal product, the nuggets size/main container, the nugget size products, the dip container, the side container, the drink container, and every option product (dips, sides, drinks). All imported menu blocks — the product and every container and option product — must be selected here for the meal to publish correctly. [SCREENSHOT: the Enable Product rule with the combo meal product and all containers and option products selected]
  7. Save the rule.

Additional Options

These are optional and not required for the meal to work:

  • Add an additional cost for premium choices — give a Combo Group Item a price in its Combo Meal Group so that choosing it (for example, the larger nugget size or a premium dip) adds that amount to the meal. A choice with no price adds no additional cost. See Combo Meals.
  • Handle different VAT rates within one meal — when the combined products carry different VAT rates, configure the meal product as a Virtual product. The price and VAT information is then collected from each individual product rather than from the combo meal product.
  • Vary the number of dips by nugget size — to offer, for example, one dip with a 4pcs nugget size and two dips with a 9pcs nugget size, configure the dips as Condiments on the main Nugget product, in a container of dip products that are configured as Condiments in EMC. Apply fo:web:configurator:climbtotop to that condiment dip container so it shows in the meal experience. See Tags and badges in Oracle Simphony EMC for Future Ordering.
  • Different prices per Order Class — add multiple Price records to the combo meal product, each on a specific menu level (Price record - Active On Level) for Eat In, Take away, and Delivery; these can carry different VAT. A different tax class for a whole Order Class is requested from Future Ordering internally.
  • Schedule availability — restrict the meal to a publish window using the Publish start and stop dates on the Enable Product rule.

Expected Outcome

The combo meal appears in the Frontend at its combo price, with the nugget size selectable from the category view, and selecting the meal opens a configurator where both dips, the side, and the drink are presented together as parallel choices. Choices that carry a Combo Group Item price add that amount to the meal price.

Verify the Configuration

  1. Open the Frontend for a store published by the Enable Product rule and locate the combo meal in its category.
  2. Confirm the nugget size can be chosen from the category view via the quick configurator, then select the meal and confirm the configurator shows two dip choices, a side choice, and a drink choice, with the configured defaults pre-selected. [SCREENSHOT: the Nugget Meal showing the category-view size choice and the in-meal dip, side, and drink choices]
  3. Add the meal to the Basket and confirm the price equals the combo price plus any additive cost for the larger nugget size or a premium dip, side, or drink.
  4. If the meal does not appear or behaves incorrectly, see the Troubleshooting section below.

Known Limitations

  • A given menu item can be the Menu Item Master of only one combo meal — a menu item cannot be reused as the master of a second combo meal.
  • Important: the real products in a container must match the products linked to its Combo Meal Group one to one. The same container and Combo Meal Group pairing can then be reused multiple times within the combo meal.
  • Combo Group Items must be main items only — virtual products, containers, and condiment products cannot be added directly as Combo Group Items.

Note: This list reflects the limitations identified as of 29 June 2026. Additional limitations may exist that have not yet been identified.

Troubleshooting

  • The meal does not appear online — confirm an Enable Product rule selects the combo meal product and all of its containers and option products, and that the category and store are also published (Enable Store, Enable Category, and Enable Product all apply).
  • The meal is hidden even though it is enabled — a Disable rule with a higher Index overrides the Enable Product rule; check the Index values and adjust.
  • A dip appears nested under the nuggets instead of alongside the side and drink — confirm fo:web:configurator:climbtotop is applied to the dip container; see Tags and badges in Oracle Simphony EMC for Future Ordering.
  • A side or dip is rejected on order — the chosen item is not part of the combo meal configuration in Simphony; see Known Order errors - Solutions and workarounds.
  • The import fails — see Known Menu import issues and solutions and Existing menu issues.