Skip to main content

Stand Worksheet

The Stand Worksheet API pulls data from the Portal, Data Management, and Venue Inventory to show a list of existing of inventory items before an event, after an event, and after transferring items between kiosks. This data includes, but is not limited to Event, Site, Recipe, and Inventory information.

Security

jwt-bearer-token

apiKey

API Key

Name

Authorization

In

header

Endpoints

GET /stand-worksheet/schema

Summary

Stand worksheet schema.

Request Parameters

In

Field Name

Type

Required

Description

header

X-COMPANY-ID

string

Yes

The identifier (ID) of the company that owns the document

Responses

Code

Description

Schema

200

Success

stand_work_sheet_get_response_1

400

Bad request, for more information look at body error

401

Unauthorized error

403

Forbidden error

404

Not Found

422

Unprocessable error

500

Internal Server Error

GET /stand-worksheet/event-status-change-ability

Summary

Check that the stand worksheet event status can be changed.

Request Parameters

In

Field Name

Type

Required

Description

header

X-COMPANY-ID

string

Yes

The identifier (ID) of the company that owns the document

query

event_id

string

Yes

The event ID

query

status

string

Yes

The event status

Responses

Code

Description

Schema

200

Success

stand_work_sheet_get_response_2

400

Bad request, for more information look at body error

401

Unauthorized error

403

Forbidden error

404

Not Found

422

Unprocessable error

500

Internal Server Error

GET /stand-worksheet/{id}

Summary

Get the stand worksheet detail.

Request Parameters

In

Field Name

Type

Required

Description

header

X-COMPANY-ID

string

Yes

The identifier (ID) of the company that owns the document

path

id

string

Yes

Stand work sheet's document _id from the database

Responses

Code

Description

Schema

200

Success

stand_work_sheet_get_response_3

400

Bad request, for more information look at body error

401

Unauthorized error

403

Forbidden error

404

Not Found

422

Unprocessable error

500

Internal Server Error

PATCH /stand-worksheet/{id}

Summary

Update the stand worksheet.

Request Parameters

In

Field Name

Type

Required

Description

header

X-COMPANY-ID

string

Yes

The identifier (ID) of the company that owns the document

path

id

string

Yes

objectId, the stand work sheet's ID

body

body

stand_work_sheet_patch_body_4

Yes

The JSON formatted request

Responses

Code

Description

Schema

204

No content

400

Bad request, for more information look at body error

401

Unauthorized error

403

Forbidden error

404

Not Found

422

Unprocessable error

500

Internal Server Error

PATCH /stand-worksheet/bulk-update-phy-diff

Summary

Bulk update for the stand worksheet diff_physical_terminal.

Request Parameters

In

Field Name

Type

Required

Description

header

X-COMPANY-ID

string

Yes

The identifier (ID) of the company that owns the document

body

body

stand_work_sheet_patch_body_4_item

Yes

The JSON formatted request

Responses

Code

Description

Schema

204

No content

400

Bad request, for more information look at body error

401

Unauthorized error

403

Forbidden error

404

Not Found

422

Unprocessable error

500

Internal Server Error

GET /stand-worksheet

Summary

Get the stand worksheet list.

Request Parameters

In

Field Name

Type

Required

Description

header

X-COMPANY-ID

string

Yes

The identifier (ID) of the company that owns the document

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

$select

string

No

query

$orderby

string

No

An order by expression in OData v4 format

Responses

Code

Description

Schema

200

Success

stand_work_sheet_get_response_5

400

Bad request, for more information look at body error

401

Unauthorized error

403

Forbidden error

404

Not Found

422

Unprocessable error

500

Internal Server Error

POST /stand-worksheet

Summary

Create the stand worksheet for the sites.

Request Parameters

In

Field Name

Type

Required

Description

header

X-COMPANY-ID

string

Yes

The identifier (ID) of the company that owns the document

body

body

stand_work_sheet_post_body_7

Yes

The JSON formatted request

Responses

Code

Description

Schema

201

Success

stand_work_sheet_post_response_7_item

400

Bad request, for more information look at body error

401

Unauthorized error

403

Forbidden error

404

Not Found

422

Unprocessable error

500

Internal Server Error

Data Models

stand_work_sheet_get_response_1

Field Name

Type

Description

stand_work_sheet_get_response_1

object

The definition of the stand worksheet schema

stand_work_sheet_post_response_2

Field Name

Type

Description

none_open_pre_transfer

boolean

