АГТ_ПомощникРасчетчика (Внешняя обработка)

Помощник расчётчика ЗУП — ручной запуск расчётов в один клик

Внешняя обработка для 1С:ЗУП 3.1

Для кого

Бухгалтеры-расчётчики и расчётные центры, ведущие от 2 до 5 организаций в одной базе ЗУП 3.1.

В базе с несколькими организациями расчётчик каждый месяц повторяет одни и те же действия по кругу: завести и провести отсутствия, начислить аванс, рассчитать отпуска, начислить зарплату, сформировать ведомости — и так по каждой организации отдельно.

АГТ_ПомощникРасчетчика_v46 собирает все организации базы в одну таблицу. Расчётчик отмечает галками, что и где нужно сделать, и запускает операцию одной кнопкой сразу по всем выбранным организациям.

• Отсутствия — проведение и расчёт прогулов и неявок (в т.ч. списком).
• Аванс — создание, заполнение и проведение начисления за первую половину месяца.
• Отпуска — расчёт и проведение отпусков штатным методом ЗУП.
• Зарплата — начисление зарплаты и взносов за месяц.
• Ведомости — формирование ведомостей на выплату аванса, зарплаты и отпускных.

• Результат совпадает с типовым расчётом 1С — проверено сверкой регистров.
• При обновлении ЗУП новые алгоритмы расчёта на 90% подхватываются автоматически — обработку не нужно переписывать под каждый релиз.
• Нет риска «расхождения с типовой методикой», характерного для ручного воспроизведения формул.

• Отпуска считаются нативным методом Отпуск.Рассчитать — полный аналог кнопки «Перезаполнить»: единовременные выплаты, компенсации, коэффициенты среднего, перерасчёты.
• Автоматический подбор видов расчёта для дополнительных отпусков (учебный, санаторно-курортный и др.) по типовой логике формы.
• Аккуратная работа с документами-исправлениями: они не трогаются автоматически, а оставляются расчётчику — перерасчёт прошлых периодов остаётся под контролем человека.
• Подробный вывод по каждой организации — видно, что обработано и где возникли вопросы.

АГТ_ПомощникРасчетчика_v46 — это ручной инструмент. Для автоматического выполнения тех же операций по расписанию (без участия человека) существует парное решение — расширение «ПомощникРасчетчика_v37». Оба продукта используют одну расчётную логику и могут применяться вместе.

Инструкция

Обработка «АГТ_ПомощникРасчетчика» — помощник расчётчика ЗУП

Версия обработки: 46   |   Конфигурация: 1С:ЗУП 3.1

«АГТ_ПомощникРасчетчика_v46» — это внешняя обработка для ручного (интерактивного) запуска типовых расчётных операций в ЗУП по выбранным организациям: проведение отсутствий, начисление аванса, расчёт отпусков, начисление зарплаты и формирование ведомостей на выплату.

Главный принцип работы — обработка вызывает штатные методы 1С, а не воспроизводит логику расчёта вручную. Благодаря этому при обновлении ЗУП алгоритмы расчёта подхватываются автоматически.

A.1. Как открыть обработку

1. Файл → Открыть в режиме 1С:Предприятие.
2. Выбрать файл обработки АГТУправление.epf.
3. Откроется форма со списком организаций базы.

A.2. Таблица организаций

При открытии форма автоматически заполняет таблицу всеми организациями базы (кроме помеченных на удаление). По умолчанию все галки выключены — вы сами решаете, что включить.

Колонки таблицы:

Отметьте галки в нужных колонках напротив тех организаций, по которым хотите выполнить операцию. Каждая кнопка работает только по своей колонке: например, кнопка «Аванс» обрабатывает организации с галкой в колонке «Аванс».

A.3. Кнопки запуска

Каждая кнопка запускает одну операцию по всем организациям, где включена соответствующая галка:

A.4. Рекомендуемый порядок за месяц

4. По необходимости — Отсутствия (если есть прогулы/неявки),
5. По мере оформления отпусков — Отпуска, затем Вед. отпуск.
6. Затем Аванс. В день аванса — Вед. аванс.
7. В конце месяца — Зарплата, затем Вед. зарплата.

A.5. Где смотреть результат

После нажатия кнопки результат выводится в окно сообщений 1С (внизу экрана). Там видно, по каким организациям что обработано, какие документы проведены, и текст ошибок, если они возникли. По завершении выводится строка === Готово ===.

A.6. Что обработка НЕ делает (намеренно)

