Настройка интеграции r_keeper с Контур.Маркет

Настройки интеграции со стороны r_keeper и StoreHouse выполняются техническими специалистами.

Настройку со стороны Контур.Маркет пользователи выполняют сами.

На каких этапах нужны тех.специалисты

• Проверить и при необходимости обновить ПО пользователя до минимально требуемых версий.

   Минимальные системные требования

  Версия r_keeper должна быть 7.7.0.363 или выше. 

  WhiteServer должен быть версии 1.63.1 или выше.

  WhiteServer Agent должен быть версии 2.8.6.1 или выше.

  Интеграция работает только со StoreHouse PRO (минимальная версия 5.145), StoreHouse 4 не поддерживается.

• Проверить наличие необходимых лицензий и распределить их по подразделениям.

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

  

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

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

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

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

   

Шаг 2. Настройте справочник товаров в StoreHouse

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

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

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

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

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

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

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

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

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

Шаг 3. Настройте права доступа в White Server

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

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

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

  

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

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

• В Контур.Маркете подключен нужный тариф с модификатором для интеграции c r_keeper
• Торговые точки в Контур.Маркете подключены к ЕГАИС. В настройках включена работа с порционным алкоголем.

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

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

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

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

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

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

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

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

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

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

   

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

   

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

   

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

       

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

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, чтобы проверить соединение с интегратором. При возникновении ошибки пользователь увидит значок, если его нет — настройка прошла успешно.
   

   

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

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

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

   

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

   

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

   

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

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

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

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

     

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

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

    Параметры для коктейлей

   1. В классификации Маркировка/Россия выберите категорию Алкогольные коктейли.
   2. В свойстве Тип товара оставьте значение Товар.
      

      

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

   1. В классификации Маркировка/Россия выберите категорию Алкогольные напитки.
   2. Выберите Литр в свойстве Тип единицы измерения. Это значение передается в атрибут фискального чека Мера количества предмета расчета (Тег 2108). Если значение не заполнено, передаются штуки.
   3. В свойстве Тип товара выберите значение Подакцизный товар без кода маркировки.

   

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

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

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

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

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