The flag which indicates if there is not an open pre event transfer

all_stand_worksheet_approved

boolean

The flag which indicates if all stand worksheets are approved

none_pending_transfer

boolean

The flag which indicates if there is not a pending pre event transfer

stand_work_sheet_get_response_3

Field Name

Type

Required

Description

transaction_id

string

Yes

objectId, the transaction identifier (ID)

_id

string

Yes

objectId, the stand worksheet's ID

event_id

string

No

objectId, the event's ID

site_id

string

Yes

objectId, the site's ID

entity_id

string

Yes

The stand worksheet entity ID

site_name

string

No

The site's name

store_number

string

No

The site ID

status

string

No

The stand worksheet status

cash_count

number

Yes

The cash count

miscellaneous

number

Yes

Other fees

miscellaneous_post_closure

number

No

The other fees generated after the event

unlinked_recipe_price

number

No

The unlinked recipe price

unlinked_recipe_price_post_closure

number

No

The unlinked recipe price after the event

unlinked_recipe_discount_post_closure

number

No

The discount for unlinked recipe after closing the event

unlinked_recipe_discount

number

No

The discount for unlinked recipe

unlinked_recipe_tax

number

No

The tax for unlinked recipe

unlinked_recipe_tax_post_closure

number

No

The tax for unlinked recipe after closing the event

payments

stand_work_sheet_get_response_3_payments

No

is_active

boolean

Yes

The validity indicator field. When set to true, it represents a valid record.

event_name

string

Yes

The event name

event_start_date_time

date/time

Yes

event_end_date_time

date/time

Yes

formula_version

string

No

The stand work sheet formula version

status_history

[ stand_work_sheet_get_response_3_status_history ]

No

The status changed history

stand_work_sheet_get_response_3_payments

Field Name

Type

Description

tips

number

The amount of payment tips

tips_post_closure

number

The amount of payment tips after the event

credit

number

The amount paid by credit card

credit_post_closure

number

The amount paid by credit card after the event

debit

number

The amount paid by debit card

debit_post_closure

number

The amount paid by debit card after the event

cash

number

The amount paid in cash

cash_post_closure

number

The amount paid in cash after the event

gift

number

The amount paid by gift card

gift_post_closure

number

The amount paid by gift card after the event

custom

number

The amount paid by custom approach

custom_post_closure

number

The amount paid by custom approach after the event

tax

number

The tax amount

tax_post_closure

number

Tax after the event

stand_work_sheet_get_response_3_status_history

Field Name

Type

Required

Description

from

string

Yes

The value of the status before this change

to

string

Yes

The status after this change

comment

string

Yes

The comment about this status change

updated_by

string

Yes

The user who updated the status

updated_at

string

Yes

The time the status was updated

stand_work_sheet_patch_body_4

Field Name

Type

Description

status

string

The stand worksheet status

cash_count

number

The cash count

items

[stand_work_sheet_patch_body_4_items]

stand_work_sheet_patch_body_4_item

Field Name

Type

Required

Description

_id

string

Yes

objectId, the stand work sheet's identifier (ID)

diff_physical_terminal

number

Yes

The diff_physical_terminal value

diff_percent_physical_terminal

number

Yes

The diff_physical_terminal percent

stand_work_sheet_patch_body_4_items

Field Name

Type

Required

Description

id

string

Yes

objectId, the stand worksheet item's identifier (ID)

inventory_item_entity_id

string

No

objectId, the inventory item venue's entity ID

is_chargeable

boolean

No

The inventory item is chargeable or non-chargeable

manager_begin

number

No

Manager begin count

gratis

number

No

The gratis

ingredient_spoil

number

No

The ingredient spoil

adjustment

number

No

The adjustment

end

number

No

The manual end count

stand_work_sheet_get_response_5

Field Name

Type

Description

items

[stand_work_sheet_get_response_5_items]

total

number

page_count

number

current_page

number

page_size

number

stand_work_sheet_get_response_5_items

Field Name

Type

Required

Description

transaction_id

string

Yes

objectId, the transaction identifier (ID)

_id

string

Yes

objectId, the stand worksheet's ID

event_id

string

No

objectId, the event's ID

site_id

string

Yes

objectId, the site's ID

entity_id

string

Yes

The stand worksheet entity ID

site_name

string

No

The site's name

store_number

string

No

The site ID

status

string

No

The stand worksheet status

cash_count

number

Yes

The cash count

miscellaneous

number

Yes

