Документ «Сведения о медицинских работниках»

⚠️ RU-объект, наследие типовой российской ЗУП 3.1. Документ обслуживает Федеральный регистр медицинских работников (медрегистр) РФ: в составе колонок присутствуют СНИЛС (СтраховойНомерПФР), «Субъект РФ целевого набора», «Прибыл из другого субъекта РФ», «Выбыл в другой субъект РФ». В конфигурации «Зарплата и управление персоналом для Казахстана 3.1» объект достался от типовой и для казахстанского регламентированного учёта не предназначен. Комментарий метаданных: «АПК:93 представления объекта и списка совпадают».

1. Назначение и место в учёте

Документ предназначен для сбора и выгрузки сведений о медицинских работниках организации в медицинский регистр (российский Федеральный регистр медработников): персональные данные, образование, сертификаты, квалификационные категории, награды, движение по личному делу, неявки и фактически отработанное время. Используется кадровой службой медицинской организации как «снимок» данных по сотрудникам для формирования файла выгрузки (флаг ФайлСформирован). Документ непериодический, номер строковый длиной 11. В контексте ЗУП для Казахстана 3.1 объект является наследием российской типовой конфигурации; точное расположение в меню и регламент применения по данным JSON-карты не определены (формы и команды в карте отсутствуют).

2. Структура объекта

2.1 Реквизиты шапки

2.2 Табличные части

Документ содержит 15 табличных частей. Сквозной приём: почти все классификаторные колонки ссылаются на cfg:CatalogRef.ЭлементыКлассификаторовМедРегистра (единый справочник элементов классификаторов медрегистра).

ТЧ Образование («Образование»)

Базовое (вузовское/среднее) образование физических лиц.

ТЧ Сотрудники («Сотрудники»)

Главная ТЧ — персональные данные работников, попадающих в выгрузку.

ТЧ Награды («Награды»)

ТЧ Сертификаты («Сертификаты»)

ТЧ Переподготовка («Переподготовка»)

ТЧ ПовышениеКвалификации («Повышение квалификации»)

ТЧ ПослевузовскоеОбразование («Послевузовское образование»)

ТЧ КвалификационныеКатегории («Квалификационные категории»)

ТЧ Неявки («Неявки»)

ТЧ Невыходы («Невыходы»)

ТЧ ЛичноеДело («Личное дело»)

Самая «тяжёлая» ТЧ — записи о занятии должностей и кадровом движении для регистра.

ТЧ ФактическиОтработанноеВремя («Фактически отработанное время»)

ТЧ УдалитьНеявки («(не используется) Неявки») — устаревшая

ТЧ УдалитьОбразованиеФизическихЛиц («(не используется) Образование физических лиц») — устаревшая

ТЧ ДополнительныеРеквизиты («Дополнительные реквизиты»)

Стандартный механизм доп. реквизитов БСП.

2.3 Формы

В JSON-карте список форм пуст (forms: []). Ключевая форма для пользователя по данным карты не определена — (не определено).

3. Сценарии работы

Данных форм, команд и BSL-модулей в карте нет, поэтому сценарии синтезированы только из структуры метаданных; конкретные кнопки/автозаполнение не подтверждены данными.

3.1 Сценарий: «Создание сведений за период»

• Когда применяется: при необходимости подготовить очередную порцию сведений о медработниках для регистра.
• Шаги пользователя: 1. Создать новый документ «Сведения о медицинских работниках». 2. Заполнить Организация (обязательно) и УИНОрганизации (обязательно, «Идентификатор учреждения»). 3. Указать период расчёта фактического времени: ДатаНачалаРасчетаФактическогоВремени и ДатаОкончанияРасчетаФактическогоВремени. 4. Заполнить табличные части: Сотрудники (персональные данные), Образование, Сертификаты, КвалификационныеКатегории, ЛичноеДело, Неявки/Невыходы, ФактическиОтработанноеВремя и пр. 5. Записать документ.
• На что обратить внимание: классификаторные колонки требуют элементов справочника ЭлементыКлассификаторовМедРегистра; без заполненных классификаторов строки останутся неполными.
• Какие проверки сработают: стандартная проверка заполнения по fill_value_required — Организация и УИНОрганизации с ShowError; прочие реквизиты не проверяются (DontCheck). Других валидаций в карте нет.
• Что произойдёт после «Записать»: документ сохранится; движений по регистрам нет (register_records пуст).

