Интеграция с ЕГАИС
Введение
Работа в системе ЕГАИС для предприятий общественного питания происходит только в части подтверждения факта закупки алкоголя (!), а не в части передачи данных о продажах.
Требования к подключению к ЕГАИС
- Зарегистрироваться в личном кабинете на сайте РАР service.fsrar.ru и получить FSRAR_ID.
- Скачать «Универсальный транспортный модуль» (УТМ). УТМ требует версию Windows 7 Starter и выше. На Windows XP не работает.
- Приобрести носитель для электронно-цифровой подписи и получить электронную подпись, например, через Аладдин , ИТ-Трейд, ЦентрИнформ.
При наличии на носителе нескольких сертификатов КЭП (квалифицированной электронной подписи), РАР не гарантирует работу сервиса УТМ. Если у Вас предприятие общественного питания, то с 01.01.2016 Вы должны принимать алкоголь только через ЕГАИС. Создание приходных документов вручную, в которых участвует алкогольная продукция, не рекомендуется!
После регистрации в РАР необходимо:
- Установить УТМ (Универсальный транспортный модуль), предоставляемый РАР.
- Произвести обновление Store House до версии 5.14.87 или выше.
- Настроить связь с УТМ в свойствах КПП подразделений в Store House.
- Запустить QushSvc.exe для получения данных из УТМ
Настройка связи с УТМ
Перед началом работы с системой ЕГАИС необходимо произвести предварительные настройки связи с Универсальным транспортным модулем.
- Откройте справочник Подразделения
- Выберите подразделение, для которого будете вносить настройки связи с УТМ и откройте карточку этого подразделения
- Выберите КПП в списке КПП подразделения, если их несколько и через контекстное меню откройте окно свойств КПП
- Укажите FSRAR_ID подразделения в поле Внешний код
Внешний код – FSRAR_ID присвоенный в базе ЕГАИС данному корреспонденту при фиксировании организации в ЕГАИС. Поле может быть заполнено вручную или автоматически при сопоставлении при работе с ЕГАИС. Данное поле необходимо заполнять только для корреспондентов, поставляющих алкогольную продукцию, и приход алкогольной продукции оформляется через ЕГАИС.
- Заполните поля Хост и Порт для подключения к УТМ
- Проделайте данную настройку для всех КПП, работающих с УТМ
- Проверьте подключение к УТМ.
Для версии Store House 5.109.397 и выше настройки УТМ можно прописать в файле конфигурации sh.ini. После установки приложения файл находится на системном диске C:\ в папке Store House 5 — Client.
Важно!
По умолчанию настройки подключения УТМ задаются в свойствах подразделений. В настройках в файле sh.ini необходимо указать все FSRAR_ID, которые не должны брать настройки подключения УТМ из свойств подразделений.Откройте файл sh.ini и пропишите настройки в блок ЕГАИС. В переменной "xxFSRARIDxx" вставьте цифры в соответствии с внешним кодом FSRAR_ID. Укажите в настройках IP-адрес и порт УТМ, а также логин и пароль, если они были заданы.
Если подключение настраивается через прокси-сервер, укажите в настройках его IP-адрес, порт и данные для авторизации.
[EGAIS]
Необязательные настройки в SH.INI, "xxFSRARIDxx" - заменить на цифры
Пример:
UtmHost_123456789012 = localhost
UtmPort_123456789012 = 18088
UtmHost_xxFSRARIDxx = более приоритетная, чем указанная в БД
UtmPort_xxFSRARIDxx = более приоритетная, чем указанная в БД
UserName_xxFSRARIDxx = если в УТМ задан логин-пароль
Password_xxFSRARIDxx = если в УТМ задан логин-пароль
ProxyHost_xxFSRARIDxx = если надо подключаться через прокси-сервер
ProxyPort_xxFSRARIDxx = если надо подключаться через прокси-сервер
ProxyUser_xxFSRARIDxx = если прокси-сервер имеет логин-пароль
ProxyPass_xxFSRARIDxx = если прокси-сервер имеет логин-пароль
Важно!
Для доступа к УТМ из Sh.exe приоритетнее настройки, указанные в файле sh.ini.Работа с QushSvc.exe и QushMan.exe
Для получения данных из УТМ в StoreHouse V5 сервер QushSvc.exe должен быть запущен. Поэтому рекомендуем установить сервер как службу. Если сервер настроен на работу с несколькими базами данных Store House и несколькими УТМ, рекомендуем вынести приложение на сервер компании, который работает постоянно.
Настройка QushSvc.exe на работу с ЕГАИС происходит в приложении QushMan.exe. Для этого запустите приложение и выберите пункт ЕГАИС в меню Файл.
Один сервер QushSvc.exe может выполнять задания на обмен данными разных УТМ с одной базой Store House и нескольких УТМ с соответствующими базами Store House (отдельными).
Для начала работы необходимо создать записи в Qushman.exe, в которых указаны параметры подключения баз Store House, работающих с ЕГАИС.
Для добавления записи в Qushman.exe:
- В левой части экрана воспользуйтесь пунктом контекстного меню Создать или нажмите клавишу Ins на клавиатуре
- Внесите наименование записи, по которому будет возможно определить базу Store House, работающую с ЕГАИС
- Для сохранения новой записи нажмите клавишу Enter на клавиатуре
- Если запись была добавления ошибочно для удаление воспользуйтесь пунктом контекстного меню Удалить или нажмите клавишу Del на клавиатуре
- Чтобы переименовать уже созданную запись воспользуйтесь пунктом контекстного меню Переименовать
После создания записи с именем базы необходимо настроить подключение к базе StoreHouse.
После успешного подключения к базе Store House на закладке УТМ будут выведены все настроенные подключения к УТМ.
УТМ считается настроенным, если для КПП подразделения заполнены поля Хост и Порт.
- Сервер – хост и порт подключения к УТМ.
- FSRAR_ID – уникальный идентификатор ЕГАИС для КПП.
- Статус – статус подключения к УТМ.
- ОК – соединение с УТМ установлено.
- Ошибка – ошибка подключения к УТМ.
При успешном подключении к УТМ можно просмотреть протокол загруженных в базу Store House накладных. Для этого на строке подключения воспользуйтесь командой контекстного меню Протокол. В открывшемся окне будет выведен список загруженных накладных в базу StoreHouse выбранного подключения к УТМ.
Список накладных выводится в обратном порядке: последние загруженные накладные будут находиться вверху списка.
Схема работы
В УТМ от поставщиков и ЕГАИС поступают документы, акты и квитанции определенных форматов в виде XML-файлов. QushSvc.exe опрашивает УТМ на предмет наличия новых документов.
Если в УТМ имеются новые документы, то QushSvc.exe разбирает соответствующие XML-файлы и записывает в БД StoreHouse пришедшую информацию.
- Для исполнения рекомендаций законодательства и избежание дублирования данных в StoreHouse, XML-файлы удаляются из УТМ средствами QushSvc.exe после сохранения в базу SH.
- В базу StoreHouse не сохраняются результаты запросов.
- При записи приходных документов в базу StoreHouse происходит автоматическое сохранение новых справочников ЕГАИС (товары и корреспонденты) в базу StoreHouse
Результаты запросов хранятся в УТМ 24 часа. Через сутки XML-ответы на запросы удаляются средствами УТМ.
Если из StoreHouse оформляются акты для ЕГАИС, то отправкой их в УТМ занимается клиент Sh.exe.
Решение проблем
Ошибка: Multiple depart`s kpps was found found by FSRAR_ID[значение ID]
Решение: В Store House есть несколько подразделений с разными КПП, но одинаковыми FSRAR_ID. Проверьте настройки подразделений.