Дилерам: настройка интеграции Контур.Маркета с r_keeper

Интеграция с Контур.Маркетом упрощает работу с крепким алкоголем для пользователей r_keeper: позволяет вести очередь марок, чтобы общепит мог быстро списывать продукцию на кассе и отчитываться о продажах в ЕГАИС.

Настройку со стороны Контур.Маркета пользователи выполняют сами. А в шагах со стороны r_keeper и StoreHouse им не обойтись без помощи дилеров. 

Эта инструкция для дилеров. Ниже мы рассказываем, как помочь пользователям настроить интеграцию.

Видеоинструкции

В этом ролике разбираем первый этап настройки интеграции и рассказываем:

• какие лицензии нужны и что с ними делать (подробнее см. в Шаг 2),
• как настроить справочник товаров в StoreHouse (подробнее см. в Шаг 3),
• как настроить права доступа в White Server и как проверить, что он готов к работе (подробнее см. в Шаг 4 и Шаг 5).

Во втором ролике разбираем следующий этап — настройку интеграции на стороне Контур.Маркета (подробнее см. в Шаг 6).

Ознакомьтесь с минимальными техническими требованиями

Если ваше ПО не соответствует им, обратитесь к дилерам r_keeper.

• Версия r_keeper должна быть 7.7.0.378 или выше. 
• WhiteServer должен быть версии 1.63.1 или выше.
• WhiteServer Agent должен быть версии 2.8.6.1 или выше.
• Интеграция работает только со StoreHouse 5 (минимальная версия 5.145). StoreHouse 4 не поддерживается.
• Наше решение также поддерживает работу с облачной системой r_keeper Cloud. 

С техническими требованиями для работы с ЕГАИС можно ознакомиться на официальном сайте Росалкогольтабакконтроля.

Подготовьте и распределите лицензии

Лицензии нужно распределить по подразделениям (точкам), в которых заведение работает с алкоголем. Именно по этим подразделениям Контур.Маркет будет получать данные для списания продукции в ЕГАИС. 

1. Запустите приложение «SDBman.exe».
2. Откройте «Storehouse» → «Объекты лицензирования подразделений». В основном окне указаны подразделения базы StoreHouse.
3. Отметьте флажками тип лицензии «ЕГАИС доп» для подразделений, на которые будут распространяться эти лицензии.

   

Настройте справочник товаров в StoreHouse

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

Если карточки позиций с крепким алкоголем в составе будут неправильно заполнены в StoreHouse 5, их не получится потом выгрузить в Контур.Маркет.

Как заполнить карточки товаров-ингредиентов

На вкладке «Основные параметры» нужно установить флаг «Алкогольная продукция» и указать код и вид продукции.

Код и вид продукции не выгружаются в Контур.Маркет и система не учитывает их при подборе марок. Поэтому можно указать любой код и вид из списка, не привязываясь к алкокодам. Главное, чтобы они относились к крепкому алкоголю. Например, для всех позиций крепкого алкоголя можно указать код 200 («Водка»), даже для вина, это не будет считаться ошибкой.

На вкладке «Единицы измерения» выберите единицу «Литр». Если раньше товар учитывался в штуках, укажите правильный коэффициент. Единицу «Литры» не нужно делать основной, она просто должна быть указана в карточке.

Как заполнить карточки блюд и комплектов

Все блюда с крепким алкоголем (чистые порции и коктейли) должны быть сопоставлены с комплектами, где ингредиентом указана карточка товара с флагом «Алкогольная продукция».

На вкладке «Списание» должно быть указано подразделение, для которого подключена лицензия «ЕГАИС доп».

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

ЕГАИС не учитывает доли миллилитра (0,1 мл; 0,5 мл и прочее). Поэтому, чтобы избежать расхождения остатков, важно указывать количество алкоголя целыми миллилитрами.

Настройте права доступа в White Server

Сначала настройте подключение White Server к StoreHouse 5, если не сделали это ранее. 

Пользователь, указанный в White Server для подключения к StoreHouse 5, должен иметь следующие права:

• Алкогольные ингредиенты в товаре (proc AlcPrepare).
• Алкогольные ингредиенты в товаре (Rid-ы в параметрах) (proc AlcPrepareRid).
• Алкогольные ингредиенты для списка товаров (proc AlcListPrepare).
• Алкогольные ингредиенты для поддерева меню (рго AlcMenuPrepare).

Проверьте, что White Server настроен

1. Зайдите в административную панель White Server по ссылке.
2. Откройте вкладку «Рестораны» в меню слева.
3. Укажите код объекта в поле «ObjectId» и нажмите «Найти».
4. Нажмите на значок шестеренки справа.

   

5. Во вкладке «Общая информация» проверьте, что:
   1. в блоке «Подключенные системы» есть система «StoreHouse» и для нее указано состояние «ОК».
   2. в блоке «Агенты V2»:
   • есть строка агента,
   • в колонке «Подключенные системы» для него указан «StoreHouse»,
   • его версия равняется 2.8.6.1 или выше,
   • агент активен (в колонке «Активность агента» указано актуальное время).

     

