Интеграция Poster и R-Keeper с Битрикс24: что передавать из кассы в CRM

Poster и R-Keeper хорошо считают чек, стол и смену, но ничего не знают про банкет, который продают за шесть недель до даты, и про корпоративного клиента, который заказывает обеды в офис каждый месяц. Эти задачи решает CRM. Связка кассы с Битрикс24 нужна для того, чтобы менеджер по площадкам видел гостя, предоплату и следующий шаг в одной карточке, а официант продолжал работать только в кассе.

Ниже разобрано, какие данные имеет смысл передавать из Poster и R-Keeper, что оставить в кассе, как построить обмен через вебхуки Битрикс24, как защититься от дублей и что проверить до запуска. Пункты меню Битрикс24 сверены со справкой в ноябре 2026 года, а возможности самих касс зависят от версии и настроек, поэтому для них даны вопросы к администратору, а не готовые обещания.

Коротко

• Касса остаётся источником правды по чекам, оплатам, сменам и начислению баллов лояльности.
• В Битрикс24 переносят контакт гостя, дату последнего визита, число визитов, точку сети и заявки на банкеты.
• Без телефона гостя на чеке связать визит с карточкой нельзя, поэтому политика сбора контакта идёт раньше коннектора.
• Для обмена хватает входящего вебхука: он создаётся в разделе «Разработчикам».
• Дубли ловят дважды: поиском по телефону перед созданием контакта и штатным контролем дубликатов в CRM.
• Первый прогон делают на 20 гостях и трёх сценариях: банкет, чек, претензия.

Что передавать из кассы в CRM, а что оставить в кассе

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

Граница проходит по длине цикла.

Бронь стола на сегодняшний вечер в эту логику не попадает. Если хостес записывает её в кассе или в телефоне, пусть так и остаётся, иначе воронка заполнится бронями на 19:00 и менеджер площадок перестанет видеть настоящие банкеты.

Принцип тот же, что и для iiko, но коннекторы, объекты и поля другие. Если у вас iiko, откройте руководство по интеграции iiko и Битрикс24, а здесь разбираются именно Poster и R-Keeper.

Что отдают Poster и R-Keeper: вопросы до начала работ

Для R-Keeper 7 в документации описан XML-интерфейс, через который внешние системы читают данные и записывают их в базы. Доступ по HTTPS в документации указан для версии 7.05.03 и новее, авторизация идёт по имени и паролю сотрудника r_keeper, а порт и ключ шифрования (CryptKey) задаются на менеджерской станции. Отдельно существует R_keeper CRM с протоколом карт: запрос «Get card info» возвращает данные держателя карты и её счета. Что из этого включено у вас, знает только тот, кто администрирует вашу кассу.

У Poster есть публичная документация для разработчиков и каталог приложений. Набор методов и событий мы сверяем с документацией на момент проекта, потому что именно он определяет, получится ли забирать гостей и визиты регулярно или только выгружать отчёт.

Администратору кассы стоит задать 6 вопросов:

• Есть ли в кассе карточка гостя и обязателен ли телефон при закрытии чека.
• Сколько точек в сети и сколько из них на одной базе.
• Облачная касса или локальный сервер и кто может открыть к нему доступ интегратору.
• Какая версия и есть ли доступ к интерфейсу обмена.
• Работает ли карта лояльности в кассе и кто начисляет баллы.
• Какая доля заказов приходит через агрегаторы доставки.

Локальный сервер без внешнего доступа превращает подключение в отдельную задачу с участием вашего ИТ-специалиста. Закладывайте на неё время заранее: согласование доступа занимает дольше самой настройки.

Как устроена связка со стороны Битрикс24

Для обмена с кассой достаточно входящего вебхука. Он вызывает методы REST API от имени сотрудника, который его создал, и работает в пределах выбранных прав. Создать его может администратор или сотрудник, которому администратор разрешил это в разделе «Настройки» → «Настройки Битрикс24» → «Безопасность» → «Интеграции Битрикс24», в поле «Кому разрешить создавать входящие вебхуки».

1. Подготовьте поля. В карточке контакта заведите поля для даты последнего визита, числа визитов, суммы за период и точки сети. Точный путь зависит от тарифа и версии портала, поэтому проверьте его в своём интерфейсе.
2. Создайте входящий вебхук. Откройте раздел «Разработчикам», вкладку «Готовые сценарии», затем «Другое» → «Входящий вебхук». Выберите только нужные права, то есть CRM, и нажмите «Создать».
3. Сохраните адрес вебхука в защищённом месте. Его секретный код даёт доступ к порталу в пределах прав, поэтому в публичный код и переписку он не попадает. У вебхука можно задать дату окончания действия.
4. Перед созданием контакта ищите его по телефону. Метод crm.duplicate.findbycomm принимает тип PHONE или EMAIL и до 20 значений за вызов, а возвращает идентификаторы лидов, контактов и компаний.
5. Создавайте и обновляйте записи универсальным методом crm.item.add и его парами. Старые методы crm.deal.add и crm.contact.add в документации помечены как устаревшие.
6. Постановку задачи менеджеру настройте в автоматизации карточки контакта по условию на поле даты последнего визита.

Если нужно, чтобы касса узнавала об изменениях в CRM, добавляют исходящий вебхук: Битрикс24 отправляет POST-запрос с названием события на адрес вашего обработчика, а за полными данными обработчик обращается к REST API. Для первой версии обмен в одну сторону, из кассы в CRM, почти всегда достаточен.

