Интеграция с 1С

Настроить подключение интеграции с 1С на стороне ELMA365
После того как в 1С загружено специальное расширение ELMA365 и подключён обмен данными, необходимо выполнить настройки на стороне ELMA365.

1. Убедиться, что в систему загружены решения: КЭДО 3.0, Портал КЭДО, КЭДО365: Интеграция с 1С.
2. Провести процесс первичных настроек в КЭДО.
3. Перейти в раздел Интеграция 1С > Главная и запустить Первичную настройку интеграции 1С.

По завершении процесса проверить следующие настройки:

• в разделе КЭДО 3.0 > Интеграции КЭДО добавлен элемент приложения Интеграция с 1С;
• в разделе КЭДО 3.0 > Модели данных интеграции созданы элементы: Приказ на увольнение, Приказ на отпуск, Приказ на командировку (Перевод, Дополнительные дни отдыха, Донорство (сдача крови) (сотрудник не работал), Материальная помощь, График отпусков, Совмещение, Трудоустройство, Приказ на увольнение, Приказ на командировку, Приказ на отпуск).

4. В разделе Администрирование > Модули, включить Модуль КЭДО 3.0.
5. Включить модуль КЭДО365: Интеграция с 1С. Настроить у модуля опцию Регистрировать журнал интеграций. При выборе Да данные обмена между ELMA365 и 1С будут фиксироваться в разделе Интеграция 1С > Журнал интеграции для отслеживания актуального состояние процессов обмена.

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

Установить расширение ELMA365 в 1С

1. В 1С раздел Администрирование, пункт Печатные формы, отчеты и обработки > Расширения.
2. Добавить из файла и загрузить файл ELMA.cfeс расширением для 1С.

3. По окончании загрузки в списке появится расширение ELMA365. Выключить опцию Безопасный режим.
4. Перезагрузить 1С, чтобы добавить в программу новый раздел ELMA365.
5. В разделе ELMA365 и выбрать пункт Использовать интеграцию с ELMA365.

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

6. При необходимости обновления расширения, нужно перейти в раздел Администрирование > Печатные формы, отчеты и обработки > Расширения. В списке выбрать ELMA365, нажать Обновить из файла и загрузить файл с новой версией решения. Перезапустить программу 1С.

Настроить подключение к «ELMA365 КЭДО 3.0»
Для подключения возможности отправки документов из 1С в ELMA365 в 1С необходимо перейти в раздел ELMA365 и выбрать Настройка интеграции с ELMA365. Настройки на странице выполняются в следующих вкладках: Настройка печатных форм, Подключение и обмен данными, Функциональные настройки, Доступ.
Вкладка «Настройка печатных форм»
На этой вкладке настраивается автоматическая отправка печатных форм документов из 1С в ELMA365. Настройка выполняется опционально:

1. В списке типов документов выбрать те, печатные формы которых необходимо отправлять в ELMA365.

2. В поле Печатные формы для обмена отметить необходимые печатные формы.
Вкладка «Подключение и обмен данными»
На этой вкладке определяются общие настройки расширения.

• Использовать авторизацию — опция включает проверку доступа к работе с установленным расширением в 1С. Если у пользователя есть карточка в ELMA365 в разделе КЭДО 3.0 > Физические лица, и он трудоустроен в указанной организации, он сможет отправлять запросы из 1С в ELMA365.
• Хост — скопировать значение в URL-адресе главной страницы ELMA365 без https:// и вставить в поле;
• Базовый адрес ресурса — указать путь для доступа к Web API модуля интеграции с 1С в ELMA365 — Модуль КЭДО 3.0.
• Токен — указать токен для авторизации запросов к API ELMA365, созданный при выполнении первичных настроек решения. В ELMA365 перейти в раздел КЭДО 3.0 > Меню настроек, найти параметр Api-ключ для методов в модуле, скопировать указанное в нём значение и перенести его в это поле;
• Узел обмена с ELMA — выбрать опцию Выгрузка данных в ELMA;
• Организация — выбрать все юридические лица из базы 1С, данные по которым необходимо отправлять в ELMA365;
• Регистрация изменений для обмена данными — в отдельном окне определяется, какие данные будут передаваться автоматически из 1С в ELMA365: штатное расписание, список сотрудников и т. д.
• Количество выгружаемых объектов в одном пакете за один запрос — указать, какое количество объектов будут передаваться из 1С в ELMA365 за один запрос. Рекомендуемое значение — не более 150 экземпляров для корректной работы процесса передачи;
• Регистрировать журнал интеграции — опция активирует сохранение результатов выгрузки данных в специальном журнале интеграции. С его помощью пользователи смогут отслеживать, какие объекты передаются в ELMA. Объекты не будут отправляться в ELMA365, если в журнале превышен допустимый объём сохранённых данных в 4 ГБ;
• Количество дней хранения записей журнала интеграции — если результаты выгрузки данных из 1С в ELMA365 фиксируются в журнале интеграции, необходимо указать, через сколько дней информация будет удаляться. Настройка позволяет избежать превышение допустимого объема сохранённых в журнале данных.

