Главная Интеграции Кассы (POS) ProCart

ProCart

Обновлено Oct 21, 2026

ProCart — модуль компании Carbis, через который внешние сервисы работают с кассой R-Keeper. Заказы с сайта и из приложения приходят в Смартомато, а после подтверждения попадают через кассовый терминал на кухню.

Модуль умеет только то, что есть в самом R-Keeper. Кроме того, Carbis сам решает, какие функции делать в ProCart: одни выходят в плановых обновлениях, другие делаются по заявке за отдельную плату. Пример: менять статус и закрывать заказ по API сам R-Keeper умеет, а ProCart — нет.

Что нужно до подключения

  • R-Keeper версии 7.6.4.347+ или 7.6.5.40+, Windows 7 или новее.
  • Статический белый внешний IP-адрес кассы и возможность пробросить порт.
  • Интерфейс «XML-сохранение заказа» (лицензия XML-Save Order). Поддерживаются SaaS- и lifetime-лицензии. По статье от 30.12.2025 интерфейс стоит 850 ₽ в месяц. Лицензию получают и активируют после настройки связи модуля с R-Keeper.
  • Модуль ProCart. Он платный, покупается у Carbis и лицензируется по числу кассовых серверов, с которыми работает. По статье от 30.12.2025: 2000 ₽ за месяц, 6000 ₽ за 3 месяца, 12 000 ₽ за полгода, 20 000 ₽ за год. Смартомато за интеграцию отдельно не берёт.
  • Меню — одна общая база (справочник), сколько бы ни было точек.

Шаги на стороне R-Keeper и Carbis

  1. Написать в обслуживающую организацию R-Keeper, примерно так: «Мы хотим внедрить у себя Смартомато и для этого необходимо поставить модуль Procart». Если там помочь не могут, то же письмо отправляют разработчику, Carbis, на zakaz@carbis.ru. Инженеры подскажут, как установить модуль и оплатить лицензию.
  2. Установить и настроить модуль по инструкциям Carbis: описание ProCart, настройка R-Keeper.
  3. Включить блюда для интернет-продаж в классификацию, прописанную в ini-файле ProCart. Зачем: меню отдаётся в Смартомато по этой классификации. Если она прописана неверно, меню не импортируется.
  4. Завести коды валют для предоплатных типов оплаты: картой онлайн, оплата на внешнем сервисе, бонусы. «Наличные» и «Картой курьеру» через API не передаются, так как передача доступна только для предоплатных валют. Способ оплаты придёт в комментарии к заказу, и кассир выбирает его вручную при закрытии.
  5. Проверить, что касса доступна: статус подключения показывает dev.carbis.ru/test.
  6. Не блокировать на сетевом оборудовании адреса API Смартомато — 95.213.242.92 и 95.213.242.80/28. При необходимости добавить их в белый список. Зачем: иначе Смартомато не достучится до кассы (см. «Типовые ошибки»).

Дополнительно, по задачам клиента

  • Цена доставки. Завести блюдо доставки с ценой 1 ₽ и сообщить код. Второй способ: завести по блюду на каждую цену доставки.
  • Сервисный сбор. Завести блюдо с ценой 1 ₽ и сообщить код, см. Итоги заказа и сервисный сбор.
  • Наценка. Передавать наценку отрицательной скидкой ProCart научился с версии v1.9.1.64, до неё нужно обновиться. Запасной способ — блюдо наценки с ценой 1 ₽, выгруженное для интернет-продаж. Он ломает чеки и себестоимость в отчётах. См. Наценка по источнику заказа.
  • Акции. Завести в Кипере суммовую скидку на заказ с изменяемым значением, по инструкции Carbis. Сумма скидки в рублях придёт в поле discounts.
  • Заказ за стол. Сообщить коды столов в Кипере. Для привязки заказов по источникам (доставка, самовывоз, агрегаторы) — коды столов под каждый источник. См. Заказ в зале и QR-меню.
  • Категории заказа. Сообщить коды категорий заказа из Кипера, если источник или тип доставки нужно связать с категорией.
  • Комментарий к блюду на чеке. Если он не печатается, клиент настраивает макет сервис-печати в Кипере сам или через обслуживающую организацию.

Несколько ресторанов

  • Три ресторана, три разных R-Keeper, разные коды блюд. В одном R-Keeper должно быть полное меню со всех точек, а коды блюд на всех точках — одинаковые. Доступность блюд по ресторанам затем выставляется вручную в Смартомато.
  • Разное меню по ресторанам. Если позиции различаются кодами (артикулами), импорт соберёт меню всех точек в единую номенклатуру. Это не сработает, если блюда одинаковые, а коды у них разные.

Что передать в Смартомато

  • Внешний IP машины и порт.
  • Токен доступа.
  • Коды валют: картой онлайн, оплата на внешнем сервисе, бонусы.
  • Для каждого ресторана — хост и токен его кассы.
  • При необходимости: коды блюд доставки, сервисного сбора и наценки, коды столов и категорий заказа.

Куда обращаться

Типовые ошибки и вопросы клиентов

  • **Failed to open TCP connection to <ip>:11111 (Connection refused …)**

    1. Удалить наш сертификат, чтобы применился правильный: выполнить certmgr.msc, найти и удалить сертификат smartomato, очистить кэш браузера. Либо вручную добавить в доверенные адреса API-сервера Смартомато: 95.213.242.92 и 95.213.242.80/28.
    2. Проверить, не заблокированы ли эти адреса у клиента. Адрес http://host:token/api/v3/ping должен открываться. Если не открывается, нужно проверить блокировки на сетевом оборудовании и добавить адреса в белый список.

  • **execution expired**. Касса недоступна, запрос ушёл в таймаут. Нужно обратиться к дилеру.

  • **(RKException) Инстанс … был деактивирован**. Проблема с лицензией: дилер перегенерирует лицензию на saas-xml.

  • **RK7CASH005: Ошибка печати на принтер UniFR.dll#1**. Нужно сразу проверить принтер: есть ли бумага, включён ли он. Для проверки попросить распечатать что-то другое, Кипер покажет подробности. По статье, вероятно, была передана предоплата, которую не удалось распечатать, а без печати на ФР она в заказе не сохраняется.

  • Меню не импортируется. В ini ProCart прописана не та классификация.

  • Блюдо на стопе в Смартомато, но в выгрузке его нет. Блюдо закрыто правом или торговой группой либо не добавлено в классификацию.

  • Как снять блюдо со стопа. На кассе открыть ограниченные или запрещённые блюда и удалить позицию из списка. Блюдо на стопе пропадает из выгрузки или приходит с ценой 0 (null).

  • Удалили позицию в R-Keeper, а она осталась в Смартомато. Импорт меню добавляет новые позиции и обновляет старые, но удалённое в R-Keeper не удаляет: убрать его нужно вручную.

  • Что не приходит из ProCart. Вложенные категории, фото блюд, КБЖУ, вес блюд. С весовыми блюдами интеграция не работает. Выгрузить меню из отдельной папки или категории нельзя.

  • Откуда берётся описание блюда. Если у блюда заполнен Комментарий, ProCart отдаёт его, даже когда заполнен Рецепт. Рецепт отдаётся, только если Комментария нет.

  • Какие статусы уходят в ProCart. Никакие: Смартомато статусы только принимает.

  • Бонусы и акции. Бонусы передаются отдельным типом оплаты, сумма скидки по акциям — отдельным полем.

Связанные статьи