• Документы-исправления отпусков (когда заполнен «Исправленный документ») — пропускаются с сообщением в окно. Перерасчёт прошлых периодов требует решений человека (период регистрации, дата выплаты), поэтому такие документы оставляются расчётчику.
• Не трогает то, что вы уже рассчитали и провели вручную, если это не входит в текущую операцию.

B.1. Тип и подключение

• Тип: внешняя обработка (.epf), запускается интерактивно из 1С:Предприятие.
• Конфигурация: 1С:ЗУП 3.1. Используется расширенный расчёт зарплаты (функциональная опция «Использовать расчёт зарплаты Расширенная»).
• Версия: 46 (актуальная на момент составления инструкции).

B.2. Архитектура

Форма содержит таблицу организаций (реквизит ТЧ с колонками-галками) и набор команд-кнопок. Каждая команда:

8. Собирает массив организаций по своей колонке-галке через ПолучитьОрганизацииИзТЧ(ИмяКолонкиГалка).
9. Для каждой организации вызывает серверный обработчик соответствующего этапа.
10. Результат и ошибки пишет в окно сообщений через Сообщить().

Имена колонок-галок: Отсутствия, Аванс, Отпуска, ЗП, ВедОтпуск, ВедАванс, ВедЗП.

B.3. Ключевые методы расчёта

Отпуска — нативный расчёт

Начиная с v35 расчёт отпусков полностью передан штатной логике: используется Отпуск.Рассчитать(ПараметрыРасчёта) — точный аналог кнопки «Перезаполнить» в форме документа. Перед расчётом обязателен гейт ДокументГотовКРасчету(Истина).

Подбор видов допотпусков (v42–v43): объектный Рассчитать() не подбирает виды расчёта для строк «Дополнительные отпуска» — это делает форма. Процедура АГТПодобратьВидыДопОтпусков повторяет логику формы на типовых методах (категория начисления → отбор → НачислениеПоУмолчанию), заполняя только пустые виды. Для санаторно-курортного отпуска используется отдельная категория (за счёт СФР).

Отсутствия — через менеджер расчёта

Документы «Прогул, неявка» рассчитываются и проводятся через РасчетЗарплатыРасширенный.СоздатьМенеджерРасчета(). Менеджер заполняет начисления (ЗаполнитьНачисленияСотрудникаЗаПериод()), выполняет РассчитатьЗарплату(), после чего результаты переносятся в документ и он проводится.

B.4. Документы-исправления отпусков

Документы-исправления отпусков (заполнен ИсправленныйДокумент) с v39 не рассчитываются — пропуск с сообщением в окно. Логика автоматического расчёта исправлений сохранена в коде, но не достигается из-за раннего Возврат. (Чтобы вернуть авторасчёт — закомментировать блок-страж). Сделано целенаправленно так как нужно не просто рассчитать, а проверить -«не создан ли документ кадровиком ошибочно?»

B.5. Зависимости

• Общие модули ЗУП: РасчетЗарплатыРасширенный, ПланыВидовРасчета.Начисления, ОбщегоНазначения.
• Функциональная опция расширенного расчёта зарплаты должна быть включена.

ПомощникРасчетчика_v37 (расширение)

Автоматический расчёт зарплаты по расписанию — без участия человека

Расширение для 1С:ЗУП 3.1

Бухгалтерии и расчётные центры с фиксированным графиком выплат (2–5 организаций в базе ЗУП 3.1), в т.ч. когда расчёт нужно выполнять в нерабочее время — ночью или рано утром к платёжным дням.

Ежемесячный расчёт привязан к датам: аванс — в свои дни, зарплата — в конце месяца, ведомости — к платёжным дням. Расчётчик вынужден помнить про каждую дату и каждую организацию, заходить в базу и вручную запускать операции.

А при нескольких организациях нагрузка умножается.

«Помощник расчётчика» работает как регламентное задание. В документе-настройке по каждой организации задаётся расписание: какая задача, в какие числа и в какой час выполняется. Дальше система делает всё сама.

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

• Email-отчёт по каждой организации после выполнения.
• Подробный журнал регистрации с разбивкой по этапам (аванс, отпуска, зарплата, ведомости) — всегда видно, что и когда отработало.
• Безопасность перерасчётов — документы-исправления и спорные случаи не проводятся вслепую, а остаются под контролем расчётчика.

