Skip to main content

Menu Engine Set Up

Configurations in both Genius Portal and Data Management are required to set up Menu Engine services.

To set up Menu Engine follow the procedure. Note that each step is a procedure itself.

Select Company

Genius PortalAdminAll Companies

To select the company from Genius Portal:

  1. From the upper-right of the Genius Portal, select the username dropdown.

  2. From the dropdown, select Admin.

  3. From the Admin menu on the left, select All Companies

  4. From the Company List, locate the company row.

  5. To the right of the company row, select the 3-dot menu.

  6. From the 3-dot menu, choose Select.

Create Admin User

To create an Admin user:

  1. From the upper-right of the Genius Portal, locate the User Name dropdown.

  2. From the User Name dropdown, select Admin.

  3. From the Admin menu on the left, select All Companies.

  4. From the Company List, use the three-dot menu on the right of the company row to select the company.

  5. From the Dashboard menu on the left, select User Management.

  6. From the User Management options, select Users.

  7. From the upper-right of the Users homepage, select Create User.

  8. From the Users menu on the left, navigate between General, Roles, and Sites to complete the following steps.

  9. From the General page, type the user information in the provided fields.

  10. From the Roles page, assign the Admin role to the user record.

  11. From the Sites page, assign the user to the applicable company sites.

Note

For comprehensive User Management documentation, please see User Management.

Create Order Source

Genius PortalData ManagementOrdering SettingsSettingsOrder Source

To create an order source:

  1. From the upper-right of the Order Source List, select New Order Source.

  2. In the General section, define the following:

    Field

    Value

    Name

    DMB

    ID

    dmb

    Active

    Toggle to Active if the order source is available for use at the site.

    Multi-site users: To the right of the field, select the globe icon to define values for each site.

    Fields not mentioned in the table do not affect the Menu Engine pricing integration.

  3. From the upper-right, select Save.

Note

For comprehensive order source documentation, please see Order Source.

Create Custom Menu Engine Service

Genius PortalSettings and ToolsCustom Services

To create a custom Menu Engine service:

  1. From the Custom Services homepage, select Add Custom Service.

  2. In the General area, define the following fields:

    Field

    Value

    Service Name

    DMB-ME

    Service URL

    {{distributor_url}}/v1/menus/notify

    Type

    From the dropdown, select Delivery

    Order Source

    DMB

  3. From the menu on the left, select Custom Fields.

  4. From the Custom Fields area, select + Add New Section.

  5. In the Section Name field of the Add Section form, type DMB.

  6. From the lower-right of the Add Section form, select Create.

  7. Select + Add New Field to add the following five (5) fields.

    The specified property values for each field are as follows:

    • Field 1: Menu Creation Order Source ID

      Property

      Value

      Type

      Text Entry

      Label

      menu_creation_order_source_id

      Required

      On

      Placeholder Text

      dmb

      Parameter Key

      menu_creation_order_source_id

    • Field 2: Menu Engine Callback URL

      Property

      Value

      Type

      Text Entry

      Label

      menu_engine_callback_url

      Required

      On

      Placeholder Text

      dmb

      Parameter Key

      menu_engine_callback_url

    • Field 3: Menu Type

      Property

      Value

      Type

      Drop Down

      Label

      menu_type

      Placeholder Text

      Select an Option...

      Required

      Off

      Parameter Key

      menu_type

      Field Choices

      Add the following choices:

      • Price

      • Site

    • Field 4: Create Time Period Menus

      Property

      Value

      Type

      Toggle

      Label

      create_time_period_menus

      Default State

      Off

      On Description

      True

      Off Description

      False

    • Field 5: Ignore Store Hours

      Property

      Value

      Type

      Toggle

      Label

      ignore_store_hours

      Default state

      On

      On Description

      Ignored

      Off Description

      Considered

      Parameter Key

      Leave this field blank.

  8. From the lower-right, select Save.

Note

For comprehensive custom service documentation, see Custom Services.

Enable Menu Engine Service for Company

Genius PortalSettings and ToolsCompany Settings

To enable the Menu Engine service for a company:

  1. Navigate to the Genius Portal.

  2. From the menu on the left, under Settings and Tools, select Company Settings.

  3. From the Company Settings menu on the left, select Services.

  4. From the list of Services, locate the service.

  5. On the the right of the service row, select the 3-dot menu.

  6. From the 3-dot menu, select Edit.

  7. From the menu to the left of the Edit Service area, select General.

  8. From the General menu, select the Enabled toggle to Yes.

  9. in the provided fields, type the following values:

    Field

    Value

    Note

    menu_creation_order_source_id

    dmb

    Value must match the ID created in the Order Source. For additional information, see Create Order Source.

    menu_engine_callback_url

    {{distributor_url}}/v1/menus/notify

    The URL must match the Menu Update Monitor (XMUM) URL according to the stack.

    menu_type

    price

    For ME integration, always use the value of price.

    create_time_period_menus

    checked/unchecked

    checked the menu includes time periods and product prices are time-based

    unchecked the menu does not include time periods and product prices are standard

    ignore_store_hours

    checked/unchecked

    checked menu includes prices for the entire day

    unchecked menu contains prices only for time frames, covered by time periods or when the store is open—according to the Store Hours configuration

    *Note that the following fields: menu_creation_order_source_id, menu_engine_callback_url, menu_type and create_time_period_menus, are affected by the environment option selected in Enable Menu Engine Service for Site.

  10. From the lower-right, select Done.

Enable Menu Engine Service for Site

Genius PortalSites

To add and enable the Menu Engine service for a site:

  1. Navigate to Genius Portal.

  2. From the menu options on the left, select Sites.

  3. From the Sites area, select the checkbox to the left of the site.

  4. From the Actions dropdown, select Edit.

  5. From the menu on the left, select Services.

  6. From the upper-right of the Services screen, select Add Service.

  7. From the Add Service panel, select the service.

  8. From the lower-right of the Add Services panel, select Add Service.

  9. From the Services page, locate the service.

  10. To the right of the service row, select the 3-dot menu.

  11. From the 3-dot menu, select Edit.

  12. From the Edit Service panel, select the Activate toggle to Yes.

  13. In the Environment area, select the appropriate option:

    • Use Company Settings - Inherits defined company settings

    • Custom - Allows modifications for the service

    *The selected option affects configurations in Enable Menu Engine Service for Company.

  14. From the lower-right of the Edit Service window, select Done.

  15. From the upper-right, select Save.