Документ «Отмена совмещения»

Конфигурация: «Зарплата и управление персоналом для Казахстана», ред. 3.1 (ЗУП КЗ 3.1). Карта объекта содержит только метаданные XML: формы (forms), статический анализ BSL (bsl_static) и модульные сводки (bsl_summaries) в выгрузку не вошли (пустые массивы). Всё, что ниже, опирается строго на метаданные; разделы без данных помечены «(не определено)».

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

Документ «Отмена совмещения» — кадровый документ, который досрочно прекращает действие ранее оформленного документа «Совмещение»: снимает с сотрудника плановую доплату за совмещение (вид расчёта из плана видов расчета «Начисления») и корректирует занятость позиций штатного расписания. Документ жёстко привязан к документу-основанию: реквизит ДокументОснование имеет тип DocumentRef.Совмещение и обязателен к заполнению, поэтому типовой путь создания — ввод на основании документа «Совмещение» (объект заявлен в based_on). Используют его кадровик и расчётчик зарплаты — по необходимости, когда совмещение прекращается раньше срока. Нумерация документов строковая, длина 11 символов, периодичность нумерации — в пределах года (number_periodicity: Year). Расположение в меню/подсистемах в карте объекта не выгружено — (не определено).

Казахстанская специфика: документ входит в кадровый контур ЗУП КЗ 3.1; состав реквизитов унаследован от российской типовой ЗУП 3.1 (см. пометки про RU-наследие в разделах 6.3 и 7).

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

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

Все реквизиты из metadata.attributes, имена дословно (пригодны для DOM-селекторов агента):

Итого 14 реквизитов; обязательных (с контролем ShowError) — пять: Организация, СовмещающийСотрудник, ДатаОтмены, ДокументОснование, Начисление.

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

НачисленияСотрудника (синоним «Начисления сотрудника») — строки плановых начислений сотрудника, затрагиваемые отменой совмещения:

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

2.3 Формы

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

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

Сценарии синтезированы из метаданных (based_on, обязательность реквизитов, register_records); команд (commands) и кода форм в карте нет, поэтому шаги описаны по реквизитному составу.

3.1 Сценарий: «Досрочное прекращение совмещения (ввод на основании)» — основной

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

3.2 Сценарий: «Ввод на основании сотрудника»

• Когда применяется: отмену оформляют «от сотрудника» — из карточки справочника «Сотрудники» (Catalog.Сотрудники заявлен в based_on).
• Шаги пользователя: 1. Открыть элемент справочника «Сотрудники». 2. «Создать на основании» → «Отмена совмещения». 3. В новом документе подобрать ДокументОснование — действующий документ «Совмещение» этого сотрудника. 4. Заполнить ДатаОтмены, проверить Начисление, провести.
• На что обратить внимание: ДокументОснование всё равно обязателен — без ссылки на «Совмещение» документ не проведётся.
• Проверки/результат: как в 3.1.

3.3 Сценарий: «Ручное создание из списка документов»

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

3.4 Сценарий: «Утверждение отмены доплаты»

• Когда применяется: в процессе согласования используется флаг ОтменаДоплатыУтверждена (boolean, необязательный).
• Шаги пользователя: открыть документ → установить флаг ОтменаДоплатыУтверждена → записать/провести.
• На что обратить внимание: влияние флага на движения/расчёт по карте не прослеживается (BSL отсутствует) — (не определено); фактическое поведение проверять в базе.

3.5 Сценарий: «Исправление проведённого документа»

• Когда применяется: ранее проведённая «Отмена совмещения» оформлена с ошибкой (не та дата, не то начисление), и её нужно исправить корректным документом.
• Шаги пользователя: 1. Создать новый документ «Отмена совмещения». 2. В реквизите ИсправленныйДокумент (тип DocumentRef.ОтменаСовмещения) указать исправляемый документ. 3. Заполнить корректные значения обязательных полей, провести.
• На что обратить внимание: механика сторнирования по коду в карту не вошла; наличие реквизита подтверждает поддержку типового механизма исправлений.

3.6 Сценарий: «Оформление приказа с подписантом»

• Когда применяется: для печатной формы приказа нужно указать подписанта.
• Шаги пользователя: заполнить Руководитель, ДолжностьРуководителя, ОснованиеПодписиРуководителя → записать → печать.
• На что обратить внимание: сами печатные формы в карте не перечислены — (не определено); все три поля необязательные.

4. Per-field reference

bsl_static пуст — обработчики ПриИзменении<X> и код ОбработкаПроверкиЗаполнения в карту не вошли, поэтому влияние полей друг на друга по коду не подтверждено; ниже — обязательность и роль по метаданным.

