Inventory Item Venue

Security

jwt-bearer-token

apiKey	API Key
Name	Authorization
In	header

Endpoints

GET /inventory-item-venue/master

Summary

Gets a master list of inventory item venue entities regardless of the site.

Request Parameters

In	Field Name	Type	Required	Description
header	`X-COMPANY-ID`	string	Yes	The identifier of the company to manage data for
query	`$top`	integer	No	The maximum documents to return. For example, if `top` is 100, and `skip` is 0, the system returns documents 1 to 100.
query	`$skip`	integer	No	The documents to skip before returning. For example, if `top` is 100, and `skip` is 100, the system returns documents 101 to 200.
query	`$filter`	string	No	A filter expression in OData v4 format
query	`$orderby`	string	No	An order by expression in OData v4 format
query	`include_nested`	boolean	No	Hydrates-related nested objects when returning a result (For example, populate a menu with menu categories and menu groups)
query	`include_mappings`	boolean	No	Include the mappings for the document in the response
query	`include_entities`	[ string ]	No	Specifies `entity_types` to be populated by nesting mechanism (For example, `include_entities`=['menu-category'] for menu call - populate a menu with menu categories)
query	`include_inactive`	boolean	No	Includes the documents that are inactive for the current sites

Responses

Code	Description	Schema
200	Success	inventory_item_venue_list
400	Bad request, for more information look at body error
403	Invalid token
404	Not Found
422	Unprocessable error
default	Unexpected Error

GET /inventory-item-venue/current

Summary

