iRetail PRO store node 1.0.0-m1: checks
22 операции
← Вся документация · Источник: контракты, openapi/store-v1.yaml на коммите 8000474.
Справочники на английском — на языке контрактов, из которых они созданы.
← iRetail PRO store node 1.0.0-m1
Операции
GET
/v1/checks
Checks, oldest first (spec/RESTAURANT.md, Checks); by default the open and billed ones.
operationId
listChecks · Право check.use
Параметры
| Имя | Где | Тип | Описание |
|---|---|---|---|
IRetail-App
|
header | string |
Which app sends the request, at which version: <app>/<version>, optionally a space and (<platform>), as cashier/1.2.0 (windows-x64) or manager/1.2.0 (web). The register (cashier), the back office and the console (manager) and the device gateway (gateway) send it on every request; a request without it is not one of the apps and is served as the current API, and a device token of an app's kind without it is an app of an unknown version; a header that does not parse counts as absent. The node may refuse an app 426 app_update_required by it, except on the operations marked x-app-update-exempt. Not a security boundary (spec/API.md, Transport; spec/RELEASES.md, Who is asking). |
state
|
query | "active" | "open" | "billed" | "closed" | "canceled" |
active (open and billed, the default), or one state. |
table_id
|
query | string (uuid) |
Only this table's checks. |
waiter_id
|
query | string (uuid) |
Only this waiter's checks. |
limit
|
query | integer |
Page size, 1–200. |
after
|
query | string |
Cursor from the previous page. |
Ответы
POST
/v1/checks
Open a check on a table, or a named tab, with its covers and optionally its first lines; the caller is its waiter.
Without the restaurant license module, a tab past the store's three places is 409 license_limit with details tables 3, and a check on a locked table (past the first three by id) is 403 module_disabled with details module restaurant (spec/LICENSE.md, The restaurant's three places).
operationId
openCheck · Право check.use
Параметры
| Имя | Где | Тип | Описание |
|---|---|---|---|
IRetail-App
|
header | string |
Which app sends the request, at which version: <app>/<version>, optionally a space and (<platform>), as cashier/1.2.0 (windows-x64) or manager/1.2.0 (web). The register (cashier), the back office and the console (manager) and the device gateway (gateway) send it on every request; a request without it is not one of the apps and is served as the current API, and a device token of an app's kind without it is an app of an unknown version; a header that does not parse counts as absent. The node may refuse an app 426 app_update_required by it, except on the operations marked x-app-update-exempt. Not a security boundary (spec/API.md, Transport; spec/RELEASES.md, Who is asking). |
Idempotency-Key
|
header | string |
spec/API.md, Idempotency. |
Approval-Token
|
header | string |
One-time approval from POST /v1/approvals for this operation's permission. |
Тело запроса обязательный
application/jsonCheckOpen
Ответы
GET
/v1/checks/{id}
One check with its lines and totals.
operationId
getCheck · Право check.use
Параметры
| Имя | Где | Тип | Описание |
|---|---|---|---|
IRetail-App
|
header | string |
Which app sends the request, at which version: <app>/<version>, optionally a space and (<platform>), as cashier/1.2.0 (windows-x64) or manager/1.2.0 (web). The register (cashier), the back office and the console (manager) and the device gateway (gateway) send it on every request; a request without it is not one of the apps and is served as the current API, and a device token of an app's kind without it is an app of an unknown version; a header that does not parse counts as absent. The node may refuse an app 426 app_update_required by it, except on the operations marked x-app-update-exempt. Not a security boundary (spec/API.md, Transport; spec/RELEASES.md, Who is asking). |
id обязательный
|
path | string (uuid) |
Id. |
Ответы
PATCH
/v1/checks/{id}
Change a check's covers, a tab's name, held courses, customer, partner code or percent receipt discounts.
operationId
updateCheck · Право check.use
Параметры
| Имя | Где | Тип | Описание |
|---|---|---|---|
IRetail-App
|
header | string |
Which app sends the request, at which version: <app>/<version>, optionally a space and (<platform>), as cashier/1.2.0 (windows-x64) or manager/1.2.0 (web). The register (cashier), the back office and the console (manager) and the device gateway (gateway) send it on every request; a request without it is not one of the apps and is served as the current API, and a device token of an app's kind without it is an app of an unknown version; a header that does not parse counts as absent. The node may refuse an app 426 app_update_required by it, except on the operations marked x-app-update-exempt. Not a security boundary (spec/API.md, Transport; spec/RELEASES.md, Who is asking). |
id обязательный
|
path | string (uuid) |
Id. |
If-Match
|
header | string |
The version the change is based on. |
Approval-Token
|
header | string |
One-time approval from POST /v1/approvals for this operation's permission. |
Тело запроса обязательный
application/jsonCheckPatch
Ответы
POST
/v1/checks/{id}/lines
Add lines, unsent, holding stock for stocked items (spec/RESTAURANT.md, Stock on a check).
operationId
addCheckLines · Право check.use
Параметры
| Имя | Где | Тип | Описание |
|---|---|---|---|
IRetail-App
|
header | string |
Which app sends the request, at which version: <app>/<version>, optionally a space and (<platform>), as cashier/1.2.0 (windows-x64) or manager/1.2.0 (web). The register (cashier), the back office and the console (manager) and the device gateway (gateway) send it on every request; a request without it is not one of the apps and is served as the current API, and a device token of an app's kind without it is an app of an unknown version; a header that does not parse counts as absent. The node may refuse an app 426 app_update_required by it, except on the operations marked x-app-update-exempt. Not a security boundary (spec/API.md, Transport; spec/RELEASES.md, Who is asking). |
id обязательный
|
path | string (uuid) |
Id. |
If-Match
|
header | string |
The version the change is based on. |
Idempotency-Key
|
header | string |
spec/API.md, Idempotency. |
Approval-Token
|
header | string |
One-time approval from POST /v1/approvals for this operation's permission. |
Тело запроса обязательный
application/jsonCheckLinesAdd
Ответы
PATCH
/v1/checks/{id}/lines/{line_no}
Change a line; quantity, options, course and price only while it is unsent (409 line_sent).
operationId
updateCheckLine · Право check.use
Параметры
| Имя | Где | Тип | Описание |
|---|---|---|---|
IRetail-App
|
header | string |
Which app sends the request, at which version: <app>/<version>, optionally a space and (<platform>), as cashier/1.2.0 (windows-x64) or manager/1.2.0 (web). The register (cashier), the back office and the console (manager) and the device gateway (gateway) send it on every request; a request without it is not one of the apps and is served as the current API, and a device token of an app's kind without it is an app of an unknown version; a header that does not parse counts as absent. The node may refuse an app 426 app_update_required by it, except on the operations marked x-app-update-exempt. Not a security boundary (spec/API.md, Transport; spec/RELEASES.md, Who is asking). |
id обязательный
|
path | string (uuid) |
Id. |
line_no обязательный
|
path | integer |
The line's number in the check. |
If-Match
|
header | string |
The version the change is based on. |
Approval-Token
|
header | string |
One-time approval from POST /v1/approvals for this operation's permission. |
Тело запроса обязательный
application/jsonCheckLinePatch
Ответы
DELETE
/v1/checks/{id}/lines/{line_no}
Delete an unsent line without a trace, releasing its hold (a sent line is voided instead).
operationId
removeCheckLine · Право check.use
Параметры
| Имя | Где | Тип | Описание |
|---|---|---|---|
IRetail-App
|
header | string |
Which app sends the request, at which version: <app>/<version>, optionally a space and (<platform>), as cashier/1.2.0 (windows-x64) or manager/1.2.0 (web). The register (cashier), the back office and the console (manager) and the device gateway (gateway) send it on every request; a request without it is not one of the apps and is served as the current API, and a device token of an app's kind without it is an app of an unknown version; a header that does not parse counts as absent. The node may refuse an app 426 app_update_required by it, except on the operations marked x-app-update-exempt. Not a security boundary (spec/API.md, Transport; spec/RELEASES.md, Who is asking). |
id обязательный
|
path | string (uuid) |
Id. |
line_no обязательный
|
path | integer |
The line's number in the check. |
If-Match
|
header | string |
The version the change is based on. |
Ответы
POST
/v1/checks/{id}/lines/{line_no}/void
Void a sent line with a reason; its station gets a cancel (spec/RESTAURANT.md, Courses and the kitchen).
operationId
voidCheckLine · Право check.void_line
Параметры
| Имя | Где | Тип | Описание |
|---|---|---|---|
IRetail-App
|
header | string |
Which app sends the request, at which version: <app>/<version>, optionally a space and (<platform>), as cashier/1.2.0 (windows-x64) or manager/1.2.0 (web). The register (cashier), the back office and the console (manager) and the device gateway (gateway) send it on every request; a request without it is not one of the apps and is served as the current API, and a device token of an app's kind without it is an app of an unknown version; a header that does not parse counts as absent. The node may refuse an app 426 app_update_required by it, except on the operations marked x-app-update-exempt. Not a security boundary (spec/API.md, Transport; spec/RELEASES.md, Who is asking). |
id обязательный
|
path | string (uuid) |
Id. |
line_no обязательный
|
path | integer |
The line's number in the check. |
If-Match
|
header | string |
The version the change is based on. |
Approval-Token
|
header | string |
One-time approval from POST /v1/approvals for this operation's permission. |
Тело запроса обязательный
application/jsonReason
Ответы
POST
/v1/checks/{id}/send
Send the unsent lines of every course that is not held to the kitchen.
operationId
sendCheck · Право check.use
Параметры
| Имя | Где | Тип | Описание |
|---|---|---|---|
IRetail-App
|
header | string |
Which app sends the request, at which version: <app>/<version>, optionally a space and (<platform>), as cashier/1.2.0 (windows-x64) or manager/1.2.0 (web). The register (cashier), the back office and the console (manager) and the device gateway (gateway) send it on every request; a request without it is not one of the apps and is served as the current API, and a device token of an app's kind without it is an app of an unknown version; a header that does not parse counts as absent. The node may refuse an app 426 app_update_required by it, except on the operations marked x-app-update-exempt. Not a security boundary (spec/API.md, Transport; spec/RELEASES.md, Who is asking). |
id обязательный
|
path | string (uuid) |
Id. |
If-Match
|
header | string |
The version the change is based on. |
Ответы
POST
/v1/checks/{id}/fire
Send a course's unsent lines, held or not, and stop holding it.
operationId
fireCourse · Право check.use
Параметры
| Имя | Где | Тип | Описание |
|---|---|---|---|
IRetail-App
|
header | string |
Which app sends the request, at which version: <app>/<version>, optionally a space and (<platform>), as cashier/1.2.0 (windows-x64) or manager/1.2.0 (web). The register (cashier), the back office and the console (manager) and the device gateway (gateway) send it on every request; a request without it is not one of the apps and is served as the current API, and a device token of an app's kind without it is an app of an unknown version; a header that does not parse counts as absent. The node may refuse an app 426 app_update_required by it, except on the operations marked x-app-update-exempt. Not a security boundary (spec/API.md, Transport; spec/RELEASES.md, Who is asking). |
id обязательный
|
path | string (uuid) |
Id. |
If-Match
|
header | string |
The version the change is based on. |
Тело запроса обязательный
application/jsonCourseFire
Ответы
POST
/v1/checks/{id}/renew
Renew the check's holds for the store's check_hold_minutes and place lapsed ones again; raises no version.
operationId
renewCheckHolds · Право check.use
Параметры
| Имя | Где | Тип | Описание |
|---|---|---|---|
IRetail-App
|
header | string |
Which app sends the request, at which version: <app>/<version>, optionally a space and (<platform>), as cashier/1.2.0 (windows-x64) or manager/1.2.0 (web). The register (cashier), the back office and the console (manager) and the device gateway (gateway) send it on every request; a request without it is not one of the apps and is served as the current API, and a device token of an app's kind without it is an app of an unknown version; a header that does not parse counts as absent. The node may refuse an app 426 app_update_required by it, except on the operations marked x-app-update-exempt. Not a security boundary (spec/API.md, Transport; spec/RELEASES.md, Who is asking). |
id обязательный
|
path | string (uuid) |
Id. |
Ответы
POST
/v1/checks/{id}/bill
Make the check billed and answer its pre-bill, which is not a fiscal document (spec/RESTAURANT.md, The pre-bill).
operationId
billCheck · Право check.use
Параметры
| Имя | Где | Тип | Описание |
|---|---|---|---|
IRetail-App
|
header | string |
Which app sends the request, at which version: <app>/<version>, optionally a space and (<platform>), as cashier/1.2.0 (windows-x64) or manager/1.2.0 (web). The register (cashier), the back office and the console (manager) and the device gateway (gateway) send it on every request; a request without it is not one of the apps and is served as the current API, and a device token of an app's kind without it is an app of an unknown version; a header that does not parse counts as absent. The node may refuse an app 426 app_update_required by it, except on the operations marked x-app-update-exempt. Not a security boundary (spec/API.md, Transport; spec/RELEASES.md, Who is asking). |
id обязательный
|
path | string (uuid) |
Id. |
If-Match
|
header | string |
The version the change is based on. |
Ответы
POST
/v1/checks/{id}/reopen
Make a billed check open again.
operationId
reopenCheck · Право check.reopen
Параметры
| Имя | Где | Тип | Описание |
|---|---|---|---|
IRetail-App
|
header | string |
Which app sends the request, at which version: <app>/<version>, optionally a space and (<platform>), as cashier/1.2.0 (windows-x64) or manager/1.2.0 (web). The register (cashier), the back office and the console (manager) and the device gateway (gateway) send it on every request; a request without it is not one of the apps and is served as the current API, and a device token of an app's kind without it is an app of an unknown version; a header that does not parse counts as absent. The node may refuse an app 426 app_update_required by it, except on the operations marked x-app-update-exempt. Not a security boundary (spec/API.md, Transport; spec/RELEASES.md, Who is asking). |
id обязательный
|
path | string (uuid) |
Id. |
If-Match
|
header | string |
The version the change is based on. |
Approval-Token
|
header | string |
One-time approval from POST /v1/approvals for this operation's permission. |
Ответы
POST
/v1/checks/{id}/cancel
Cancel a check with nothing to pay; unsent lines are deleted and holds released (409 check_not_empty otherwise).
operationId
cancelCheck · Право check.use
Параметры
| Имя | Где | Тип | Описание |
|---|---|---|---|
IRetail-App
|
header | string |
Which app sends the request, at which version: <app>/<version>, optionally a space and (<platform>), as cashier/1.2.0 (windows-x64) or manager/1.2.0 (web). The register (cashier), the back office and the console (manager) and the device gateway (gateway) send it on every request; a request without it is not one of the apps and is served as the current API, and a device token of an app's kind without it is an app of an unknown version; a header that does not parse counts as absent. The node may refuse an app 426 app_update_required by it, except on the operations marked x-app-update-exempt. Not a security boundary (spec/API.md, Transport; spec/RELEASES.md, Who is asking). |
id обязательный
|
path | string (uuid) |
Id. |
If-Match
|
header | string |
The version the change is based on. |
Ответы
POST
/v1/checks/{id}/move
Move a check to another table, or make it a tab (spec/RESTAURANT.md, Moving).
Without the restaurant license module, a check is not moved onto a locked table (403 module_disabled, details module restaurant), and making it a tab past the store's three places is 409 license_limit with details tables 3; moving a check off a locked table is allowed (spec/LICENSE.md, The restaurant's three places).
operationId
moveCheck · Право check.use
Параметры
| Имя | Где | Тип | Описание |
|---|---|---|---|
IRetail-App
|
header | string |
Which app sends the request, at which version: <app>/<version>, optionally a space and (<platform>), as cashier/1.2.0 (windows-x64) or manager/1.2.0 (web). The register (cashier), the back office and the console (manager) and the device gateway (gateway) send it on every request; a request without it is not one of the apps and is served as the current API, and a device token of an app's kind without it is an app of an unknown version; a header that does not parse counts as absent. The node may refuse an app 426 app_update_required by it, except on the operations marked x-app-update-exempt. Not a security boundary (spec/API.md, Transport; spec/RELEASES.md, Who is asking). |
id обязательный
|
path | string (uuid) |
Id. |
If-Match
|
header | string |
The version the change is based on. |
Тело запроса обязательный
application/jsonCheckMove
Ответы
POST
/v1/checks/{id}/merge
Merge another check into this one, its seats moved up past this check's guests; the other is canceled.
operationId
mergeCheck · Право check.use
Параметры
| Имя | Где | Тип | Описание |
|---|---|---|---|
IRetail-App
|
header | string |
Which app sends the request, at which version: <app>/<version>, optionally a space and (<platform>), as cashier/1.2.0 (windows-x64) or manager/1.2.0 (web). The register (cashier), the back office and the console (manager) and the device gateway (gateway) send it on every request; a request without it is not one of the apps and is served as the current API, and a device token of an app's kind without it is an app of an unknown version; a header that does not parse counts as absent. The node may refuse an app 426 app_update_required by it, except on the operations marked x-app-update-exempt. Not a security boundary (spec/API.md, Transport; spec/RELEASES.md, Who is asking). |
id обязательный
|
path | string (uuid) |
Id. |
If-Match
|
header | string |
The version the change is based on. |
Тело запроса обязательный
application/jsonCheckMerge
Ответы
POST
/v1/checks/{id}/move-lines
Move chosen lines to another check, with their holds; answers the check they left.
operationId
moveCheckLines · Право check.use
Параметры
| Имя | Где | Тип | Описание |
|---|---|---|---|
IRetail-App
|
header | string |
Which app sends the request, at which version: <app>/<version>, optionally a space and (<platform>), as cashier/1.2.0 (windows-x64) or manager/1.2.0 (web). The register (cashier), the back office and the console (manager) and the device gateway (gateway) send it on every request; a request without it is not one of the apps and is served as the current API, and a device token of an app's kind without it is an app of an unknown version; a header that does not parse counts as absent. The node may refuse an app 426 app_update_required by it, except on the operations marked x-app-update-exempt. Not a security boundary (spec/API.md, Transport; spec/RELEASES.md, Who is asking). |
id обязательный
|
path | string (uuid) |
Id. |
If-Match
|
header | string |
The version the change is based on. |
Тело запроса обязательный
application/jsonCheckLinesMove
Ответы
POST
/v1/checks/{id}/transfer
Pass a check to another waiter.
operationId
transferCheck · Право check.transfer
Параметры
| Имя | Где | Тип | Описание |
|---|---|---|---|
IRetail-App
|
header | string |
Which app sends the request, at which version: <app>/<version>, optionally a space and (<platform>), as cashier/1.2.0 (windows-x64) or manager/1.2.0 (web). The register (cashier), the back office and the console (manager) and the device gateway (gateway) send it on every request; a request without it is not one of the apps and is served as the current API, and a device token of an app's kind without it is an app of an unknown version; a header that does not parse counts as absent. The node may refuse an app 426 app_update_required by it, except on the operations marked x-app-update-exempt. Not a security boundary (spec/API.md, Transport; spec/RELEASES.md, Who is asking). |
id обязательный
|
path | string (uuid) |
Id. |
If-Match
|
header | string |
The version the change is based on. |
Approval-Token
|
header | string |
One-time approval from POST /v1/approvals for this operation's permission. |
Тело запроса обязательный
application/jsonCheckTransfer
Ответы
PUT
/v1/checks/{id}/service-charges/{charge_id}
Add a store's service charge to a check by hand, remove it with a reason (service_charge.remove too, or a senior's approval), or hand it back to the store's rules (spec/RESTAURANT.md, Service charges).
operationId
setCheckServiceCharge · Право check.use
Параметры
| Имя | Где | Тип | Описание |
|---|---|---|---|
IRetail-App
|
header | string |
Which app sends the request, at which version: <app>/<version>, optionally a space and (<platform>), as cashier/1.2.0 (windows-x64) or manager/1.2.0 (web). The register (cashier), the back office and the console (manager) and the device gateway (gateway) send it on every request; a request without it is not one of the apps and is served as the current API, and a device token of an app's kind without it is an app of an unknown version; a header that does not parse counts as absent. The node may refuse an app 426 app_update_required by it, except on the operations marked x-app-update-exempt. Not a security boundary (spec/API.md, Transport; spec/RELEASES.md, Who is asking). |
id обязательный
|
path | string (uuid) |
Id. |
charge_id обязательный
|
path | string |
The store's service charge (spec/API.md, Service charges). |
If-Match
|
header | string |
The version the change is based on. |
Approval-Token
|
header | string |
One-time approval from POST /v1/approvals for this operation's permission. |
Тело запроса обязательный
application/jsonCheckServiceChargeSet
Ответы
POST
/v1/checks/{id}/split
The receipts a split would make, each figured by the receipt math, with their parts; changes nothing.
operationId
previewCheckSplit · Право check.use
Параметры
| Имя | Где | Тип | Описание |
|---|---|---|---|
IRetail-App
|
header | string |
Which app sends the request, at which version: <app>/<version>, optionally a space and (<platform>), as cashier/1.2.0 (windows-x64) or manager/1.2.0 (web). The register (cashier), the back office and the console (manager) and the device gateway (gateway) send it on every request; a request without it is not one of the apps and is served as the current API, and a device token of an app's kind without it is an app of an unknown version; a header that does not parse counts as absent. The node may refuse an app 426 app_update_required by it, except on the operations marked x-app-update-exempt. Not a security boundary (spec/API.md, Transport; spec/RELEASES.md, Who is asking). |
id обязательный
|
path | string (uuid) |
Id. |
Тело запроса обязательный
application/jsonCheckSplitRequest
Ответы
GET
/v1/check-conflicts
Offline receipts of checks that did not apply, for a person to settle (spec/RESTAURANT.md, Offline).
operationId
listCheckConflicts · Право check.any
Параметры
| Имя | Где | Тип | Описание |
|---|---|---|---|
IRetail-App
|
header | string |
Which app sends the request, at which version: <app>/<version>, optionally a space and (<platform>), as cashier/1.2.0 (windows-x64) or manager/1.2.0 (web). The register (cashier), the back office and the console (manager) and the device gateway (gateway) send it on every request; a request without it is not one of the apps and is served as the current API, and a device token of an app's kind without it is an app of an unknown version; a header that does not parse counts as absent. The node may refuse an app 426 app_update_required by it, except on the operations marked x-app-update-exempt. Not a security boundary (spec/API.md, Transport; spec/RELEASES.md, Who is asking). |
resolved
|
query | boolean |
false (the default) for the unresolved ones. |
limit
|
query | integer |
Page size, 1–200. |
after
|
query | string |
Cursor from the previous page. |
Ответы
-
200OKCheckConflictPage -
401Error (spec/API.md).Error -
403Error (spec/API.md).Error
POST
/v1/check-conflicts/{id}/resolve
Apply an offline receipt to its check after all, or dismiss the conflict. 409 check_conflict_resolved for one already resolved, before its version is compared.
operationId
resolveCheckConflict · Право check.any
Параметры
| Имя | Где | Тип | Описание |
|---|---|---|---|
IRetail-App
|
header | string |
Which app sends the request, at which version: <app>/<version>, optionally a space and (<platform>), as cashier/1.2.0 (windows-x64) or manager/1.2.0 (web). The register (cashier), the back office and the console (manager) and the device gateway (gateway) send it on every request; a request without it is not one of the apps and is served as the current API, and a device token of an app's kind without it is an app of an unknown version; a header that does not parse counts as absent. The node may refuse an app 426 app_update_required by it, except on the operations marked x-app-update-exempt. Not a security boundary (spec/API.md, Transport; spec/RELEASES.md, Who is asking). |
id обязательный
|
path | string (uuid) |
Id. |
If-Match
|
header | string |
The version the change is based on. |
Тело запроса обязательный
application/jsonCheckConflictResolve
Ответы
Схемы
Error object
Every error response.
error обязательный
|
string |
Stable code, see spec/API.md. |
message обязательный
|
string |
English text for logs. |
details
|
object |
Discount object | object
As in spec/RECEIPT_MATH.md.
ReceiptTax object
code обязательный
|
string |
|
base обязательный
|
integer (int64) |
|
amount обязательный
|
integer (int64) |
CheckState "open" | "billed" | "closed" | "canceled"
open · billed · closed · canceled
CheckLineState "unsent" | "sent" | "voided"
unsent · sent · voided
HoldState "held" | "lapsed" | "none"
held · lapsed · none
CheckLineVoid object
reason обязательный
|
string |
|
by обязательный
|
string (uuid) |
|
approved_by обязательный
|
string (uuid) | null |
|
at обязательный
|
string (date-time) |
CheckLine object
A sale line with its seat and course (spec/RESTAURANT.md, Checks).
line_no обязательный
|
integer |
|
item_id обязательный
|
string (uuid) |
|
name обязательный
|
string |
|
quantity_milli обязательный
|
integer (int64) |
|
unit_price_minor обязательный
|
integer (int64) |
The price when the line was added, options included (spec/RESTAURANT.md, Checks); a receipt paying the line carries it less its options' deltas. |
modifiers обязательный
|
array of object |
|
discounts обязательный
|
array of Discount |
|
seat обязательный
|
integer |
0 for a shared line. |
course обязательный
|
integer |
|
state обязательный
|
CheckLineState |
|
sent_at обязательный
|
string (date-time) | null |
|
voided обязательный
|
CheckLineVoid | null |
|
receipt_id обязательный
|
string (uuid) | null |
|
hold_state обязательный
|
HoldState |
|
seller_id обязательный
|
string (uuid) | null |
|
guest_order_id обязательный
|
string (uuid) | null |
|
added_by обязательный
|
string (uuid) |
|
added_at обязательный
|
string (date-time) |
CheckLineTotals object
line_no обязательный
|
integer |
|
gross обязательный
|
integer (int64) |
|
line_discount обязательный
|
integer (int64) |
|
receipt_discount обязательный
|
integer (int64) |
|
net обязательный
|
integer (int64) |
|
tax обязательный
|
integer (int64) |
|
service_charges обязательный
|
array of ServiceChargeShare |
The line's share of each charge that applies, with the tax on it. |
CheckTotals object
What one sale receipt of the check's lines that are not voided would be (spec/RESTAURANT.md, Checks).
lines обязательный
|
array of CheckLineTotals |
|
taxes обязательный
|
array of ReceiptTax |
|
gross_total обязательный
|
integer (int64) |
|
discount_total обязательный
|
integer (int64) |
|
net_total обязательный
|
integer (int64) |
|
tax_total обязательный
|
integer (int64) |
|
deposit_total
|
integer (int64) |
|
total обязательный
|
integer (int64) |
|
points_earned обязательный
|
integer | null |
What a bonus card would earn on one receipt of the check; null without one. |
service_charges обязательный
|
array of CheckTotalsServiceCharge |
The service charges that apply to the check, judged on its covers and order type (spec/RESTAURANT.md, Service charges). |
service_charge_total обязательный
|
integer (int64) |
Check object
An open order on a table, or a tab (spec/RESTAURANT.md, Checks).
id обязательный
|
string (uuid) |
|
number обязательный
|
integer (int64) |
|
kind обязательный
|
"table" | "tab" |
|
table_id обязательный
|
string (uuid) | null |
|
table_name обязательный
|
string | null |
|
area_id обязательный
|
string (uuid) | null |
|
name обязательный
|
string | null |
A tab's name; null for a check on a table. |
waiter_id обязательный
|
string (uuid) |
|
covers обязательный
|
integer |
|
state обязательный
|
CheckState |
|
order_type обязательный
|
"dine_in" | "take_out" |
|
held_courses обязательный
|
array of integer |
|
customer_id обязательный
|
string (uuid) | null |
|
card_number_masked обязательный
|
string | null |
|
partner_code обязательный
|
string | null |
|
receipt_discounts обязательный
|
array of object |
Percentages only (spec/RESTAURANT.md, Checks). |
service_charges обязательный
|
array of CheckServiceCharge |
The store's service charges the check carries, in the store's order, each with how it came to (spec/RESTAURANT.md, Service charges). |
lines обязательный
|
array of CheckLine |
|
totals обязательный
|
CheckTotals |
|
paid_minor обязательный
|
integer (int64) |
|
receipt_ids обязательный
|
array of string (uuid) |
|
prebill_count обязательный
|
integer |
|
opened_at обязательный
|
string (date-time) |
|
billed_at обязательный
|
string (date-time) | null |
|
closed_at обязательный
|
string (date-time) | null |
|
merged_into обязательный
|
string (uuid) | null |
|
version обязательный
|
integer (int64) |
CheckPage object
items обязательный
|
array of Check |
|
next обязательный
|
string | null |
CheckLineInput object
item_id обязательный
|
string (uuid) |
|
quantity_milli обязательный
|
integer (int64) |
At most 10^12; a check holds at most 1 000 lines and is bounded as the receipt it adds up to (spec/API.md, Payments; 422 amount_too_large). |
seat
|
integer |
0 for a shared line. |
course
|
integer |
|
modifiers
|
array of string |
Option ids in the chosen order (spec/FOOD_SERVICE.md). |
discounts
|
array of Discount |
|
unit_price_minor
|
integer (int64) |
The price before options, as on a sale line (spec/FOOD_SERVICE.md); only with receipt.price.override, otherwise the store price. |
seller_id
|
string (uuid) | null |
CheckOpen object
table_id for a check on a table, or name for a tab.
table_id
|
string (uuid) | null |
|
name
|
string | null |
A tab's name; null for a check on a table. |
covers обязательный
|
integer |
|
order_type
|
"dine_in" | "take_out" |
|
lines
|
array of CheckLineInput |
CheckPatch object
covers
|
integer |
|
name
|
string | null |
A tab's name; null for a check on a table. |
held_courses
|
array of integer |
|
customer_id
|
string (uuid) | null |
|
card_number
|
string | null |
A loyalty card as scanned; never returned (spec/LOYALTY.md). |
partner_code
|
string | null |
|
receipt_discounts
|
array of object |
Percentages only (spec/RESTAURANT.md, Checks). |
CheckLinesAdd object
lines обязательный
|
array of CheckLineInput |
CheckLinePatch object
quantity_milli
|
integer (int64) |
|
seat
|
integer |
0 for a shared line. |
course
|
integer |
|
modifiers
|
array of string |
|
discounts
|
array of Discount |
|
unit_price_minor
|
integer (int64) |
The price before options, as on a sale line (spec/FOOD_SERVICE.md); only with receipt.price.override. |
seller_id
|
string (uuid) | null |
Reason object
reason обязательный
|
string |
CourseFire object
course обязательный
|
integer |
CheckMove object
table_id обязательный
|
string (uuid) | null |
The table to move to; null makes the check a tab, which then needs a name. |
name
|
string | null |
A tab's name; null for a check on a table. |
CheckMerge object
source_check_id обязательный
|
string (uuid) |
|
source_version обязательный
|
integer (int64) |
CheckLinesMove object
to_check_id обязательный
|
string (uuid) |
|
to_version обязательный
|
integer (int64) |
|
line_nos обязательный
|
array of integer |
|
to_seat
|
integer | null |
The seat every moved line takes; null keeps their seats. |
CheckTransfer object
waiter_id обязательный
|
string (uuid) |
CheckSplitRequest object
items: receipts as lists of line numbers; seats: optionally shared_by; equal: parts (spec/RESTAURANT.md, Split and close).
kind обязательный
|
"items" | "seats" | "equal" |
|
receipts
|
array of array of integer |
|
shared_by
|
array of integer |
|
parts
|
integer |
CheckSplitPart object
part обязательный
|
integer |
|
seat обязательный
|
integer | null |
|
amount_minor обязательный
|
integer (int64) |
|
cash_minor обязательный
|
integer | null |
The part when every part is paid in cash in a store that rounds cash; null otherwise. |
CheckSplitReceipt object
seat обязательный
|
integer | null |
|
shared обязательный
|
boolean |
|
line_nos обязательный
|
array of integer |
|
taxes обязательный
|
array of ReceiptTax |
|
gross_total обязательный
|
integer (int64) |
|
discount_total обязательный
|
integer (int64) |
|
net_total обязательный
|
integer (int64) |
|
deposit_total
|
integer (int64) |
The container deposits of this receipt's lines (spec/TAX.md), inside total; present only when a line of it has one, as on a receipt. |
tax_total обязательный
|
integer (int64) |
|
total обязательный
|
integer (int64) |
|
cash_due обязательный
|
integer | null |
|
parts обязательный
|
array of CheckSplitPart |
The divided due of an equal split or of the shared lines; empty otherwise. |
service_charges обязательный
|
array of ServiceChargeAmount |
The check's charges that apply, figured on this receipt's lines. |
service_charge_total обязательный
|
integer (int64) |
CheckSplit object
check_version обязательный
|
integer (int64) |
|
check_total обязательный
|
integer (int64) |
|
receipts обязательный
|
array of CheckSplitReceipt |
|
receipts_total обязательный
|
integer (int64) |
|
difference обязательный
|
integer (int64) |
receipts_total less check_total; taxes and stamps are figured per receipt. |
PreBillLine object
line_no обязательный
|
integer |
|
seat обязательный
|
integer |
0 for a shared line. |
quantity_milli обязательный
|
integer (int64) |
|
name обязательный
|
string |
|
options обязательный
|
array of string |
|
gross обязательный
|
integer (int64) |
|
line_discount обязательный
|
integer (int64) |
PreBill object
A check's pre-bill; not a fiscal document, and printed as such (spec/RESTAURANT.md, The pre-bill).
check_id обязательный
|
string (uuid) |
|
check_number обязательный
|
integer (int64) |
|
table_name обязательный
|
string | null |
|
name обязательный
|
string | null |
A tab's name; null for a check on a table. |
waiter_id обязательный
|
string (uuid) |
|
waiter_name обязательный
|
string |
|
covers обязательный
|
integer |
|
language обязательный
|
string |
The store's receipt language, in which "Pre-bill — not a receipt" is printed. |
lines обязательный
|
array of PreBillLine |
|
service_charges обязательный
|
array of PreBillServiceCharge |
What the pre-bill prints of each charge that applies, in its language; the amounts are in totals. |
totals обязательный
|
CheckTotals |
|
printed_at обязательный
|
string (date-time) |
|
copy обязательный
|
integer |
1 for the first print, then each reprint. |
CheckConflictReason object
line_no обязательный
|
integer | null |
|
reason обязательный
|
"check_closed" | "check_canceled" | "line_missing" | "line_voided" | "line_paid" | "line_changed" | "service_charges_changed" |
CheckConflict object
An offline receipt of a check that did not apply (spec/RESTAURANT.md, Offline).
id обязательный
|
string (uuid) |
|
check_id обязательный
|
string (uuid) |
|
receipt_id обязательный
|
string (uuid) |
|
reasons обязательный
|
array of CheckConflictReason |
|
created_at обязательный
|
string (date-time) |
|
resolution обязательный
|
"apply" | "dismiss" | null |
|
resolved_by обязательный
|
string (uuid) | null |
|
resolved_at обязательный
|
string (date-time) | null |
|
version обязательный
|
integer (int64) |
CheckConflictPage object
items обязательный
|
array of CheckConflict |
|
next обязательный
|
string | null |
CheckConflictResolve object
resolution обязательный
|
"apply" | "dismiss" |
ServiceChargeHow "automatic" | "added" | "removed"
automatic (its conditions hold), added by hand, or removed by hand with a reason.
automatic · added · removed
ServiceChargeAmount object
A charge figured on a receipt's lines.
id обязательный
|
string |
|
base_minor обязательный
|
integer (int64) |
What the rate was applied to. |
amount_minor обязательный
|
integer (int64) |
|
tax_minor обязательный
|
integer (int64) |
CheckTotalsServiceCharge object
A charge that applies to a check, figured on its lines, with how it came to.
id обязательный
|
string |
|
how обязательный
|
ServiceChargeHow |
|
base_minor обязательный
|
integer (int64) |
|
amount_minor обязательный
|
integer (int64) |
|
tax_minor обязательный
|
integer (int64) |
CheckServiceCharge object
A service charge a check carries (spec/RESTAURANT.md, Service charges).
id обязательный
|
string |
|
how обязательный
|
ServiceChargeHow |
|
reason обязательный
|
string | null |
|
by обязательный
|
string (uuid) | null |
|
approved_by обязательный
|
string (uuid) | null |
|
at обязательный
|
string (date-time) | null |
CheckServiceChargeSet object
how обязательный
|
"added" | "removed" | "automatic" |
added, removed (with a reason, and service_charge.remove or an approval) or automatic (back to the store's rules). |
reason
|
string | null |
PreBillServiceCharge object
id обязательный
|
string |
|
label обязательный
|
string |
|
rate_ppm обязательный
|
integer |
|
notice обязательный
|
string |
|
to_staff_ppm обязательный
|
integer |