Документ «ПисьмоОбменСБанками» (Письмо с банком) — Бухгалтерия для Казахстана 3.0

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

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

Документ реализует именно корреспонденцию (обмен письмами), а не денежные операции. Финансовые движения по расчётному счёту (счёт 1030 «Денежные средства на текущих банковских счетах») формируют платёжные документы (платёжное поручение, платёжный ордер), а не письмо.

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

Ниже — назначение полей по стандартной модели документа электронного обмена 1С:ДиректБанк. Конкретный состав реквизитов уточняется в конфигураторе конкретного релиза.

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

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

Точный перечень реквизитов и табличных частей версионно-специфичен — сверяйтесь с метаданными объекта в вашем релизе.

3. Формы

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

Из evidence подтверждены следующие места кода (release 3.0.68.1, тексты сообщений — дословно из конфигурации):

Типовые обработчики (по виду объекта — непроводящий документ обмена)

• ОбработкаЗаполнения (модуль объекта) — заполнение реквизитов при вводе на основании (платёжного поручения, входящего письма).
• ОбработкаПроверкиЗаполнения — контроль обязательных полей (организация, банк, настройка обмена) перед записью.
• ПередЗаписью / ПриЗаписи (модуль объекта) — фиксация статуса обмена, обновление идентификаторов сообщения.
• Клиентские обработчики форм: ПриСозданииНаСервере, ПриОткрытии — инициализация видимости и доступности элементов в зависимости от направления и статуса письма.
• Процедуры интеграции с ДиректБанк: отправка сообщения, синхронизация статусов и загрузка входящих (сценарий 3.5), проверка ЭП (сценарий 3.6), выгрузка данных для техподдержки (сценарий 3.7) — реализуются в общих модулях подсистемы обмена с банками.

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

Документ не является проводящим. В метаданных объекта отсутствует раздел register_records (движения по регистрам), а в модулях нет процедуры ОбработкаПроведения. Как следствие:

• Документ не формирует бухгалтерских проводок и не создаёт записей в регистрах накопления/сведений в рамках собственного проведения.
• Он фиксирует факт и содержание корреспонденции с банком, а не хозяйственную операцию.

Соответственно, письмо не затрагивает такие счета типового плана счетов РК, как:

Денежные и расчётные операции (движение по 1030, взаиморасчёты по 1210/3310, признание дохода 6010, себестоимости 7010, НДС по счёту 3130 «НДС к уплате» по ставке 16 %) отражаются профильными документами (платёжные поручения/ордера, реализация, поступление), а также электронными документами ЭСФ (ИС ЭСФ) и СНТ. Письмо с банком лишь сопровождает эти операции корреспонденцией.

Если требуется аудит движений — их следует искать в связанных финансовых документах, а не в письме.

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

Основные сценарии работы

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

• Настройки обмена с банками (1С:ДиректБанк) — обязательный источник параметров подключения; без действующей настройки создание/отправка письма блокируется.
• Справочники «Организации», «Банки», «Банковские счета» — реквизиты шапки.
• Платёжное поручение — документ-основание для письма (сценарий 3.4, ДокументОснование).
• ПисьмоОбменСБанками (само на себя) — цепочка «письмо → ответ» через ПисьмоОснование (сценарий 3.3).
• Сертификаты ключей ЭП — используются в форме «Подписи» для подписания и проверки.

Ввод на основании

• Из платёжного поручения → «Письмо с банком» (сценарий 3.4): реквизиты организации, банка и настройки обмена переносятся из документа-основания.
• Из входящего письма → ответное письмо (сценарий 3.3): заполняется ПисьмоОснование, тема/адресат наследуются.

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

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

Поскольку документ непроводящий, добавление собственных движений (регистров) через расширение возможно, но нетипично: для отражения финансовых операций используйте профильные проводящие документы, а письмо оставляйте средством корреспонденции.

Типовые ошибки (дословно из кода, release 3.0.68.1)

Если видите такое сообщение — проверьте условие из третьей колонки. Тексты сообщений и имена процедур требуют проверки при переходе на другой релиз — они версионно-специфичны.