APKASSA — умная касса для бизнеса

1. Что такое APKassa

APKassa — это облачная кассовая и торговая платформа на apkassa.ru. Один каталог товаров питает витрину, кассу кассира, киоск самообслуживания и внешние магазины (OpenCart / apflower.ru / sushiap.ru). Заказы, оплаты, склад и сотрудники живут в одной базе, но каждая организация видит только свои данные.

Рядом работают продукты той же группы: цветы apflower.ru, суши sushiap.ru, доставка apdostavka.ru, доска объявлений apsalle.ru. Оплата с витрин идёт в APKassa и ЮKassa.

2. Возможности

Архитектура

Заказ: от витрины до выдачи

Статусы заказа двигают кухню и курьера. При сборке блюда техкарта списывает ингредиенты (/api/consume_ingredients.php).

Оплата OpenCart / apflower / sushiap

Каталог: касса → OpenCart → APSALLE

Повторная выгрузка на APSALLE обновляет объявление. Без фото карточка не считается полноценным объявлением.

Роли и рабочие места

Кабинет: https://apkassa.ru/man/?page=…. Страницы без ?page= — отдельные PHP. Ничего из рабочего контура не отключалось: это описание того, что уже есть.

Где	Страница	Зачем	Участвует
Основное	dashboard	Сводка, подписка, остатки, «нехватка»	да
Основное	selfemployed	Самозанятый	да
Основное	profile	Профиль пользователя	да
Основное	orders	Заказы организации	да
Основное	Почта / сообщения	Уведомления кабинета	да, если включена
Основное	sales	Продажи и выручка	да
Основное	customers	Покупатели, бонусы	да
Основное	products	Номенклатура	да — источник каталога
Основное	categories.php	Категории	да
Основное	import_products_csv.php	Импорт CSV	да
Основное	cash	Касса в кабинете	да
Основное	app_store	Магазин приложений	да
Склад	purchases	Закупки / приход	да
Склад	materials	Материалы	да
Склад	tech_cards	Техкарты блюд	да, списание при сборке
Финансы	expenses	Расходы	да
Финансы	analytics	Аналитика	да
Финансы	payouts	Выплаты	да
Финансы	yookassa	ЮKassa в кабинете	да
Финансы	opencart_payment	Оплата магазинов APKASSA.RU	да
Финансы	sber_bank / sber_settings	Сбер: операции и ключи	да
Персонал	employees, employee_tariffs, schedule	Люди, ставки, графики	да, admin/manager
Админ	managers, organizations, cashregisters, users	Мультитенант	да, admin
Админ	integrations	Паспорт Telegram, банков, ИИ, телефонии	да
Админ	apsalle	Выгрузка товаров на apsalle.ru	да, если модуль стоит
Доп.	flower_shop, delivery, callcenter, neural_manager, files	Вертикали бизнеса	да
Доп.	/doc/counterparties.php, audit.php, settings	Контрагенты, журнал, настройки	да
Вне кабинета	/kassa1/ /povar/ /courier/ /senior/ /buh/ /tehnik/	Рабочие места по ролям	да
Вне кабинета	/shop/ /kiosk/ /login.php /store.php /book.php /FAQ/	Витрина, киоск, вход, витрина приложений, эта книга	да

Роль	Вход	Что видит
admin / superadmin	/man/	Все организации, кассы, интеграции, пользователи
manager	/man/	Своя организация: товары, заказы, сотрудники, отчёты
старший смены	/senior/	Приход, сборка, смена, отчёт
повар	/povar/	Заказы на кухню, техкарта
курьер	/courier/	Доставка, отметка вручения
кассир	/kassa1/	Продажи своей кассы
бухгалтер	/buh/	Финучёт, склад, продажи; Сбер при выдаче прав

Изоляция: все выборки фильтруются по org_id. Кассир дополнительно по cash_register_id.

Каталог

Таблица products + categories. Картинки в /uploads/products/. Импорт CSV и синхронизация OpenCart обновляют те же записи. Витрина, касса и киоск читают один каталог.

Заказ

Витрина держит корзину в браузере, затем /shop/api/create_order.php пишет orders и order_items. Касса создаёт заказ сразу. Оплата меняет статус на paid. Кухня и курьер двигают дальше.

Склад и техкарты

Ингредиенты — ingredients, состав блюда — recipes / recipe_items. При статусе «в сборке» или «готов» списывается склад, движения — stock_movements. Если остатка мало, статус не меняется.

Касса и киоск

Кассир работает в /kassa1/. Киоск — /kiosk/?org_id= или ?inn=, крупные плитки, оплата ЮKassa (QR). Настройки точки — карточка кассы cash_registers: адрес, доставка, ключи ЮKassa.

ОФД, Сбер, сверки

Отчёты ОФД.ру — /man/ofd_reports.php и API /man/api/ofd_reports_api.php (список ККТ, отчёт за период). Сверки эквайринга — /man/api/reconciliation_api.php. Сбер: настройки в кабинете, webhook /api/sber/webhook.php пишет журнал входящих событий.

