About the Operation Groups API

The Operation Groups API allows you to manage operation groups for a restaurant.

An operation is a distinct service provided at a single restaurant location. For example, the catering service provided at a restaurant's California location. An operation group is the set of operations for a particular service provided across all of a restaurant's locations. For example, if a restaurant has a takeaway service offered at 3 different restaurant locations, they will have a Catering operation group with a catering operation for each of their 3 locations.

Example of restaurant with multiple services across multiple locations:

Operation GroupOperationLocation
CateringOperation 1California
CateringOperation 2New York
CateringOperation 3London
TakeawayOperation 4California
TakeawayOperation 5New York
TakeawayOperation 6London

You can create an operation group for any configuration based on your restaurant offerings, not just for entirely distinct services like catering and takeaway. For example, you could create one operation group for the restaurant's regular hours and menus, and another for Easter hours and menus.

With the Operation Groups API, you can:

  • Create, retrieve, update, and delete individual or multiple operation groups.
  • Manage tags for individual or multiple operation groups.

Operation group behaviour

Before an operation can become active and available for online orders, it must be connected to an operation group.

There can only be 1 operation for a given location in an operation group. In other words, an operation can't have the same combination of businessLocationId and operationGroupId as another operation.

You can't change an operation's operation group or location.

On Wix sites, all operations under the same operation group are displayed and configured together. By default, Wix aggregates operations from the same operation group under the same page on a Wix site. These are called ordering pages.

Adding a new location to a Wix site

When the Wix Restaurants Orders (New) app is installed, if the site has at least one location configured, an operation group is created containing an operation for each location. If no locations are configured an operation group containing a single operation with no location is created. When the first location is added, the single operation in each group is assigned to the new location. When a subsequent location is added, a new operation is created for each operation group and assigned to the new location.

For more information, see About Business Locations.

Example

There are 2 operation groups ("Catering" and "Takeaway") and 1 location (“California”) on a site, and you add a new location ("New York"). Wix generates 2 new operations:

Operation GroupOperationLocation
CateringOperation 1California
CateringOperation 2New York(New)
TakeawayOperation 3California
TakeawayOperation 4New York(New)

Adding a new operation group to a Wix site

If a site has multiple locations, when an operation group is created for a restaurant service, individual operations for that restautant service are created for each of the site's locations. Each of these operations have their own configuration for online ordering and menus.

If there are no locations on the site - Wix creates a single operation with a businessLocationId of "none" per operation group. If a location is later added, these operations with no businessLocationId are assigned that location.

Example

There are 3 locations (“California”, “New York”, and “London”) and 1 operation group ("Catering"). You then create another operation group ("Takeaway"). Wix generates 3 additional operations:

Operation GroupOperationLocation
CateringOperation 1California
CateringOperation 2New York
CateringOperation 3London
TakeawayOperation 4California(New)
TakeawayOperation 5New York(New)
TakeawayOperation 6London(New)

Deleting an operation group

If an operation group is deleted, all operations belonging to the operation group are deleted.

Before you begin

The Operation Groups API only works with the Wix Restaurants Orders (New) app. Make sure you have installed this app from the Wix App Market.

Did this help?