Как настроить интеграцию с r_keeper в Маркете
Интеграция с Контур.Маркетом упрощает работу с крепким алкоголем для пользователей r_keeper: позволяет вести очередь марок, чтобы общепит мог быстро списывать продукцию на кассе и отчитываться о продажах в ЕГАИС.
Прежде чем приступать к настройке интеграции, подготовьте все необходимое.
Старт
- Откройте в Маркете раздел «Настройки» → вкладка «Учет товаров».
- В блоке «r_keeper» нажмите «Начать настройку».
- Следуйте шагам мастера настройки на экране. Ниже мы рассказываем о них подробнее — это на случай, если у вас возникнут трудности.
Настройте работу с ЕГАИС
Маркету нужно убедиться, что ваша торговая точка подключена к ЕГАИС и помощнику УТМ. Если она уже подключена, мастер настройки покажет это и вы сможете перейти к следующему шагу.

Подключитесь к r_keeper
На этом шаге вам потребуется код объекта — это уникальный идентификатор вашей торговой точки в r_keeper, он состоит из 9 знаков. Как узнать код объекта.
Если у вас несколько ресторанов, то нужно указать код того объекта, в торговой точке которого вы будете работать с очередью марок в Маркете.

Сопоставьте товары StoreHouse 5 с Маркетом
На кассе r_keeper продаются блюда, например, бокал вина, коктейль Маргарита и прочее. При этом на кассе нет информации об алкогольных ингредиентах в составе этих блюд. Она хранится на стороне StoreHouse 5.
Поэтому вам нужно сопоставить каталоги StoreHouse 5 и Маркета, установив связь между алкогольными товарами в StoreHouse 5 и алкокодами в Маркете. Тогда при продаже касса r_keeper будет отправлять запрос в Маркет, а он запросит у StoreHouse 5 актуальную техкарту и поймет, какой алкогольный ингредиент и в каком количестве нужно списать.
Достаточно один раз сопоставить товар — Маркет запомнит ваш выбор и будет подставлять марки при продаже крепкого алкоголя на кассе. Обратите внимание, что для каждой позиции крепкого алкоголя должен быть указан штрихкод. Если его нет, вы увидите значок . Когда вы закончите сопоставление, возвращайтесь в мастер настройки.

Если товары не найдены, значит их карточки неправильно заполнены в Storehouse. Проверьте и отредактируйте их в вашей товароучетной системе. Затем обновите страницу и продолжите сопоставление позиций в Маркете.
Подключите API Маркета
API — это сервис, который помогает Маркету настроить связь с кассовой программой r_keeper. API важен для интеграции. Чтобы подключить его, просто нажмите кнопку в мастере настройки.

Настройте менеджерскую станцию r_keeper
- Скопируйте FSRAR_ID и получите уникальный API-ключ в Контур.Интеграторе.
Скопируйте и сохраните API-ключ в надежном месте, потому что он будет показан только один раз. Это сделано в целях безопасности — мы не храним ключи на своей стороне.
- Передайте FSRAR_ID и API-ключ вашему дилеру r_keeper. Он укажет их в настройках менеджерской станции.
- В мастере настройки нажмите «Далее».
- Готово, настройка интеграции со стороны Маркета завершена.
- После того, как дилер завершит настройку интеграции со стороны r_keeper, можно приступать к наполнению очереди списания, чтобы без лишнего сканирования продавать и списывать крепкий алкоголь.
Как проверить, что интеграция настроена
На кассе r_keeper нет уведомления об ошибке.

Алкогольные товары успешно выгружены из StoreHouse 5 и сопоставлены в Контур.Маркете.

Все готово: как работать с r_keeper
Процесс работы с крепким алкоголем на кассе при формировании чеков не меняется. С очередью списания вам не придется при продаже каждой порции крепкого алкоголя сканировать акцизную марку с бутылки, считать в конце смены потраченный алкоголь и вручную создавать акты списания. Маркет сделает это за вас.
Например, вы добавляете в чек бутылку виски 700 мл и два бокала вина по 150 мл. Ваша касса запрашивает марки у Маркета. Если вы ранее добавили этот алкоголь в очередь и он еще не израсходовался — Маркет подставит марки и отправит данные о продаже в ЕГАИС. Бутылка виски и 300 мл вина будут списаны. После продажи Маркет обновит баланс в очереди. Весь проданный алкоголь отобразится в разделе «Журнал продаж».
Маркет получает из вашей товароучетной системы данные по техкартам — поэтому он знает, сколько мл крепкого алкоголя содержится в каждом коктейле.
Например, вы добавляете в чек коктейль «Джин-тоник». Сама продажа проходит как в примере выше: касса запрашивает марку, а Маркет, если может, ее подставляет. А как списать такой алкоголь? Касса сообщает Маркету, что продала 50 мл джина в составе коктейля, он запоминает это и обновляет баланс очереди. В конце смены весь проданный алкоголь отобразится в Маркете в «Журнале продаж». Вам останется только проверить данные и нажать «Отправить» — для алкоголя, проданного в составе коктейлей, Маркет сам сформирует акт списания и отправит его в ЕГАИС.
Если вы не добавили марки в очередь списания или они израсходовались — Маркет не сможет подставить их.
Пополнить очередь списания можно в Маркете в разделе «Журнал продаж» → кнопка «Очередь списания».
Чтобы вернуться к сопоставлению товаров, откройте в Маркете раздел «Настройки» → вкладка «Учет товаров» → блок «r_keeper» и нажмите на поле «Товары».