«Помощник расчётчика» автоматизирует расчёт по расписанию. Для случаев, когда нужно запустить расчёт вручную здесь и сейчас (внеплановый пересчёт, разовая операция), существует парное решение — Внешняя обработка «АГТ_ПомощникРасчетчика_v46». Оба продукта используют одну расчётную логику и могут применяться вместе.

Инструкция пользователя

Расширение «Помощник расчётчика» — автозапуск по расписанию

Конфигурация: 1С:ЗУП 3.1   |   Тип: расширение (.cfe)

Расширение «ПомощникРасчетчика_v37» выполняет те же расчётные операции, что и обработка «АГТ_ПомощникРасчетчика_v46», но автоматически по расписанию — через регламентное задание. Расчётчику не нужно открывать обработку и нажимать кнопки: достаточно один раз настроить расписание в документе, и задачи будут выполняться сами в указанные дни и часы.

Как и обработка, расширение вызывает штатные методы 1С — при обновлении ЗУП расчётная логика подхватывается автоматически.

A.1. Документ «Настройки помощника»

Это главная настройка. На каждую организацию создаётся свой документ. Расширение берёт активный документ организации и работает по нему.

Реквизиты документа:

A.2. Таблица «Расписание»

Каждая строка расписания — это одна задача и условие, когда её запускать:

Варианты колонки «Числа месяца»

A.3. Пример заполнения расписания

В этом примере отсутствия и аванс считаются в платёжные дни организации, а зарплата с ведомостью — в последний день месяца вечером.

A.4. Email-отчёт о выполнении

Если включён флаг «Отправлять отчёты на почту», после выполнения задач по организации формируется письмо со сводкой (что обработано, какие ошибки) и отправляется Ответственному с учётной записи, указанной в «От кого». Это удобно, чтобы контролировать ночные/утренние запуски, не заходя в базу.

A.5. Как проверить, что всё сработало

• Письмо на почте (если включены email-отчёты) — самый быстрый способ.
• Журнал регистрации. Расширение пишет подробный лог. Откройте журнал и отфильтруйте по событиям, начинающимся с ПомощникРасчетчика.

• Проведённые документы в списках ЗУП за нужный период.

B.1. Тип и состав

• Тип: расширение конфигурации (.cfe) для 1С:ЗУП 3.1.
• Общий модуль ПомощникЗУП — логика расчёта, диспетчер задач, чтение настроек, email-отчёт.
• Документ НастройкиПомощника — реквизиты-галки задач, платёжные дни, ТЧ «Расписание», реквизиты почты, ТЧ «Список недоверенных» (для перерасчёта отпусков).
• Регламентное задание ПомощникОбработкиДокументов — вызывает точку входа.

B.2. Точка входа и поток выполнения

Регламентное задание вызывает ВыполнитьЗадание(). Дальнейший поток:

1. ВыполнитьЗадание() — фиксирует время старта, перебирает организации, вызывает ОбработатьОрганизацию.
2. ОбработатьОрганизацию — читает активный документ через ПрочитатьНастройки, перебирает строки расписания.
3. Для каждой строки проверяет РасписаниеСработало (число месяца + час + платёжные дни) и ЗадачаВключена (галка задачи).
4. Если оба условия истинны — вызывает диспетчер ЗапуститьЗадачу(Настройки, СтрокаРасписания, СтрокиОтчёта).
5. После обработки организации — при включённом флаге шлёт письмо через АГТОтправитьОтчётОрганизации.

B.3. Диспетчер задач

ЗапуститьЗадачу нормализует имя задачи и маршрутизирует в одну из процедур:

Неизвестное имя — запись в журнал «не реализована, пропускаем» и (при наличии) строка в email-отчёте.

B.4. Версии модуля

При доработке точек входа важно сохранять сигнатуру с СтрокиОтчёта = Неопределено в v35: диспетчер передаёт третий параметр. Процедура с двумя параметрами вызовет ошибку «Слишком много фактических параметров».

B.5. Журналы регистрации

Имена событий: ПомощникРасчетчика, ПомощникРасчетчика.Аванс, ПомощникРасчетчика.Отпуска, ПомощникРасчетчика.Зарплата, ПомощникРасчетчика.Ведомости.

B.6. Связь с обработкой АГТ_ПомощникРасчетчика_v46

Расширение и обработка — парные продукты с общей расчётной логикой. Обработка предназначена для ручного запуска, расширение — для регламентного. Расчётные алгоритмы (нативный Отпуск.Рассчитать, подбор видов допотпусков, менеджер расчёта для отсутствий) идентичны.