Gets a list of currently effective active inventory item 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	`X-COMPANY-ID`	string	Yes	The identifier of the company to manage data for
header	`X-SITE-IDs`	[ string ]	No	The unique identifiers (UIDs) of the site to manage data for
query	`$filter`	string	No	A filter expression in OData v4 format
query	`$top`	int32	No	The maximum documents to return. For example, if `top` is 100 and `skip` is 0, the system returns documents 1 to 100.
query	`$skip`	int32	No	The documents to skip before returning. For example, if `top` is 100, and `skip` is 100, the system returns documents 101 to 200.
query	`$orderby`	string	No	An order by expression in OData v4 format
query	`effective_date`	string	Yes	The date and time to query against. If the entity is updated on a specific date, then specifying an `effective_date` prior to that date returns a previous version of the entity.
query	`entity_ids`	[ string ]	No	An array of entity identifiers
query	`include_nested`	boolean	No	Hydrates-related nested objects when returning a result (For example, populate a menu with menu categories and menu groups)
query	`include_mappings`	boolean	No	Include the mappings for the document in the response
query	`include_mappings_for_entities`	[ string ]	No	Specifies entity types for which mappings are presented as a part of the response (For example, `include_mappings_for_entities_param`=&.
query	`include_entities`	[ string ]	No	Specifies `entity_types` to be populated by nesting mechanism (For example, `include_entities`=['menu-category'] for menu call - populate a menu with menu categories)
query	`include_audit`	boolean	No	Adds audit fields to each document when returning a result (`is_active, is_master, created_at, created_by, updated_at, updated_by`)
query	`include_inactive`	boolean	No	Includes the documents that are inactive for the current sites

Responses

Code	Description	Schema
200	Success	inventory_item_venue_list
400	Bad request, for more information look at body error
403	Invalid token
404	Not Found
422	Unprocessable error
default	Unexpected Error

GET /inventory-item-venue/list

Summary

Gets a list of currently effective active inventory item 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	`X-COMPANY-ID`	string	Yes	The identifier of the company to manage data for
header	`X-SITE-IDs`	[ string ]	No	The unique identifiers (UIDs) of the site to manage data for
query	`$filter`	string	No	A filter expression in OData v4 format
query	`$top`	integer	No	The maximum documents to return. For example, if `top`is 100, and `skip` is 0, the system returns documents 1 to 100.
query	`$skip`	integer	No	The documents to skip before returning; for example, if `top` is 100, and `skip` is 100, the system returns documents 101 to 200.
query	`$orderby`	string	No	An order by expression in OData v4 format
query	`effective_date`	string	Yes	The date and time to query against. If the entity is updated on a specific date, then specifying an `effective_date` prior to that date returns a previous version of the entity.
query	`entity_ids`	[ string ]	No	An array of entity identifiers
query	`include_nested`	boolean	No	Hydrates-related nested objects when returning a result (For example, populate a menu with menu categories and menu groups)
query	`include_entities`	[ string ]	No	Specifies `entity_types` to be populated by nesting mechanism (For example, `include_entities`=['menu-category'] for menu call - populate a menu with menu categories)
query	`include_audit`	boolean	No	Adds audit fields to each document when returning a result (`is_active, is_master, created_at, created_by, updated_at, updated_by`)
query	`include_inactive`	boolean	No	Includes the documents that are inactive for the current sites
query	`include_mappings_for_entities`	[ string ]	No	Specifies entity types for which mappings are presented as a part of the response (For example, `include_mappings_for_entities_param`=&.

Responses

Code	Description	Schema
200	Success	inventory_item_venue_list
400	Bad request, for more information look at body error
403	Invalid token
404	Not Found
422	Unprocessable error
default	Unexpected Error

POST /inventory-item-venue

Summary

Adds a new inventory item venue.

Request Parameters

In	Field Name	Type	Required	Description
header	`X-COMPANY-ID`	string	Yes	The identifier of the company to manage data for
query	`include_nested`	boolean	No	Hydrates-related nested objects when returning a result (For example, populate a menu with menu categories and menu groups)
query	`include_entities`	[ string ]	No	Specifies `entity_types` to be populated by nesting mechanism (i.e. `include_entities`=['menu-category'] for menu call - populate a menu with menu categories)
body	`body`	inventory_item_venue_create	Yes	The JSON formatted request

Responses

Code	Description	Schema
200	Success	inventory_item_venue
400	Bad request, for more information look at body error
403	Invalid token
404	Not Found
422	Unprocessable error
default	Unexpected Error

POST /inventory-item-venue/entity/<entity_id>

Summary

Creates/Updates inventory item venues.

Request Parameters

In	Field Name	Type	Required	Description
header	`X-COMPANY-ID`	string	Yes	The identifier of the company to manage data for
path	`entity_id`	string	Yes	The identifier of the entity
body	`body`	inventory_item_venue_create	Yes	The JSON formatted request

Responses

Code	Description	Schema
200	Success	inventory_item_venue
400	Bad request, for more information look at body error
403	Invalid token
404	Not Found
422	Unprocessable error
default	Unexpected Error

DELETE /inventory-item-venue/entity/<entity_id>

Summary

Deletes an entity and all versions of it.

Request Parameters

In	Field Name	Type	Required	Description
header	`X-COMPANY-ID`	string	Yes	The identifier of the company to manage data for
path	`entity_id`	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 /inventory-item-venue/updateEntitiesWithDependencies

Summary

Creates/Updates inventory item venues with the mappings.

Request Parameters

In	Field Name	Type	Required	Description
header	`X-COMPANY-ID`	string	Yes	The identifier of the company to manage data for
header	`X-SITE-IDs`	[ string ]	No	The unique identifiers (UIDs) of the site to manage data for
body	`body`	[ inventory_item_venue_create ]	Yes	Supports the mappings field (array/boolean) for each document. With mappings: True mappings are created for the current date and sites from the `X-SITE-IDs` header.

Responses

Code	Description	Schema
200	Success	inventory_item_venue_list
400	Bad request, for more information look at body error
403	Invalid token
404	Not Found
422	Unprocessable error
default	Unexpected Error

GET /inventory-item-venue/document/<_id>

Summary

Gets one inventory item venue by a specific document identifier.

Request Parameters

In	Field Name	Type	Required	Description
header	`X-COMPANY-ID`	string	Yes	The identifier of the company to manage data for
path	`_id`	string	Yes	The identifier of the document
query	`include_nested`	boolean	No	Hydrates-related nested objects when returning a result (For example, populate a menu with menu categories and menu groups)
query	`include_entities`	[ string ]	No	Specifies `entity_types` to be populated by nesting mechanism (For example, `include_entities`=['menu-category'] for menu call - populate a menu with menu categories)
query	`include_mappings_for_entities`	[ string ]	No	Specifies entity types for which mappings are presented as a part of the response (For example, `include_mappings_for_entities_param`=&.

Responses

Code	Description	Schema
200	Success	inventory_item_venue
400	Bad request, for more information look at body error
403	Invalid token
404	Not Found
422	Unprocessable error
default	Unexpected Error

PATCH /inventory-item-venue/document/<_id>

Summary

Partially updates an inventory item venue.

Request Parameters

In	Field Name	Type	Required	Description
header	`X-COMPANY-ID`	string	Yes	The identifier of the company to manage data for
path	`_id`	string	Yes	The identifier of the document
query	`include_nested`	boolean	No	Hydrates-related nested objects when returning a result (For example, populate a menu with menu categories and menu groups)
query	`include_entities`	[ string ]	No	Specifies `entity_types` to be populated by nesting mechanism (For example, `include_entities`=['menu-category'] for menu call - populate a menu with menu categories)
body	body	inventory_item_venue_edit	Yes	The JSON of the category being patched

Responses

Code	Description	Schema
200	Success	inventory_item_venue_edit
400	Bad request, for more information look at body error
403	Invalid token
404	Not Found
422	Unprocessable error
default	Unexpected Error

DELETE /inventory-item-venue/document/<_id>

Summary

Deletes an inventory item venue.

Request Parameters

In	Field Name	Type	Required	Description
header	`X-COMPANY-ID`	string	Yes	The identifier of the company to manage data for
path	`_id`	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 /inventory-item-venue/documents/dependencies

Summary

Checks for document dependencies.

Request Parameters

In	Field Name	Type	Required	Description
header	`X-COMPANY-ID`	string	Yes	The identifier of the company to manage data for
body	body	[ inventory_item_venue ]	Yes	The JSON formatted request

Responses

Code	Description	Schema
200	Success	inventory_item_venue_list
400	Bad request, for more information look at body error
403	Invalid token
404	Not Found
422	Unprocessable error
default	Unexpected Error

GET /inventory-item-venue/mapping/entity/<entity_id>

Summary

Gets a list of inventory item venue mappings for specified sites.

Request Parameters

In	Field Name	Type	Required	Description
header	`X-COMPANY-ID`	string	Yes	The identifier of the company to manage data for
header	`X-SITE-IDs`	[ string ]	No	The unique identifiers (UIDs) of the site to manage data for
path	`entity_id`	string	Yes	The identifier of the entity
query	`$top`	integer	No	The maximum documents to return. For example, if `top` is 100, and `skip` is 0, the system returns documents 1 to 100.
query	`$skip`	integer	No	The documents to skip before returning. For example, if `top` is 100, and `skip` is 100, the system returns documents 101 to 200.
query	`$filter`	string	No	A filter expression in OData v4 format
query	`$orderby`	string	No	An order by expression in OData v4 format
query	`include_inactive`	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 /inventory-item-venue/mapping/entity/<entity_id>

Summary

Creates the list of inventory item venue mappings for an entity and sites.

Request Parameters

In	Field Name	Type	Required	Description
header	`X-COMPANY-ID`	string	Yes	The identifier of the company to manage data for
header	`X-SITE-IDs`	[ string ]	No	The unique identifier (UIDs) of the site to manage data for
path	`entity_id`	string	Yes	The identifier of the entity
body	`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 /inventory-item-venue/mapping

Summary

Adds a new inventory item venue mapping.

Request Parameters

In	Field Name	Type	Required	Description
header	`X-COMPANY-ID`	string	Yes	The identifier of the company to manage data for
body	`body`	[ mapping_create_request ]	Yes	The JSON of the inventory item 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

inventory_item_venue

inventory_item_venue_create

inventory_item_venue_edit

inventory_item_venue_list