1. Идентификация
| Параметр | Значение |
|---|---|
| Тип объекта | Документ (Documents) |
| Имя | ЭлектронноеПисьмоИсходящее |
| Полное имя | Документ.ЭлектронноеПисьмоИсходящее |
| Синоним | — (в поставляемой конфигурации синоним не задан; в интерфейсе отображается как «Электронное письмо исходящее») |
| Конфигурация | Бухгалтерия для Казахстана, редакция 3.0, версия 3.0.74.2 |
| Подсистема | «Взаимодействия» (управление электронной почтой и коммуникациями с контрагентами) |
| Где найти | Раздел «Стандартные подсистемы» → «Электронное письмо исходящее». Навигационная ссылка: e1cib/list/Документ.ЭлектронноеПисьмоИсходящее |
Назначение. Документ служит для создания, редактирования и отправки электронных писем непосредственно из 1С. Это элемент подсистемы управления взаимодействиями с контрагентами, партнёрами и внутренними пользователями. Документ интегрирован с учётными записями электронной почты, поддерживает создание писем на основании других взаимодействий (встречи, телефонные звонки, входящие письма), работу с вложениями и шаблонами, управление статусами отправки и хранение истории переписки. Используется сотрудниками отделов продаж, закупок, бухгалтерии и руководителями для формальной коммуникации. Доступ к письму ограничивается правами ответственного, автора и владельца учётной записи через механизм RLS (Row-Level Security).
Важно: это коммуникационный, а не учётный документ. Он не участвует в налоговом и бухгалтерском учёте, не оперирует суммами НДС (в РК с 2026 г. — 16 %), МРП (4 325 ₸) или счетами плана счетов. Письмо может лишь содержать вложением учётные и электронные документы (например, печатную форму счёта, ЭСФ, СНТ), но само по себе движений и сумм не формирует.
2. Реквизиты шапки и табличные части
2.1 Реквизиты шапки
| Реквизит | Тип | Назначение |
|---|---|---|
УчетнаяЗапись |
СправочникСсылка.УчетныеЗаписиЭлектроннойПочты | Учётная запись, от имени которой отправляется письмо. Именно её адрес подставляется в поле «От кого» |
Тема |
Строка | Тема письма (Subject) |
Важность |
ПеречислениеСсылка.ВажностьИнтернетПочтовогоСообщения | Приоритет: Низкая / Обычная / Высокая |
ТекстПисьма |
Строка (неограниченная) | Тело письма в текстовом виде |
HTMLТекстПисьма |
Хранилище значения / Строка | Тело письма в формате HTML (когда формат — HTML) |
ФорматТекстаПисьма |
ПеречислениеСсылка.ТипыТекстовПочтовыхСообщений | Формат: ПростойТекст / HTML |
Отправлено |
Булево | Признак успешной отправки (влияет на статус и блокировку редактирования) |
ДатаОтправления / ДатаПолучения |
Дата | Фактические дата и время отправки |
Размер |
Число | Размер письма с вложениями (байт) |
ИдентификаторСообщения |
Строка | Message-ID для связывания цепочки переписки |
ОсновнаяТемаВзаимодействия (Предмет) |
ЛюбаяСсылка | Предмет переписки — контрагент, договор, заказ и т. п. (через регистр «ПредметыПапкиВзаимодействий») |
Автор |
СправочникСсылка.Пользователи | Создатель письма |
Ответственный |
СправочникСсылка.Пользователи | Ответственный за взаимодействие (используется в RLS) |
УдалятьПослеОтправки |
Булево | Служебный флаг для временных писем |
ЗапланированноеВремяОтправки |
Дата | Время отложенной отправки (сценарий 3.5) |
ИнтернетЗаголовки |
Хранилище значения | Служебные заголовки RFC-822 |
2.2 Табличные части
| Табличная часть | Ключевые колонки | Назначение |
|---|---|---|
Получатели |
Контакт (любая ссылка), Адрес (Строка, email), Представление (Строка), ГруппаПолучателя (перечисление: Кому / Копия / СкрытаяКопия) |
Список адресатов письма. Одна строка — один email. Группа определяет, попадёт ли адрес в «Кому», «Копия» или «Скрытая копия» |
ДополнительныеРеквизиты |
Свойство, Значение |
Дополнительные реквизиты и характеристики (механизм БСП «Свойства») |
Вложения (файлы) хранятся не в табличной части, а в отдельном справочнике присоединённых файлов ЭлектронноеПисьмоИсходящееПрисоединенныеФайлы, связанном с документом-владельцем. Вложенные письма (сценарий 3.7) хранятся как присоединённые файлы формата .eml.
Требует проверки в конкретном релизе: в разных версиях БСП набор колонок табличной части «Получатели» и наличие отдельных ТЧ для копий/скрытых копий может отличаться — в 3.0.7x получатели обычно разделяются полем
ГруппаПолучателявнутри одной ТЧ.
3. Формы
| Форма | Назначение |
|---|---|
ФормаДокумента |
Основная форма — составление письма: адресаты, тема, текст (HTML/текст), вложения, кнопки «Отправить», «Переслать», работа с шаблонами и уточнением контактов |
ФормаСписка |
Список исходящих писем (открывается по e1cib/list/Документ.ЭлектронноеПисьмоИсходящее) |
| Форма выбора | Выбор письма из списка при подборе в связанные объекты |
Дополнительно задействуются общие формы подсистемы «Взаимодействия»: форма уточнения контактов получателей (сценарий 3.6), форма работы с шаблонами сообщений (сценарий 3.4), форма выбора учётной записи.
4. Ключевые процедуры модулей
Из evidence извлекаются следующие обработчики (тексты сообщений приведены дословно из кода, release 3.0.68.1; в 3.0.74.2 логика сохранена):
| Модуль / процедура | Что делает |
|---|---|
Форма.ФормаДокумента → ОтправитьВыполнить |
Отправка письма. Проверяет доступность учётной записи для отправки. При НайденныеСтроки.Количество() = 0 выдаёт «Выбранная почта недоступна для отправки писем.» |
Форма.ФормаДокумента → ОтправитьПереслатьВыполнить |
Пересылка/отправка с проверкой наличия адресатов. При СписокПолучателей.Количество() = 0 выдаёт «Укажите хотя бы одного получателя письма.» |
Форма.ФормаДокумента → ПоказатьПредупреждениеОНеобходимостиВвестиАдресЭлектроннойПочты |
Контроль заполнения email адресата, выдаёт «Введите адрес электронной почты» |
МодульОбъекта (серверный контекст) |
Формирование объекта письма; при неверном вызове клиентского метода на сервере возможно «Недопустимый вызов объекта на клиенте.» |
Типовые обработчики этого вида объекта (общая логика, не из evidence):
ОбработкаЗаполнения— заполнение при вводе на основании (подстановка адресата из контрагента, темы, предмета переписки).ПередЗаписью/ПриЗаписи— фиксация статуса отправки, обновление регистра предметов взаимодействий, пересчёт размера.- Обработчики формы
ПриСозданииНаСервере,ПриОткрытии— инициализация учётной записи по умолчанию, подготовка списка получателей и вложений.
Поддерживаемые сценарии (из evidence): создание письма с нуля (3.1), ответ на входящее (3.2), пересылка (3.3), создание по шаблону (3.4), отложенная отправка (3.5), уточнение контактов получателей (3.6), добавление вложений и вложенных писем (3.7).
5. Проведение и движения
Документ не проводится и не формирует движений — в метаданных register_records = []. Записи в регистрах бухгалтерии, накопления и сведений по учётному контуру он не создаёт.
Отсюда:
- Проводок по плану счетов РК документ не делает (счета 1210 «Краткосрочная ДЗ покупателей», 1030 «Деньги на текущих счетах», 1330 «Товары», 3310 «КЗ поставщикам», 3130 «НДС к уплате», 6010 «Доход от реализации», 7010 «Себестоимость реализации» и др. здесь не задействованы).
- Суммы, ставки и налоги (НДС 16 %, ИПН, ОПВ, ОСМС и т. д.) документом не рассчитываются.
- Всё «движение» документа — это факт отправки почтового сообщения через SMTP-сервер учётной записи и служебная привязка к предмету взаимодействия (через регистр сведений
ПредметыПапкиВзаимодействий/СостоянияВзаимодействийподсистемы «Взаимодействия»).
Если письмо используется для отправки контрагенту учётных или электронных документов (счёт-фактура, ЭСФ через ИС ЭСФ, СНТ), то за формирование этих документов и их проводок/выгрузку отвечают соответствующие учётные объекты (реализация, ЭСФ, СНТ), а не письмо. Письмо лишь несёт их как вложения.
6. Связанные объекты и ввод на основании
Ввод на основании исходящего письма — обычно письмо само является результатом ввода на основании, а не источником. Типовые источники (создание письма «Ответить»/«Переслать»/«Написать»):
| Источник | Что подставляется |
|---|---|
Документ.ЭлектронноеПисьмоВходящее |
Адресат (из отправителя входящего), тема с префиксом «Re:»/«Fwd:», цитируемый текст, предмет переписки |
Справочник.Контрагенты / Партнеры |
Email контактного лица, предмет взаимодействия |
Справочник.Пользователи, контактные лица |
Адрес получателя |
| Прочие взаимодействия (встреча, телефонный звонок, запланированное взаимодействие) | Предмет переписки, участники |
Связанные объекты:
Справочник.УчетныеЗаписиЭлектроннойПочты— от чьего имени и через какой SMTP отправляется.Справочник.ЭлектронноеПисьмоИсходящееПрисоединенныеФайлы— вложения.- Регистры подсистемы «Взаимодействия»: предметы, состояния, папки, отложенные к отправке.
Документ.ЭлектронноеПисьмоВходящее— вторая половина цепочки переписки (связь поИдентификаторСообщения/ предмету).
7. Точки расширения
- Расширение конфигурации (без снятия с поддержки): добавление реквизитов/колонок к документу и форме, переопределение обработчиков формы
ФормаДокумента(ОтправитьВыполнить,ОтправитьПереслатьВыполнить), добавление собственных команд (например, «Приложить ЭСФ», «Приложить СНТ»). - Программные интерфейсы БСП: модули
Взаимодействия,РаботаСПочтовымиСообщениями,РаботаСПочтовымиСообщениямиКлиент— переопределяемые процедуры формирования и отправки писем. - Механизм «Свойства» (ТЧ
ДополнительныеРеквизиты) — расширение состава характеристик письма без изменения метаданных. - Шаблоны сообщений (
Справочник.ШаблоныСообщений) — типизация текстов писем (счёт-оффер, уведомление о задолженности) под задачи внедрения. - Присоединённые файлы — интеграция с внешними хранилищами (тома, S3) через подсистему работы с файлами.
- Правила обмена / бизнес-процессы — запуск отправки писем из бизнес-процессов и задач.
Требует проверки в конкретном релизе 3.0.74.2: точный состав экспортных процедур модулей
Взаимодействия*версионно-зависим — перед переопределением сверьтесь с текущим синтаксис-помощником конфигурации.