Skip to main content

Order Destination

GET /order-destination/current

GET /order-destination/list

GET /order-destination/document/<_id>

Data Models

Endpoints

GET /order-destination/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_entities

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

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 /order-destination/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

array, 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_entities

array, csv of 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

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 /order-destination/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

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

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

[ csv of string ]

No

Specifies entity types for which mappings are presented as a part of the response (For example, include_mappings_for_entities_param=&#39;product&#39;,&#39;product-price&#39;, etc.

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

order_destination_entity_id

order_destination

order_destination_create

order_destination_edit

order_destination_list

name

_id

company_id

entity_id

is_master

is_active

external_id

created_by

updated_by

created_at

updated_at

order_destination_entity_id

An array of the order_destination entity_ids.

Field Name

Type

Description

order_destination_entity_id

string, object

An array of the order_destination entity_ids

order_destination

Stores the definition of an order destination.

Field Name

Type

Required

Description

name

string

Yes

The name of the destination (For example, Carry Out)

short_name

string

Yes

The short name of the destination (For example, CAOU)

id

string

Yes

The user defined identifier of the destination (For example, carry-out)

background_color

string (hex)

No

The hexadecimal value of color

text_color

string (hex)

No

The hexadecimal value of color

required_customer_info

[ string ]

No

The required customer fields to capture for the order destination

optional_customer_info

[ string ]

No

The optional customer fields to capture for the order destination

segment_name

string

No

The name of the order segment.

The possible values are "tray," "seat," or "bag."

guest_count_calculation_method

string

No

Chooses how the guest count is calculated for an order.

  • By Segment - Increases the guest count (by 1) with each new segment added to an order.

  • By Product - Increases the guest count based on the Guest Count Value configured per each product added to the order.

The possible values are  "by_segment" or "by_product."

consumption_type

string

No

The consumption type.

The possible values are "OnPremises" or "OffPremises."

default_taxable_destination

boolean

No

Configures the default taxable destination

time_based_customer_fields

[ object ]

No

The customer fields to capture for the specific time periods

external_id

external_id

No

_id

_id

No

company_id

company_id

No

entity_id

entity_id

No

is_master

is_master

No

is_active

is_active

No

created_by

created_by

No

updated_by

updated_by

No

created_at

created_at

No

updated_at

updated_at

No

order_destination_create

Stores the definition of an order destination.

Field Name

Type

Required

Description

name

string

Yes

The name of the destination (For example, Carry Out)

short_name

string

Yes

The short name of the destination (For example, CAOU)

id

string

Yes

The user defined identifier of the destination (For example, carry-out)

background_color

string (hex)

No

The hexadecimal value of color

text_color

string (hex)

No

The hexadecimal value of color

required_customer_info

[ string ]

No

The required customer fields to capture for the order destination

optional_customer_info

[ string ]

No

The optional customer fields to capture for the order destination

segment_name

string

No

The name of the order segment.

The possible values are "tray," "seat," or "bag."

guest_count_calculation_method

string

No

Chooses how the guest count is calculated for an order.

  • By Segment - Increases the guest count (by 1) with each new segment added to an order.

  • By Product - Increases the guest count based on the Guest Count Value configured per each product added to the order.

The possible values are "by_segment" or "by_product."

consumption_type

string

No

The consumption type.

The possible values are "OnPremises"or "OffPremises."

default_taxable_destination

boolean

No

Configures the default taxable destination

time_based_customer_fields

[ object ]

No

The customer fields to capture for the specific time periods

external_id

external_id

No

entity_id

entity_id

No

order_destination_edit

Stores the definition of an order destination.

Field Name

Type

Description

name

string

The name of the destination (For example, Carry Out)

short_name

string

The short name of the destination (For example, CAOU)

id

string

The user defined identifier of the destination (For example, carry-out)

background_color

string (hex)

The hexadecimal value of color

text_color

string (hex)

The hexadecimal value of color

required_customer_info

[ string ]

The required customer fields to capture for the order destination

optional_customer_info

[ string ]

The optional customer fields to capture for the order destination

segment_name

string

The name of the order segment.

The possible values are "tray," "seat," or "bag."

guest_count_calculation_method

string

Chooses how the guest count is calculated for an order.

  • By Segment - Increases the guest count (by 1) with each new segment added to an order.

  • By Product - Increases the guest count based on the Guest Count Value configured per each product added to the order.

The possible values are "by_segment" or "by_product."

consumption_type

string

The consumption type.

The possible values are "OnPremises" or "OffPremises."

default_taxable_destination

boolean

Configures the default taxable destination

time_based_customer_fields

[ object ]

The customer fields to capture for the specific time periods

external_id

external_id

order_destination_list

Field Name

Type

Description

total

integer

items

[order_destination ]

name

Field Name

Type

Description

name

string

external_id

Field Name

Type

Description

external_id

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.

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