Other fees

miscellaneous_post_closure

number

No

The other fees generated after the event

unlinked_recipe_price

number

No

The unlinked recipe price

unlinked_recipe_price_post_closure

number

No

The unlinked recipe price after the event

unlinked_recipe_discount_post_closure

number

No

The discount for unlinked recipe after closing the event

unlinked_recipe_discount

number

No

The discount for unlinked recipe

unlinked_recipe_tax

number

No

The tax for unlinked recipe

unlinked_recipe_tax_post_closure

number

No

The tax for unlinked recipe after closing the event

payments

stand_work_sheet_get_response_5_items_payments

No

is_active

boolean

Yes

The validity indicator field. When set to true, it represents a valid record.

event_name

string

Yes

The event name

event_start_date_time

date/time

Yes

event_end_date_time

date/time

Yes

formula_version

string

No

The stand work sheet formula version

status_history

stand_work_sheet_post_response_5_item_status_history

No

The status changed history

stand_work_sheet_get_response_5_items_payments

Field Name

Type

Description

tips

number

The amount of payment tips

tips_post_closure

number

The amount of payment tips after the event

credit

number

The amount paid by credit card

credit_post_closure

number

The amount paid by credit card after the event

debit

number

The amount paid by debit card

debit_post_closure

number

The amount paid by debit card after the event

cash

number

The amount paid in cash

cash_post_closure

number

The amount paid in cash after the event

gift

number

The amount paid by gift card

gift_post_closure

number

The amount paid by gift card after the event

custom

number

The amount paid by custom approach

custom_post_closure

number

The amount paid by custom approach after the event

tax

number

The tax amount

tax_post_closure

number

Tax after the event

stand_work_sheet_get_response_5_items_status_history

Field Name

Type

Required

Description

from

string

Yes

to

string

Yes

comment

string

Yes

updated_by

string

Yes

updated_at

string

Yes

stand_work_sheet_post_body_7

Field Name

Type

Required

Description

event_id

string

Yes

The event identifier (ID)

site_ids

[string]

Yes

The site ID list

stand_work_sheet_post_response_7_item

Field Name

Type

Required

Description

transaction_id

string

Yes

objectId, the transaction identifier (ID)

_id

string

Yes

objectId, the stand worksheet's ID

event_id

string

No

objectId, the event's ID

site_id

string

Yes

objectId, the site's ID

entity_id

string

Yes

The stand worksheet entity ID

site_name

string

No

The site's name

store_number

string

No

The site ID

status

string

No

The stand worksheet status

cash_count

number

Yes

The cash count

miscellaneous

number

Yes

Other fees

miscellaneous_post_closure

number

No

The other fees generated after the event

unlinked_recipe_price

number

No

The unlinked recipe price

unlinked_recipe_price_post_closure

number

No

The unlinked recipe price after the event

unlinked_recipe_discount_post_closure

number

No

The discount for unlinked recipe after closing the event

unlinked_recipe_discount

number

No

The discount for unlinked recipe

unlinked_recipe_tax

number

No

The tax for unlinked recipe

unlinked_recipe_tax_post_closure

number

No

The tax for unlinked recipe after closing the event

payments

stand_work_sheet_post_response_7_item_payments

No

is_active

boolean

Yes

The validity indicator field. When set to true, it represents a valid record.

event_name

string

Yes

The event name

event_start_date_time

date/time

Yes

event_end_date_time

date/time

Yes

formula_version

string

No

The stand work sheet formula version

status_history

stand_work_sheet_post_response_7_item_status_history

No

stand_work_sheet_post_response_7_item_payments

Field Name

Type

Description

tips

number

The amount of payment tips

tips_post_closure

number

The amount of payment tips after the event

credit

number

The amount paid by credit card

credit_post_closure

number

The amount paid by credit card after the event

debit

number

The amount paid by debit card

debit_post_closure

number

The amount paid by debit card after the event

cash

number

The amount paid in cash

cash_post_closure

number

The amount paid in cash after the event

gift

number

The amount paid by gift card

gift_post_closure

number

The amount paid by gift card after the event

custom

number

The amount paid by custom approach

custom_post_closure

number

The amount paid by custom approach after the event

tax

number

The tax amount

tax_post_closure

number

Tax after the event

stand_work_sheet_post_response_7_item_status_history

Field Name

Type

Required

Description

from

string

Yes

to

string

Yes

comment

string

Yes

updated_by

string

Yes

updated_at

string

Yes