Частоту обмена выбирают по задаче. Для сегмента гостей, которые не были 45 дней, достаточно одной выгрузки в сутки, например ночью, потому что звонить по такому списку никто не станет раньше утра. Для заявок на банкет нужна скорость другого порядка: сделка должна появиться сразу после отправки формы, а ответственный получить уведомление, пока клиент ещё ждёт ответа. Поэтому обмен с кассой и приём заявок строят как 2 независимых потока. Лимиты запросов к REST API Битрикс24 описаны в документации, и при выгрузке тысяч гостей запросы объединяют в пакеты, а не отправляют по одному.

Банкеты и корпоративы: заявка, предоплата, дата

Заявка на банкет почти никогда не приходит из кассы. Она приходит с сайта, из звонка или из мессенджера, и здесь работают штатные инструменты CRM. Форму создают в разделе «CRM» → «Продажи» → «Каналы продаж» → «CRM-формы». Если форма создаёт сделку, в ней выбирают воронку и указывают, что делать с найденными дублями контактов и компаний.

Воронку для площадки стоит держать отдельной от общих продаж. Стадии зависят от процесса, но обычно хватает 5 стадий: заявка, расчёт и меню, ожидание предоплаты, дата подтверждена, проведено. В карточке сделки нужны поля даты мероприятия, числа гостей, суммы предоплаты и юрлица, от которого выставляют счёт. Если юрлиц несколько, поле юрлица обязательно: иначе акт и счёт уйдут от неверного ИНН.

Два менеджера, которые продали один зал на одну субботу, чаще всего работали с таблицей без календаря. Поле даты в сделке и список сделок с фильтром по этому полю закрывают проблему без всякого обмена с кассой. Поэтому запуск часто начинают именно с воронки банкетов, а чеки подключают вторым этапом, когда нужен сегмент повторных гостей. Подробнее о том, как выстроить сам отдел, читайте в статье про отдел продаж в Битрикс24.

Дубли гостей: два уровня защиты

Гость, который пришёл через кассу, позвонил на площадку и оставил заявку на сайте, не должен превратиться в три карточки. Уровень 1 защиты стоит в самом обмене: перед созданием контакта скрипт ищет телефон через crm.duplicate.findbycomm и обновляет найденную карточку.

Уровень 2 настраивается в CRM. В справке для CRM-форм дубликатом считается запись, у которой совпадают любые два из трёх параметров: ФИО или название компании, телефон, e-mail. Для найденных дублей предусмотрено три режима: «Разрешить дубликаты» создаёт новую карточку, «Заменять дубликаты» перезаписывает поля данными формы, а «Объединять дубликаты» объединяет данные в одной карточке.

Для уже накопленных данных используется «Контроль дубликатов»: откройте «Клиенты» → «Контакты», затем «Настройки» → «Контроль дубликатов», выберите поля проверки и запустите сканирование. По справке, автоматически объединяются только карточки, у которых совпали значения всех полей и один ответственный. Остальные CRM предлагает объединить вручную. Мастер доступен не на всех тарифах, поэтому проверьте свой.

Ограничения и частые ситуации

Отдельно о персонале. Официанты и повара в Битрикс24 не работают. В CRM заходят 2 или 3 человека: менеджер площадок, администратор банкетов и руководитель. Обучение всего зала работе в CRM только мешает проекту и раздражает людей.

Проверка перед запуском

Пробный прогон делают на 20 гостях и трёх сценариях за 1 день.

Сценарий 1: заявка на банкет с сайта. Должна появиться сделка в нужной воронке с ответственным, датой и полем предоплаты, а файл меню должен прикрепляться к карточке. Сценарий 2: чек гостя с известным телефоном. Контакт должен найтись и обновиться, а не создаться заново, и поля визита должны измениться. Сценарий 3: претензия после зала. Она не должна попадать в ту же воронку, что и корпоратив, иначе руководитель продаж решит, что банкеты сыпятся.

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

Типичные ошибки

• Сделка из каждого чека. Воронка заполняется за сутки, и менеджеры перестают её открывать.
• Обмен запущен без правила дублей по телефону, и через неделю у каждого постоянного гостя по три карточки.
• Загрузка всех гостей в CRM без цели. Нужен сегмент, например гости без визита больше 45 дней, а не вся база.
• Вебхук с широкими правами, адрес которого лежит в чате. Секретный код открывает доступ к порталу, поэтому права ограничивают, а адрес хранят отдельно.
• Одна воронка для банкетов, бронь на вечер и претензий. Скорость процессов разная, поэтому смешивать их нельзя.
• Попытка заменить кассовый отчёт дашбордом в CRM. Касса, учёт и CRM работают рядом, и у каждой своя зона ответственности.

Вопросы и ответы про Poster, R-Keeper и Битрикс24

С чего начать и сколько это стоит

Начните с воронки банкетов: она не зависит от кассы и сразу убирает таблицу с датами и предоплатами.

Затем соберите ответы администратора кассы на 6 вопросов из раздела выше и решите, собираете ли вы телефон гостя на чеке. Обмен с Poster или R-Keeper подключается после этого, под конкретные данные, которые касса действительно отдаёт.

Если нужна настройка воронки, полей и прав вместе с обменом, начните с пакета «Старт» за 49 000 ₽. Состав работ и условия описаны на странице стоимости внедрения Битрикс24, а связку вашей кассы мы разбираем на консультации.

Об авторе: Иван Остривной, NAVIPOINT, партнёр Битрикс24.