# About the Operation Groups API

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

An [operation](fallback::https://dev.wix.com/docs/sdk/backend-modules/restaurants/wix-restaurants-new/online-orders/operations/introduction) 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 Group      | Operation           | Location     |
|----------------------|---------------------|--------------|
| Catering             | Operation 1         | California   |
| Catering             | Operation 2         | New York     |
| Catering             | Operation 3         | London    |
| Takeaway             | Operation 4         | California   |
| Takeaway             | Operation 5         | New York     |
| Takeaway             | Operation 6         | London    |

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](fallback::https://dev.wix.com/docs/sdk/backend-modules/tags/tags/introduction) 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](fallback::https://dev.wix.com/docs/sdk/backend-modules/restaurants/wix-restaurants-new/about-business-locations) 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](fallback::https://dev.wix.com/docs/sdk/backend-modules/restaurants/wix-restaurants-new/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 Group   | Operation        | Location    |      |
|-------------------|------------------|-------------|----------|
| Catering   | Operation 1      | California  |          |
| Catering   | Operation 2      | New York    | (New)      |
| Takeaway   | Operation 3      | California  |          |
| Takeaway   | Operation 4      | New 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 Group   | Operation        | Location    |      |
|-------------------|------------------|-------------|----------|
| Catering   | Operation 1      | California  |        |
| Catering   | Operation 2      | New York    |     |
| Catering   | Operation 3      | London  |       |
| Takeaway   | Operation 4      | California  |     (New)       |
| Takeaway   | Operation 5      | New York    | (New)      |
| Takeaway   | Operation 6      | London  |   (New)         |

### Deleting an operation group

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



## Before you begin

It’s important to note the following points before starting to code:

* The site or project owner must install the Wix Restaurants Orders (New) app.

@package_metadata:@wix/restaurants

To use the OperationGroups API, install the `@wix/restaurants` package.

#### Install the package

Follow the installation instructions for your development environment.

| Development environment | Installation method |
|--|--|
| Wix sites (editor or IDE) | Use the [package manager](fallback::https://dev.wix.com/docs/develop-websites/articles/coding-with-velo/packages/work-with-npm-packages-in-the-editor). |
| Wix sites (local IDE) | Run `wix install @wix/restaurants` using the [Wix CLI](fallback::https://dev.wix.com/docs/develop-websites/articles/coding-with-velo/packages/work-with-npm-packages-with-the-wix-cli).|
| Blocks apps | Use the same installation method as Wix sites. |
| CLI and self-hosted apps | Run `npm install @wix/restaurants` or `yarn add @wix/restaurants`. |
| Headless sites and apps | Run `npm install @wix/restaurants` or `yarn add @wix/restaurants`. |

#### Import the package

To import the package in your code:

```js
import { operationGroups } from '@wix/restaurants'
```

Coding Examples

Sled Tests

Go Headless

Build Apps

Client

API Preview

Ricos

Develop Websites

REST

Velo

Picasso

GraphQL (Alpha)

bulkUpdateOperationGroups( )