Интеграция приложения ресторана с агрегаторами — Яндекс.Еда, Купер, Достаевский

Channel manager — один контур, который держит меню, цены, остатки и заказы во всех агрегаторах синхронно с вашей POS. Без ручного дублирования, без расхождений с кассой, без потерянных заказов в час пик. Делаем на foodtech-опыте 14+ лет — кейсы Burger King, KFC, Додо, Performance Food.

Что такое channel manager и зачем он ресторану

Channel manager (оркестратор каналов) — это сервис между вашей POS-системой и кабинетами агрегаторов, который автоматически синхронизирует меню, цены, остатки, заказы и статусы в обе стороны. Без него каждый агрегатор обновляется руками в своём кабинете — и через три месяца в Яндекс.Еде одно меню, в Купере другое, а на кассе третье.

Без channel manager сеть платит ежедневный налог:

  • Дублирование работы. Маркетолог обновляет акцию в четырёх кабинетах — это четыре шанса на опечатку и четыре точки ошибки.
  • Расхождение остатков. В Яндексе товар «в наличии», на кухне закончился — заказ отменён, рейтинг падает.
  • Потерянные заказы в час пик. Кассир физически не успевает копировать заказы с планшетов агрегаторов в POS — теряются 5–15% позиций.
  • Невидимые расхождения по деньгам. Один и тот же заказ может оплатиться дважды — клиентом в агрегаторе и потом на месте; сверки нет.
  • Реклама ломает данные. Купили промо в Яндекс.Еде, заказы пошли — но без channel manager непонятно, какие принёс маркетинг, а какие пришли сами.

С channel manager эти проблемы исчезают как класс: один контур, одна правда о меню и остатках, один поток заказов в POS.

[ ВОЗМОЖНОСТИ ]

Что делает channel manager

Четыре опоры одного контура: единое меню, единый поток заказов, финансовая сверка и аналитика по каналам. На MVP обычно стартуют с первых двух, остальные подключают по фазам.

[ 01 ]

Единое меню и остатки во всех каналах

Блюда, фото, описания, цены, модификаторы и стоп-листы синхронизируются из POS во все агрегаторы автоматически. Одна правда о меню — без расхождений с кассой и без отмен заказов из-за «нет в наличии». Маркетолог обновляет акцию в одном месте, а не в четырёх кабинетах.

[ 02 ]

Единый поток заказов и статусов

Заказы из всех агрегаторов автоматически летят в POS, а статусы (принят, готовится, готов, выдан, отменён) уходят обратно клиенту. Никакого ручного копирования заказов с планшетов в час пик — а значит, ноль потерянных позиций.

[ 03 ]

Сверка комиссий и финансы

Каждый заказ из агрегатора сверяется с его выплатой, комиссии учитываются по типам (базовая, подсветка, маркетинг, курьер), корректировки задним числом отражаются автоматически. Финансист видит чистую маржу по каждому каналу, а не живёт в Excel.

[ 04 ]

Аналитика и репутация по каналам

Единый дашборд: какой агрегатор сколько приносит, как меняется маржа от месяца к месяцу, где аномальный рост комиссии. Отзывы и рейтинги из всех каналов в одном месте, без переключения между кабинетами.

Карта агрегаторов и каналов в РФ на 2026 год

В крупных городах ресторан обычно работает с 3–5 каналами одновременно. У каждого своя API, свои особенности и своя модель доставки.

КаналЧто этоМодель доставки
Яндекс.ЕдаКрупнейший агрегатор после объединения с Delivery ClubКурьеры платформы
Купер (бывший СберМаркет)Доставка продуктов и готовой еды, экосистема СбераКурьеры платформы + самовывоз
Самокат (готовая еда)Quick commerce и готовая едаСвоя доставка из dark store
Кушать ПоданоРегиональный сегмент, средние городаСвоя или курьеры платформы
ChibbisРегиональный агрегатор, 100+ городовРестораны возят сами
Свой сайт и приложениеПрямой канал ресторанаСвоя доставка / самовывоз

