Минимальные требования R-Keeper для работы интеграции:
Для работы интеграции, версия R-Keeper должна быть 7.7.0.363 или выше. 
WhiteServer должен быть версии 1.63.1 или выше.
WhiteServer Agent должен быть версии 2.8.6.1 или выше.
Работает интеграция только с StoreHouse 5 (минимальная версия 5.145), StoreHouse 4 не поддерживается.
Для работы интеграции нужно приобрести лицензию “R-Keeper модуль Интеграции SH5 для внешних систем ЕГАИС".
За обновлением версий и приобретением лицензии необходимо обратиться к вашему дилеру.

<!-- Узкая встроенная форма Bitrix24 (ID 726) -->
<div style="max-width:420px; margin:0 auto;">          <!-- ограничиваем ширину -->
  <div style="transform:scale(0.80); transform-origin:0 0;"> <!-- при необходимости уменьшаем -->
    <script data-b24-form="inline/726/2ukvec" data-skip-moving="true">
      (function (w, d, u) {
        var s = d.createElement('script'); s.async = true;
        s.src = u + '?' + (Date.now() / 180000 | 0);
        var h = d.getElementsByTagName('script')[0];
        h.parentNode.insertBefore(s, h);
      })(window, document,
        'https://cdn-ru.bitrix24.ru/b3926067/crm/form/loader_726.js');
    </script>
  </div>
</div>

Если вы соответствуете минимальным требованиям R-Keeper для работы интеграции, то перед настройкой самой интеграции нужно выполнить предварительные шаги.

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

В ходе выполнения инструкции вам нужно самостоятельно или с помощью дилера:
- Распределить лицензии;
- Проверить наличие FSRAR ID в учетной системе;
- Настроить справочники;
- Настроить карточки блюд;
- Настроить обязательные параметры для чистого алкоголя и коктейлей;
- Проверить настройки работы списаний.

Соответствующие инструкции находятся в разделах ниже.

После этого вам необходимо либо обратиться за донастройками к тех. поддержке Docsinbox, либо завершить настройку самостоятельно с помощью раздела "Самостоятельные настройки интеграции с DocsInBox"


Распределить лицензии (выполняется самостоятельно или с помощью дилера)

Распределение лицензий по подразделениям производится в "SDBman.exe".

  1. Перейдите в пункт "Storehouse" > "Объекты лицензирования подразделений". 
  2. В основном окне перечислены подразделения базы Store House. 
    Флагами для типа лицензии «ЕГАИС доп.» определите для подразделений, на которые будет распространяться действия данных лицензий. Именно для этих подразделений можно будет получать информацию для ЕГАИС для интеграции DocsInBox.

После того, как лицензии распределены нужно настроить справочники.

Проверить наличие FSRAR ID и КПП в учетной системе (выполняется самостоятельно или с помощью дилера)

В справочнике “Настройки” > “Центральный офис” > “Собственные юридические лица” убедитесь, что для вашего юрлица прописаны КПП и FSRAR ID.

Если они не прописаны, то пропишите и сохраните изменения. 

Если вашего юрлица нет, то его необходимо создать. Инструкция от R-Keeper: https://docs.rkeeper.ru/rk7/latest/ru/sobstvennye-yuridicheskie-litsa-37065851.html#id-%D0%AE%D1%80%D0%B8%D0%B4%D0%B8%D1%87%D0%B5%D1%81%D0%BA%D0%B8%D0%B5%D0%BB%D0%B8%D1%86%D0%B0-%D0%A1%D0%BE%D0%B7%D0%B4%D0%B0%D0%BD%D0%B8%D0%B5%D0%BD%D0%BE%D0%B2%D0%BE%D0%B3%D0%BE%D1%8E%D1%80%D0%B8%D0%B4%D0%B8%D1%87%D0%B5%D1%81%D0%BA%D0%BE%D0%B3%D0%BE%D0%BB%D0%B8%D1%86%D0%B0


Настроить справочники (выполняется самостоятельно или с помощью дилера)

  1. У ингредиентов должен быть выставлен флаг «Алкогольная продукция». И у данного товара на закладке «Единицы измерения» есть единица измерения «Литр», нужно указывать именно литры. Важно указать правильный коэффициент, если до этого в товаре были только штуки.

2. В комплекты блюд «чистого алкоголя» и «коктейли» входя ингредиенты с флагом алкогольная продукция. 
3. На блюде обязательно должен стоять флаг "Производить".
4. Для блюд r_k 7 (чистый алкоголь и коктейли) должна быть заполнена закладка "Списание" (определены подразделения списания)
5. В качестве кода алкогольной продукции можно указывать один и тот же код для всех алкогольных товаров. Главное, чтобы код соответствовал крепкому алкоголю.