3.2 Сценарий: «Заполнение личных дел (ТЧ ЛичноеДело)»

• Когда применяется: для передачи в регистр данных о занятии должностей и кадровом движении.
• Шаги пользователя: 1. В ТЧ ЛичноеДело добавить строку по сотруднику. 2. Указать период записи (ДатаНачалаЗаписи/ДатаОкончанияЗаписи), КоличествоСтавок, номера приказов. 3. Заполнить характеристики: должность, вид/условия медпомощи, тип подразделения, режим работы, тип занятия должности. 4. Для прибытия/выбытия заполнить блок движения кадров (ПрибылХарактеристика, ДвижениеКадровНачалоХарактеристика, ОснованиеУвольненияХарактеристика, ВыбылВСтрануХарактеристика и т.д.).
• На что обратить внимание: ДокументОснованиеНачалаЗаписи/ДокументОснованиеОкончанияЗаписи принимают только ссылки типов КадровыйПеревод, БольничныйЛист, ИзменениеУсловийОплатыОтпускаПоУходуЗаРебенком — связь записей регистра с кадровыми документами базы.
• Какие проверки сработают: специальных проверок в карте нет — (не определено).
• После «Записать»: данные сохраняются в документе; проведения с движениями нет.

3.3 Сценарий: «Учёт фактически отработанного времени»

• Когда применяется: для передачи часов, отработанных сотрудниками за период.
• Шаги пользователя: 1. В шапке задать ДатаНачалаРасчетаФактическогоВремени и ДатаОкончанияРасчетаФактическогоВремени. 2. В ТЧ ФактическиОтработанноеВремя указать по каждому сотруднику период (ДатаНачала, ДатаОкончания) и КоличествоЧасов. 3. Периоды отсутствия отразить в ТЧ Неявки и Невыходы с состояниями из классификатора.
• На что обратить внимание: механизм автозаполнения из табелей в карте не зафиксирован (BSL отсутствует) — рассчитывать на ручной ввод/внешнее заполнение.
• Проверки: (не определено).
• После «Записать»: сохранение без движений.

3.4 Сценарий: «Формирование файла выгрузки»

• Когда применяется: после полного заполнения сведений, для передачи в медрегистр.
• Шаги пользователя: 1. Проверить заполненность обязательных реквизитов шапки и табличных частей. 2. Выполнить выгрузку файла (команда в карте не зафиксирована — механизм не определён). 3. Убедиться, что флаг ФайлСформирован установлен — он фиксирует факт формирования файла.
• На что обратить внимание: флаг ФайлСформирован — единственный встроенный индикатор статуса выгрузки.
• Проверки/последствия: (не определено).

3.5 Сценарий: «Просмотр и корректировка ранее введённых сведений»

• Когда применяется: исправление данных перед повторной выгрузкой.
• Шаги пользователя: 1. Открыть документ из списка (представления объекта и списка совпадают — см. комментарий метаданных). 2. Исправить нужные строки ТЧ; устаревшие ТЧ УдалитьНеявки и УдалитьОбразованиеФизическихЛиц не заполнять — они помечены «(не используется)». 3. Записать документ; при необходимости заново сформировать файл (сбросить/установить ФайлСформирован согласно регламенту организации).
• Проверки: обязательность Организация, УИНОрганизации.

4. Per-field reference

Обработчики ПриИзменении в карте отсутствуют (bsl_static пуст), поэтому влияние полей друг на друга не зафиксировано.