После того как данные внесены, нажать кнопку Записать.
Вкладка «Функциональные настройки»
На вкладке Функциональные настройки определяются особенности обмена данными между 1С и ELMA365:

• Тип выгружаемых файлов печатных форм — указывается, для каких файлов будут формироваться печатные формы при обмене данными с ELMA365. Рекомендуемый вариант — опция PDF/A-1;
• Автоматически рассчитывать документы при загрузке из ELMA365 — опция включается, чтобы в загруженных документах из ELMA365 (отпуска, оплата по среднему заработку, справки 2-НДФЛ) автоматически рассчитывались и подставлялись значения дополнительных полей из данных 1С;
• Не устанавливать галку «Расчет утвердил» при автоматическом расчете — настройка доступна, если включена предыдущая опция, и в загруженных из ELMA365 документах дополнительные поля заполняются значениями из 1С. Флажок в этом поле ставится, чтобы в документах появлялась отметка, что расчёт утверждён;
• Вид телефона сотрудника для выгрузки в ELMA — телефон, который будет передаваться из 1С в карточку сотрудника в ELMA365 в качестве контактного номера;
• Работа с расчетными листками производится через интерфейс модуля — опция для возможности работать с расчётными листами в 1С;
• Количество запросов расчетных листков, получаемых за 1 раз — количество расчётных листов из очереди, передающееся из ELMA365 в 1С за один запрос;
• Выгрузка уволенных сотрудников с: — дата, с которой данные уволенных сотрудников будут передаваться в систему;
• Отключенные объекты выгрузки в ELMA365 — сведения, которые не будут передаваться в ELMA.
  

Вкладка «Доступ»
Пользователи, трудоустроенные в определённой организации, могут работать в 1С только с относящимися к ней документами. На вкладке Доступ можно предоставить сотрудникам дополнительные права на документы по другим организациям.

Настроить синхронизацию данных по расписанию
Обновление данных в ELMA365 происходит по расписанию для каждого обработчика, загруженного из файла на предыдущем шаге. Если настройки не заданы, синхронизация выполняется вручную из программы 1С.

1. Администрирование > Печатные формы, отчеты и обработки > Дополнительные отчеты и обработки и дважды нажмите на файл Обмен с ELMA.
2. Включить опцию обновления по таймеру.

3. В открывшемся окне задать параметры.

Рекомендуемые настройки для каждого обработчика:

• Обмен с ELMA365 — запускать обновление ежедневно, каждые 10 минут. Для этого:
  • на вкладке Общие указать Повторять каждые: 1 (дн.);
  • на вкладке Дневное — Повторять через: 600 (сек.). В полях Время начала и Время окончания отметить рабочие часы;
  • на вкладке Недельное — выбрать рабочие дни недели;
• Обновление статусов печатных форм ELMA365 — запускать обновление ежедневно, каждые 10 минут. На вкладках указываются настройки, как для предыдущего обработчика;
• Очистка устаревших записей журнала интеграции с ELMA365 — установить ежедневное обновление, каждый час;
• Расчет отпусков сотрудников для обмена с ELMA365 — запускать обновление ежедневно;
• Формирование расчетных листков по запросам ELMA365 — настраивается в зависимости от рабочего процесса компании.

4. Посмотреть список отправленных данных можно в разделе ELMA365 > Журнал интеграции (ELMA365). В ELMA365 отправленная информация фиксируются в разделе Интеграция 1С > Полученные данные в виде элементов приложения.

