Исходный код вики Настройка интеграции с PERCo-Web

Редактировал(а) PROSTO:СКУД 2026/09/30 10:02

version	line-number	content
1.1	1	= ОПИСАНИЕ СИСТЕМЫ =
	2
	3	«PROSTO:СКУД» — программный продукт реализованный в виде расширения на платформе 1С:Предприятие решает задачи интеграции СКУД и 1С ЗУП 3.1, ERP 2.4, 2.5, КА 2. Система поддерживает автоматический обмен данными между 1С и популярными СКУД, автоматизирует бизнес-процессы по созданию и учету сотрудников в СКУД. Значительно упрощает работу специалистов отдела кадров и отдела безопасности: избавляет от двойного ввода информации в 1С и СКУД, сокращает время составления табеля учета рабочего времени.
	4
34.3	5	Интеграционные возможности продукта «PROSTO:СКУД» позволяют:
1.1	6
34.6	7	* настраивать подключение к системам СКУД, а также настраивать параметры интеграции в отдельной СКУД, задавать расписания обменов с системами СКУД;
	8	* создавать или сопоставлять с текущими параметрами объекты систем СКУД:
34.7	9	** подразделения,
	10	** должности,
	11	** графики,
	12	** территории,
	13	** контроллеры доступа,
	14	** сотрудники (физические лица);
34.6	15	* выдавать, продлевать или блокировать - обеспечивать учет карт доступа;
	16	* устанавливать сотрудникам ограничения в разрезе рабочих помещений для более точного учета;
	17	* устанавливать права прохода через контрольные точки СКУД путем назначения сотрудникам групп и уровней доступа или указания определенных контроллеров СКУД;
	18	* просматривать данные о проходах сотрудников через точки доступа СКУД.
	19
1.2	20	= НАСТРОЙКА ИНТЕГРАЦИИ С PERCo-Web =
	21
1.3	22	== 1. Настройка подключения ==
	23
34.8	24	Для настройки подключения к СКУД PERCo-Web необходимо перейти в «Настройки подсистемы PROSTO:СКУД» и установить флаг для используемого СКУД.
34.3	25
48.1	26	[[image:1754563553298-729.png\|\|data-xwiki-image-style-border="true"]]
34.8	27
49.1	28	[[image:1754563629542-609.png\|\|data-xwiki-image-style-border="true" height="439" width="717"]]
35.2	29
36.2	30
36.3	31	Затем необходимо перейти к элементам справочника «Системы контроля доступа» по одноименной ссылке раздела «PROSTO:СКУД». В элементах данного справочника настраиваются параметры подключения к системам СКУД, а также настройки интеграционного характера:
36.2	32
49.1	33	[[image:1754312035563-813.png\|\|data-xwiki-image-style-border="true" height="751" width="1168"]]
2.2	34
	35
36.5	36	В элементах данного справочника настраиваются параметры подключения к системам СКУД, а также настройки интеграционного характера. Необходимо выбрать Вид системы контроля доступа – PERCo-Web, указать наименование и данные подключения: адрес сервера в локальной сети, имя пользователя и пароль. При помощи признака «Используется» можно отключать/включать интеграцию с конкретным сервером СКУД, например, на время отладки.
36.3	37
49.1	38	[[image:1754312161954-409.png\|\|data-xwiki-image-style-border="true" height="656" width="716"]]
3.2	39
	40
	41	На второй вкладке указываются дополнительные настройки, отвечающие за параметры и состав данных, участвующих в интеграции. Для первоначальной настройки рекомендуется воспользоваться кнопкой «Заполнить по умолчанию». После заполнения необходимо установить «ДА» в значении тех параметров, которые будут использоваться при обмене данными между СКУД и 1С.
	42
	43	Изменять состав параметров можно будет при необходимости.
	44
51.1	45	(% class="box infomessage" %)
	46	(((
52.1	47	Важно: При использовании защищенного соединения требуется в поле соответствующей дополнительной настройки перевести значение в положение Истина и изменить Порт с 80 на 443. Подробнее о том как настроить работу PERCo-Web через https можно изучить по [[ссылке>>doc:.Настройка-https-для-PERCo-Web.WebHome]]
51.1	48	)))
5.2	49
49.1	50	[[image:1754312301052-361.png\|\|data-xwiki-image-style-border="true" height="655" width="716"]]
5.2	51
	52