Каждый канал — это отдельная интеграция со своей моделью данных. Channel manager скрывает эти различия за единым контуром.

Что синхронизируется и в какую сторону

Тонкая часть интеграции не в том, что синхронизируется, а в том, в какую сторону идёт каждый поток.

ПотокОткуда → кудаЗачем
Каталог и ценыPOS → агрегаторыОдна правда о меню во всех каналах
Остатки и стоп-листыPOS → агрегаторыБез отмен заказов из-за «нет в наличии»
Время приготовленияPOS → агрегаторыРеалистичная оценка готовности для клиента
Часы работы и точкиPOS → агрегаторыБез заказов в нерабочее время
ЗаказыАгрегаторы → POSЗаказ автоматически летит в кассу
Статусы заказаPOS → агрегаторыКлиент видит реальный статус
Привязка курьераАгрегаторы ↔ POSКто доставляет — курьер платформы или ресторана
Комиссии и финансыАгрегаторы → channel managerСверка и контроль маржи
Промо и акцииPOS → агрегаторыПромо синхронны во всех каналах
Отзывы и рейтингиАгрегаторы → channel managerЕдиный дашборд репутации

Десять потоков в обе стороны — полная картина. На MVP стартуют с 4–5 базовых (каталог, остатки, заказы, статусы, комиссии), остальные подключают по фазам.

Архитектура channel manager

Правильная архитектура — это отдельный сервис между POS и агрегаторами, а не «прямые провода» из приложения: через прямые провода ничего не масштабируется, и при сбое одного агрегатора падает весь стек. Наши слои:

  • Шина оркестратора — централизованный узел с очередями (RabbitMQ / Kafka), куда падают события «новый заказ из Яндекса», «обновить меню для Купера». Идемпотентность на уровне сообщения: повторное событие не приводит к двойному заказу.
  • POS-адаптеры — тонкий слой к iiko, R-Keeper, Poster; у каждой POS свой контракт, channel manager скрывает различия.
  • Адаптеры агрегаторов — по одному на канал; внутри авторизация, логика повторов, обработка лимитов запросов, сопоставление моделей данных.
  • Движок сопоставления — главная боль интеграции: у каждого агрегатора своя модель данных (где-то модификатор это атрибут блюда, где-то отдельная позиция). Движок хранит правила преобразования.
  • Машина состояний заказа — заказ проходит 5–10 состояний от «принят» до «закрыт»; у каждого агрегатора свой набор статусов, машина состояний унифицирует их.
  • Модуль сверки — комиссии и финансовые потоки (подробнее ниже).
  • Наблюдаемость и логирование — на сети с 1 000+ заказов в день в час пик без этого «не знаем, где упало»: Sentry, Grafana, собственное хранилище данных.

Эту архитектуру мы переносим из проектов масштаба Burger King и KFC, где интеграционный слой держит пиковую нагрузку федеральной сети.

Конкретика по ключевым API

Яндекс.Еда (Partner API)

Методы: каталог (меню, цены, фото), остатки и стоп-лист, приём заказов, статусы в обе стороны, курьеры (для собственной доставки). Авторизация — партнёрский OAuth и API-ключ, документация открыта для партнёров. Подводный камень: обновления каталога часто идут не по атрибутам, а карточкой целиком — это важно учитывать при частых ценовых изменениях.

Купер (Partner API)

Методы: ассортимент, остатки, заказы, статусы, точки самовывоза. Авторизация — API-ключ и список разрешённых адресов для критичных операций. Ориентирован на продукты, но поддерживает готовую еду; интеграция глубже на уровне ассортимента (десятки тысяч позиций реалистичны). Подводный камень: ассортимент проверяется модератором — нужен буфер на согласование.

Достаевский (как пример сети с собственной доставкой)

Не классический агрегатор, а сеть пиццерий со своей службой; на правах прямого канала — те же потоки данных, но без комиссии 25–30%, как с собственным сайтом. Маршрутизация курьеров — на их стороне.

Chibbis (региональный)

Методы: меню, заказы, статусы. Работает в 100+ городах, рестораны обычно возят сами. Подводный камень: в малых городах партнёрская поддержка медленнее, чем у федеральных платформ — закладывайте больше времени на выход на рабочий режим.