Настроить карточки блюда в R-Keeper (выполняется самостоятельно или с помощью дилера)

Проверьте наличие предустановленных условий:

  1. В справочнике Меню > Модификаторы по умолчанию добавлены группы модификаторов ЕГАИС EAN13 или ЕГАИС EAN, а также DataMatrix/PDF417
    Также убедитесь, что модификаторы включены в используемые торговые группы
  2. В справочнике Меню > Схемы модификаторов по умолчанию добавлена схема РОССИЯ: ЕГАИС, в которую входят группу модификаторов ЕГАИС EAN13 или ЕГАИС EAN, а также ЕГАИС PDF41.
  3. В справочник Меню > Классификации блюд по умолчанию добавлена классификация Маркировка/Россия с предустановленными категориями. Если классификация не активирована, активируйте ее.
    Если меню было заведено до активации классификации, чтобы активировать классификацию Маркировка/Россия, снимите флаг Обяз. группировка. Активируйте классификацию, распределите все блюда по категориям, а потом снова выставьте флаг, если обязательность группировки нужна.
    Для продажи алкоголя будут использоваться категории Алкогольные напитки и Алкогольные коктейли. Для категории Алкогольные напитки выбрана схема модификаторов РОССИЯ: ЕГАИС.
    Также убедитесь, что категории включены в используемую торговую группу.
  4. Для каждого блюда, которое должно учитываться при порционной продаже алкоголя, заполните обязательные параметры.
  5. Для каждого товара, который должен учитываться при порционной продаже алкоголя, во вкладке «Списание» нужны данные в таблице под столбцами «Место реализации» и «Подразделение». В строке «Списывать по умолчанию» должно быть указано актуальное место реализации.

Обязательные параметры для чистого алкоголя (выполняется самостоятельно или с помощью дилера)

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

Обязательные параметры для коктейлей (выполняется самостоятельно или с помощью дилера)

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


Проверить настройки работы списаний (выполняется самостоятельно или с помощью дилера)

  1. В справочнике перейдите по пути Настройки > Параметры > Параметры работы станции > Маркировка > Режим работы заведения.
    Проверьте, что в строке "Значение" указано "Режим HoReCa" или поставьте его.

2. В справочнике перейдите по пути Настройки > Параметры > Параметры работы станций > Маркировка > Ввод марок для крепкого алкоголя.

Проверьте, что в строке "Значение" указано "Автоматически - через систему управления складом

3. На главной кассе в справочнике Настройки > Печать > Документы > Документы CRM" > Купон должен быть создан макет печати ЕГАИС:Инфо.

Если его нет, то получить его можно у вашего дилера.

Мониторинг связи между кассой и интегратором DocsInBox

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

Если возникла проблема со связью, то маркер загорится красным. Если маркера нет, то все в порядке.


Самостоятельные настройки интеграции с DocsInBox (выполняется самостоятельно или через обращение к тех. поддержке Docsinbox)

Для того, чтобы настроить интеграцию самостоятельно, вам нужно в справочнике Сервисы > Кассовые станции и устройства > Устройства нажать правой кнопкой мыши на свободное пространство и в выпадающем списке выбрать "Список драйверов".

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

В списке найдите драйвер "Alcohol accounting interface for external services" и перетяните его в "Устройства".

Подтвердите запрос и теперь нужно осталось заполнить строки настроек (выделены красным) самого драйвера.

Введите следующие значения:

В строке URL — https://dxbx.ru/api/rkeeper-gateway/v1

В строке Authorization header format — X-Dxbx-Api-Key:%s

В строке LogLevel — Talcative

В строке Token — получить его можно обратившись в нашу тех. поддержку. Мы сможем отправить значение для этой строки на почту, которая привязана к вашему юридическому лицу в DocsInBox.

После того, как все поля заполнены нажмите ctrl+S, чтобы сохранить изменения, и перезагрузите R-Keeper.

После этого необходимо перейти по пути "Сервис"> "Интерфейсы".

Выберите “Интерфейс Алкоголь/Россия линк”. В блоке “Файлы библиотек” нажмите на знак + слева от названия станции и убедитесь, что на главном сервере стоит “Alcohol accounting interface for external service”. Если не стоит, то кликните по полю и выберите этот интерфейс.

Тоже самое проделайте для всех интерфейсов, которые согласно названию могли бы работать с крепким алкоголем. Например, для интерфейса «Продажа порционного алкоголя», если он есть.

Снова сохраните изменения и перезагрузите R-Keeper. 

Интеграция завершена.