32.3	53	После заполнения всех полей можно проверить подключение к серверу СКУД, нажав на кнопку «Проверить соединение» на вкладке «Основные настройки». Если все настроено правильно, на форме появятся сообщения об успешном подключении к СКУД.
5.2	54
49.1	55	[[image:1754312363514-783.png\|\|data-xwiki-image-style-border="true" height="617" width="717"]]
5.2	56
5.3	57
37.2	58	Отдельно следует упомянуть настройку «Использовать отложенную выгрузку» (на вкладке «Дополнительные настройки»), если данная настройка включена, то система не будет выгружать данные в СКУД в момент их изменения, а зарегистрирует измененные объекты в соответствующем СКУД узле, далее данные будут выгружены регламентным заданием.
38.2	59	Полный состав предопределенных настроек применимых к СКУД PERCo-Web можно посмотреть по ссылке «Дополнительные настройки СКУД» раздела «СКУД».
37.2	60
48.1	61	[[image:1754567017955-421.png\|\|data-xwiki-image-style-border="true"]]
38.2	62
39.2	63
	64	Полный перечень настроек применимых к СКУД PERCo-Web предоставляется по запросу.
	65
5.3	66	== 2. Начальная синхронизация с PERCo-Web ==
	67
39.3	68	Существует два подхода начала работы с системой:
5.3	69
39.4	70	1. Сначала создаются все доступные справочные данные в системе PROSTO:СКУД и данные выгружаются в СКУД регламентным заданием после настройки (подробнее в п. 3).
32.4	71	1. СКУД уже запущена на момент внедрения PROSTO:СКУД и содержит в себе данные. Для этого в системе PROSTO:СКУД предусмотрены обработки Начальной синхронизации – индивидуальные для каждого вида СКУД.
5.3	72
39.4	73	Рассмотрим второй вариант, для этого откроем обработку начальной синхронизации со СКУД PERCo-Web из раздела «PROSTO:СКУД».
	74
5.3	75	Для вызова обработки начальной синхронизации с СКУД PERCo-Web необходимо перейти в раздел «PROSTO:СКУД» – Сервис – Начальная синхронизация PERCo-Web
	76
	77	Открыв обработку, необходимо выбрать Систему контроля доступа и перемещаясь между вкладками в том порядке, в котором они расположены в форме обработки, поочередно синхронизировать объекты системы PROSTO:СКУД и PERCo-Web.
5.4	78
48.1	79	[[image:1754312515414-512.png\|\|data-xwiki-image-style-border="true"]]
7.2	80
	81
32.5	82	Для того, чтобы данные отобразились в строках табличной части, необходимо нажать кнопку «Заполнить»:
7.2	83
49.1	84	[[image:1754312594196-767.png\|\|data-xwiki-image-style-border="true" height="312" width="1197"]]
8.1	85
	86
	87	Каждая запись об объекте в табличной части разделяется на две строки.
	88
	89	В первой строке указываются данные из основной базы 1С, во второй строке соответственно указываются данные, поступившие из СКУД PERCo-Web.
	90
39.5	91	Первичное сопоставление для большинства объектов производится по наименованию. Таким образом, у пользователя есть возможность сравнить данные и в случае несовпадения сопоставить данные вручную либо создать недостающие объекты средствами обработки. В случае расхождения данных между базами в первой колонке табличной части будет указано, что значения различаются.
8.1	92
49.1	93	[[image:1754483197431-646.png\|\|data-xwiki-image-style-border="true" height="364" width="1183"]]
9.2	94
	95
39.5	96	Чтобы данные из 1С и данные внешней базы были идентичны, их необходимо синхронизировать.
9.2	97
	98	Для этого необходимо выбрать приоритет синхронизации: СКУД (загрузка данных из СКУД в 1С) или 1С (выгрузка данных из 1С в СКУД), отметить флажками нужные строки и нажать кнопку «Синхронизировать».
	99
