Skip to main content

Bundle Component

GET /bundle-component/current

GET /bundle-component/list

GET /bundle-component/document/<_id>

GET /bundle-component/mapping/entity/<entity_id>

Data Models

Endpoints

GET /bundle-component/current

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

[ csv of 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

query

$skip

int32

No

The documents to skip before returning

query

$orderby

string

No

An order by expression in OData v4 format

query

effective_date

string

Yes

The date and time to query against

query

entity_ids

[ string ]

No

An array of entity identifiers

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

Response Codes

Response

Description

200 OK

Success

400 Bad Request

Bad request, for more information look at body error

403 Forbidden

Invalid token

404 Not Found

Not found

422 Unprocessable Entity

Unprocessable error

Default

Unexpected error

GET /bundle-component/list

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

[ csv of 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

query

$skip

int32

No

The documents to skip before returning

query

$orderby

string

No

An order by expression in OData v4 format

query

effective_date

string

Yes

The date and time to query against

query

entity_ids

[ string ]

No

An array of entity identifiers

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

Response Codes

Response

Description

200 OK

Success

400 Bad Request

Bad request, for more information look at body error

403 Forbidden

Invalid token

404 Not Found

Not found

422 Unprocessable Entity

Unprocessable error

Default

Unexpected error

GET /bundle-component/document/<_id>

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

Response Codes

Response

Description

200 OK

Success

400 Bad Request

Bad request, for more information look at body error

403 Forbidden

Invalid token

404 Not Found

Not found

422 Unprocessable Entity

Unprocessable error

Default

Unexpected error

GET /bundle-component/mapping/entity/<entity_id>

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

[ csv of 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

int32

No

The maximum documents to return

query

$skip

int32

No

The documents to skip before returning

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 are inactive for the current sites

Response Codes

Response

Description

200 OK

Success

400 Bad Request

Bad request, for more information look at body error

403 Forbidden

Invalid token

404 Not Found

Not found

422 Unprocessable Entity

Unprocessable error

Default

Unexpected error

Data Models

bundle_component

bundle_component_create

bundle_component_edit

bundle_component_list

bundle_component_price

bundle_component_price_create

bundle_component_price_edit

bundle_component_price_list

bundle_components_entity_ids

name

_id

company_id

entity_id

is_master

is_active

external_id

created_by

updated_by

created_at

updated_at

bundle_component

Stores the definition of a bundle component.

Field Name

Type

Required

Description

name

string

Yes

The name of the bundle component

description

string

No

The description of the bundle component

is_enabled

boolean

No

Decides if the component is available for the bundle

main_item

boolean

No

Decides if the component is the main item for the bundle

component_type

string

No

The type of bundle component. The possible values are "group" (default) or "item."

offer_question

string

No

The message that displays on Ordering application

sort_order

integer

No

The order the component appears in

minimum_quantity

integer

No

The minimum quantity of the component. Default is 1

default_quantity

integer

No

The default quantity of this component. Default is 1

maximum_quantity

integer

No

The maximum quantity of the component. Default is 1

choice_label

string

No

An optional label for the on-screen product choices

product_choices_entity_ids

[ string, object ]

No

The available choices for the component

product_choices_entity_ids_info

object

No

Additional information about added products. The keys are Product Entity IDs.

disabled_product_choices_entity_ids

[ string, object ]

No

The available disabled choices for the component

default_products

[ object ]

No

The products to be used as defaults

pricing_change_action

string

Yes

The type of price change to apply. The possible values are "off" (default), "replace", or "adjust."

allowed_destination_entity_ids

[ string, object ]

Yes

Choose the destinations where the component is available.

allowed_order_source_entity_ids

[ string, object ]

No

An array of allowed Order Source entity identifiers

allowed_order_source_ids

[ string ]

No

An array of allowed Order Source identifiers

is_template

boolean

No

Identifies if the current document is the Bundle Template

template_entity_id

string, object

No

A reference by the entity identifier to the template from which the current bundle component was created

select_items_using

string

No

The possible values are "items," "tags," "both," or "menu_category"

menu_category_entity_id

string, object

No

The unique identifier of the menu category

tag_entity_ids

[ string, object ]

No

An array of allowed tag entity identifiers

_id

_id

No

company_id

company_id

No

entity_id

entity_id

No

is_master

is_master

No

is_active

is_active

No

external_id

external_id

No

created_by

created_by

No

updated_by

updated_by

No

created_at

created_at

No

updated_at

updated_at

No

bundle_component_create

Stores the definition of a bundle component.

Field Name

Type

Required

Description

name

string

Yes

The name of the bundle component

description

string

No

The description of the bundle component

is_enabled

boolean

No

Decides if the component is available for the bundle

main_item

boolean

No

Decides if the component is main item for the bundle

component_type

string

No

The type of bundle component. The possible values are "group" (default) or "item."

offer_question

string

No

The message that displays on the Ordering application

sort_order

integer

No

The order the component appears in

minimum_quantity

integer

No

The minimum quantity of the component. Default is 1

default_quantity

integer

No

The default quantity of the component. Default is 1

maximum_quantity

integer

No

The maximum quantity of the component. Default is 1

choice_label

string

No

An optional label for the on-screen product choices

product_choices_entity_ids

[ string, object ]

No

The available choices for the component

product_choices_entity_ids_info

object

No

Additional information about added products. The keys are product entity identifiers.

disabled_product_choices_entity_ids

[ string, object ]

No

The available disabled choices for the component

default_products

[ object ]

No

The products to be used as defaults

pricing_change_action

string

Yes

The type of price change to apply. The possible values are "off" (default), "replace," or "adjust."

allowed_destination_entity_ids

[ string, object ]

Yes

Choose the destinations where the component is available.

allowed_order_source_entity_ids

[ string, object ]

No

An array of allowed Order Source entity identifiers

allowed_order_source_ids

[ string ]

No

An array of allowed Order Source identifiers

is_template

boolean

No

Identifies if the current document is the Bundle Template

template_entity_id

string, object

No

A reference by the entity identifier to the template from which the current bundle component was created

select_items_using

string

No

The possible values are "items," "tags," "both," or "menu_category"

menu_category_entity_id

string, object

No

The unique identifier of the menu category

tag_entity_ids

[ string, object ]

No

An array of allowed tag entity identifiers

entity_id

entity_id

No

The auto-assigned unique identifier (UID) of the entity, set on creation. All future versions of the entity share the same entity_id.

external_id

external_id

No

bundle_component_edit

Stores the definition of a bundle component.

Field Name

Type

Description

name

string

The name of the bundle component

description

string

The description of the bundle component

is_enabled

boolean

Decides if the component is available for the bundle

main_item

boolean

Decides if the component is the main for the bundle

component_type

string

The type of bundle component. The possible values are "group" (default) or "item."

offer_question

string

This is the message that displays on Ordering application

sort_order

integer

The order the component appears in

minimum_quantity

integer

The minimum quantity of the component. Default is 1

default_quantity

integer

The default quantity of the component. Default is 1

maximum_quantity

integer

The maximum quantity of the component. Default is 1

choice_label

string

An optional label for the on-screen product choices

product_choices_entity_ids

[ string, object ]

The available choices for the component

product_choices_entity_ids_info

object

Additional information about added products. The keys are product entity identifiers

disabled_product_choices_entity_ids

[ string, object ]

The available disabled choices for this component

default_products

[ object ]

The products to be used as defaults

pricing_change_action

string

The type of price change to apply. The possible values are "off" (default), "replace," or "adjust."

allowed_destination_entity_ids

[ string, object ]

Choose the destinations where the component is available

allowed_order_source_entity_ids

[ string, object ]

An array of allowed Order Source entity identifiers

allowed_order_source_ids

[ string ]

An array of allowed Order Source identifiers

is_template

boolean

Identifies if current document is the Bundle Template

template_entity_id

string, object

A reference by the entity identifier to the template from which current the bundle component was created

select_items_using

string

The possible values are "items," "tags," "both," or "menu_category"

menu_category_entity_id

string, object

The unique entity identifier (UID) of the menu category

tag_entity_ids

[ string, object ]

An array of allowed tag entity identifiers

external_id

external_id

bundle_component_list

Field Name

Type

Description

total

integer

items

 bundle_component

bundle_component_price

Bundle Component Price request creates validation JSON-schema.

Field Name

Type

Required

Description

bundle_component_entity_id

string, object

Yes

unit_price

number (currency)

Yes

tags

[ string ]

No

time_period_entity_ids

[ string, object ]

Yes

_id

_id

No

company_id

company_id

No

entity_id

entity_id

No

is_master

is_master

No

is_active

is_active

No

external_id

external_id

No

created_by

created_by

No

updated_by

updated_by

No

created_at

created_at

No

updated_at

updated_at

No

bundle_component_price_create

Bundle Component Price request creates validation JSON-schema.

Field Name

Type

Required

Description

bundle_component_entity_id

string, object

Yes

unit_price

number (currency)

Yes

tags

[ string ]

No

time_period_entity_ids

[ string, object ]

Yes

entity_id

entity_id

No

external_id

external_id

No

bundle_component_price_edit

Bundle Component Price request creates validation JSON-schema.

Field Name

Type

Description

bundle_component_entity_id

string, object

unit_price

number (currency)

tags

[ string ]

time_period_entity_ids

[ string, object ]

external_id

external_id

bundle_component_price_list

Field Name

Type

Description

total

integer

items

 bundle_component_price

bundle_components_entity_ids

An array of bundle_component entity_ids.

Field Name

Type

Description

bundle_components_entity_ids

array

An array of bundle_component entity_ids

name

Field Name

Type

Description

name

string

_id

The auto-assigned system document identifier.

Field Name

Type

Description

_id

string

The auto-assigned system document identifier

company_id

The identifier of the company that owns the document.

Field Name

Type

Description

company_id

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

entity_id

string

The auto-assigned unique ID of this entity, set on creation. All future versions of this entity will share the same entity_id

is_master

Field Name

Type

Description

is_master

boolean

is_active

Marking property is the essence of active documents. Sets in true by default.

Field Name

Type

Description

is_active

boolean

Marking property is the essence of active documents. Sets in true by default.

external_id

Field Name

Type

Description

external_id

string

created_by

The identifier of the OPRA user or site that created the document.

Field Name

Type

Description

created_by

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.

Field Name

Type

Description

updated_by

string

The identifier of the OPRA user or site that last updated the document

created_at

The date and time the document was created.

Field Name

Type

Description

created_at

string

The date and time (date-time) the document was created

updated_at

The last date and time the document was updated.

Field Name

Type

Description

updated_at

string

The last date and time (date-time) the document was updated