Быстрый старт
Путь интегратора: от запроса до запуска с White Server (для ресторанов и кафе)
Цель документа: провести интегратора по маршруту от первого письма до работающей интеграции, готовой к продаже через дилерскую сеть r_keeper.
Почта запроса для новых интеграторов: integrations@rkeeper.ru
Что отправить:
- Тема: [Название компании] – Запрос на интеграцию с WS
- Тело письма:
- Статус: Являемся интегратором / разработчиком ПО
- Реквизиты организации
- Краткое описание сервиса
- Был ли запрос тестового стенда ранее (да/нет)
Взаимодействия:
Сотрудник технической поддержки обрабатывает запрос, при принятии положительного решения заводится тестовый объект.
На объект устанавливаются лицензии сроком на 3 месяца:
- R-Keeper Cloud-RK7 Stations Start
- WS Server-TEST
Доступы отправляются на реквизиты, указанные в письме.
Условия тестового доступа:
- Бесплатно ( при тесте нет доступа к админке WS)
- Лимит: 5 запросов в минуту
- Только для разработки и отладки
- Срок действия: 3 месяца (продление возможно по запросу)
Платные услуги (по желанию интегратора):
- Настройка тестового стенда силами r_keeper
- Расширенные консультации: минимальный пакет — 5 часов
Интегратор ведёт разработку самостоятельно, согласно документации:
- Стандартные методы White Server API v2 — для типовых сценариев
- Метод ExecuteRk7Query — для выполнения произвольных запросов на кассе через WS
- Необходимые настройки доступны в административной панели WSA. Для авторизации используйте логин и пароль от системы лицензирования
- Подробнее об административной панели читайте в статьях раздела Административная панель.
При возникновении сложностей возможно обращение на integrations@rkeeper.ru с описанием возникшей проблемы.
Доступы:
Тестовый стенд WS, API-ключи, тестовые лицензии — получены на шаге 1
Критерии готовности решения:
- Интеграция стабильно работает на тестовом стенде
- Все сценарии воспроизводятся штатно
- Решение готово к предложению клиентам.
Разработка по FarCards производится силами интегратора, если необходима помощь, рекомендуем обратится к дилерам (Карбис, ЦТО, Делавто).
Тестирование возможно на своем стенде, если его нет — предоставляем на общих условиях.
Обязательный этап перед выходом в прод — Выпуск рабочей лицензии
Минимальные требования: работающий объект со всеми необходимыми для полноценной работы r_keeper лицензиями.
Без выполненного выпуска лицензии интеграция не может быть продана. 1 объект =1 лицензия WS.
Канал запроса: integrations@rkeeper.ru
Тема письма: [Название компании] — Выпуск лицензии для интеграции [Название сервиса]
- ФИО контактного лица
- Уникальный email (не использовался ранее в системе лицензирования для других интеграций)
- Полные реквизиты организации, указанные на бланке Письмо на получение мастер-пароля
- Название лицензии (уникальное, обычно соответствует названию сервиса)
Внутренний процесс:
- На основании запроса оформляется Приказ на ввод новой номенклатуры
- Срок выпуска номенклатуры лицензии: до 3х рабочих дней.
Результат:
После оформления договора на указанный email направляются:
- Мастер-пароль
- Доступ в административную панель WS
- Доступ в систему лицензирования
- Токен WS для настройки интеграции
Интеграция доступна для приобретения только через авторизованных дилеров r_keeper.
Интегратор вправе самостоятельно определять каналы поиска клиентов: прямой поиск ресторанов, партнерство с дилерами
r_keeper нейтрален к способу привлечения клиента.
- лимит 360 запросов/мин.
Монетизация:
- Оплата возникает только при подключении первого реального объекта
- Плательщиком может выступать как конечный потребитель (ресторан) так и интегратор.
Схема расчётов: ресторан/агрегатор → дилер → r_keeper (детали междилерских соглашений не регламентируются).
Условия оплаты и взаиморасчетов зависят от количества подключаемых объектов и популярности вашего сервиса.
Пример подключения ресторана:
Вариант I (подходит любому интегратору)
- Ресторан обращается к дилеру
- Дилер оформляет продажу и активирует интеграцию
- Интегратор в процесс выставления/оплаты счетов не вовлечён.
Вариант II (актуален для крупных агрегаторов)
- Агрегатор имеет пул ресторанов для подключения своей интеграции, обращается к дилеру
- Дилер оформляет продажу на указанные объекты и активирует интеграцию
- Счет по указанным объектам оплачивает агрегатор.
Возможные нюансы:
- На объекте нет юр.лица и клиент не помнит, от какого юр. лица закупал ПО. Обратитесь на order@rkeeper.ru или в телеграмм-чат с описанием проблемы и указанием кода объекта.
- По каким-то причинам вам нужен код генерации лицензии. Обратитесь на order@rkeeper.ru или в телеграмм-чат с описанием проблемы и указанием кода объекта.
- Сотрудник с доступом в СЛ создает заявку Заказ агрегатора на нужный объект

- В данной заявке нужно заполнить следующие поля:
- 9-значный код объекта (например 5000100)
- ИНН юр. лица клиента
- наименование Юр.лица клиента
- Тип продукта Лицензия по подписке
- Юр.лицо плательщика – выбирается ОБЯЗАТЕЛЬНО юр. лицо Агрегатора

- В табличной части заявки выберите лицензию R-Keeper модуль [название лицензии] ПО и нажмите кнопку Заказать

- Активная лицензия автоматически появится на данном объекте. Можно настраивать интеграцию.