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