6. Во вкладке «Лицензии» проверьте, что:
   • есть активная лицензия в блоке «Лицензии Ws Client»,
   • есть активная лицензия «Контур.Маркет (Ws агрегатор)» в блоке «Лицензии WsProduct». 

     

Подключите интеграцию в Маркете

Этот шаг выполняется на стороне Контур.Маркета. Сначала нужно подготовиться к интеграции, убедившись в том, что:

1. В Контур.Маркете подключен модификатор «Интеграция госсистем с r_keeper» к одному из тарифов:

   • «Все госсистемы».

   • «ЕГАИС».

   • Сочетание любого тарифа для общепита «Базовый», «Оптимальный» или «Премиум» + модификатор «ЕГАИС».

2. Торговые точки в Контур.Маркете подключены к ЕГАИС. В настройках включена работа с порционным алкоголем.
3. Подключен Помощник УТМ.
4. В Маркете в разделе «Настройки» включена работа с порционным алкоголем.

Затем можно приступать к настройке интеграции. Для этого нужно:

1. Открыть в Контур.Маркете раздел «Настройки» → вкладка «Учет товаров».
2. Найти блок «r_keeper» и нажать «Начать настройку». 
3. Выполнить шаги мастера настройки, указанные на экране, чтобы привязать точку в Контур.Маркете к ресторану в r_keeper. Всего нужно выполнить пять шагов:

Проверить связь Маркета с ЕГАИС. Маркету нужно убедиться, что торговая точка подключена к ЕГАИС и помощнику УТМ. Если она уже подключена, мастер настройки покажет это и вы сможете перейти к следующему шагу.

Указать код объекта r_keeper. Для каждой точки в Маркете можно указать только один код ресторана. При продаже бутылок на кассе этого ресторана будут использоваться бутылки, поступившие по документам ЕГАИС именно в эту точку Маркета.

Сопоставить товары из StoreHouse 5. Это нужно, чтобы Контур.Маркет, r_keeper и StoreHouse 5 работали с одним каталогом товаров и блюд. 

Подключить API Маркета. API — это сервис, который помогает Контур.Маркету настроить связь с кассовой программой r_keeper.

Получить и передать вам FSRAR_ID и API-ключ, чтобы вы указали их в настройках менеджерской станции. 

Выберите архитектуру на кассовом сервере

Для корректной обработки чеков коррекции с алкоголем выберите новую архитектуру на кассовом сервере. Следуйте шагам:

1. Откройте папку «Rk7MidServer» и найдите файл «rkeeper.ini».

   

    

2. В файле укажите следующий ключ.

   [Features]
   NEW_INTENT_RECEIPT_ARCH = 1 ; 1 - для включения новой архитектуры чека намерения

   Подробнее про архитектуру см. в документации r_keeper. 

Настройте менеджерскую станцию

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

1. На менеджерской станции откройте вкладку «Меню» → «Меню».

   

2. В меню для всех блюд с крепким алкоголем (чистые порции и коктейли) нужно удалить все значения из поля «Схема модификаторов» — оно должно быть пустым.
   

   Это важно сделать для корректно списания крепкого алкоголя при нефискальной оплате. Дополнительно для корректной работы нефискальных оплат надо настроить валюту в r_keeper.

   

    

3. Откройте справочник «Настройки» → «Параметры». 
4. Перейдите во вкладку «Все» → «Параметры работы станции» → «Маркировка» → «Режим работы заведения».
5. Выберите значение «Режим HoReCa». Он нужен для реализации порционного алкоголя.
6. В параметре «Ввод марок для крепкого алкоголя» (доступен только дилерам) установите значение «Автоматически - через систему управления складом». Он нужен для реализации порционного алкоголя через r_keeper и ЕГАИС с использованием сторонней системы учета.
7. Узнайте у пользователя FSRAR_ID его торговой точки. В Контур.Маркете его можно найти в разделе «Настройки» → «Госсистемы» → блок «ЕГАИС» → поле «Код ЕГАИС». Или скопировать этот код из мастера настройки интеграции.
8. В менеджерской станции откройте справочник «Настройки» → «Центральный офис» → «Собственные юридические лица».
9. Заполните реквизиты юрлица: КПП и FSRAR_ID пользователя.

   

10. Откройте справочник «Сервис» → «Станции и устройства».
11. На вкладке «Свойства» для каждого ресторана заполните свойство «Главный кассовый сервер» — это кассовый сервер, необходимый для работы с интегратором.

    

12. В левой части отображаются кассовые станции. Для каждой из них укажите реквизиты юрлица для фискального регистратора. Они нужны для передачи данных интегратору.
    Что делать, если в одной базе работают сразу с несколькими ресторанами

    • Если они принадлежат одному юрлицу, нужно указать реквизиты для одного юрлица с разными КПП и затем привязать эти реквизиты к принтерам.

    • Если они принадлежат разным юрлицам, нужно создать отдельные юрлица и реквизиты к ним.