10 типовых сложностей интеграции

Каждую из них мы прошли на проектах федеральных сетей. Часть лечится архитектурой, часть — операционными правилами.

  • Лимиты запросов на обновление каталога. Обновление 5 000 позиций упирается в лимит и растягивается на часы. Решение: пакетные обновления дельтами, очередь с дросселированием.
  • Разные модели данных у агрегаторов. Где-то модификатор — атрибут, где-то отдельная позиция. Решение: движок сопоставления с правилами и тест-кейсами под каждый агрегатор.
  • Идемпотентность заказов. Сетевые сбои → один заказ приходит дважды. Решение: уникальные идентификаторы заказа и проверка на стороне channel manager.
  • Сопоставление статусов. У каждого агрегатора свои состояния, у POS свои. Решение: машина состояний с единым внутренним языком статусов.
  • Своя доставка против доставки платформы. В одном заказе ресторан возит сам, в другом — курьер платформы. Решение: явный флаг типа доставки и разные пайплайны в кассе.
  • Конфликты остатков. Заказ из Яндекса забрал последние порции, в Купере они ещё «в наличии». Решение: атомарное обновление остатков по всем каналам после каждого заказа.
  • Двойное списание при сбоях. Клиент оплатил в агрегаторе, заказ не дошёл до POS, клиент заплатил снова на кассе. Решение: очередь необработанных сообщений, алерт менеджеру за 5 минут, модуль сверки для разбора задним числом.
  • Разные часовые пояса и форматы дат. Решение: приведение к UTC внутри контура и явная привязка к часовому поясу точки.
  • Падение отдельного агрегатора. Один канал недоступен 30 минут — остальное падать не должно. Решение: предохранитель и плавная деградация, остальные каналы продолжают работать.
  • Обновления API без предупреждения. Решение: контрактные тесты, контрольные запросы и мониторинг расхождений, чтобы видеть изменение сразу.
[ ПОЧЕМУ SURF ]

За 14 лет создали 300+ мобильных и веб-продуктов

300+ реализованных проектов, 100 международных наград, №1 в мобильной разработке, 250 специалистов в команде. Интеграционный слой такого масштаба мы строили на проектах Burger King и KFC, а агрегатор знаем изнутри — делали Delivery Club.

7 млн

Пользователей в приложении Burger King

Интеграционный слой на пиковой нагрузке

1100+

Ресторанов KFC автоматизировано

Распределённая сеть с несколькими каналами

№ 1

В разработке приложений для крупного бизнеса

Рейтинг Рунета 2024

250

Штатных специалистов

Backend, интеграции, DevOps, QA

[ КЕЙСЫ ]

Кейсы Surf

Мы создаём foodtech-продукты для лидеров рынка — от стартапов до федеральных сетей. Несколько релевантных проектов из портфеля (полный — на странице foodtech-практики):

Бургер Кинг

Бургер Кинг

Интеграционный слой на масштабе. Приложение для 7+ млн пользователей федеральной сети с интеграциями — опыт надёжного интеграционного слоя под пиковую нагрузку QSR.

Delivery Club

Delivery Club

Агрегатор изнутри. Первый российский агрегатор доставки — мы делали приложение самой платформы, поэтому знаем модель агрегатора со стороны API, а не только со стороны ресторана.

Юнит-экономика channel manager

Channel manager окупается через две статьи: сэкономленное время сотрудников и уменьшение потерь от расхождений. Иллюстративный расчёт на сети из 30 точек, 4 агрегатора, 100 заказов через агрегаторы в день на точку.

Без channel manager: маркетолог обновляет каталог в четырёх кабинетах — 8–12 часов в неделю; кассиры вручную дублируют 5–15% заказов с планшетов в POS (ошибки и потери); расхождения остатков дают 3–7% отменённых заказов; сверка комиссий вручную — 2–4 дня финансиста в месяц.

