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