Как прикрепить файл к письму в 1С: 5 рабочих способов (с примерами кода)

Отправка писем с вложениями из 1С:Предприятие — стандартная задача для бухгалтеров, кадровиков и менеджеров. Но не все знают, что в системе есть несколько способов прикрепить файл к письму: от простого ручного добавления через интерфейс до автоматизации с помощью встроенного языка. В этой статье разберём все актуальные методы с учётом последних обновлений платформы 1С 8.3.23+.

Особенность работы с вложениями в 1С заключается в том, что не все конфигурации поддерживают одинаковые функции. Например, в 1С:Бухгалтерия можно отправлять файлы напрямую из документов, а в 1С:Управление торговлей для этого часто требуется доработка. Мы рассмотрим универсальные решения, которые работают в большинстве типовых конфигураций, а также укажем на подводные камни, с которыми сталкиваются пользователи.

1. Прикрепление файла через встроенный почтовый клиент 1С

Самый простой способ — использовать встроенную почтовую систему 1С, которая доступна в большинстве конфигураций (например, 1С:Бухгалтерия 3.0, 1С:Зарплата и управление персоналом). Этот метод не требует знания программирования и подходит для разовых задач.

Чтобы прикрепить файл:

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

⚠️ Внимание: В некоторых конфигурациях (например, 1С:Розница) встроенный почтовый клиент может отсутствовать. В этом случае используйте альтернативные методы из следующих разделов.

Проверить настройки почтового профиля в 1С

Убедиться, что файл для вложения доступен (не заблокирован другим процессом)

Проверить лимиты на размер вложений у вашего почтового провайдера

Сохранить черновик письма перед отправкой (на случай сбоя)

-->

Если кнопка Отправить по почте отсутствует, возможно, в вашей конфигурации отключена функция почтовой интеграции. Чтобы её включить:

1. Перейдите в Администрирование → Настройки программы → Интеграция → Почта.
2. Установите флажок Разрешить отправку писем.
3. Настройте почтовый профиль (укажите SMTP-сервер, логин, пароль).

2. Автоматическое прикрепление файлов через обработки

Если вам нужно регулярно отправлять письма с одинаковыми вложениями (например, еженедельные отчёты), удобнее автоматизировать процесс с помощью внешних обработок. Этот метод требует базовых знаний встроенного языка 1С, но экономит время в долгосрочной перспективе.

Пример кода для прикрепления файла к письму через обработку:

Процедура ОтправитьПисьмоСВложением()
Почта = Новый ПочтовыйКлиент;
Сообщение = Почта.СоздатьСообщение();

// Настройка письма
Сообщение.Адресат = "client@example.com";
Сообщение.Тема = "Отчёт по продажам за неделю";
Сообщение.Текст = "Добрый день! Прилагаем отчёт в формате Excel.";

// Прикрепление файла
ПутьКФайлу = "C:\Reports\sales_weekly.xlsx";
Вложение = Новый ВложениеФайла(ПутьКФайлу);
Сообщение.Вложения.Добавить(Вложение);

// Отправка
Почта.Отправить(Сообщение);
КонецПроцедуры

Этот код можно вставить в обработку или модуль документа. Чтобы создать обработку:

1. Откройте Файл → Новый → Обработка.
2. В модуле обработки вставьте приведённый выше код (с поправкой на ваши пути и адреса).
3. Сохраните обработку и запустите её через Файл → Открыть.

⚠️ Внимание: При работе с путями к файлам используйте абсолютные пути (например, C:\Folder\file.pdf), чтобы избежать ошибок. Если файл хранится в базе 1С, используйте метод ПолучитьИмяВременногоФайла() для создания временной копии.

3. Прикрепление файлов из печатных форм документов

Многие документы в 1С (счета, акты, накладные) имеют печатные формы, которые можно сразу отправить по почте с вложением. Этот способ удобен для бухгалтеров и менеджеров, так как не требует ручного сохранения файла на диск.

Инструкция:

1. Откройте нужный документ (например, Реализация товаров и услуг).
2. Нажмите Печать → Печатная форма (или Ещё → Печать).
3. В открывшемся окне выберите формат (PDF, Excel или Word).
4. Нажмите кнопку Отправить по почте (если она доступна) или сначала сохраните файл, а затем прикрепите его вручную (см. раздел 1).

В некоторых конфигурациях (например, 1С:ERP) печатные формы можно отправлять непосредственно из формы документа без сохранения на диск. Для этого:

• 📄 Выберите документ и нажмите Ещё → Отправить → По почте.
• 📎 В открывшемся окне отметьте галочкой Прикрепить печатную форму.
• 📧 Укажите адресата и отправьте письмо.

⚠️ Внимание: Если кнопка Отправить по почте отсутствует в печатной форме, это означает, что в вашей конфигурации не настроена интеграция с почтовым клиентом. Обратитесь к администратору 1С для доработки.

4. Использование внешних компонент (Outlook, Gmail API)

Если встроенные средства 1С не подходят (например, из-за ограничений SMTP или необходимости работы с Microsoft Outlook), можно использовать внешние компоненты. Этот метод сложнее в настройке, но даёт больше возможностей:

• 📧 Интеграция с Microsoft Outlook через COM-объект.
• 🔗 Подключение к Gmail API или другим почтовым сервисам.
• 📁 Работа с облачными хранилищами (Яндекс.Диск, Google Drive) для отправки ссылок вместо вложений.

Пример кода для отправки письма через Outlook:

Процедура ОтправитьЧерезOutlook()
Попытка
Outlook = Новый COMОбъект("Outlook.Application");
Письмо = Outlook.CreateItem(0); // 0 - MailItem

Письмо.To = "client@example.com";
Письмо.Subject = "Договор на поставку";
Письмо.Body = "Здравствуйте! Прилагаем договор.";
Письмо.Attachments.Add("C:\Docs\contract.pdf");

Письмо.Send(); // или .Display() для предварительного просмотра
Исключение
Сообщить("Ошибка при работе с Outlook: " + ОписаниеОшибки());
КонецПопытки;
КонецПроцедуры

Для работы с Gmail API потребуется:

1. Зарегистрировать проект в Google Cloud Console.
2. Получить клиентские ключи (OAuth 2.0).
3. Установить в 1С библиотеку для работы с HTTP-запросами (например, HTTPСервис).

⚠️ Внимание: При использовании внешних компонент убедитесь, что на компьютерах пользователей установлены необходимые программы (например, Microsoft Outlook для COM-объекта). Также учитывайте политики безопасности вашей компании — некоторые IT-отделы блокируют доступ к COM-объектам.

5. Отправка писем с вложениями через HTTP-сервисы (REST API)

Для продвинутых пользователей и разработчиков существует возможность отправки писем через HTTP-запросы к почтовым сервисам (например, SendGrid, Mailgun или корпоративный SMTP-сервер). Этот метод подходит для автоматизации массовых рассылок.

Пример кода для отправки письма через SendGrid API:

Процедура ОтправитьЧерезSendGrid()
Заголовки = Новый Соответствие;
Заголовки.Вставить("Authorization", "Bearer YOUR_SENDGRID_API_KEY");
Заголовки.Вставить("Content-Type", "application/json");

ТелоЗапроса = JSON.Записать(Новый Структура(
"personalizations,from,subject,content,attachments",
Новый Массив(
Новый Структура("to", Новый Массив(Новый Структура("email", "client@example.com")))
),
Новый Структура("email", "noreply@yourcompany.com"),
"Отчёт по продажам",
Новый Массив(
Новый Структура("type", "text/plain", "value", "Добрый день! Прилагаем отчёт.")
),
Новый Массив(
Новый Структура(
"content", Base64Строка(ПолучитьДвоичныеДанные("C:\Reports\report.pdf")),
"filename", "report.pdf"
)
)
));

HTTP = Новый HTTPСоединение("api.sendgrid.com", 443, Истина);
Ответ = HTTP.ОтправитьДляОбработки("/v3/mail/send", Заголовки, ТелоЗапроса);
КонецПроцедуры

Преимущества этого метода:

• 🚀 Высокая скорость отправки (подходит для массовых рассылок).
• 🔒 Безопасность (используются API-ключи вместо паролей).
• 📊 Возможность отслеживания статуса доставки.

⚠️ Внимание: При работе с API учитывайте лимиты бесплатных тарифов (например, в SendGrid бесплатно доступно 100 писем/день). Для корпоративного использования потребуется платный аккаунт.

ДвоичныеДанные = Новый ДвоичныеДанные("C:\path\to\file.pdf");

6. Решение типичных ошибок при работе с вложениями

При отправке писем с вложениями пользователи часто сталкиваются с ошибками. Рассмотрим самые распространённые проблемы и способы их решения:

Если ошибка не указана в таблице, проверьте журнал регистрации 1С (Администрирование → Журнал регистрации). Часто там содержится подробное описание проблемы.

⚠️ Внимание: Если вы используете 1С:Предприятие в веб-клиенте, некоторые методы (например, работа с COM-объектами) могут быть недоступны. В этом случае используйте серверные процедуры или HTTP-сервисы.

7. Оптимизация работы с вложениями: советы экспертов

Чтобы ускорить работу и избежать ошибок, следуйте этим рекомендациям:

• 📂 Храните часто используемые файлы в базе 1С. Например, создайте справочник Шаблоны писем с реквизитом типа ХранилищеЗначения для файлов.
• 🔄 Автоматизируйте именование вложений. Вместо document.pdf используйте осмысленные имена, например:

  "Счёт №123 от " + Формат(ТекущаяДата(), "ДФ=ddMMyyyy") + ".pdf"

• 📊 Используйте архивацию для больших файлов. Например, перед отправкой сжимайте отчёты в ZIP:

  ЗипФайл = Новый ZipФайл;
  ЗипФайл.Добавить("C:\Reports\large_report.xlsx");
  ЗипФайл.Закрыть("C:\Reports\report.zip");

• 🔒 Шифруйте конфиденциальные вложения. Для этого можно использовать внешние утилиты (например, 7-Zip с паролем) или библиотеки 1С для шифрования.

⚠️ Внимание: При отправке писем с персональными данными (например, данные сотрудников из 1С:ЗУП) убедитесь, что вы соблюдаете требования 152-ФЗ "О персональных данных". В некоторых случаях потребуется согласие получателя на обработку данных.

FAQ: Частые вопросы по работе с вложениями в 1С