Recipe Venue
POST /recipe-venue/entity/<entity_id>
DELETE /recipe-venue/entity/<entity_id>
POST /recipe-venue/updateEntitiesWithDependencies
GET /recipe-venue/document/<_id>
PATCH /recipe-venue/document/<_id>
DELETE /recipe-venue/document/<_id>
POST /recipe-venue/documents/dependencies
GET /recipe-venue/mapping/entity/<entity_id>
POST /recipe-venue/mapping/entity/<entity_id>
Security
jwt-bearer-token
apiKey | API Key |
|---|---|
Name | Authorization |
In | header |
Endpoints
GET /recipe-venue/master
Summary
Gets a master list of recipe venue entities regardless of the site.
Request Parameters
In | Field Name | Type | Required | Description |
|---|---|---|---|---|
header |
| string | Yes | The identifier of the company to manage data for |
query |
| integer | No | The maximum documents to return. For example, if |
query |
| integer | No | The documents to skip before returning. For example, if |
query |
| string | No | A filter expression in OData v4 format |
query |
| string | No | An order by expression in OData v4 format |
query |
| boolean | No | Hydrates-related nested objects when returning a result (For example, populate a menu with menu categories and menu groups) |
query |
| boolean | No | Include the mappings for the document in the response |
query |
| [ string ] | No | Specify |
query |
| boolean | No | Includes documents that are inactive for current sites |
Responses
Code | Description | Schema |
|---|---|---|
200 | Success | |
400 | Bad request, for more information look at body error | |
403 | Invalid token | |
404 | Not Found | |
422 | Unprocessable error | |
default | Unexpected Error |
GET /recipe-venue/current
Summary
Gets a list of currently effective active recipe venue entities for the specified sites as of the given effective_date:
effective_date=2099-11-18T19:04:58.124Z
To narrow the list to specific entity_ids:
?effective_date=2099-11-18T19:04:58.124Z&entity_ids=['578e98111fa261f4867bdf12','231e98111fa261f4867bdf08']
To include the audit fields:
?include_audit=true
To include the inactive documents:
?include_inactive=true
To populate nested entities:
?include_nested=true
To populate only specified nested entities:
?include_entities="menu-category","menu-item-group"
Other filters can be applied against the entity documents by using the $filter parameter
Request Parameters
In | Field Name | Type | Required | Description |
|---|---|---|---|---|
header |
| string | Yes | The identifier of the company to manage data for |
header |
| [ string ] | No | The unique identifiers (UIDs) of the site to manage data for |
query |
| string | No | A filter expression in OData v4 format |
query |
| integer | No | The maximum documents to return. For example, if |
query |
| integer | No | The documents to skip before returning. For example, if |
query |
| string | No | An order by expression in OData v4 format |
query |
| string | Yes | The date and time to query against. If the entity is updated on a specific date, then specifying an |
query |
| [ string ] | No | An array of entity identifiers |
query |
| boolean | No | Hydrates-related nested objects when returning a result (For example, populate a menu with menu categories and menu groups) |
query |
| boolean | No | Include the mappings for the document in the response |
query |
| [ string ] | No | Specifies entity types for which mappings are presented as a part of the response (For example, |
query |
| [ string ] | No | Specifies |
query |
| boolean | No | Adds audit fields to each document when returning a result ( |
query |
| boolean | No | Includes the documents that are inactive for the current sites |
Responses
Code | Description | Schema |
|---|---|---|
200 | Success | |
400 | Bad request, for more information look at body error | |
403 | Invalid token | |
404 | Not Found | |
422 | Unprocessable error | |
default | Unexpected Error |
GET /recipe-venue/list
Summary
Gets a list of currently effective active recipe venue entities for the specified sites as of the given effective_date:
effective_date=2099-11-18T19:04:58.124Z
To narrow the list to specific entity_ids:
?effective_date=2099-11-18T19:04:58.124Z&entity_ids=['578e98111fa261f4867bdf12','231e98111fa261f4867bdf08']
To include the audit fields:
?include_audit=true
To include the inactive documents:
?include_inactive=true
To populate nested entities:
?include_nested=true
To populate only specified nested entities:
?include_entities="menu-category","menu-item-group"
Other filters can be applied against the entity documents by using the $filter parameter
Request Parameters
In | Field Name | Type | Required | Description |
|---|---|---|---|---|
header |
| string | Yes | The identifier of the company to manage data for |
header |
| [ string ] | No | The unique identifiers (UIDs) of the site to manage data for |
query |
| string | No | A filter expression in OData v4 format |
query |
| integer | No | The maximum documents to return. For example, if |
query |
| integer | No | The documents to skip before returning. For example, if |
query |
| string | No | An order by expression in OData v4 format |
query |
| string | Yes | The date and time to query against. If the entity is updated on a specific date, then specifying an |
query |
| [ string ] | No | An array of entity identifiers |
query |
| boolean | No | Hydrates-related nested objects when returning a result (For example, populate a menu with menu categories and menu groups) |
query |
| [ string ] | No | Specifies |
query |
| boolean | No | Adds audit fields to each document when returning a result ( |
query |
| boolean | No | Includes the documents that are inactive for the current sites |
query |
| [ string ] | No | Specifies entity types for which mappings are presented as a part of the response (For example, |
Responses
Code | Description | Schema |
|---|---|---|
200 | Success | |
400 | Bad request, for more information look at body error | |
403 | Invalid token | |
404 | Not Found | |
422 | Unprocessable error | |
default | Unexpected Error |
POST /recipe-venue
Summary
Adds a new recipe venue.
Request Parameters
In | Field Name | Type | Required | Description |
|---|---|---|---|---|
header |
| string | Yes | The identifier of the company to manage data for |
query |
| boolean | No | Hydrates-related nested objects when returning a result (For example, populate a menu with menu categories and menu groups) |
query |
| [ string ] | No | Specifies |
body |
| Yes | The JSON formatted request |
Responses
Code | Description | Schema |
|---|---|---|
200 | Success | |
400 | Bad request, for more information look at body error | |
403 | Invalid token | |
404 | Not Found | |
422 | Unprocessable error | |
default | Unexpected Error |
POST /recipe-venue/entity/<entity_id>
Summary
Creates/Updates recipe venues.
Request Parameters
In | Field Name | Type | Required | Description |
|---|---|---|---|---|
header |
| string | Yes | The identifier of the company to manage data for |
path |
| string | Yes | The identifier of the entity |
body |
| Yes | The JSON formatted request |
Responses
Code | Description | Schema |
|---|---|---|
200 | Success | [ recipe_venue ] |
400 | Bad request, for more information look at body error | |
403 | Invalid token | |
404 | Not Found | |
422 | Unprocessable error | |
default | Unexpected Error |
DELETE /recipe-venue/entity/<entity_id>
Summary
Deletes an entity and all versions of the entity.
Request Parameters
In | Field Name | Type | Required | Description |
|---|---|---|---|---|
header |
| string | Yes | The identifier of the company to manage data for |
path |
| string | Yes | The identifier of the entity |
Responses
Code | Description | Schema |
|---|---|---|
200 | Success | |
400 | Bad request, for more information look at body error | |
403 | Invalid token | |
404 | Not Found | |
422 | Unprocessable error | |
default | Unexpected Error |
POST /recipe-venue/updateEntitiesWithDependencies
Summary
Creates/Updates recipe venues with the mappings.
Request Parameters
In | Field Name | Type | Required | Description |
|---|---|---|---|---|
header |
| string | Yes | The identifier of the company to manage data for |
header |
| [ string ] | No | The unique identifiers (UIDs) of the site to manage data for |
body |
| Yes | Supports the mappings field (array/boolean) for each document. With mappings: True mappings are created for the current date and sites from the |
Responses
Code | Description | Schema |
|---|---|---|
200 | Success | |
400 | Bad request, for more information look at body error | |
403 | Invalid token | |
404 | Not Found | |
422 | Unprocessable error | |
default | Unexpected Error |
GET /recipe-venue/document/<_id>
Summary
Gets one recipe venue by a specific document identifier.
Request Parameters
In | Field Name | Type | Required | Description |
|---|---|---|---|---|
header |
| string | Yes | The identifier of the company to manage data for |
path |
| string | Yes | The identifier of the document |
query |
| boolean | No | Hydrates-related nested objects when returning a result (For example, populate a menu with menu categories and menu groups) |
query |
| [ string ] | No | Specifies |
query |
| [ string ] | No | Specifies entity types for which mappings are presented as a part of the response (For example, |
Responses
Code | Description | Schema |
|---|---|---|
200 | Success | |
400 | Bad request, for more information look at body error | |
403 | Invalid token | |
404 | Not Found | |
422 | Unprocessable error | |
default | Unexpected Error |
PATCH /recipe-venue/document/<_id>
Summary
Partially updates a recipe venue.
Request Parameters
In | Field Name | Type | Required | Description |
|---|---|---|---|---|
header |
| string | Yes | The identifier of the company to manage data for |
path |
| string | Yes | The identifier of the document |
query |
| boolean | No | Hydrates-related nested objects when returning a result (For example, populate a menu with menu categories and menu groups) |
query |
| [ string ] | No | Specifies |
body | body | No | The JSON of the category being patched |
Responses
Code | Description | Schema |
|---|---|---|
200 | Success | |
400 | Bad request, for more information look at body error | |
403 | Invalid token | |
404 | Not Found | |
422 | Unprocessable error | |
default | Unexpected Error |
DELETE /recipe-venue/document/<_id>
Summary
Deletes a recipe venue.
Request Parameters
In | Field Name | Type | Required | Description |
|---|---|---|---|---|
header |
| string | Yes | The identifier of the company to manage data for |
path |
| string | Yes | The identifier of the document |
Responses
Code | Description | Schema |
|---|---|---|
200 | Success | |
400 | Bad request, for more information look at body error | |
403 | Invalid token | |
404 | Not Found | |
422 | Unprocessable error | |
default | Unexpected Error |
POST /recipe-venue/documents/dependencies
Summary
Checks for document dependencies.
Request Parameters
In | Field Name | Type | Required | Description |
|---|---|---|---|---|
header |
| string | Yes | The identifier of the company to manage data for |
body | body | [ recipe_venue ] | Yes | The JSON formatted request |
Responses
Code | Description | Schema |
|---|---|---|
200 | Success | |
400 | Bad request, for more information look at body error | |
403 | Invalid token | |
404 | Not Found | |
422 | Unprocessable error | |
default | Unexpected Error |
GET /recipe-venue/mapping/entity/<entity_id>
Summary
Gets a list of recipe venue mappings for specified sites.
Request Parameters
In | Field Name | Type | Required | Description |
|---|---|---|---|---|
header |
| string | Yes | The identifier of the company to manage data for |
header |
| [ string ] | No | The unique identifiers (UIDs) of the site to manage data for |
path |
| string | Yes | The identifier of the entity |
query |
| integer | No | The maximum documents to return. For example, if |
query |
| integer | No | The documents to skip before returning; for example, if |
query |
| string | No | A filter expression in OData v4 format |
query |
| string | No | An order by expression in OData v4 format |
query |
| boolean | No | Includes the documents that inactive for the current sites |
Responses
Code | Description | Schema |
|---|---|---|
200 | Success | mapping_list_response |
400 | Bad request, for more information look at body error | |
403 | Invalid token | |
404 | Not Found | |
422 | Unprocessable error | |
default | Unexpected Error |
POST /recipe-venue/mapping/entity/<entity_id>
Summary
Creates the list of recipe venue mappings for an entity and sites.
Request Parameters
In | Field Name | Type | Required | Description |
|---|---|---|---|---|
header |
| string | Yes | The identifier of the company to manage data for |
header |
| [ string ] | No | The unique identifiers (UIDs) of the site to manage data for |
path |
| string | Yes | The identifier of the entity |
body |
| mappings_update-request | Yes | The array of the inventory item venue mappings being added |
Responses
Code | Description | Schema |
|---|---|---|
200 | Success | mapping_list_response |
400 | Bad request, for more information look at body error | |
403 | Invalid token | |
404 | Not Found | |
422 | Unprocessable error | |
default | Unexpected Error |
POST /recipe-venue/mapping
Summary
Adds a new recipe venue mapping.
Request Parameters
In | Field Name | Type | Required | Description |
|---|---|---|---|---|
header |
| string | Yes | The identifier of the company to manage data for |
body |
| [ mapping_create_request ] | Yes | The JSON of the recipe venue mapping being added |
Responses
Code | Description | Schema |
|---|---|---|
200 | Success | mapping_list_response |
400 | Bad request, for more information look at body error | |
403 | Invalid token | |
404 | Not Found | |
422 | Unprocessable error | |
default | Unexpected Error |
Data Models
recipe_venue
Field Name | Type | Required | Description |
|---|---|---|---|
| string | Yes | |
| string | Yes | |
| string | No | |
| boolean | No | |
| [ object ] | No | |
| [ object ] | No | |
| [ object_id ] | No | |
| [ object ] | No | |
| object | No | |
| string, object | No | The inventory item that users count during stand worksheet operations. |
| No | ||
| No | ||
| No | ||
| No | ||
| No | ||
| No | ||
| No | ||
| No | ||
| No | ||
| No |
recipe_venue_create
Field Name | Type | Required | Description |
|---|---|---|---|
| string | Yes | |
| string | Yes | |
| string | No | |
| boolean | No | |
| [ object ] | No | |
| [ object ] | No | |
| [ | No | |
| [ object ] | No | |
| object | No | |
| string, object | No | The inventory item that users count during stand worksheet operations |
| No | ||
| No |
recipe_venue_edit
Field Name | Type | Description |
|---|---|---|
| string | |
| string | |
| string | |
| boolean | |
| [ object ] | |
| [ object ] | |
| [ | |
| [ object ] | |
| object | |
| string,object | The inventory item that users count during stand worksheet operations |
|
recipe_venue_list
Field Name | Type | Description |
|---|---|---|
| integer | |
| [ recipe_venue ] |
name
Field Name | Type | Description |
|---|---|---|
| string |
code
Select the international code of the currency according to ISO 4217.
Field Name | Type | Description |
|---|---|---|
| string | Select the international code of the currency according to ISO 4217 |
product
The Product JSON schema for validation create.
Field Name | Type | Required | Description |
|---|---|---|---|
| string | Yes | The default name of the product |
| string | Yes | The unique identifier (UID) of the product |
| string | No | The caption that is displayed on the button in the menu. A maximum of five (5) lines with 255 characters is allowed. |
| string | Yes | The type of product. The possible values are "standard," "modifier," "comment," "placeholder," "modifier_placeholder," "gift_card," "gift_certificate," "fee," or "retail_item." |
| string | No | The product type. The possible values are "product," "modifier," "comment," "placeholder," "modifier_placeholder," "gift_card," "gift_certificate," "fee," or "retail_item." |
| string | No | |
| boolean | No | Decides if the product affects the item count |
| integer | No | Determines the value that the item will be counted when added to an order |
| integer | No | Defines the number of guests that are associated with an order when the product has been added |
| object | No | |
| string | No | |
| string | No | |
| string | No | |
| boolean | Yes | Determines if the user is prompted for a price when adding to the order |
| boolean | No | Enables the product to be a bundle |
| [ string, object ] | No | An array of |
| [ string, object ] | No | The categories that the product is routed to |
| string, object | No | The selection of the base modifier collection for the product |
| string | No | Allows overriding the "Display Modifier Menu on Item Add" option in the preferences for the current product. The possible values are "use_company_preference," "when_product_is_added_to_order," or "do_not_display_automatically." |
| [ object ] | No | |
| string, object | No | The group of tax rates to be applied on an order |
| number (currency) | No | The default cost of the product |
| integer | No | Allows the user to set the size for each unit for the price that will be configured |
| string | No | Allows the user to select the type of the unit that makes up the item. The possible values are "none," "pack," "each," "case," "bottle," "can," "gallon," "quart," "milliliter," "liter," "pound", "ounce," "gram," or "kilograms." |
| boolean | No | Whether or not this modifier always prints in red (overrides the modifier group setting) |
| boolean | No | Whether or not this modifier is included by default in a build |
| boolean | No | Whether or not this modifier allows changing quantities |
| number | No | The possible values are 1, 0.5, 0.33333, or 0.25 |
| object | No | |
| object | No | |
| object | No | |
| string, object | No | The preferred term used by the system when referencing the bundle item. Default is "Combo." The maximum is 20 characters. |
| boolean | No | Decides if the user will be prompted to confirm combining order item components into a bundle, when the bundle components are added to the order separately |
| string | No | Allows overriding the "Advance on Component Fulfillment" option in the preferences for the current product. The possible values are "use_company_preference," "on_final_component_choice," "do_not_automatically_advance." |
| boolean | No | Determines if the bundle will get changed based on the size of the components added |
| boolean | No | |
| [ string ] | No | Category identifiers provided by IRIS/EDM that are not exposed to the Data Management (DM) user interface (UI) |
| [ string ] | No | The external tag identifiers |
| [ object ] | No | An array of product related images |
| [ object ] | No | The nutrition values for the product |
| [ object ] | No | The allergens presence information |
| [ string, object ] | No | An array of product category entity identifiers |
| [ string, object ] | No | The tags that are currently added to the product |
| boolean | No | Determines if the user is prompted to enter the quantity when adding to the order |
| string | No | Determines how the product is routed to the kitchen. The possible values are "by_category" or "by_destination" |
| string, object | No | The order destination entity identifier |
| [ object ] | No | An array of objects with |
| string | No | The optimized shorter name for kitchen printing and video |
| string, object | No | The priority in which this modifier displays in relation to other modifiers in the kitchen displays |
| string | No | The preparation instructions field |
| [ string ] | No | The images for preparation Instruction |
| [ string, object ] | No | An array of tag entity identifiers |
| [ string ] | No | Allows the user to add the product to an order using the added price look ups (PLUs) |
| boolean | No | Flags if the product is a liability item such as a gift card |
| object | No | |
| boolean | No | Prevents the product from being added to an order through product look up in the ordering application |
| [ string, object ] | No | An array of restricted order source entity identifiers |
| [ string ] | No | An array of restricted Order Source identifiers |
| [ string, object ] | No | An array of allowed Order Source entity identifiers |
| [ string ] | No | An array of allowed Order Source identifiers |
| boolean | No | Flags if the product "Is Restrict Availability by Order Source" or not |
| string | No | The primary product name for use with voice ordering |
| string | No | Defines a detailed description of the voice ordering for the product |
| string | No | The typical pronunciations of the product name or alternate names for the product (comma separated) |
| boolean | No | Enables time-based pricing logic |
| [ string ] | No | Identifiers that are used to reference the product from the external systems |
| boolean | No | Defines whether new prices for the item are tax inclusive or not |
| string | No | Defines whether the price for the item should be rolled up to a parent product price after tax calculation, before tax calculation, or should not be rolled up. The possible values are "do_not_roll_up," "after_tax," or "before_tax." |
| [ object ] | No | Contains names and identifiers for every changed section in a site specific document |
| object | No | |
| [ object ] | No | The list of product ingredients |
| string, object | No | The Revenue General Ledger Account (GLA) for the product. |
| string | No | Determine how the product is displayed on the menu in suite catering. The possible values are "half_size" or "full_size" |
| [ object ] | No | |
| No | ||
| No | ||
| No | ||
| No | ||
| No | ||
| No | ||
| No | ||
| No | ||
| No | ||
| No |
_id
The auto-assigned system document identifier.
Field Name | Type | Description |
|---|---|---|
| string | The auto-assigned system document identifier |
company_id
The identifier of the company who owns the document.
Field Name | Type | Description |
|---|---|---|
| string | The identifier of the company that owns the document |
entity_id
The auto-assigned unique identifier (UID) of the entity, set on creation. All future versions of the entity share the same entity_id.
Field Name | Type | Description |
|---|---|---|
| string | The auto-assigned UID of the entity, set on creation. All future versions of the entity share the same |
is_master
Field Name | Type | Description |
|---|---|---|
| boolean |
is_active
Marking property is the essence of active documents. Sets in true by default.
Field Name | Type | Description |
|---|---|---|
| boolean | Marking property is the essence of active documents. Sets in true by default. |
external_id
Field Name | Type | Description |
|---|---|---|
| string |
created_by
The identifier of the OPRA user or site that created the document.
Field Name | Type | Description |
|---|---|---|
| string | The identifier of the OPRA user or site that created the document |
updated_by
The identifier of the OPRA user or site that last updated the document.
Name | Type | Description |
|---|---|---|
| string | The identifier of the OPRA user or site that last updated the document |
created_at
The last date and time the document was updated.
Field Name | Type | Description |
|---|---|---|
| string | The last date and time the document was updated |
updated_at
The last date and time the document was updated.
Field Name | Type | Description |
|---|---|---|
| string | The last date and time the document was updated |