Документ «Изменение условий договора займа сотруднику»
Регистрирует пересмотр условий действующего займа, выданного организацией работнику: фиксирует новую сумму, процентную ставку, даты и график погашения, после проведения обновляет регистры, из которых механизмы удержаний и расчёта материальной выгоды берут актуальные параметры.
🎯 Что это и зачем
Организация выдала сотруднику заём и зафиксировала его документом «Договор займа сотруднику». Со временем условия могут меняться — пролонгация срока, снижение ставки, реструктуризация графика погашения, беспроцентный режим. Для каждого такого пересмотра создаётся документ «Изменение условий договора займа сотруднику»: он не отменяет исходный договор, а дополняет его новыми параметрами, действующими с указанной даты.
После проведения новые условия записываются в регистры сведений УсловияДоговораЗаймаСотруднику и ТраншиЗаймаСотруднику. Именно оттуда механизм удержаний по займам читает актуальный размер платежа, ставку и дату погашения, а подсистема налогообложения — признак обложения ИПН материальной выгоды от экономии на вознаграждении.
Использует документ бухгалтер-расчётчик зарплаты; создаётся эпизодически — только при реальном изменении условий. Нумерация: строковый номер до 11 символов, уникальный в пределах года.
🧭 Где найти в программе
Раздел «Зарплата» → пункт «Изменение условий договора займа сотруднику». Откроется журнал документов; новый документ создаётся кнопкой «Создать» или командой «Создать на основании» из документа «Договор займа сотруднику».
👤 Часть 1. Для пользователя
Три сценария: стандартное изменение условий, пересмотр ставки и реструктуризация графика траншей.
Урок 1. Изменение условий на основании договора займа
Когда: с сотрудником подписано дополнительное соглашение к договору займа — изменился срок, сумма долга или размер платежа.
- Откройте исходный документ «Договор займа сотруднику» нужного сотрудника.
- Нажмите «Создать на основании» → «Изменение условий договора займа сотруднику». Поля Организация, Сотрудник (реквизит
ФизическоеЛицо) и Договор займа (ДоговорЗайма) заполнятся автоматически. - Укажите Дату изменений (
ДатаИзменений) — с какой даты вступают в силу новые условия. Не путайте с датой самого документа. - Заполните изменяемые параметры: Сумма, Процентная ставка, Дата окончания, Размер платежа, Размер погашения, Дата начала погашения, Ограничение платежа — только те, что фактически меняются.
- При необходимости заполните подписные реквизиты для печатной формы: Руководитель, Должность, Основание подписи.
- Нажмите «Провести».
ФизическоеЛицо) и Договор займа (ДоговорЗайма). При отсутствии любого из них платформа выдаст ошибку заполнения и не проведёт документ. Поле «Сотрудник» в форме подписано как «Сотрудник», но в метаданных его имя — ФизическоеЛицо; не путайте с реквизитом Руководитель (тоже физическое лицо, только подписант).Урок 2. Изменение процентной ставки и налогообложения материальной выгоды
Когда: заём становится беспроцентным или ставка снижается ниже рыночной — возникает или прекращается вопрос о налогообложении материальной выгоды ИПН.
- Создайте документ «на основании» договора займа, как в Уроке 1.
- Укажите Дату изменений — с какой даты действует новая ставка.
- Введите новое значение Процентная ставка (
ПроцентнаяСтавка). Ноль означает беспроцентный заём. - Проверьте флаг «Материальная выгода облагается НДФЛ» (
МатериальнаяВыгодаОблагаетсяНДФЛ). Установите Истина, если учётная политика требует исчислять ИПН с материальной выгоды по этому займу. - Проведите документ.
УсловияДоговораЗаймаСотруднику с даты изменений. С этого момента расчёт материальной выгоды в начислениях зарплаты будет использовать новые параметры.Урок 3. Реструктуризация графика траншей
Когда: заём выдаётся или гасится частями, и стороны договорились о новом графике предоставления и погашения траншей.
- Создайте документ «на основании» договора займа.
- Укажите Дату изменений, скорректируйте при необходимости Дату начала погашения, Размер платежа, Ограничение платежа в шапке.
- Перейдите на вкладку «Транши займа» (
ТраншиЗайма). Заполните обновлённый график: по одной строке на транш. - В каждой строке укажите: Месяц предоставления (
ДатаПредоставления— дата соответствующего месяца), Сумма транша, Размер погашения по строке, Дата погашения транша. - Проведите документ — программа перезапишет график в регистре
ТраншиЗаймаСотруднику.
ДатаПредоставления — вводите первое число нужного месяца или любую дату из него (платформа трактует значение в разрезе месяца). Перепроведение полностью перезаписывает транши в регистре; если нужно вернуть прежний график — отмените проведение этого документа.🛠 Часть 2. Для программиста
Состав объекта, регистры-приёмники движений и логика проведения. Конфигурация ЗУП для Казахстана 3.1, релиз 3.1.2.24.
Структура объекта
Тип объекта — документ. Нумерация: тип номера String, длина 11, периодичность Year (в пределах года). В шапке 17 реквизитов, 2 табличных части. Три реквизита обязательны (ShowError), остальные заполняются по необходимости (DontCheck).
Реквизиты шапки
| Имя | Тип | Обяз. | Назначение |
|---|---|---|---|
Организация | CatalogRef.Организации | Да | Организация-займодатель, от имени которой изменяются условия договора |
ФизическоеЛицо | CatalogRef.ФизическиеЛица | Да | Сотрудник-заёмщик; на форме подписан «Сотрудник», имя реквизита — ФизическоеЛицо |
ДоговорЗайма | DocumentRef.ДоговорЗаймаСотруднику | Да | Ссылка на исходный договор займа, условия которого меняются |
Сумма | xs:decimal | Нет | Новая сумма займа после изменения условий |
ДатаИзменений | xs:dateTime | Нет | Дата вступления новых условий в силу (разрез регистра) |
ДатаОкончания | xs:dateTime | Нет | Новая дата окончания договора (пролонгация или сокращение срока) |
ПроцентнаяСтавка | xs:decimal | Нет | Новая процентная ставка; 0 = беспроцентный заём |
РазмерПлатежа | xs:decimal | Нет | Новый размер периодического платежа по займу |
РазмерПогашения | xs:decimal | Нет | Новый размер погашения основного долга |
ДатаНачалаПогашения | xs:dateTime | Нет | Дата, с которой начинается (возобновляется) погашение по новым условиям |
ОграничениеПлатежа | xs:decimal | Нет | Предельная сумма удержания за расчётный период |
МатериальнаяВыгодаОблагаетсяНДФЛ | xs:boolean | Нет | Признак налогообложения материальной выгоды — управляет обложением ИПН в ZupKZ31 RU-наследие в имени |
Руководитель | CatalogRef.ФизическиеЛица | Нет | Подписант со стороны организации для печатной формы |
ДолжностьРуководителя | CatalogRef.Должности | Нет | Должность подписанта (синоним «Должность») |
ОснованиеПодписиРуководителя | (тип не определён) | Нет | Основание полномочий (устав, доверенность); тип в метаданных не определён |
Ответственный | CatalogRef.Пользователи | Нет | Пользователь ИБ, ответственный за документ; обычно подставляется текущий пользователь |
Комментарий | xs:string | Нет | Произвольный текстовый комментарий |
Табличные части
ТраншиЗайма (синоним «Транши займа») — обновлённый график предоставления и погашения займа частями по новым условиям:
| Имя | Тип | Назначение |
|---|---|---|
ДатаПредоставления | xs:dateTime | Дата выдачи транша; синоним колонки — «Месяц предоставления», трактуется в разрезе месяца |
Сумма | xs:decimal | Сумма транша |
РазмерПогашения | xs:decimal | Размер погашения по траншу |
ДатаПогашения | xs:dateTime | Плановая дата погашения транша |
ДополнительныеРеквизиты (синоним «Дополнительные реквизиты») — стандартный механизм БСП для пользовательских свойств:
| Имя | Тип | Назначение |
|---|---|---|
Свойство | ChartOfCharacteristicTypesRef.ДополнительныеРеквизитыИСведения | Какое дополнительное свойство заполняется |
Значение | (произвольный, определяется свойством) | Значение свойства |
ТекстоваяСтрока | xs:string | Текстовое представление значения |
Движения по регистрам
Документ является регистратором двух регистров сведений. Бухгалтерских проводок не формирует.
| Регистр | Тип | Назначение |
|---|---|---|
УсловияДоговораЗаймаСотруднику | Сведений | Действующие параметры договора займа: ставка, суммы платежей, даты, признак налогообложения ИПН. Срез последних записей на дату читается механизмом удержаний и расчёта материальной выгоды |
ТраншиЗаймаСотруднику | Сведений | График траншей займа (предоставление и погашение по строкам). Перепроведение полностью перезаписывает график |
Как формируется проведение — реальный код (3.1.2.24)
bsl_static / bsl_summaries пусты), поэтому дословный текст процедур ОбработкаПроведения / ОбработкаПроверкиЗаполнения привести нельзя. Ниже — реконструкция по метаданным (состав регистров-приёмников, обязательность реквизитов): это не цитата исходного кода, а корректная по структуре схема.Три обязательных реквизита (из fill_value_required: ShowError) — платформа проверяет их автоматически перед проведением:
// Реконструкция по metadata: 3 реквизита с ShowError.
// Платформа останавливает проведение, если любой из них пуст.
ПроверяемыеРеквизиты = "Организация, ФизическоеЛицо, ДоговорЗайма";
// Дополнительные прикладные проверки (ОбработкаПроверкиЗаполнения) — в выгрузке не определены.
Схема проведения (реконструкция по составу регистров-приёмников):
// Реконструкция по metadata.register_records. Не дословный код модуля.
Процедура ОбработкаПроведения(Отказ, РежимПроведения)
// 1. Записываем обновлённые условия договора в регистр сведений.
// Запись привязана к ДатаИзменений — это разрез действия условий.
// Содержит: Сумма, ПроцентнаяСтавка, ДатаОкончания, РазмерПлатежа,
// РазмерПогашения, ДатаНачалаПогашения, ОграничениеПлатежа,
// МатериальнаяВыгодаОблагаетсяНДФЛ (управляет ИПН с матвыгоды в РК).
Движения.УсловияДоговораЗаймаСотруднику;
// 2. Перезаписываем график траншей (из ТЧ ТраншиЗайма).
// Предыдущий график по этому договору замещается новым полностью.
Движения.ТраншиЗаймаСотруднику;
// 3. Запись наборов записей регистров.
Движения.Записать();
// Бухгалтерских проводок нет — документ работает только с регистрами сведений.
КонецПроцедуры
Зависимости
| Зависимость | Что используется |
|---|---|
| Документы-основания | Document.ДоговорЗаймаСотруднику — основной путь ввода; Catalog.Сотрудники — ввод от карточки сотрудника |
| Регистры-приёмники | InformationRegister.УсловияДоговораЗаймаСотруднику, InformationRegister.ТраншиЗаймаСотруднику |
| Справочники | Организации, ФизическиеЛица, Пользователи, Должности |
| Потребители регистров | Механизм удержаний по займам (читает актуальные условия для расчёта удержания в начислении зарплаты); подсистема расчёта материальной выгоды (читает ставку и признак ИПН) |
| Документы-потребители (inverse_based_on) | Не определено — на основании данного документа типовых документов не создаётся |
🔗 Связанные разделы
- Договор займа сотруднику — первичный документ, на основании которого создаётся изменение условий.
- Начисление зарплаты и взносов — как удержания по займу и ИПН с материальной выгоды попадают в расчёт месяца.