orders.list
List in-stay orders for this tenant, newest-first. Filter by stayId (per-stay folio drill-down) or status (pending/confirmed/delivered/cancelled). Read-only.
Input parameters
| Field | Type | Required | Notes |
|---|---|---|---|
stayId | string | no | |
status | enum | no | One of: pending, confirmed, delivered, cancelled |
limit | integer | no | Default: 50 |
Output fields
| Field | Type | Required | Notes |
|---|---|---|---|
orders | array of object | yes | |
orders.id | string | yes | |
orders.stayId | string | yes | |
orders.itemId | string | yes | |
orders.quantity | integer | yes | |
orders.note | string · nullable | yes | |
orders.status | enum | yes | One of: pending, confirmed, delivered, cancelled |
orders.folioLineId | string · nullable | yes | |
orders.orderedAt | string | yes | |
orders.updatedAt | string | yes |
orders.listCatalog
Orders: list catalog. Read-only query. See the input schema for argument details.
Input parameters
Returns object.
Output fields
Returns array of object. Fields of each element:
| Field | Type | Required | Notes |
|---|---|---|---|
id | string | yes | |
tenantId | string | yes | |
name | string | yes | |
description | string · nullable | yes | |
priceCents | integer | yes | |
currency | string | yes | |
category | string | yes | |
active | boolean | yes | |
sortOrder | integer | yes | |
createdAt | string | yes |
orders.listCatalogByToken
Orders: list catalog by token. Read-only query. See the input schema for argument details.
Input parameters
| Field | Type | Required | Notes |
|---|---|---|---|
token | string | yes |
Output fields
Returns array of object. Fields of each element:
| Field | Type | Required | Notes |
|---|---|---|---|
id | string | yes | |
name | string | yes | |
description | string · nullable | yes | |
priceCents | integer | yes | |
currency | string | yes | |
category | string | yes |
orders.listOrders
Orders: list orders. Read-only query. See the input schema for argument details.
Input parameters
| Field | Type | Required | Notes |
|---|---|---|---|
stayId | string | no | |
status | enum | no | One of: pending, confirmed, delivered, cancelled |
Output fields
Returns array of object. Fields of each element:
| Field | Type | Required | Notes |
|---|---|---|---|
id | string | yes | |
tenantId | string | yes | |
stayId | string | yes | |
itemId | string | yes | |
quantity | integer | yes | |
note | string · nullable | yes | |
status | enum | yes | One of: pending, confirmed, delivered, cancelled |
folioLineId | string · nullable | yes | |
orderedAt | string | yes | |
updatedAt | string | yes |
orders.placeOrderByToken
Orders: place order by token. Mutation — changes data. See the input schema for argument details.
Input parameters
| Field | Type | Required | Notes |
|---|---|---|---|
token | string | yes | |
itemId | string | yes | |
quantity | integer | no | Default: 1 |
note | string | no |
Output fields
| Field | Type | Required | Notes |
|---|---|---|---|
id | string | yes | |
folioLineId | string · nullable | yes |
orders.place_order
Place an in-stay order on behalf of a guest. Verifies the catalog item belongs to this tenant + is active, inserts the stay_orders row, then writes a folio_lines charge (VAT 19% for in-stay extras). Best-effort: if the folio insert fails the order still exists with folioLineId=NULL.
Input parameters
| Field | Type | Required | Notes |
|---|---|---|---|
stayId | string | yes | |
itemId | string | yes | |
quantity | integer | no | Default: 1 |
note | string | no |
Output fields
| Field | Type | Required | Notes |
|---|---|---|---|
id | string | yes | |
folioLineId | string · nullable | yes |
orders.updateOrderStatus
Advance a guest order's status (received / preparing / delivered).
Input parameters
| Field | Type | Required | Notes |
|---|---|---|---|
id | string | yes | |
status | enum | yes | One of: confirmed, delivered, cancelled |
Output fields
| Field | Type | Required | Notes |
|---|---|---|---|
ok | literal | yes | One of: true |
orders.update_status
Transition an order to confirmed / delivered / cancelled. Owner-only. Cancellation does NOT remove the associated folio_lines row — staff must reverse the charge manually if needed. Confirmation-gated.
Input parameters
| Field | Type | Required | Notes |
|---|---|---|---|
id | string | yes | |
status | enum | yes | One of: confirmed, delivered, cancelled |
Output fields
| Field | Type | Required | Notes |
|---|---|---|---|
ok | literal | yes | One of: true |
orders.upsertCatalogItem
Orders: upsert catalog item. Mutation — changes data. See the input schema for argument details.
Input parameters
| Field | Type | Required | Notes |
|---|---|---|---|
id | string | no | |
name | string | yes | |
description | string | no | |
priceCents | integer | yes | |
currency | string | no | Default: "EUR" |
category | string | no | Default: "general" |
active | boolean | no | Default: true |
sortOrder | integer | no | Default: 0 |
Output fields
| Field | Type | Required | Notes |
|---|---|---|---|
id | string | yes |