🚀 Готовая интеграция с платформой Paloma365

Исследуйте возможности Paloma365 Platform API

Подключите ваше заведение через OAuth 2.1 или Персональный ключ (PPIK) для управления меню, создания и расчёта онлайн-заказов (quote), мониторинга кассы, аналитики и работы со стоп-листами. Либо запустите демо-режим в один клик!

Документация API

Профиль бизнеса

ID: {{ account.id || status.account_id || '—' }}

Валюта заведения {{ account.currency || 'KZT' }}

Часовой пояс {{ account.time_zone || 'Asia/Almaty' }}

ИИН / БИН {{ account.bin_iin || '—' }}

Телефон {{ account.phone || '—' }}

Выданные права доступа (OAuth Scopes):

Возможности платформы

Order Writes & POS

Статус доступности создания заказов через API для данного заведения.

Запись заказов (order_writes) {{ account.capabilities?.order_writes?.available !== false ? 'Включено' : 'Отключено' }}

Проверка корзины (/orders/quote) Поддерживается

Шаг округления цен {{ locations[0]?.money_step || '1.00' }} {{ account.currency || 'KZT' }}

Эндпоинт: /v1/account

Точки продаж и залы (Locations)

Филиалы заведения, способы доставки и рабочие часы

Всего точек: {{ locations.length }}

Режимы обслуживания:

Самовывоз

{{ (loc.fulfillment?.pickup?.enabled || loc.fulfillment_modes?.pickup?.enabled) ? 'Включен' : 'Выключен' }}

Доставка

{{ (loc.fulfillment?.delivery?.enabled || loc.fulfillment_modes?.delivery?.enabled) ? 'Включена' : 'Выключена' }}

ID: {{ loc.id }}

Утверждённые меню заведения GET /v1/menus

Меню залов, бара и доставки (Menus)

В отличие от общего каталога товаров, Меню определяет конкретный состав блюд для гостей (QR-меню, залы, доставка, бар). Каждое меню имеет свои разделы (папки), индивидуальные цены, привязку к филиалам и расписание окон подачи.

Основное для касс точки

Валюта: {{ activeMenu.currency || 'KZT' }} · Привязано к филиалам: {{ activeMenu.location_ids?.length || 'Все' }}

Окна подачи (Schedule): Действует по расписанию окон филиала

В этом меню пока нет добавленных позиций

Вы можете наполнить меню в бэк-офисе Paloma365

Раздел меню

Базовый Item ID: {{ entry.item_id }} Сортировка: {{ entry.sort_index }}

Цена в этом меню {{ entry.price || '0.00' }} {{ activeMenu.currency || account.currency || 'KZT' }}

Справочник номенклатуры GET /v1/items

Товары и складские позиции (Items)

Полная номенклатурная база: базовые цены, категории, штрихкоды, артикулы SKU и ставки налогов.

Позиции не найдены

В выбранной категории нет товаров. Выберите «Все товары» или сбросьте поиск.

ID	Наименование	Категория	Артикул / Штрихкод	НДС	Ед. изм.	Базовая цена	Действие
{{ item.id }}	{{ item.name }} {{ item.description }}	{{ getCategoryName(item.category_id) }}	SKU: {{ item.sku }} {{ item.barcodes.join(', ') }} —	{{ item.effective_tax.name \|\| item.effective_tax.rate + '%' }} —	{{ item.unit \|\| 'each' }}	{{ item.price }} {{ item.currency \|\| account.currency \|\| 'KZT' }}

В стоп-листе {{ getCategoryName(item.category_id) }}

{{ item.description || (item.sku ? 'Артикул: ' + item.sku : 'Складская позиция') }}

SKU: {{ item.sku }} НДС: {{ item.effective_tax.name || item.effective_tax.rate + '%' }}

Базовая цена {{ item.price }} {{ item.currency || account.currency || 'KZT' }}

Параметры получения заказа

Точка обслуживания (Location)

Способ получения

Имя гостя

Телефон гостя (E.164)

Адрес доставки

Комментарий к заказу

Позиции заказа (Корзина)

Корзина пуста. Добавьте блюда из вкладки «Меню и Каталог»!

Серверный расчёт заказа

POST /v1/orders/quote

Чаевые курьеру/персоналу (Tip)

Подытог (Subtotal): {{ quoteResult.subtotal }} {{ quoteResult.currency }}

Доставка (Delivery Fee): {{ quoteResult.delivery_fee }} {{ quoteResult.currency }}

Налоги в т.ч. (Tax total): {{ quoteResult.tax_total }} {{ quoteResult.currency }}

Чаевые: {{ quoteResult.tip }} {{ quoteResult.currency }}

Итого к оплате: {{ quoteResult.total_with_tip || quoteResult.total }} {{ quoteResult.currency }}

Запрос передаст заголовок Idempotency-Key и expected_total.

Список и трекинг заказов

Заказы со всех каналов и касс в реальном времени (GET /v1/orders)

Статус заказов в песочнице (Paloma365):

Номер / ID	Время	Гость / Контакт	Способ	Статус	Сумма	Действия
{{ ord.number \|\| ord.id }}	{{ formatTime(ord.created_at) }}	{{ ord.customer?.name \|\| 'Гость' }} {{ ord.customer?.phone \|\| '—' }}	{{ ord.fulfillment?.type === 'delivery' ? 'Доставка' : 'Самовывоз' }}	{{ ord.status }}	{{ ord.total }} {{ ord.currency \|\| account.currency \|\| 'KZT' }}

Отчет по продажам (Daily Sales)

Официальные показатели закрытых смен через эндпоинт GET /v1/reports/sales-daily

Выручка (Gross Sales) {{ salesReport[0]?.gross_sales || '0.00' }} {{ account.currency || 'KZT' }}

Чистые продажи (Net) {{ salesReport[0]?.net_sales || '0.00' }} {{ account.currency || 'KZT' }}

Количество чеков {{ salesReport[0]?.order_count || '0' }}

Средний чек {{ salesReport[0]?.avg_check || '0.00' }} {{ account.currency || 'KZT' }}

Дата	Чеков	Выручка брутто	Чистая выручка	Налог (НДС)	Средний чек
{{ row.date }}	{{ row.order_count }}	{{ row.gross_sales }}	{{ row.net_sales }}	{{ row.tax_total }}	{{ row.avg_check }}

Клиентская база

Данные гостей (GET /v1/customers)

Заказов: {{ c.total_orders }} Бонусы: {{ c.balance_bonus }}

Персонал и смены

Сотрудники заведения (GET /v1/employees)

Роль: {{ emp.role }}

Интерактивный API Explorer

Выполняйте любые прямые запросы к Paloma365 Platform API с авторизацией Bearer токеном

Быстрые пресеты:

Тело запроса (JSON Body):

Ответ сервера: HTTP {{ explorer.response.status }} {{ explorer.response.url }}

{{ JSON.stringify(explorer.response.data, null, 2) }}

Исследуйте возможности Paloma365 Platform API

{{ account.name || 'Загрузка...' }}

Order Writes & POS

Точки продаж и залы (Locations)

{{ loc.name }}

Меню залов, бара и доставки (Menus)

{{ menu.name }}

{{ activeMenu.name }}

{{ entry.name }}