Документ «ЭлектронноеПисьмоВходящее» — техническое описание (Бухгалтерия для Казахстана 3.0.74.2)

1. Идентификация объекта

Назначение. Документ предназначен для регистрации и хранения входящих электронных писем в системе управления взаимодействиями. Фиксирует переписку с контрагентами, партнёрами и прочими контактами, поступающую через настроенные учётные записи электронной почты. Создаётся автоматически при получении писем через интеграцию с почтовыми серверами (POP3/IMAP) либо регистрируется вручную. Обеспечивает связь переписки с объектами учёта (контрагенты, договоры, проекты, папки) и хранение истории взаимодействий. Доступ имеют пользователи, ответственные за взаимодействие, и лица с правами на соответствующую учётную запись почты.

Где найти в 1С:

• Навигационная ссылка: e1cib/list/Документ.ЭлектронноеПисьмоВходящее
• Интерфейс: раздел, содержащий подсистему «Взаимодействия» / «Почта, задачи» → журнал «Взаимодействия» (входящие письма отображаются в общем списке взаимодействий).

2. Реквизиты шапки и табличные части

2.1 Реквизиты шапки

2.2 Табличные части

Вложения письма хранятся не в табличной части, а во вложенных файлах (подсистема «Работа с файлами»): справочник присоединённых файлов, привязанный к документу-владельцу.

3. Формы

4. Ключевые процедуры модулей

Evidence содержит указание на общий модуль подсистемы, но без точных номеров строк BSL. Ниже — обработчики по фактическому evidence и типовые обработчики данного вида объекта БСП.

Из evidence:

• Взаимодействия.ПриЗаписиДокумента(...) — вызывается из обработчика ПриЗаписи модуля объекта. Выполняет запись в регистры сведений подсистемы взаимодействий (см. раздел 5): фиксирует связь письма с контактами, статус обработки и принадлежность папке/предмету.

Типовые обработчики модуля объекта / формы (БСП «Взаимодействия», «Электронная почта»):

• ОбработкаЗаполнения — заполнение реквизитов при создании (учётная запись, дата, ответственный, разбор адресов отправителя/получателей в контакты).
• ПередЗаписью — контроль заполнения обязательных полей (учётная запись, тема/адресат), обновление служебных полей.
• ПриЗаписи — вызов Взаимодействия.ПриЗаписиДокумента для актуализации регистров сведений (контакты, статусы, предметы).
• ПриСозданииНаСервере (форма) — инициализация панели вложений, кнопок «Ответить»/«Переслать», настройка отображения тела письма по ТипТекста.
• Ответить / ОтветитьВсем / Переслать (команды формы) — создание нового документа исходящего письма с подстановкой темы (Re:/Fwd:), цитированием тела и переносом вложений (для «Переслать»).
• РазобратьКонтакты — сопоставление адресов с контактами/контрагентами; при неоднозначности открывается форма уточнения контактов.
• ИзменитьКодировку — повторное декодирование тела письма в выбранной кодировке.

Типовые ошибки (дословно из кода, релиз-специфично)

⚠️ Требует проверки для 3.0.74.2: тексты и наличие обработчиков зафиксированы по релизу 3.0.68.1; в 3.0.74.2 возможны изменения в составе служебных методов подсистемы взаимодействий.

5. Проведение и движения

Документ не является проводимым бухгалтерским объектом. Он не формирует движений по регистру бухгалтерии и регистрам накопления — набор register_records в метаданных пуст. Поэтому:

• Проводок нет. Счета типового плана счетов РК (1210 «Краткосрочная ДЗ покупателей», 1030 «Деньги на текущих счетах», 1330 «Товары», 3310 «КЗ поставщикам», 3130 «НДС к уплате», 6010 «Доход от реализации», 7010 «Себестоимость реализации») данным документом не затрагиваются.
• Налоговые расчёты (НДС 16 %, ИПН 10 %/15 %, ОПВ 10 %, ОПВР 3,5 %, ВОСМС 2 %, ОСМС 3 %, СО 5 %, соцналог 6 %, МРП 4 325 ₸, МЗП 85 000 ₸) к этому объекту не относятся — он выполняет исключительно CRM-функцию. Эти показатели приведены как страновой контекст конфигурации, но письмо их не использует.

Взаимодействие с регистрами сведений (выполняется в ПриЗаписи через Взаимодействия.ПриЗаписиДокумента):

6. Связанные объекты и ввод на основании

Связанные объекты:

• Справочник.УчетныеЗаписиЭлектроннойПочты — ящик получения.
• Контакты взаимодействия: Справочник.Контрагенты, Справочник.ФизическиеЛица, Справочник.Пользователи и прочие типы, допустимые в регистре ВзаимодействияКонтакты.
• Присоединённые файлы (вложения) подсистемы работы с файлами.
• Документ.ЭлектронноеПисьмоИсходящее — при действиях «Ответить»/«Переслать».
• Предметы папок: проекты, договоры и иные объекты, связываемые через ПредметыПапок.

Ввод на основании (из письма создаётся):

• Исходящее электронное письмо — «Ответить», «Ответить всем», «Переслать» (с переносом темы, цитаты и вложений).
• Прочие взаимодействия/задачи подсистемы (при типовой настройке): встреча, телефонный звонок, запланированное взаимодействие с сохранением связи по предмету.

На основании письма могут создаваться (при развёрнутых механизмах подсистемы): контрагент/контакт из адреса отправителя; при необходимости — учётные документы вручную (счёт, реализация и т. п.), но прямой типовой команды ввода на основании учётного документа из письма нет.

7. Точки расширения

• Обработчики модуля объекта: ОбработкаЗаполнения, ПередЗаписью, ПриЗаписи, ПередУдалением — для донастройки автозаполнения, антидублей по ИдентификаторСообщения, дополнительной привязки к предметам.
• Подписки на события документа (ПриЗаписи/ПередЗаписью) — для интеграций без изменения модуля объекта.
• Переопределяемые модули БСП подсистемы «Взаимодействия» и «Электронная почта» — правила разбора контактов, определения предмета/папки, форматирования ответа.
• Расширение конфигурации: добавление реквизитов (например, признак «спам», категория, тег), команд формы, колонок в список; перехват команд «Ответить»/«Переслать».
• Дополнительные реквизиты и сведения (механизм свойств) — маркировка писем без изменения структуры метаданных.
• Правила обмена/интеграции с внешними почтовыми и CRM-системами через регистры взаимодействий.

⚠️ Требует проверки для 3.0.74.2: конкретный состав переопределяемых процедур подсистемы взаимодействий и сигнатуры методов зависят от версии БСП, включённой в 3.0.74.2.