Документы и Печать · 11 мин
ВПФ в 1С: что это такое и как с ней работать
ВПФ в 1С — это внешняя печатная форма. Разбираем, что это, как подключить ВПФ через дополнительные отчеты и обработки, типичные ошибки и проверку результата.
ВПФ в 1С — это внешняя печатная форма: файл с расширением .epf, который добавляет в программу новый макет печати документа без изменения самой конфигурации. Типичный пример — компания использует «1С:Бухгалтерию» или «1С:Управление торговлей», но стандартный счёт на оплату или ТОРГ-12 не устраивает: нужен другой шаблон с логотипом, дополнительными колонками или особыми подписями. Вместо доработки конфигурации программист создаёт отдельный файл, который подключается к программе и появляется в списке печати документа.
Главное преимущество подхода — конфигурация остаётся типовой. Это значит, что обновления 1С устанавливаются штатно, без слияния изменений и риска потерять доработки. Внешняя форма живёт отдельно от программы: её можно заменить, отключить или обновить в любой момент, не затрагивая учётные данные.
ВПФ применяется повсеместно: счета, акты, накладные, доверенности, прайс-листы, этикетки, заявления сотрудников. Практически любой печатный документ, который формируется из данных 1С, можно реализовать как внешнюю форму — при условии, что конфигурация поддерживает механизм дополнительных отчётов и обработок.
Как устроена внешняя печатная форма
Файл ВПФ — это обычная внешняя обработка 1С, но с особой структурой. Внутри неё есть модуль объекта, в котором описана экспортная функция СведенияОВнешнейОбработке(). Эта функция сообщает программе: тип обработки («ПечатнаяФорма»), название, которое увидит пользователь, версию формата сведений и список команд печати с указанием документов, к которым форма привязывается.
Второй обязательный элемент — процедура Печать() в модуле менеджера обработки. Именно она получает массив ссылок на печатаемые документы, выбирает нужные данные запросом и заполняет табличный документ по макету. Макет обычно хранится прямо в обработке в виде табличного документа с именованными областями и параметрами.
Если форма написана не по этому стандарту — например, это просто обработка с кнопкой «Сформировать» — подключить её как печатную форму не получится. Программа при регистрации выдаст ошибку вида «Функция СведенияОВнешнейОбработке не обнаружена» или просто не покажет команду в меню печати.
Где находится и как подключить ВПФ
В типовых конфигурациях на БСП (Бухгалтерия, Управление торговлей, ERP, Зарплата и управление персоналом) внешние формы подключаются через раздел «Администрирование» → «Печатные формы, отчеты и обработки» → «Дополнительные отчеты и обработки». Перед этим нужно включить сам механизм: в том же разделе установить флажок «Дополнительные отчеты и обработки».
Дальше порядок такой: нажать «Создать», выбрать файл .epf с диска, программа прочитает сведения об обработке и покажет её название и назначение. После записи элемента форма становится доступна в списке печати соответствующих документов — обычно в подменю «Дополнительные печатные формы» или сразу в общем списке команд печати.
- 1Откройте Администрирование → Печатные формы, отчеты и обработки и включите флажок «Дополнительные отчеты и обработки»
- 2Перейдите по ссылке «Дополнительные отчеты и обработки» и нажмите «Создать»
- 3Выберите файл .epf и дождитесь чтения сведений об обработке
- 4Проверьте размещение: в таблице «Размещение» должны быть указаны нужные виды документов
- 5Запишите элемент, откройте документ и проверьте наличие формы в меню «Печать»
В старых конфигурациях (например, «Управление торговлей 10.3» или «Бухгалтерия 2.0») механизм другой: там есть справочник «Внешние печатные формы», где файл регистрируется вручную с указанием вида документа. Принцип тот же, но структура модуля обработки отличается — форма от новой конфигурации в старой не заработает, и наоборот.
Как проверить, что форма работает правильно
После подключения недостаточно увидеть новую строку в меню «Печать» — нужно проверить сам результат. Откройте реальный заполненный документ, сформируйте печатную форму и сверьте ключевые данные: номер и дату документа, наименования контрагентов, суммы, итоги по НДС, подписи. Особое внимание — на данные, которые берутся не из самого документа, а из связанных справочников: банковские реквизиты организации, адреса, ФИО руководителя.
Частая проблема — форма корректно работает для одного документа, но «ломается» на другом: например, когда в табличной части нет ни одной строки, когда цена указана без НДС, когда контрагент — физлицо. Проверьте форму на 3–5 документах разного характера, включая пограничные случаи.
Как проверить результат
Форма видна и называется понятно
Команды нет — проверьте размещение в карточке дополнительной обработки
Суммы, реквизиты и подписи совпадают с документом
Пустые поля, нулевые итоги или данные другого документа
Каждый документ выводится отдельно с верными данными
Формируется только первый документ или данные перемешаны
Пустая табличная часть и документ без НДС обрабатываются без ошибок
Ошибка выполнения или пустой табличный документ
Типичные ошибки при подключении и использовании
Самая распространённая ошибка — попытка подключить файл, не предназначенный для этой конфигурации. Форма, написанная для «Бухгалтерии 3.0», не заработает в «Управлении торговлей 11», даже если документы называются одинаково: различаются имена реквизитов и структура данных. Всегда уточняйте, под какую конфигурацию и релиз разработана ВПФ.
Вторая группа ошибок связана с безопасностью и правами. Если у пользователя нет права «Использование дополнительных отчетов и обработок», он просто не увидит форму. Если программа работает в безопасном режиме, а обработка обращается к файловой системе или внешним компонентам, выполнение будет заблокировано.
Безопасность: чем рискует компания
Файл .epf — это исполняемый код, который запускается внутри 1С с правами текущего пользователя. Внешняя обработка может читать любые данные информационной базы и, при наличии прав, изменять их. Файл, полученный из непроверенного источника (форум, письмо, мессенджер), теоретически способен выгрузить данные наружу или повредить учёт.
Поэтому правило простое: подключайте только формы от разработчиков, которым доверяете, и при малейшем сомнении просите специалиста посмотреть код обработки в конфигураторе перед подключением. В типовых конфигурациях при открытии файла программа сама показывает предупреждение о безопасности — не игнорируйте его без причины.
ВПФ или доработка конфигурации: что выбрать
Внешняя форма — не единственный способ получить нужный макет. Альтернатива — изменить типовую печатную форму прямо в конфигурации. Это оправдано, только если форма должна полностью заменить типовую для всех пользователей и глубоко интегрирована в логику программы. Минус очевиден: конфигурация снимается с полной поддержки, каждое обновление требует сравнения и переноса доработок.
ВПФ выигрывает в большинстве сценариев: форма нужна части пользователей, требуется несколько вариантов одного документа (например, счёт с логотипом и без), макет периодически меняется по требованиям контрагентов. Ограничение у внешних форм одно, но существенное: они работают только там, где конфигурация поддерживает механизм дополнительных обработок, и не могут заменить встроенную команду печати — только добавить свою.
Сравнение вариантов
Подходит для новых макетов без изменения конфигурации; обновления 1С проходят штатно. Ограничение: нужна поддержка механизма дополнительных обработок
Подходит, когда типовую форму нужно заменить полностью для всех. Ограничение: усложняются обновления, нужен программист для каждого релиза
Подходит для разовых правок: в табличном документе можно исправить текст вручную. Ограничение: правки не сохраняются и не масштабируются
Обновление и замена ВПФ
Когда разработчик присылает новую версию формы, не нужно создавать новый элемент справочника. Откройте карточку существующей дополнительной обработки, загрузите файл заново — программа заменит хранимый файл, сохранив настройки размещения и доступа. Пользователи увидят новую версию сразу, без перезапуска.
После обновления самой конфигурации 1С внешние формы стоит проверять заново: разработчики типовых решений иногда меняют состав параметров процедуры печати или имена реквизитов. Признак проблемы — форма перестала формироваться или выдаёт ошибку сразу после обновления программы, хотя раньше работала.
Что важно запомнить
ВПФ — это внешний файл .epf с макетом печатной формы, который подключается через «Дополнительные отчеты и обработки» и не требует изменения конфигурации. Подключайте только проверенные файлы, проверяйте размещение и тестируйте форму на нескольких реальных документах, включая частные случаи.
Частые вопросы о ВПФ в 1С
Чем ВПФ отличается от обычной внешней обработки?
Любая ВПФ — это внешняя обработка, но не любая обработка — печатная форма. Отличие в структуре кода: ВПФ содержит функцию СведенияОВнешнейОбработке с типом «ПечатнаяФорма» и процедуру Печать, благодаря чему программа понимает, что файл нужно показать в меню печати документов. Обычная обработка запускается сама по себе и в списке печати не появляется.
Можно ли подключить ВПФ в 1С:Бухгалтерии для редкого документа?
Да, если конфигурация поддерживает механизм дополнительных отчётов и обработок и разработчик указал этот вид документа в сведениях об обработке. Если нужного документа нет в списке размещения, его можно добавить вручную в карточке обработки — но сама форма заработает только при условии, что код умеет получать данные именно этого документа.
Почему форма подключена, но её нет в меню «Печать»?
Чаще всего не заполнена таблица размещения в карточке дополнительной обработки — откройте её и проверьте, указан ли нужный вид документов. Другие причины: у пользователя нет права использования дополнительных обработок, форма отключена (снят флажок публикации) или она подключена в другой информационной базе.
Нужно ли снимать конфигурацию с поддержки для подключения ВПФ?
Нет, в этом и смысл механизма. Внешняя печатная форма хранится в справочнике дополнительных обработок внутри базы данных, а конфигурация остаётся полностью типовой. Обновления релизов устанавливаются стандартно, файл ВПФ при этом не затрагивается.
Можно ли сделать ВПФ самостоятельно без программиста?
Простую форму — с трудом. Потребуется конфигуратор, знание встроенного языка 1С, запросов и работы с табличными документами. Реалистичный путь без программирования — взять готовую форму под вашу конфигурацию от проверенного разработчика. Небольшие правки текста в макете иногда возможны, но любая ошибка в коде приведёт к неработающей форме.
Что делать, если после обновления 1С форма перестала работать?
Сначала зафиксируйте текст ошибки и проверьте, видна ли команда в меню печати. Если команда есть, но формирование падает с ошибкой — вероятно, в новом релизе изменились реквизиты или параметры механизма печати, и форму нужно адаптировать. Обратитесь к разработчику формы с текстом ошибки и номером релиза конфигурации; до исправления используйте типовую печатную форму.