С channel manager: каталог обновляется в одном месте (−6–10 часов в неделю), заказы летят в POS автоматически (0% дублирования), стоп-листы синхронны в реальном времени (отмен в разы меньше), сверка комиссий автоматическая (часы вместо дней).

На сети из 30 точек с месячной выручкой через агрегаторы 30–50 млн ₽: экономия операционных потерь и фонда оплаты — 300–700 тыс. ₽ в месяц, прирост выручки за счёт меньшего числа отмен и точного маркетинга — 2–5% агрегаторного канала, окупаемость разработки от 1,5 млн ₽ — 6–12 месяцев. Точные цифры под вашу сеть зависят от доли заказов в каналах, числа агрегаторов и уровня операционных потерь сейчас.

Сверка комиссий и финансовый контроль

На сети из 30–100 точек с 4–5 агрегаторами финансовый блок становится отдельной болью: у каждого агрегатора своя модель комиссий, периодичность выплат, корректировки задним числом и возвраты. Без модуля сверки финансист живёт в Excel. Что делает модуль:

  • Сверка заказов и выплат. Каждый заказ из агрегатора должен совпасть с его выплатой в банк; расхождения подсвечиваются автоматически.
  • Учёт комиссий по типам. Базовая комиссия, платная подсветка, маркетинговая комиссия, комиссия за курьера — у каждой свой процент и правила, разделяем явно.
  • Корректировки задним числом. Агрегатор может вернуть деньги клиенту через неделю — это отражается в учёте.
  • Дашборд по каналам. Какой агрегатор сколько приносит, какая чистая маржа за вычетом всех комиссий, как она менялась.
  • Сигналы об аномалиях. Средняя комиссия по агрегатору выросла за неделю — алерт; часто это незамеченное изменение тарифа.

Этот модуль обычно выносят в отдельный сервис со своей базой данных и отчётностью, интегрируют с 1С или BI сети.

Кастомный channel manager или готовый коннектор iiko App Store

В iiko App Store есть готовые коннекторы для большинства агрегаторов — разумный путь для маленьких ресторанов и старта. Но у такого подхода есть пределы.

ПараметрКастомный channel managerГотовый коннектор
Срок запуска2–4 месяца1–3 недели
Стоимость стартаот 1,5 млн ₽подписка / комиссия
Глубина синхронизациивсе 10 потоковбазовые 3–5 потоков
Редкие и региональные агрегаторылюбой APIтолько из списка App Store
Кастомные правила сопоставлениядабазовые
Мультибренд для холдингадаограниченно
Свой модуль сверки комиссийданет, только базовая сверка
Контроль над данными и аналитикойу бизнесау поставщика коннектора

Для одиночного ресторана коннектор из App Store — очевидный выбор. Для сети с 30+ точками, нестандартными региональными агрегаторами или важностью финансового контроля кастом окупается и работает надёжнее.

[ ПРОЦЕСС ]

Процесс разработки

[ 01 ]

Discovery

1–2 недели. Аудит текущих интеграций, карта агрегаторов, карта пути заказа.

[ 02 ]

Дизайн архитектуры

1–2 недели. Схема channel manager, выбор очередей, машина состояний, правила сопоставления.

[ 03 ]

Разработка адаптеров

4–6 недель. POS-адаптер и 2–3 первых адаптера агрегаторов.

[ 04 ]

Модуль сверки

2–3 недели. Сверка комиссий, дашборд по каналам.

[ 05 ]

Тестирование и пилот

3–4 недели. Запуск на 3–5 точках, проверка пиковой нагрузки.

[ 06 ]

Масштабирование

4–8 недель. Подключение остальных агрегаторов и точек.

Стек технологий

СлойТехнологии
Бэкенд channel managerPython (FastAPI / Django) или Kotlin + Spring Boot
База данныхPostgreSQL
Очереди и шинаRabbitMQ или Apache Kafka — идемпотентность и повторы
КэшRedis — сессии адаптеров, дросселирование
Контракты APIOpenAPI 3 / gRPC
POS-адаптерыAPI iiko, R-Keeper, Poster
Адаптеры агрегаторовPartner API каждого канала
Модуль сверкиPython + PostgreSQL + BI
НаблюдаемостьSentry, Prometheus + Grafana, OpenTelemetry
АналитикаClickHouse / собственное хранилище данных
ИнфраструктураDocker, Kubernetes, российские облака — данные в РФ по 152-ФЗ