48.1	100	[[image:1754483294741-479.png\|\|data-xwiki-image-style-border="true"]]
10.2	101
	102
	103	Если синхронизация данных прошла успешно, в первой колонке появится надпись Данные синхронизированы. При этом система создаст запись идентификатора объекта в системе СКУД в регистр сведений «Идентификаторы объектов СКУД».
	104
48.1	105	[[image:1754483402241-826.png\|\|data-xwiki-image-style-border="true"]]
11.2	106
	107
	108	То, как поведет себя система при сопоставлении объектов, будет ли объект перезаписан или просто сопоставлен при помощи идентификатора, задается в дополнительных настройках элемента справочника «Системы контроля доступа»
	109
	110	Отдельно рассмотрим каждую вкладку обработки интеграции:
	111
11.4	112	=== 2.1. Организации ===
	113
	114	При создании организационной структуры предприятия в системе PERCo-Web организации встают в верхний уровень иерархии справочника «Подразделения» корневой элемент, название которого обычно совпадает с названием предприятия (организации).
	115
49.1	116	[[image:1754561389182-800.png\|\|data-xwiki-image-style-border="true" height="567" width="1178"]]
12.2	117
49.1	118	[[image:1754483812057-802.png\|\|data-xwiki-image-style-border="true" height="336" width="1177"]]
12.2	119
13.2	120
	121	Первичное сопоставление данных происходит по наименованию. Возможна двухсторонняя интеграция, т.е. выгрузка из СКУД и загрузка в СКУД из 1С объектов:
	122
	123	=== 2.2. Подразделения ===
13.3	124
39.7	125	В системе PERCo-Web подразделения хранятся в иерархическом справочнике «Подразделения», с возможностью создания многоуровневого раскрывающегося списка структурных подразделений.
13.3	126
48.1	127	[[image:1754484010032-585.png\|\|data-xwiki-image-style-border="true"]]
14.2	128
	129
39.8	130	Первичное сопоставление данных происходит по наименованию. Возможна двухсторонняя интеграция, т.е. выгрузка из СКУД и загрузка в СКУД из 1С Объектов. При сопоставлении учитывается родитель. Для синхронизации Подразделения нижнего уровня иерархии необходимо, чтобы все вышестоящие были синхронизированы.
14.2	131
46.2	132
14.2	133	=== 2.3. Должности ===
	134
	135	В системе PERCo-Web Должности представляют собой справочник «Должности». При внедрении подсистемы PROSTO:СКУД в типовом решении от 1С (ЗУП, ERP, КА) используется справочник «Должности».
15.2	136
49.1	137	[[image:1754561610679-168.png\|\|data-xwiki-image-style-border="true" height="589" width="1174"]]
15.2	138
40.2	139	При внедрении подсистемы PROSTO:СКУД в тиражное решение от 1С (ЗУП, ERP, КА) используется типовой справочник «Должности».
	140
15.2	141	Первичное сопоставление данных происходит по наименованию.
	142
48.1	143	[[image:1754484197402-134.png\|\|data-xwiki-image-style-border="true"]]
16.2	144
	145
	146	=== 2.4. Графики работы ===
	147
40.2	148	Графики работы в системе PERCo-Web представляют собой справочник «Графики работы».
18.2	149
48.1	150	[[image:1754568366944-832.png\|\|data-xwiki-image-style-border="true"]]
18.2	151
	152
40.3	153	При внедрении подсистемы PROSTO:СКУД в тиражное решение от 1С (ЗУП, ERP, КА) используется типовой справочник «Графики работы сотрудников».
40.2	154	Первичное сопоставление данных по наименованию.
	155
18.2	156	При создании подразделений в PERCo-Web, в поле «График работы» заданный график работы для подразделения, будет считаться заданным Графиком работы для всех сотрудников, числящихся в данном подразделении по умолчанию.
	157
	158