• Организация (CatalogRef.Организации): организация-учреждение, по которой готовятся сведения; обязательна (ShowError); влияние на другие поля по данным карты не определено.
• УИНОрганизации (Строка): «Идентификатор учреждения» в медрегистре; обязателен (ShowError); вводится строкой, типичное значение — код учреждения, выданный оператором регистра.
• ДатаНачалаРасчетаФактическогоВремени / ДатаОкончанияРасчетаФактическогоВремени (ДатаВремя): границы периода, за который собирается ТЧ ФактическиОтработанноеВремя; необязательны по метаданным.
• ФайлСформирован (Булево): статусный флаг «файл выгрузки сформирован»; необязателен; устанавливается процедурой выгрузки (в карте не зафиксирована).
• Ответственный (CatalogRef.Пользователи): кто отвечает за документ; необязателен.
• Комментарий (Строка): произвольная заметка; необязателен.
• Сотрудники.Сотрудник / Сотрудники.ФизическоеЛицо (ссылки): ключевые колонки главной ТЧ; связывают строку с кадровыми данными базы; персональные поля строки (ФИО, документы, адрес, телефон) хранятся копией строками/датами.
• Сотрудники.СтраховойНомерПФР (Строка): СНИЛС — чисто российский реквизит, в РК не применяется (наследие типовой).
• ЛичноеДело.ДокументОснованиеНачалаЗаписи / ДокументОснованиеОкончанияЗаписи (составной DocumentRef): допустимые типы — КадровыйПеревод, БольничныйЛист, ИзменениеУсловийОплатыОтпускаПоУходуЗаРебенком.
• *Характеристика-колонки (CatalogRef.ЭлементыКлассификаторовМедРегистра): все справочные значения регистра выбираются из единого классификатора ЭлементыКлассификаторовМедРегистра — агенту важно искать значения именно там.

5. Бизнес-логика

• Обработчики событий: (не определено) — BSL-модули в карте отсутствуют (bsl_static: [], bsl_summaries: []).
• Проводки/ОбработкаПроведения: (не определено); register_records пуст — документ не пишет в регистры.
• Валидации (ОбработкаПроверкиЗаполнения): в карте не зафиксированы; действует только стандартная проверка обязательности Организация и УИНОрганизации (ShowError из метаданных).
• Зависимости от других модулей: (не определено).

6. Связи с другими объектами

6.1 Документы-основания

based_on пуст — документ не вводится на основании других объектов.

6.2 Кто создаётся на основании этого

inverse_based_on пуст — на основании этого документа ничего не создаётся.

6.3 Регистры движения

register_records пуст — движений нет; документ служит контейнером данных для выгрузки.

Косвенные ссылочные связи через реквизиты: Справочник.Организации, Справочник.Пользователи, Справочник.Сотрудники, Справочник.ФизическиеЛица, Справочник.ЭлементыКлассификаторовМедРегистра, Перечисление.ПолФизическогоЛица, ПланВидовХарактеристик.ДополнительныеРеквизитыИСведения, документы КадровыйПеревод, БольничныйЛист, ИзменениеУсловийОплатыОтпускаПоУходуЗаРебенком (через колонки ТЧ ЛичноеДело).

7. Заметки для ИИ-агента

1. Это RU-объект (медрегистр РФ). В казахстанском учёте ЗУП КЗ 3.1 не используйте его для регламентированной отчётности РК — СНИЛС, субъекты РФ и пр. неприменимы; предлагайте его пользователю только если организация реально ведёт российский медрегистр.
2. Перед записью обязательно заполняйте Организация и УИНОрганизации — единственные два реквизита с проверкой ShowError; без них запись упадёт со стандартной ошибкой заполнения.
3. Все колонки *Характеристика ссылаются на один справочник ЭлементыКлассификаторовМедРегистра — значения подбирайте из него; если справочник не заполнен классификаторами, строки заполнить не получится.
4. Не заполняйте ТЧ УдалитьНеявки и УдалитьОбразованиеФизическихЛиц — они помечены «(не используется)» и оставлены для совместимости.
5. В ЛичноеДело колонки ДокументОснованиеНачалаЗаписи/ДокументОснованиеОкончанияЗаписи принимают только ссылки КадровыйПеревод, БольничныйЛист, ИзменениеУсловийОплатыОтпускаПоУходуЗаРебенком — другие типы документов подставить нельзя.
6. Документ не делает движений и не имеет вводов на основании — после «Записать» проверять регистры бессмысленно; индикатор готовности выгрузки — флаг ФайлСформирован.
7. Форм и команд в карте нет — UI-селекторы строить по именам реквизитов/ТЧ из раздела 2 (имена метаданных процитированы дословно).