13. Откройте справочник «Сервис» → «Обработка сигналов устройств» → «MCR».
14. Убедитесь, что предустановленные MCR-алгоритмы «ЕГАИС EAN13» и «ЕГАИС PDF417» активны.
15. Откройте справочник «Настройки» → «Печать» → «Документы и макеты» → раздел «Документы CRM» → «Купон».
16. Создайте новый макет печати «ЕГАИС: Инфо». Для этого:
    1. Откройте дизайнер макета и импортируйте готовый макет EGAIS_kupon.mak. Он находится на FTP ftp://ftp.ucs.ru/rk7/other/fc_egais/EGAIS_kupon.mak. 
    2. В печатный макет кроме команды QRCode можно добавлять параметр QRProperties <высота>;<Уровень коррекции QR-кода>. Например: <QRProperties 100;15%><QRCode "[QRCodeField]">.
    3. В справочнике «Настройки» → «Печать» → «Схемы печати» выберите нужную схему печати и добавьте в представления документов созданный макет печати «ЕГАИС: Инфо». В свойствах представления выберите класс основного принтера, который будет печатать QR-код (обычно это чековый принтер).
17. Откройте справочник «Параметры» → «Установочные» → «Связь с другими системами».
18. В свойствах параметра «Классификация для ЕГАИС» выберите классификацию «Маркировка/Россия».

19. Если ранее для списания в ЕГАИС использовали библиотеку «Кассовый сервер >farcards>ExtdllEGAIS.dll», отключите для нее настройки. Списание будет проходить на стороне Контур.Маркета.
    

    Как отключить настройки

    1. В настройках менеджерской станции выберите кассовый сервер.

    2. Во вкладке «Устройства» найдите и удалите интерфейс «PDS interface #....».

    3. Если интерфейсов несколько, удалите тот, где в свойстве «PDS Server Name» прописано сетевое имя «Farcards», именно оно используется для связи с ЕГАИС.

       

        

Настройте связь с интегратором

1. На менеджерской станции откройте справочник «Сервис» → «Станции и устройства».
2. В списке кассовых серверов слева выберите «MID».
3. На вкладке «Устройства» вы увидите список драйверов.
4. Добавьте драйвер «Alcohol accounting interface for external services». На другие кассовые серверы ресторана добавлять этот драйвер не нужно.

   

5. Подтвердите выполнение операции.
6. В свойствах драйвера укажите: 
   
   URL интегратора — значение по умолчанию https://api.kontur.ru/market/v1/Rkeeper/fsrarIds/{fsrarid}/{command}, используйте его.
   
   Токен — это API-ключ, который вы получили в Маркете при настройке интеграции. 
   
   Authorization header format — значение по умолчанию x-kontur-apikey:%s, используйте его.

   

7. Запустите кассу r_keeper, чтобы проверить соединение с интегратором. При возникновении ошибки пользователь увидит значок, если его нет — настройка прошла успешно.

   

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

• Если вы партнер Маркета, обратитесь в СПП;
• Если вы не являетесь партнером Маркета, попросите пользователя обратиться в техподдержку Контур.Маркета.

Проверьте блюда в менеджерской станции

1. В справочнике «Меню» → «Модификаторы» должны быть добавлены группы модификаторов «ЕГАИС EAN13» и «DataMatrix/PDF417». Убедитесь, что эти модификаторы включены в используемые торговые группы.

   

2. В справочнике «Меню» → «Схемы модификаторов» должны быть добавлена схема «РОССИЯ: ЕГАИС», в которую входят группу модификаторов «ЕГАИС EAN13» и «ЕГАИС PDF417».

   

3. В справочнике «Меню» → «Классификации блюд» должна быть добавлена и активирована классификация «Маркировка/Россия» с предустановленными категориями.
   

   Если меню было создано до активации, сначала снимите флаг «Обяз. группировка». Затем активируйте классификацию, распределите блюда по категориям и снова установите флаг, если группировка нужна.

4. Для продажи крепкого алкоголя будут использоваться категории: 

   • «Алкогольные коктейли» для продажи напитков, в котором присутствует несколько ингредиентов, включая крепкий алкоголь.  

   • «Алкогольные напитки» для продажи чистого алкоголя (бокал вина, бутылка виски и тд). Такое блюдо должно содержать только один алкогольный товар-ингредиент. Иначе блюдо должно быть в группе «Алкогольные коктейли». 

     Для категории «Алкогольные напитки» должна быть выбрана схема модификаторов «РОССИЯ: ЕГАИС». Убедитесь, что эти категории включены в используемые торговые группы.

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

   • В классификации «Маркировка/Россия» выберите категорию «Алкогольные коктейли».

   • В свойстве «Тип товара» оставьте значение «Товар».

     

      

   Параметры для чистого алкоголя

   • В классификации «Маркировка/Россия» выберите категорию «Алкогольные напитки».

   • Выберите «Литр» в свойстве «Тип единицы измерения». Это значение передается в атрибут фискального чека «Мера количества предмета расчета» (Тег 2108). Если значение не заполнено, передаются штуки.

   • В свойстве «Тип товара» выберите значение «Подакцизный товар без кода маркировки».

     

      

Завершение настройки и рекомендации 

Настройка интеграции завершена. Все готово к работе, если:

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

Чтобы интеграция работала как надо, рекомендуем пользователям: 

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