48.1	159	[[image:1754484635050-499.png\|\|data-xwiki-image-style-border="true"]]
19.2	160
	161
	162	При внедрении подсистемы PROSTO: СКУД в типовом решении от 1С (ЗУП, ERP, КА) используется справочник «Графики работы сотрудников».
	163
	164	Первичное сопоставление данных происходит по наименованию.
	165
	166	=== 2.5. Территории ===
	167
	168	Территории в системе PERCo-Web находятся в разделе «Помещения» справочника «Управление устройствами».
21.2	169
49.1	170	[[image:1754484726788-469.png\|\|data-xwiki-image-style-border="true" height="595" width="1197"]]
21.2	171
	172
	173	При синхронизации территорий с приоритетом «СКУД» в 1С создаются элементы справочника «Территории (СКУД)»
	174
48.1	175	[[image:1754484800030-531.png\|\|data-xwiki-image-style-border="true"]]
21.2	176
21.3	177
21.4	178	После синхронизации для рабочих территорий в справочнике «Территории (СКУД)» необходимо установить флаг «Это рабочая территория».
	179
49.1	180	[[image:1754484986933-201.png\|\|data-xwiki-image-style-border="true" height="632" width="716"]]
23.2	181
	182
	183	=== 2.6. Контроллеры ===
	184
	185	Контроллеры в системе PERCo-Web находятся в разделе «Устройства» справочника «Управление устройствами».
	186
49.1	187	[[image:1754485052140-113.png\|\|data-xwiki-image-style-border="true" height="285" width="1239"]]
23.2	188
23.3	189	В подсистеме PROSTO:СКУД реализован аналогичный справочник, в данном справочнике задаются территории. После создания элемента справочника Контроллеры в поле «Территория вход» указывается территория, на которую попадает сотрудник при входе на предприятие при использовании карты доступа. «Территория выход» – заполняется аналогично и определяет территорию выхода, при использовании карты доступа.
	190
49.1	191	[[image:1754485075990-677.png\|\|data-xwiki-image-style-border="true" height="524" width="717"]]
24.2	192
24.3	193	Первичное сопоставление данных происходит по наименованию. Возможна только загрузка элементов справочника Контроллеры из СКУД.
	194
24.5	195	=== 2.7. Сотрудники ===
24.6	196
25.2	197	В системе PERCo-Web список сотрудников представляет собой справочник «Сотрудники».
	198
48.1	199	[[image:1754570190848-553.png\|\|data-xwiki-image-style-border="true"]]
25.2	200
	201
41.2	202	В зависимости от значения дополнительной настройки Системы контроля доступа «Синхронизировать только работающих сотрудников» в выборку данных из 1С будут попадать только физические лица работающих сотрудников (или также не работающих). Для сопоставления сотрудников необходимо предварительно синхронизировать подразделения и должности, если они не синхронизированы, то и синхронизировать Сотрудника не удастся.
25.2	203
	204	Первичное сопоставление данных происходит по ФИО и табельным номерам. Возможна двухсторонняя интеграция.
26.2	205
	206	=== 2.8. События СКУД ===
	207
	208	Вкладка предназначена для ручной загрузки данных о событиях проходов сотрудников, которые зафиксировал тот или иной контроллер доступа.
	209
50.1	210	[[image:1787737889967-877.png\|\|data-xwiki-image-style-border="true"]]
27.2	211
27.3	212	В поле «Период» по умолчанию указывается текущий день, но при необходимости можно задать тот период, за который необходимо получить данные.
	213
	214	В табличной части в колонке «Пометка» указано, загрузились ли данные в систему или нет. Для того, чтобы загрузить данные в систему PROSTO:СКУД, нужно выбрать необходимые строки, проставив галочки.
	215
	216	Если необходимо выбрать все строки сразу, то можно нажать на кнопку «Установить флажки», после чего нажать на кнопку Синхронизировать.
27.4	217
50.1	218	[[image:1787737977949-648.png\|\|data-xwiki-image-style-border="true"]]
30.2	219
	220	Данные в колонках табличной части:
	221
	222	* Дата – показывает дату и время, когда сотрудником (физическим лицом) был осуществлен проход через турникет;
	223	* Физ. лицо – отражает полные фамилию, имя и отчество сотрудника;
	224	* Контроллер – отражает информацию о том, через какой контроллер был осуществлен проход;
	225	* Дверь – отображаются данные о направлении прохода, где «0» - это вход, а «1» - выход;
	226	* Территория – отражает данные о том, на какую территорию был осуществлен проход;
	227	* Карта – отражает номер карты, которая была использована при проходе.
	228