APSALLE

Страница /man/?page=apsalle публикует товар как объявление на apsalle.ru (категория, новое/БУ, города). Фото из карточки товара обязательно. Повторная загрузка обновляет объявление, а не создаёт пустышку без картинки.

Колл-центр и файлы

Колл-центр и паспорт интеграций живут в integrations / callcenter. Секреты телефонии в книге не публикуются: ключи задаются только в кабинете. Файлы организации — модуль files.

1. Откройте apkassa.ru/login.php. После входа кабинет — /man/.
2. Админ: Организации → создать юрлицо (ИНН, логотип, подписка).
3. Кассы (админ) — терминал, адрес, ЮKassa shopId и секрет.
4. Товары и Категории — каталог. При необходимости CSV-импорт или OpenCart.
5. Сотрудники — роли и вход в /kassa1, /povar, /courier.
6. Витрина организации: интернет-магазин /shop, киоск /kiosk.
7. Оплата сайтов: Оплата OpenCart — API-ключ, тест ЮKassa, подключение apflower/sushiap.
8. Приложения: /store.php. Эта книга: /book.php.

Где читать дальше: FAQ /FAQ/faq.php, описание модулей /FAQ/description.php, FAQ товары /FAQ/products_faq.php, бухгалтерия /buh/, IT /tehnik/, для ИИ /docs/apkassa-llms.txt и /docs/apkassa-api.json.

На ноутбуках и планшетах левое меню кабинета прокручивается отдельно; до 1180px ширины открывается кнопкой ☰.

Ключ берётся в кабинете: Оплата OpenCart → сгенерировать ключ. Передавать в X-API-Key, Authorization: Bearer или поле api_key. Неверный ключ → 403.

Создать оплату

POST https://apkassa.ru/api/apflower_payment.php
Content-Type: application/json
X-API-Key: <ключ>

{
  "org_id": 30,
  "opencart_order_id": 1996,
  "amount": 1500,
  "phone": "79001234567",
  "email": "buyer@example.com",
  "return_url": "https://shop.example/success",
  "embedded": 1,
  "items": [{"name":"Букет","price":1500,"qty":1}]
}

Ответ: success, идентификатор заказа APKassa, ссылка/виджет ЮKassa. Телефон обязателен (не короче 10 цифр), корзина не пустая, ЮKassa должна быть настроена у организации.

Статус оплаты

GET https://apkassa.ru/api/apflower_payment_status.php?api_key=…&opencart_order_id=1996

Кабинетные JSON (нужна сессия менеджера)

• /man/api/opencart_payment_api.php — get_config, save_config, generate_key, test_yookassa, test_payment
• /man/api/opencart_connections.php — магазины OpenCart: list/get/save/test/delete
• /man/api/app_store_api.php — list/save/delete приложений
• /api/sber/* — баланс, операции, webhook Сбера
• /api/ofd_reports_api.php, /api/reconciliation_api.php — ОФД и сверки

Синхронизация OpenCart: соединения в opencart_connections, лог opencart_sync_log, интервал автообмена в минутах.

Машиночитаемые файлы (кладите в контекст агента):

• https://apkassa.ru/docs/apkassa-llms.txt — краткий паспорт системы
• https://apkassa.ru/docs/apkassa-api.json — каталог эндпоинтов
• https://apkassa.ru/llms.txt — копия паспорта в корне

Правила для агента: не выдумывать ключи; org_id брать из кабинета; не обещать «оплату без ЮKassa», если ключи пустые; товары без фото на APSALLE не выгружать как полноценные объявления; секреты интеграций не печатать. Мутации только с ключом или сессией менеджера. Идемпотентность оплаты завязана на opencart_order_id + org_id.

{
  "service": "APKassa",
  "base": "https://apkassa.ru",
  "auth": ["X-API-Key", "Bearer", "api_key"],
  "create_payment": "POST /api/apflower_payment.php",
  "payment_status": "GET /api/apflower_payment_status.php",
  "cabinet": "/man/?page={page}",
  "handbook": "/book.php",
  "certificate": "2026688570"
}

Публично: apkassa.ru/store.php. В кабинете: Магазин приложений. Android — APK, iPhone — «на экран Домой». В витрине также эта книга: смотреть онлайн или скачать HTML.

Скачивание файла магазина: /download_app.php?token=… (HTML открывается в браузере, APK сохраняется; &download=1 — принудительно скачать).

Токен книги: apkassa-handbook-2026688570, пакет ru.apkassa.handbook.

Программа: APKASSA Умная касса для бизнеса
Автор и правообладатель: Бирич Максим Владимирович (RU)
Свидетельство о государственной регистрации программы для ЭВМ: № 2026688570
Заявка: № 2026688152 от 04 июля 2026 г.
Дата регистрации в Реестре программ для ЭВМ: 18 сентября 2026 г.
Сайт: https://apkassa.ru