Документ «Изменение аванса»
Регистрирует плановое изменение аванса сотрудников: с указанного месяца назначает новый способ расчёта аванса и новые значения по списку сотрудников и пишет их в регистр плановых авансов, откуда их берут механизмы начисления и выплаты аванса. Документ раздела «Кадры» в ЗУП для Казахстана 3.1.
🎯 Что это и зачем
У сотрудников меняется договорённость о выплате за первую половину месяца — нужно зафиксировать новый аванс, начиная с конкретного месяца. Именно это и делает документ «Изменение аванса»: он назначает новый способ расчёта аванса и новые значения по списку сотрудников, действующие с месяца изменения. Меняют точечно по нескольким сотрудникам или списком по подразделению.
При проведении документ пишет записи в регистр сведений «ПлановыеАвансы» — это его единственное движение. Из этого регистра плановый аванс потом подхватывают механизмы начисления и выплаты аванса. Сам документ — чисто плановый: бухгалтерских проводок он не делает и налоговый контур РК не затрагивает. Налоги и взносы (ИПН, ОПВ, ОПВР, СО, ВОСМС, ООСМС) исчисляют уже расчётные документы при начислении аванса/зарплаты — само «Изменение аванса» лишь задаёт плановую величину.
Кто работает: расчётчик зарплаты, бухгалтер по расчётам с персоналом, по мере изменения договорённостей о выплатах. Документ самостоятельный: на основании других документов не вводится и сам основанием не служит.
🧭 Где найти в программе
Раздел «Кадры» → пункт «Изменение аванса». Откроется журнал документов; новый создаём кнопкой «Создать».
👤 Часть 1. Для пользователя
Проходим по шагам: от пустого документа до проведённого изменения планового аванса.
Урок 1. Назначить новый аванс с очередного месяца
Когда: изменилась договорённость о размере выплаты за первую половину месяца — нужно назначить новый аванс нескольким сотрудникам. Это основной сценарий.
- Создаём новый документ «Изменение аванса» и указываем Организацию (обязательно) — по её сотрудникам будут меняться авансы.
- При необходимости выбираем Подразделение — оно служит для отбора и удобного заполнения списка сотрудников; можно оставить пустым.
- Выбираем Способ расчёта аванса (обязательно) — значение из перечисления «Способы расчёта аванса». От него зависит, как читается число в колонке «Аванс».
- Указываем Месяц изменения (обязательно) — месяц, с которого начинает действовать новый аванс.
- В табличной части «Авансы сотрудников» добавляем строки: Сотрудник и значение Аванс.
- Нажимаем «Провести и закрыть».
Урок 2. Сменить способ расчёта и временное изменение
Когда: сотрудников переводят на другой способ расчёта аванса, либо аванс меняется лишь на ограниченный период.
- Смена способа. Заполняем документ как в Уроке 1, но ключевое — выбрать новый Способ расчёта аванса и перезаполнить значения «Аванс» в ТЧ под этот новый способ. После проведения в «ПлановыеАвансы» фиксируется новый способ и значения.
- Временное изменение. Если аванс меняется не навсегда, дополнительно заполняем Период окончания — необязательную дату окончания действия изменения.
- Проводим документ.
Урок 3. Массовое изменение по подразделению и исправление
Когда: аванс меняется всем сотрудникам подразделения, либо в уже проведённом документе нужно скорректировать суммы или состав.
- Массово по подразделению. Указываем Подразделение в шапке, заполняем ТЧ «Авансы сотрудников» сотрудниками этого подразделения, проставляем значения и проводим. Подразделение здесь — контекст отбора; фактический состав фиксируется построчно в ТЧ.
- Найти проведённый документ. В списке номер строковый (до 11 символов), нумерация в пределах года — учитывайте год документа. Состав видно в поле «Сотрудники» (это строка-представление состава, а не таблица).
- Исправить. Открываем документ, правим состав/значения и перепроводим — записи «ПлановыеАвансы» переформируются. Отмена проведения удаляет движения (стандартное поведение платформы).
🛠 Часть 2. Для программиста
Состав объекта, регистр-приёмник движений и логика проведения. Конфигурация ЗУП для Казахстана 3.1, релиз 3.1.2.24.
Структура объекта
Тип объекта — документ. Нумерация: тип номера String, длина 11, периодичность Year (в пределах года). В метаданных объекта стоит комментарий разработчика АПК:58. В шапке 8 реквизитов, 3 табличные части. Ниже — реквизиты шапки и состав табличных частей дословно из метаданных.
Реквизиты шапки
| Имя | Тип | Обяз. | Назначение |
|---|---|---|---|
Организация | СправочникСсылка.Организации | Да (ShowError) | Организация, по сотрудникам которой меняются авансы; определяет принадлежность записей регистра |
Подразделение | СправочникСсылка.ПодразделенияОрганизаций | Нет (DontCheck) | Подразделение — для отбора/массового заполнения списка сотрудников; можно оставить пустым |
СпособРасчетаАванса | ПеречислениеСсылка.СпособыРасчетаАванса | Да (ShowError) | Новый способ расчёта аванса, назначаемый сотрудникам документа; задаёт смысл колонки Аванс |
МесяцИзменения | Дата | Да (ShowError) | Месяц, с которого действует изменённый аванс — ключевой период записи регистра |
ПериодОкончания | Дата | Нет (DontCheck) | Необязательная дата окончания действия изменения (для временных изменений) |
КраткийСоставДокумента | Строка | Нет (DontCheck) | Строковое представление состава; в UI — под синонимом «Сотрудники». Формируется по составу ТЧ, вручную не заполняется |
Ответственный | СправочникСсылка.Пользователи | Нет (DontCheck) | Пользователь, ответственный за документ |
Комментарий | Строка | Нет (DontCheck) | Произвольный комментарий |
Табличные части
| Имя | Назначение |
|---|---|
АвансыСотрудников | Основная ТЧ: список сотрудников и новые значения аванса. Колонки: Сотрудник (СправочникСсылка.Сотрудники) — кому изменяется аванс; Аванс (Число/decimal) — новое значение, интерпретируется в контексте выбранного СпособРасчетаАванса |
ФизическиеЛица | Вспомогательная ТЧ; назначение в выгрузке не описано (BSL-модули отсутствуют), по составу — список физических лиц документа. Колонка ФизическоеЛицо (СправочникСсылка.ФизическиеЛица) |
ДополнительныеРеквизиты | Стандартная ТЧ механизма дополнительных реквизитов БСП (общая для типовой, не казахстанская специфика). Колонки: Свойство (ПланВидовХарактеристикСсылка.ДополнительныеРеквизитыИСведения), Значение (составной, в выгрузке не типизирован), ТекстоваяСтрока (Строка) |
КраткийСоставДокумента имеет синоним «Сотрудники» — в списке журнала это строковое представление состава, а не таблица; не путайте его с ТЧ АвансыСотрудников. Формы в выгрузке не описаны (forms: []) — документ открывается своей формой документа из журнала. Поле Значение в ТЧ ДополнительныеРеквизиты в метаданных не типизировано (составной тип).Движения по регистрам
Документ объявлен регистратором по одному регистру — это его единственное движение.
| Регистр | Тип | Назначение |
|---|---|---|
ПлановыеАвансы | Сведений | Плановый аванс сотрудника: способ расчёта и значение, действующие с МесяцИзменения. Из этого регистра плановые авансы используются механизмами начисления и выплаты аванса |
Как формируется проведение — реальный код (3.1.2.24)
bsl_static / bsl_summaries пусты), поэтому дословный текст процедур ОбработкаПроведения / ОбработкаПроверкиЗаполнения / обработчиков ПриИзменении привести нельзя. Ниже — реконструкция по метаданным (единственный регистр-приёмник и обязательность реквизитов): это не цитата исходного кода, а корректная по структуре схема того, как типовая ЗУП проводит документ.Структура обязательности (из fill_value_required: ShowError) — то, что проверяет типовая ОбработкаПроверкиЗаполнения на уровне платформы:
// Реконструкция по metadata: 3 реквизита с проверкой заполнения (ShowError).
// Платформа проверяет их автоматически перед записью; имена — дословно из метаданных.
ПроверяемыеРеквизиты =
"Организация, СпособРасчетаАванса, МесяцИзменения";
// Остальные реквизиты — DontCheck (необязательны).
// Дополнительные прикладные проверки задаёт ОбработкаПроверкиЗаполнения (в выгрузке нет).
Схема проведения (реконструкция): у документа ровно один регистр-приёмник, поэтому всё проведение сводится к формированию набора записей регистра сведений «ПлановыеАвансы».
// Реконструкция по metadata.register_records (1 регистр). Не дословный код модуля.
Процедура ОбработкаПроведения(Отказ, РежимПроведения)
// Единственное движение документа — регистр сведений ПлановыеАвансы.
// По строкам ТЧ АвансыСотрудников формируются записи планового аванса:
// период <- МесяцИзменения (по необходимости ограничен ПериодОкончания);
// организация <- Организация;
// сотрудник <- АвансыСотрудников.Сотрудник;
// способ <- СпособРасчетаАванса;
// значение <- АвансыСотрудников.Аванс.
Движения.ПлановыеАвансы.Записывать = Истина;
Для Каждого СтрокаТЧ Из АвансыСотрудников Цикл
Движение = Движения.ПлановыеАвансы.Добавить();
Движение.Период = МесяцИзменения;
Движение.Организация = Организация;
Движение.Сотрудник = СтрокаТЧ.Сотрудник;
// СпособРасчетаАванса и значение Аванс — плановые параметры аванса.
КонецЦикла;
// Бухгалтерских проводок и движений по налогам/взносам РК нет.
Движения.Записать();
КонецПроцедуры
Зависимости
Дословный список общих модулей в выгрузке отсутствует (bsl_static: []). Структурно документ опирается на:
| Зависимость | Что используется |
|---|---|
| Регистр сведений | ПлановыеАвансы — единственный приёмник движений; источник плановых авансов для начисления/выплаты |
| Справочники | Организации, ПодразделенияОрганизаций, Сотрудники, ФизическиеЛица, Пользователи |
| Перечисления | СпособыРасчетаАванса — способ расчёта аванса, назначаемый документом |
| Механизмы БСП | Дополнительные реквизиты (ТЧ ДополнительныеРеквизиты со ссылкой на план видов характеристик ДополнительныеРеквизитыИСведения) |
based_on — не определено) и на основании «Изменения аванса» другие документы не создаются (inverse_based_on — не определено). Команды объекта в выгрузке отсутствуют (commands: []).🔗 Связанные разделы
- Приём на работу — соседний документ раздела «Кадры»; первичное оформление сотрудника, которому затем назначают плановый аванс.
- Начисление зарплаты и взносов — как плановый аванс участвует в расчёте выплат за месяц и где исчисляются налоги и взносы РК.