50.1	229	Настройка кодов успешных событий для СКУД PERCo-Web.
	230
	231	Начиная с релиза 1.2.8.6, появилась возможность настройки кодов успешных событий для СКУД Perco-Web.
	232
	233	В системе СКУД PERCo-Web существует большое количество внутренних кодов событий. Чтобы система PROSTO:СКУД могла точно определять, какие события считать реальными проходом, а какие - системной ошибкой, в систему введена гибкая настройка "Коды событий".
	234
	235	Данная настройка находится находится на вкладке Дополнительные настройки системы контроля доступа.
	236
	237	* Поле "Коды событий": имеет строковый тип, здесь через запятую перечисляются коды событий СКУД, которые система должна считать успешными.
	238
	239	(% class="box infomessage" %)
	240	(((
	241	По умолчанию при заполнении Дополнительный настроек в поле "Коды событий" установлено значение 17 (Проход по идентификатору)
	242	)))
	243
	244	* Как это работает:
	245
	246	Если код события, пришедший из СКУД, присутствует в этой строке настроек - событие признается успешным, в регистре События (СКУД) оно отображается как корректный проход.
	247
	248	Если кода события нет в списке - оно автоматически классифицируется как ошибочное, помечается флагом ошибки.
	249
	250	[[image:1787738559161-960.png\|\|data-xwiki-image-style-border="true" height="607" width="712"]]
	251
	252	Как настроить свои коды:
	253
	254	В первичной интеграции в колонке "Комментарий" автоматически записывается технический код событий в формате [Код] - [Наименование]. Если вы хотите разрешить проход по новому типу событий, найдите нужное событие и посмотрите его комментарий, чтобы определить код. После этого перейдите в Дополнительные настройки и просто допишите этот код через запятую в поле "Коды событий". При следующем обмене это событие будет считаться успешным.
	255
30.2	256	== 3. Настройка автоматического обмена данными с PERCo-Web и получение событий проходов сотрудников ==
	257
	258	После первоначального сопоставления данных двух систем 1С и СКУД считается, что 1С выступает мастер системой и выгрузка новых объектов, а также изменения уже сопоставленных должны быть осуществлены и в СКУД.
	259
	260	Для настройки автоматического обмена данными со СКУД необходимо в планах открыть форму плана обмена «Узлы регистрации объектов для выгрузки в СКУД», где для каждой СКУД в которую планируется выгрузка данных создать узел обмена.
	261
49.1	262	[[image:1754570431593-477.png\|\|data-xwiki-image-style-border="true" height="961" width="1246"]]
30.2	263
49.1	264	[[image:1754570507233-417.png\|\|data-xwiki-image-style-border="true" height="348" width="719"]]
30.2	265
46.1	266	{{warning}}
	267	Важно: необходимо именно «Создать» новый узел для каждой СКУД, а не использовать текущую пустую запись (данная запись предопределена и используется для других целей).
	268	{{/warning}}
30.2	269
32.1	270	Далее в дополнительных отчетах и обработках во внешней обработке «Регламентные задания СКУД» можно настроить расписание выгрузки.
	271
49.1	272	[[image:1754485496847-389.png\|\|data-xwiki-image-style-border="true" height="534" width="1260"]]
32.1	273
	274
	275	В этой же обработке задается «Импорт событии СКД (СКУД)» - т.е. периодичность, с которой система будет обращаться к настроенным в ней СКУД и получать события проходов через турникеты.
	276
	277	После описанных выше настроек система будет в автоматическом режиме выгружать данные в СКУД в зависимости от настроек.
