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