Команда: продакт (метрики каналов), системный аналитик (карта потоков и сопоставление моделей данных агрегаторов), 2–3 backend-разработчика и инженер интеграций, DevOps (очереди, наблюдаемость, инфраструктура), QA (контрактные и нагрузочные тесты на реальных API), при необходимости — финансовый аналитик для модуля сверки.

Стоимость и сроки

Тип проектаСрок MVPСтоимость «от»
Интеграция 1–2 агрегаторов в существующее приложение4–6 недельот 1,5 млн ₽
Channel manager на 3–4 агрегатора + адаптер iiko10–14 недельот 4 млн ₽
Полный channel manager с модулем сверки4–5 месяцевот 7 млн ₽
Федеральный уровень: 5+ агрегаторов, мультибренд, BI5–7 месяцевот 12 млн ₽
Расширение для собственной партнёрской платформы6–8 месяцевот 18 млн ₽

Что влияет на бюджет: число агрегаторов (каждый — отдельный адаптер и тестирование), глубина модуля сверки (базовая или с BI и дашбордами), число поддерживаемых POS (iiko, R-Keeper, Poster — все или одна), мультибренд для холдинга, уровень наблюдаемости. Для проверки гипотезы в узком сегменте — MVP foodtech.

[ ОТЗЫВЫ ]

Клиенты о работе с нами

Бургер Кинг

Благодаря усилиям команды Surf продажи через цифровые каналы выросли на 85% в течение года. Мобильное приложение заняло первое место в категории «Еда и напитки» в App Store и Google Play.

Татьяна Павлова

Директор по продукту

Додо Пицца

Я протестировал все приложения коллег по рынку и могу сказать, что это, пожалуй, лучшее мобильное приложение для заказа в России — очень быстрое, красивое и удобное.

Федор Овчинников

Основатель Додо Пиццы

KFC

С новой системой у нас улучшились процессы отчётности, планирования и составления графиков. Surf создала впечатляющий дизайн и удобный интерфейс, а также хорошо организованный процесс коммуникации.

Геннадий Дорофеев

Менеджер по инновациям

[ FAQ ]

Клиенты часто спрашивают

Обычно нет — для 1–2 точек хватает готового коннектора из iiko App Store или ручного управления. Channel manager окупается на сети от 10 точек или при работе с 4+ агрегаторами одновременно.
Delivery Club вошёл в Яндекс.Еду в 2022–2023 годах, сейчас де-факто работает как часть платформы Яндекс.Еда — отдельная интеграция не требуется. В кейсе Delivery Club мы делали приложение самого агрегатора в годы его независимой работы — оттуда у нас опыт «изнутри платформы».
Да, это стандартный подход. Архитектура с шиной и адаптерами позволяет подключать новый агрегатор без переписывания всего стека. Стартуем с самого крупного для вашей сети (обычно Яндекс.Еда), дальше расширяем.
Через идемпотентность на уровне сообщений в очереди и модуль сверки, который задним числом сверяет заказ и оплату. На пилоте двойное списание случается у всех — главное вычистить его до масштабирования.
Да — кастомный адаптер пишется под любой публичный API. Срок разработки одного адаптера — 2–4 недели в зависимости от полноты документации и качества API.
Контрактные тесты и контрольные запросы в продакшене ловят расхождения на ранней стадии. Обычно агрегаторы предупреждают партнёров за 1–3 месяца; channel manager поддерживает версионирование API, переход на новую версию делается без простоя.
Да, архитектура одинаковая, меняются только адаптеры. Для локальных платформ нужен партнёрский статус у каждой и проработка платёжной и логистической специфики страны.

[ обратная связь ]

Расскажите о проекте и мы предложим подходящие решения

напишите нам в Telegram
добавить файл

Отправляя запрос, вы соглашаетесь с политикой конфиденциальности