46.2	278
48.1	279	=== 4. Назначения Шаблонов доступа ===
46.2	280
	281	Для подразделения в Perco-Web можно настроить Шаблоны доступа, которые будут устанавливаться по умолчанию сотрудникам этого подразделения.
	282
	283	Для этого нужно зайти в карточку подразделения и в параметре Шаблон доступа для сотрудника выбрать нужный шаблон доступа.
	284
48.1	285	[[image:1779350063063-667.png\|\|data-xwiki-image-style-border="true" height="524" width="399"]]
46.3	286
	287	Система 1С автоматически выдает права только один раз, оставляя дальнейшее управление службе безопасности.
	288
	289	~1. Прием на работу и первичная выгрузка
	290
	291	При добавлении нового сотрудника в СКУД (как в автоматическом обмене, так и при ручной выгрузке) система 1С определяет, в каком Подразделении он числится. Сотруднику автоматически присваивается базовый Шаблон доступа, привязанный к этому Подразделению.
	292
	293	2. Кадровые переводы (Изменение подразделения)
	294
	295	Если сотрудник ранее уже был выгружен в СКУД и у него уже есть какой -либо шаблон доступа, 1С не будет его изменять.
	296
47.1	297	* При кадровом переводе сотрудника в другой отдел. 1С обновит его должность и подразделения в Perco-Web, но шаблон доступа останется старым (от предыдущего подразделения)
	298	* Службе безопасности необходимо вручную зайти в Perco-Web и изменить Шаблон доступа переведенному сотруднику на актуальный. 1С сделает это автоматически только в том случае, если в карточке сотрудника в Perco-Web поле шаблона доступа абсолютно пустое.
	299
48.1	300	=== 5. Выдача карт ===
	301
	302	Данный документ находится в разделе «PROSTO:СКУД» – Карты и управление доступом.
	303
	304	Предназначен для выдачи или продления пропусков (карт доступа).
	305
	306	При заполнении документа необходимо указать вид операции, дату операции, систему контроля доступа, в которой планируется выдача/продление карты, а также заполнить табличную часть документа, указав:
	307
	308	– номер карты доступа,
	309
	310	– дату начала и окончания действия карты,
	311
	312	– владельца карты – физическое лицо,
	313
	314	– подразделение
	315
	316	– должность
	317
49.1	318	[[image:1786363033319-658.png\|\|data-xwiki-image-style-border="true" height="283" width="1214"]]
48.1	319
	320	Начиная с релиза 1.2.8.4, в системе реализован механизм, позволяющий определять размещение по подразделениям в СКУД для сторонних физических лиц, у которых в базе 1С:ЗУП нет трудового договора и кадрового подразделения. Для этого используется дополнительная настройка "Подразделение по умолчанию".
	321
49.1	322	[[image:1786363089286-781.png\|\|data-xwiki-image-style-border="true" height="346" width="1213"]]
48.1	323
	324	Как система определяет подразделение в СКУД при выдаче карты?
	325
	326	Когда регламентное задание обрабатывает документ выдачи карты и готовит данные для отправки в СКУД, оно определяет подразделение для физического лица по следующему приоритетному алгоритму:
	327
	328	* Кадровый приоритет: Система проверяет, есть ли у этого физического лица действующий трудовой договор в 1С. Если это штатный сотрудник - берется подразделение из его кадровых документов (приема/перевода). Поле "Подразделение" документа выдачи карт игнорируется.
	329	* Дополнительная настройка "Подразделение по умолчанию": Если кадровых данных нет (это стороннее физическое лицо), система обращается к настройке, вставляет Подразделение по умолчанию в документ выдачи карт и выгружает физлицо в Подразделение по умолчанию ( Подразделение должно быть синхронизировано).
	330	* Ручной выбор в документе: Если кадровых данных нет ( это стороннее физлицо), вы можете выбрать в поле "Подразделение" любое синхронизированное Подразделение (не обязательно из дополнительной настройки "Подразделение по умолчанию". Физлицо будет выгружено в выбранное подразделение.
	331
	332	{{warning}}
	333	Выбор или изменение подразделения в документе Выдача/продление карты влияет на СКУД только один раз - в момент самого первого создания (первичной выгрузки) этого физлица в базу СКУД.
	334	{{/warning}}
	335
46.3	336