Документ «Сверка с военным комиссариатом»
Документ «Сверка с военным комиссариатом» предназначен для регистрации факта проведения сверки данных воинского учёта сотрудников организации с органом военного управления. Он фиксирует, кто из физических лиц был включён в сверяемый список, по какому номеру списка, кто из сотрудников организации проводил сверку и по какой организации она выполнена. Используется специалистом, ответственным за ведение воинского учёта (обычно кадровик), с периодичностью, принятой для сверок с учётным органом; нумерация документа годовая (тип номера — строка, длина 11, периодичность Year). Воинский учёт в РК ведётся, поэтому объект применим в казахстанской практике; при этом сам объект и терминология «военный комиссариат» — наследие российской типовой конфигурации ЗУП (в составе «Зарплата и управление персоналом для Казахстана 3.1» помечаем как RU-наследие типовой). Результат проведения — запись данных сверки в специализированный регистр сведений.
1. Назначение и место в учёте
Документ «Сверка с военным комиссариатом» предназначен для регистрации факта проведения сверки данных воинского учёта сотрудников организации с органом военного управления. Он фиксирует, кто из физических лиц был включён в сверяемый список, по какому номеру списка, кто из сотрудников организации проводил сверку и по какой организации она выполнена. Используется специалистом, ответственным за ведение воинского учёта (обычно кадровик), с периодичностью, принятой для сверок с учётным органом; нумерация документа годовая (тип номера — строка, длина 11, периодичность Year). Воинский учёт в РК ведётся, поэтому объект применим в казахстанской практике; при этом сам объект и терминология «военный комиссариат» — наследие российской типовой конфигурации ЗУП (в составе «Зарплата и управление персоналом для Казахстана 3.1» помечаем как RU-наследие типовой). Результат проведения — запись данных сверки в специализированный регистр сведений.
2. Структура объекта
2.1 Реквизиты шапки
| Имя | Тип | Обязательность | Зачем нужен |
|---|---|---|---|
Организация |
cfg:CatalogRef.Организации | Обязателен (ShowError) | Организация, по сотрудникам которой проводится сверка с военным комиссариатом |
КраткийСоставДокумента |
xs:string | Не проверяется (DontCheck) | Строковый служебный реквизит с синонимом «Сотрудники» — текстовое представление состава документа (перечня сотрудников) для отображения в списках |
СверкуПровел |
cfg:CatalogRef.ФизическиеЛица | Обязателен (ShowError) | Физическое лицо, проводившее сверку со стороны организации |
Ответственный |
cfg:CatalogRef.Пользователи | Не проверяется (DontCheck) | Пользователь информационной базы, ответственный за документ |
Комментарий |
xs:string | Не проверяется (DontCheck) | Произвольный комментарий к документу |
Все реквизиты из metadata.attributes перечислены, без пропусков.
2.2 Табличные части
ТЧ Сотрудники (синоним «Сотрудники») — список физических лиц, данные воинского учёта которых сверяются:
| Имя | Тип | Назначение |
|---|---|---|
ФизическоеЛицо |
cfg:CatalogRef.ФизическиеЛица | Сотрудник (синоним колонки — «Сотрудник»), чьи данные воинского учёта включены в сверку |
НомерСписка |
xs:string | Номер списка, по которому физлицо проходит в сверке |
ТЧ ДополнительныеРеквизиты (синоним «Дополнительные реквизиты») — стандартный механизм дополнительных реквизитов и сведений:
| Имя | Тип | Назначение |
|---|---|---|
Свойство |
cfg:ChartOfCharacteristicTypesRef.ДополнительныеРеквизитыИСведения | Вид дополнительного реквизита |
Значение |
(составной, в карте не определён) | Значение дополнительного реквизита |
ТекстоваяСтрока |
xs:string | Текстовое представление значения |
2.3 Формы
(не определено) — в JSON-карте список форм пуст (forms: []); собственных управляемых форм в карте не зафиксировано, используются формы, генерируемые платформой по метаданным.
3. Сценарии работы
3.1 Сценарий: «Регистрация проведённой сверки» (Create)
- Когда применяется: после фактического проведения сверки данных воинского учёта сотрудников с органом военного управления — для фиксации результата в базе.
- Шаги пользователя:
1. Создать новый документ «Сверка с военным комиссариатом».
2. Указать
Организация(обязательно). 3. УказатьСверкуПровел— физическое лицо, проводившее сверку (обязательно). 4. Заполнить ТЧСотрудники: построчноФизическоеЛицои при необходимостиНомерСписка. 5. При необходимости заполнитьКомментарийиОтветственный. 6. Провести документ. - На что обратить внимание: номер документа формируется автоматически (строка длиной 11, нумерация в пределах года) — вручную не задавать.
- Какие проверки сработают: платформенная проверка заполнения — при пустых
ОрганизацияилиСверкуПровелпроведение остановится с ошибкой (режим ShowError). - Что произойдёт после «Провести»: документ сформирует записи в регистре сведений
ДанныеСверкиСВоеннымКомиссариатом— данные сверки станут учётным фактом.
3.2 Сценарий: «Просмотр истории сверок» (Read)
- Когда применяется: нужно узнать, когда и кем проводилась последняя сверка, кто из сотрудников был включён.
- Шаги пользователя:
1. Открыть список документов «Сверка с военным комиссариатом».
2. Ориентироваться по дате, номеру и колонке состава (реквизит
КраткийСоставДокументас синонимом «Сотрудники» даёт текстовую сводку состава в списке). 3. Открыть нужный документ и просмотреть ТЧСотрудники. - Проверки: не выполняются (чтение).
3.3 Сценарий: «Корректировка ранее введённой сверки» (Update)
- Когда применяется: обнаружена ошибка в составе сотрудников, номере списка или в том, кто указан проводившим сверку.
- Шаги пользователя:
1. Открыть проведённый документ.
2. Исправить строки ТЧ
Сотрудники(добавить/удалить/изменитьФизическоеЛицо,НомерСписка) или реквизиты шапки. 3. Перепровести документ. - Что произойдёт: записи в регистре сведений
ДанныеСверкиСВоеннымКомиссариатомбудут переформированы по новым данным. - Проверки: та же платформенная проверка обязательных полей (
Организация,СверкуПровел).
3.4 Сценарий: «Отмена ошибочно введённой сверки»
- Когда применяется: сверка зарегистрирована ошибочно (не тот период, не та организация).
- Шаги пользователя: 1. Открыть документ, выполнить «Отмена проведения» (либо пометить на удаление).
- Что произойдёт: движения по регистру сведений
ДанныеСверкиСВоеннымКомиссариатомбудут удалены; история сверок очистится от ошибочной записи.
3.5 Сценарий: «Учёт дополнительных сведений по сверке»
- Когда применяется: в организации настроены дополнительные реквизиты для этого вида документов (через механизм «Дополнительные реквизиты и сведения»).
- Шаги пользователя:
1. В документе заполнить значения дополнительных реквизитов (хранятся в ТЧ
ДополнительныеРеквизиты:Свойство,Значение,ТекстоваяСтрока). 2. Записать/провести документ. - На что обратить внимание: состав доступных свойств определяется настройкой плана видов характеристик
ДополнительныеРеквизитыИСведения, а не самим документом.
4. Per-field reference
В JSON-карте нет BSL-модулей (bsl_static: [], bsl_summaries: []), поэтому обработчики ПриИзменении и программные валидации не определены; ниже — справка по метаданным.
- Организация (CatalogRef.Организации): организация, по которой регистрируется сверка. Обязательна — fill_value_required = ShowError, без неё документ не пройдёт проверку заполнения. Влияние на другие поля по обработчикам — (не определено).
- СверкуПровел (CatalogRef.ФизическиеЛица): физическое лицо, проводившее сверку. Обязателен (ShowError). Важно: тип — именно справочник «Физические лица», а не «Пользователи».
- КраткийСоставДокумента (xs:string, синоним «Сотрудники»): служебная строка-представление состава документа для списков; проверка заполнения отключена (DontCheck), вручную заполнять не требуется.
- Ответственный (CatalogRef.Пользователи): пользователь-ответственный; необязателен (DontCheck). Типичное значение — текущий пользователь.
- Комментарий (xs:string): произвольный текст; необязателен (DontCheck).
- Сотрудники.ФизическоеЛицо (CatalogRef.ФизическиеЛица, синоним «Сотрудник»): сверяемый сотрудник; ключевая колонка ТЧ.
- Сотрудники.НомерСписка (xs:string): номер списка в рамках сверки; строковое поле, формат не валидируется метаданными.
- ДополнительныеРеквизиты.Свойство / Значение / ТекстоваяСтрока: стандартные поля механизма доп. реквизитов; заполняются только при настроенных свойствах.
5. Бизнес-логика
- Обработчики событий: (не определено) — в карте отсутствуют BSL-модули и их сводки.
- Проводки/движения: документ пишет в регистр сведений
ДанныеСверкиСВоеннымКомиссариатом(см. metadata.register_records); логика формирования записей в карте не раскрыта (модуль проведения отсутствует в выгрузке). - Валидации: программная ОбработкаПроверкиЗаполнения — (не определено); действуют декларативные проверки заполнения метаданных:
ОрганизацияиСверкуПровелобязательны (ShowError), остальные поля не проверяются (DontCheck). - Зависимости от других модулей: (не определено).
6. Связи с другими объектами
6.1 Документы-основания
(не определено) — metadata.based_on пуст: документ не вводится на основании других объектов.
6.2 Кто создаётся на основании этого
(не определено) — metadata.inverse_based_on пуст: на основании этого документа другие документы не вводятся.
6.3 Регистры движения
InformationRegister.ДанныеСверкиСВоеннымКомиссариатом— регистр сведений, хранящий данные проведённых сверок; единственный регистр движений документа.
7. Заметки для ИИ-агента
- Обязательных полей всего два:
ОрганизацияиСверкуПровел(оба ShowError) — без них проведение упадёт; всё остальное можно не заполнять. СверкуПровелссылается на справочник ФизическиеЛица, аОтветственный— на Пользователи; не путать типы при подборе значений.- Поле с подписью «Сотрудники» в шапке/списке — это строковый служебный реквизит
КраткийСоставДокумента; реальный состав вводится только в табличную частьСотрудники(колонкиФизическоеЛицо,НомерСписка). - Номер документа — строка длиной 11 с годовой периодичностью; не задавать вручную, платформа нумерует сама.
- Документ проводимый: факт сверки становится данными учёта только после проведения (запись в регистр сведений
ДанныеСверкиСВоеннымКомиссариатом); правка задним числом требует перепроведения. - Собственных форм и команд в карте нет — UI стандартный платформенный; не искать специальных кнопок заполнения, ТЧ заполняется построчно.
- Контекст конфигурации: объект — наследие российской типовой ЗУП (терминология «военный комиссариат»); в РК воинский учёт ведётся, документ используется для фиксации сверок с местным органом военного управления.