Справочники
Загружаются один раз при старте и кешируются. Меняются редко — достаточно обновлять раз в сутки.
Точки
GET /points
Точки бренда. Ключ видит все точки своего бренда.
{
"points": [
{
"id": "f40d9ea6-bb66-4d8a-9185-219916b68224",
"name": "Mison TEST",
"short_name": "Mison TEST",
"address": null,
"phone": "998993999966",
"latitude": "39.622158230795",
"longitude": "66.954307133951",
"delivery_distance": 10000000
}
]
}
| Поле | Описание |
|---|---|
id | UUID точки. Это point_id во всех остальных методах |
name / short_name | Название полное и краткое |
address | Адрес текстом, может быть null |
phone | Телефон точки |
latitude / longitude | Координаты, строками |
delivery_distance | Радиус доставки в метрах |
Внутренние числовые идентификаторы точек через API не передаются — только UUID.
Доступность точки
GET /points/{point_id}/is-alive
Открыта ли смена на кассе. Вызывайте перед отправкой заказа и перед тем, как показать точку в приложении: если смена закрыта, заказ никто не увидит.
{
"id": "f40d9ea6-bb66-4d8a-9185-219916b68224",
"is_alive": true,
"shift_opened_at": "2026-07-06 17:43:03"
}
is_alive: false — смена закрыта, точка заказ не примет.
Типы заказов
GET /order-types
GET /order-types?language=uz_latn
Общий справочник, одинаковый у всех заведений.
{
"order_types": [
{ "id": 1, "name": "Зал" },
{ "id": 2, "name": "Собой" },
{ "id": 3, "name": "Доставка" }
]
}
id | Тип | Что нужно в заказе |
|---|---|---|
1 | Зал | table_id (необязательно) |
2 | С собой | ничего дополнительно |
3 | Доставка | address обязателен |
Параметр language: ru, uz_latn, uz_cyrl, en, tr. По умолчанию ru.
Подтипы заказов
GET /order-type-subs
GET /order-type-subs?order_type_id=3
Подтипы настраивает заведение под свои каналы продаж. От подтипа зависит, как заказ ляжет в отчёты и на какой принтер уйдёт.
{
"order_type_subs": [
{ "id": 65, "name": "Доставка", "order_type_id": 3, "is_default": true },
{ "id": 66, "name": "Telegram bot", "order_type_id": 3, "is_default": false },
{ "id": 67, "name": "Call center", "order_type_id": 3, "is_default": false }
]
}
Обычно передавать не нужно
Если в заказе не указать order_type_sub_id, подставится подтип, закреплённый за вашим ключом. Именно так заведение отделяет заказы вашего приложения от Telegram-бота и колл-центра. Передавайте своё значение только если заведение прямо попросило.
Типы оплат
GET /payment-types?point_id={uuid}
Типы оплат, настроенные на конкретной точке.
{
"payment_types": [
{ "id": 59, "name": "Наличка", "category_id": 1 },
{ "id": 60, "name": "Терминал", "category_id": 2 },
{ "id": 52, "name": "Payme", "category_id": 5 }
]
}
category_id — категория оплаты:
category_id | Значение |
|---|---|
1 | Наличные |
2 | Карта, терминал |
4 | Бонусы, лояльность |
5 | Онлайн-оплата, выставление счёта |
6 | Долг, оплата сотрудником |
Категория 5 меняет поведение заказа
При category_id: 5 заказ создаётся в статусе AWAITING_PAYMENT — он ждёт оплаты и на кухню не уходит, пока оплата не пройдёт. Для обычного заказа выбирайте category_id 1 или 2.
Причины отмены
GET /cancel-causes
Причины, по которым заведение разрешает отменять заказы. Список настраивает заведение, у нового бренда он может быть пустым.
{
"cancel_causes": [
{ "id": 12, "name": "Клиент отказался", "is_default": true, "is_comment_required": false }
]
}
is_comment_required: true — при отмене по этой причине заполните comment.
Передаётся в POST /orders/{id}/cancel как cancel_cause_id.