Настроить права доступа
Чтобы пользователи могли работать с расширением ELMA365 в 1С, нужно настроить права доступа.

1. В 1С раздел Администрирование > Настройки пользователей и прав.
2. В открывшемся окне выбрать Профили групп доступа.

3. На верхней панели нажать Создать и указать данные о группе:

• поле Наименование - название группы доступа;
• на вкладке Разрешенные действия (роли) отметить опцию Пользователь модуля интеграции с ELMA.

4. Нажать Записать и закрыть.
5. Вернуться в окно Настройки пользователей и прав и выбрать Группы доступа. В открывшейся странице нажать Создать и указать

• в поле Наименование указать Пользователь интеграции с ELMA365;
• в поле Профиль выбрать из списка созданный ранее профиль.

6. На вкладке Участники группы нажать кнопку Подобрать и выбрать сотрудников, которым будет предоставлен доступ к разделу ELMA365 в 1С.

7. Для сохранения настроек группы доступа нажать Записать и закрыть.

Первичный обмен данными и сопоставление справочников
Чтобы записи справочников 1С появились в КЭДО, после проведения всех настроек, нужно выполнить обмен справочниками и провести их обработку на стороне решения "Интеграция с 1С" в ELMA. Для этого в расширении 1С в разделе ELMA365 нужно перейти в настройки интеграции с ELMA365, подключение и обмена данными, зайти в "Регистрация изменений для обмена данными". Зарегистрировать все справочники.

Далее в дополнительной обработке "Обмен с ELMA" выполнить "обмен с ELMA 365". Данное действие нужно выполнять до тех пор, пока не останется зарегистрированных к обмену записей.
Выгруженные справочники должны появиться в ELMA365 в решении "Интеграция с 1С" в приложении "Полученные данные" с признаком "обработано" = нет. На главной странице интеграции нужно запустить и дождаться завершения общего процесса обработки, который создаст записи в решении КЭДО.

Для корректной работы интеграции некоторые справочники 1С и ELMA КЭДО нуждаются в однократном ручном сопоставлении. Сопоставление происходит на странице "Сопоставление справочников" в решении "Интеграция с 1С". Требуют сопоставления следующие справочники:
1) Причины на отпуск без сохранения ЗП
2) Виды отпусков
3) Виды материальной помощи
Сопоставления видов документов будут сохраняться автоматически после выполнения задач, в которых нужно будет указать вид документа, по печатным формам, полученным из 1С

Общая схема взаимодействия решения "интеграция с 1С" с решением "КЭДО" и 1С

Приложения решения "Интеграция с 1С":
1) Полученные данные. Хранит в себе "сырую" информацию по всем справочникам и регистрам, полученным из 1С.
2) Соответствия ID. Хранит в себе соответствия ID элементов 1С с ID элементов приложений в решении КЭДО.
3) Полученные данные по РЛ. Хранит "сырую" информацию по расчётным листам, полученным из 1С.
4) Приложения интеграции. Приложение хранит информацию по кадровому событию. Является точкой обмена информации по кадровому событию между 1С и КЭДО.
5) Полученные печатные формы. Хранит в себе информацию по печатным формам из 1С, по которым нет связанного кадрового события.
Основные бизнес процессы "Интеграция с 1С":
1) Общий процесс обработки. Процесс отбирает необработанные записи в приложении "Полученные данные", далее если существует запись в приложении "соответствия ID" по ID 1С, то соответствующая запись в решении КЭДО по ID ELMA обновляется, иначе создаются новые записи в решении КЭДО и новый элемент в соответствиях id. Процесс дополнительно разбит на несколько подпроцессов, которые обрабатывают отдельные виды справочников.
2) Процесс обработки расчётных листов создаёт из необработанных элементов "Полученные данные по РЛ" новые элементы приложений "Расчетный лист" и запускает процесс "Ознакомление с расчетными листами" по ним.
3) Для каждого кадрового процесса, требующего интеграцию с 1С, существует соответствующий бизнес процесс, который создаёт новый элемент приложения "Приложения интеграции с 1С", далее с помощью подписки на элемент приложения на форме задачи, ожидает изменения этого элемента со стороны 1С, после чего обратным вызовом возвращает управление в кадровый процесс КЭДО.