• Организация (CatalogRef.Организации): организация документа; обязателен (ShowError); первичное поле шапки.
• СовмещающийСотрудник (CatalogRef.Сотрудники): сотрудник, у которого снимается совмещение; обязателен (ShowError); логически определяет выбор ДокументОснование (совмещение именно этого сотрудника) и ФизическоеЛицо.
• ДатаОтмены (xs:dateTime): дата прекращения совмещения; обязателен (ShowError); главное содержательное значение, вводимое пользователем.
• ДокументОснование (DocumentRef.Совмещение): отменяемое совмещение; обязателен (ShowError); из него логически следуют Начисление и состав ТЧ НачисленияСотрудника (код автозаполнения — не определено).
• Начисление (ChartOfCalculationTypesRef.Начисления): отменяемый вид расчёта (доплата за совмещение); обязателен (ShowError).
• ФизическоеЛицо (CatalogRef.ФизическиеЛица): физлицо сотрудника; необязателен (DontCheck); типичное значение — физлицо, соответствующее СовмещающийСотрудник.
• ОтменаДоплатыУтверждена (xs:boolean): флаг утверждения отмены доплаты; необязателен; влияние на движения — (не определено).
• ИсправленныйДокумент (DocumentRef.ОтменаСовмещения): ссылка на исправляемый документ того же вида; необязателен; заполняется только в сценарии исправления (3.5).
• Руководитель (CatalogRef.ФизическиеЛица), ДолжностьРуководителя (CatalogRef.Должности), ОснованиеПодписиРуководителя (тип не указан): реквизиты подписанта для печатных форм; все необязательны.
• ДатаЗапрета (xs:dateTime): служебная дата запрета изменений; необязателен; пользователем обычно не заполняется.
• Ответственный (CatalogRef.Пользователи): ответственный пользователь; необязателен; типично — текущий пользователь.
• Комментарий (xs:string): свободный текст; необязателен.
• ТЧ НачисленияСотрудника. Начисление / Размер / ДокументОснование / ИдентификаторСтрокиВидаРасчета: строки затрагиваемых плановых начислений с размером; порядок заполнения (вручную или автоматически из документа-основания) по карте не определён.

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

• Обработчики событий: (не определено) — bsl_static и bsl_summaries в карте пустые; модуль объекта и модули форм в выгрузку не вошли.
• Проводки/движения: документ при проведении пишет в пять регистров сведений (см. 6.3) — управление плановыми начислениями, занятостью позиций штатного расписания и параметрами бухучёта начислений. Регистров накопления и бухгалтерии в register_records нет — бухгалтерских проводок документ сам не формирует.
• Валидации: по метаданным — контроль заполнения ShowError для Организация, СовмещающийСотрудник, ДатаОтмены, ДокументОснование, Начисление. Дополнительные проверки из ОбработкаПроверкиЗаполнения — (не определено).
• Зависимости от других модулей: (не определено).

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

6.1 Документы-основания (metadata.based_on)

• Document.Совмещение — основной путь ввода: отмена создаётся на основании действующего совмещения, ссылка ложится в ДокументОснование.
• Catalog.Сотрудники — ввод «от сотрудника» из его карточки; документ-основание затем подбирается вручную.

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

metadata.inverse_based_on пуст — на основании «Отмены совмещения» другие документы не вводятся.

6.3 Регистры движения (metadata.register_records)

• InformationRegister.ЗанятостьПозицийШтатногоРасписания — освобождение/корректировка занятости позиции штатного расписания, занятой по совмещению.
• InformationRegister.ЗначенияПериодическихПоказателейРасчетаЗарплатыСотрудников — корректировка периодических показателей расчёта зарплаты сотрудника.
• InformationRegister.УдалитьБухучетПлановыхНачислений — устаревший регистр (префикс «Удалить»), наследие типовой RU-конфигурации; оставлен для совместимости.
• InformationRegister.БухучетНачисленийСотрудников — способ отражения начислений сотрудника в бухучёте.
• InformationRegister.ПлановыеНачисления — прекращение плановой доплаты за совмещение с ДатаОтмены.

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

1. Пять обязательных полей до проведения: Организация, СовмещающийСотрудник, ДатаОтмены, ДокументОснование, Начисление — иначе ShowError при записи/проведении.
2. Создавай через «Создать на основании» из документа «Совмещение» — ДокументОснование строго типизирован (DocumentRef.Совмещение) и обязателен; при ручном создании подбирай только совмещение того же сотрудника.
3. Номер не заполняй — строковая нумерация длиной 11 в пределах года присваивается автоматически.
4. ФизическоеЛицо не заполняй насильно — поле без контроля заполнения; ожидай системное заполнение от СовмещающийСотрудник, но код автозаполнения в карте отсутствует — при автоматизации проверь фактическое поведение формы.
5. Результат проведения проверяй по регистрам сведений (ПлановыеНачисления, ЗанятостьПозицийШтатногоРасписания, БухучетНачисленийСотрудников), а не по бухгалтерским проводкам — их документ не делает.
6. УдалитьБухучетПлановыхНачислений — legacy-регистр RU-типовой («Удалить»-префикс): движения по нему не использовать как опорные данные.
7. Для печатного приказа заполни необязательные Руководитель, ДолжностьРуководителя, ОснованиеПодписиРуководителя; на проведение они не влияют (по метаданным).
8. Формы и обработчики в карте отсутствуют — любые предположения о каскадном перезаполнении полей (например, очистке ТЧ при смене сотрудника) проверяй экспериментально в UI.