🎯 Что это и зачем

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

В конфигурации ЗУП для Казахстана документ является наследием российской типовой ЗУП 3.1: использует специализированный справочник классификаторов ЭлементыКлассификаторовМедРегистра и реквизит «Идентификатор учреждения» (УИНОрганизации). Казахстанские нормы — ИПН, ОПВ, ОПВР, СО, ВОСМС/ООСМС, единый платёж, ФНО, enbek.kz — к данному документу не относятся.

Комментарий метаданных объекта: «АПК:93 представления объекта и списка совпадают».

🧭 Где найти в программе

Раздел «Кадры» → пункт «Сведения о штатном расписании». Откроется журнал документов; новый создаём кнопкой «Создать».

👤 Часть 1. Для пользователя

Сценарии работы синтезированы из структуры метаданных; формы и кнопки автозаполнения в карте объекта не зафиксированы.

Урок 1. Создание сведений о штатном расписании

Когда: необходимо подготовить очередную выгрузку данных о штатном расписании в медицинский регистр.

1. Создайте новый документ «Сведения о штатном расписании».
2. Заполните УИНОрганизации («Идентификатор учреждения») — единственный обязательный реквизит; код выдаётся учреждению оператором регистра.
3. Заполните Организация — по метаданным не проверяется (DontCheck), однако содержательно необходима для идентификации данных; всегда заполняйте её вручную.
4. При необходимости укажите Ответственного и Комментарий для ведения журнала выгрузок.
5. В табличной части ШтатныеЕдиницы добавьте строки: для каждой штатной единицы выберите ПозицияШтатногоРасписания из справочника «Штатное расписание», сопоставьте её с классификаторами регистра (см. Урок 2) и укажите КоличествоСтавок.
6. Запишите документ.

Урок 2. Сопоставление позиций с классификаторами регистра

Когда: для каждой строки табличной части ШтатныеЕдиницы необходимо сопоставить позицию внутреннего справочника с кодировкой медицинского регистра.

1. В строке ТЧ ШтатныеЕдиницы выберите ПозицияШтатногоРасписания — ссылка на реальную позицию из справочника «Штатное расписание» базы.
2. Подберите ПодразделениеХарактеристика из справочника ЭлементыКлассификаторовМедРегистра — кодировка подразделения по требованиям регистра.
3. Подберите ДолжностьХарактеристика из того же справочника ЭлементыКлассификаторовМедРегистра — кодировка должности.
4. Заполните НаименованиеПодразделения строкой — именно так наименование войдёт в файл выгрузки.
5. При необходимости добавьте произвольное Описание позиции.
6. Укажите КоличествоСтавок (десятичное число, например 0.5 или 1.0).

Урок 3. Актуализация при изменении штатного расписания

Когда: штатное расписание изменилось (новые позиции, изменение ставок) и необходимо передать актуальные данные в регистр.

1. Откройте список документов «Сведения о штатном расписании» и найдите прежний документ. Нумерация непериодическая — используйте поиск по дате или номеру.
2. Создайте новый документ или скорректируйте существующий до момента формирования файла выгрузки.
3. В ТЧ ШтатныеЕдиницы добавьте новые позиции, скорректируйте КоличествоСтавок по изменившимся строкам.
4. Запишите документ.
5. Сформируйте файл выгрузки (механизм в карте объекта не зафиксирован — уточните в интерфейсе программы).
6. Убедитесь, что флаг ФайлСформирован установлен.

🛠 Часть 2. Для программиста

Состав объекта. Конфигурация ЗУП для Казахстана 3.1, релиз 3.1.2.24.

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

Тип объекта — документ. Нумерация: тип номера String, длина 11, периодичность Nonperiodical (нумерация сквозная, не сбрасывается в начале периода). Объект содержит 5 реквизитов шапки и 2 табличные части. Формы и команды в JSON-карте не определены (forms: [], commands: []).

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

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

ТЧ ШтатныеЕдиницы («Штатные единицы») — основная ТЧ, строки штатного расписания для выгрузки в регистр:

ТЧ ДополнительныеРеквизиты («Дополнительные реквизиты») — стандартный механизм доп. реквизитов БСП:

Движения по регистрам

Документ не пишет в регистры: register_records в JSON-карте пуст. Документ является исключительно контейнером данных для формирования файла выгрузки — никаких движений при записи не создаётся.

Как формируется проведение — реальный код (3.1.2.24)

Документ не имеет процедуры ОбработкаПроведения в обычном смысле: нет ни РежимаПроведения, ни записей регистров. Единственная платформенная проверка — обязательность УИНОрганизации:

// Реконструкция по metadata.attributes (fill_value_required: ShowError).
// Платформа выполняет проверку автоматически перед записью документа.
// Все остальные реквизиты — DontCheck, проверяются на уровне прикладного кода
// (в выгрузке модуль объекта отсутствует).

ПроверяемыеРеквизиты = "УИНОрганизации";  // ShowError — единственный обязательный

// register_records: [] — движений нет.
// Документ не проводится; запись = сохранение данных в ИБ.

Механизм формирования файла выгрузки (команда, вызываемая из формы или обработки) в карте объекта не зафиксирован. После выгрузки программа должна устанавливать флаг ФайлСформирован = Истина — конкретный модуль в данных отсутствует.

Зависимости

Документ не имеет оснований (based_on: []) и не является основанием для других объектов (inverse_based_on: []). Ссылочные зависимости через реквизиты:

🔗 Связанные разделы

• Штатное расписание — справочник позиций штатного расписания, на который ссылается ТЧ документа.
• Приём на работу — кадровые документы раздела «Кадры»; контекст работы со штатным расписанием.