--- title: "Документ «ПисьмоОбменСБанками» (Письмо с банком) — Бухгалтерия для Казахстана 3.0" country: KZ lang: ru author: Сапа Т.И. (https://buhgpt.kz/authors/sapa-ti) date: 2026-09-06 canonical: https://buhgpt.kz/suraqtar/dokument-pismoobmensbankami-pismo-s-bankom-buhgalteriya-dlya-kazahstan source: BuhGPT --- # Документ «ПисьмоОбменСБанками» (Письмо с банком) — Бухгалтерия для Казахстана 3.0 > **TL;DR:** 1. Идентификация объекта Параметр Значение Тип объекта Документ ( Документ ) Имя ПисьмоОбменСБанками Полное имя Документ.ПисьмоОбменСБанками Синоним «Письмо с банком» Конфигурация Бухгалтерия для Казахстана, редакция 3.0 (версия 3.0.74.2) Проведение Не проводится (см. раздел 5 --- 1. Идентификация объекта Параметр Значение Тип объекта Документ (Документ) Имя ПисьмоОбменСБанками Полное имя Документ.ПисьмоОбменСБанками Синоним «Письмо с банком» Конфигурация Бухгалтерия для Казахстана, редакция 3.0 (версия 3.0.74.2) Проведение Не проводится (см. раздел 5) Где найти (интерфейс) Раздел «Электронное взаимодействие» → «Письмо с банком» Навигационная ссылка e1cib/list/Документ.ПисьмоОбменСБанками Назначение. Документ предназначен для регистрации и обработки электронной корреспонденции между организацией и банком в рамках системы электронного взаимодействия (технология 1С:ДиректБанк). Через него отправляются и принимаются сообщения, уведомления, запросы и ответы: произвольные письма, документы валютного контроля, сопроводительная переписка к платёжным поручениям. С документом ежедневно работают пользователи бухгалтерии и казначейства при отправке и получении электронных документов. В списке представлены входящие и исходящие письма с возможностью фильтрации по организациям, банкам и типам писем. Документ реализует именно корреспонденцию (обмен письмами), а не денежные операции. Финансовые движения по расчётному счёту (счёт 1030 «Денежные средства на текущих банковских счетах») формируют платёжные документы (платёжное поручение, платёжный ордер), а не письмо. 2. Реквизиты шапки и табличные части Ниже — назначение полей по стандартной модели документа электронного обмена 1С:ДиректБанк. Конкретный состав реквизитов уточняется в конфигураторе конкретного релиза. 2.1. Реквизиты шапки Реквизит Тип (типовой) Назначение Номер Строка Номер документа-письма в информационной базе Дата Дата Дата регистрации письма Организация СправочникСсылка.Организации Организация — участник обмена Банк / БанковскийСчет СправочникСсылка.Банки / БанковскиеСчета Банк-адресат/отправитель и связанный банковский счёт НастройкаОбмена СправочникСсылка.НастройкиОбменаСБанками Действующая настройка обмена 1С:ДиректБанк, через которую идёт передача ВидПисьма / ТипСообщения Перечисление Тип корреспонденции (запрос, уведомление, ответ, произвольное письмо) Направление Перечисление (Входящее/Исходящее) Направление письма Тема Строка Тема/заголовок сообщения Текст / СодержаниеПисьма Строка (многострочная) Тело письма ПисьмоОснование ДокументСсылка.ПисьмоОбменСБанками Исходное письмо при формировании ответа (сценарий 3.3) ДокументОснование ДокументСсылка Связанный документ (например, платёжное поручение — сценарий 3.4) Статус / СтатусОбмена Перечисление Состояние обмена: подготовлено, отправлено, доставлено, ошибка и т. п. Прочитано Булево Признак прочтения входящего письма (сценарий 3.2) ИдентификаторДокументаОбмена / GUIDСообщения Строка/УникальныйИдентификатор Идентификатор сообщения на стороне сервиса ДиректБанк Автор / Ответственный СправочникСсылка.Пользователи Пользователь, оформивший письмо 2.2. Табличные части Табличная часть Ключевые колонки Назначение Вложения / Файлы Имя файла, Данные (ХранилищеЗначения), Тип Прикреплённые к письму файлы и электронные документы Подписи / ЭП Сертификат, Владелец, Статус проверки, Штамп времени Электронные подписи письма и результаты их проверки (сценарий 3.6) Точный перечень реквизитов и табличных частей версионно-специфичен — сверяйтесь с метаданными объекта в вашем релизе. 3. Формы Форма Назначение ФормаСписка (Форма.ФормаСписка) Основной список входящих/исходящих писем с фильтрацией по организациям и банкам. Выполняет ЗаполнитьСпискиОрганизацийИБанков — подбор доступных настроек обмена ДиректБанк с поддержкой писем ПисьмоВБанк (Форма.ПисьмоВБанк) Форма исходящего письма. Метод ОформитьШапкуФормы проверяет наличие действующих настроек обмена для нового письма Подписи (Форма.Подписи) Работа с электронными подписями письма: просмотр сертификатов, проверка ЭП. Метод ОткрытьСертификат открывает выбранный в списке сертификат Форма входящего письма / просмотра Просмотр полученного письма, пометка «Прочитано», формирование ответа 4. Ключевые процедуры модулей Из evidence подтверждены следующие места кода (release 3.0.68.1, тексты сообщений — дословно из конфигурации): Процедура / метод Расположение Что делает ЗаполнитьСпискиОрганизацийИБанков Форма.ФормаСписка Формирует списки доступных организаций/банков по настройкам обмена ДиректБанк. Если результат пуст (НЕ ТаблицаРезультата.Количество()), выдаёт: «Не найдено ни одной настройки обмена 1С:ДиректБанк c поддержкой отправки писем.» ОформитьШапкуФормы Форма.ПисьмоВБанк При создании нового письма (ЭтоНовый И НЕ ТаблицаРезультата.Количество()) проверяет действующие настройки обмена; при их отсутствии выдаёт: «Отсутствуют действующие настройки обмена 1С:ДиректБанк со Сбербанком.» ОткрытьСертификат Форма.Подписи Открывает выбранный сертификат ЭП. При отсутствии выбора (Элементы.ЭП.ТекущиеДанные <> Неопределено) выдаёт: «Выберите сертификат в списке установленных подписей.» Типовые обработчики (по виду объекта — непроводящий документ обмена) - ОбработкаЗаполнения (модуль объекта) — заполнение реквизитов при вводе на основании (платёжного поручения, входящего письма). - ОбработкаПроверкиЗаполнения — контроль обязательных полей (организация, банк, настройка обмена) перед записью. - ПередЗаписью / ПриЗаписи (модуль объекта) — фиксация статуса обмена, обновление идентификаторов сообщения. - Клиентские обработчики форм: ПриСозданииНаСервере, ПриОткрытии — инициализация видимости и доступности элементов в зависимости от направления и статуса письма. - Процедуры интеграции с ДиректБанк: отправка сообщения, синхронизация статусов и загрузка входящих (сценарий 3.5), проверка ЭП (сценарий 3.6), выгрузка данных для техподдержки (сценарий 3.7) — реализуются в общих модулях подсистемы обмена с банками. 5. Проведение и движения Документ не является проводящим. В метаданных объекта отсутствует раздел register_records (движения по регистрам), а в модулях нет процедуры ОбработкаПроведения. Как следствие: - Документ не формирует бухгалтерских проводок и не создаёт записей в регистрах накопления/сведений в рамках собственного проведения. - Он фиксирует факт и содержание корреспонденции с банком, а не хозяйственную операцию. Соответственно, письмо не затрагивает такие счета типового плана счетов РК, как: Счёт Наименование 1030 Денежные средства на текущих банковских счетах 1210 Краткосрочная дебиторская задолженность покупателей 3310 Краткосрочная кредиторская задолженность поставщикам Денежные и расчётные операции (движение по 1030, взаиморасчёты по 1210/3310, признание дохода 6010, себестоимости 7010, НДС по счёту 3130 «НДС к уплате» по ставке 16 %) отражаются профильными документами (платёжные поручения/ордера, реализация, поступление), а также электронными документами ЭСФ (ИС ЭСФ) и СНТ. Письмо с банком лишь сопровождает эти операции корреспонденцией. Если требуется аудит движений — их следует искать в связанных финансовых документах, а не в письме. 6. Связанные объекты и ввод на основании Основные сценарии работы № Сценарий Когда применяется 3.1 Отправка нового письма в банк Произвольный запрос/уведомление/документ вне типовых платёжных операций 3.2 Просмотр входящего письма и пометка как прочитанного Получено новое письмо от банка 3.3 Ответ на письмо от банка Ответ с привязкой к исходному письму (ПисьмоОснование) 3.4 Создание письма на основании платёжного поручения Дополнительное письмо, связанное с конкретным платежом 3.5 Синхронизация с банком и получение новых писем Загрузка новых писем и обновление статусов отправленных 3.6 Проверка электронных подписей письма Проверка подлинности входящего/корректности исходящего письма 3.7 Сохранение информации для техподдержки При ошибке обмена или передаче данных в техподдержку Связанные объекты - Настройки обмена с банками (1С:ДиректБанк) — обязательный источник параметров подключения; без действующей настройки создание/отправка письма блокируется. - Справочники «Организации», «Банки», «Банковские счета» — реквизиты шапки. - Платёжное поручение — документ-основание для письма (сценарий 3.4, ДокументОснование). - ПисьмоОбменСБанками (само на себя) — цепочка «письмо → ответ» через ПисьмоОснование (сценарий 3.3). - Сертификаты ключей ЭП — используются в форме «Подписи» для подписания и проверки. Ввод на основании - Из платёжного поручения → «Письмо с банком» (сценарий 3.4): реквизиты организации, банка и настройки обмена переносятся из документа-основания. - Из входящего письма → ответное письмо (сценарий 3.3): заполняется ПисьмоОснование, тема/адресат наследуются. 7. Точки расширения - Расширения конфигурации (модули форм): перехват ЗаполнитьСпискиОрганизацийИБанков, ОформитьШапкуФормы, ОткрытьСертификат через &Вместо/&После для кастомной фильтрации настроек обмена или дополнительной валидации. - Модуль объекта: доопределение ОбработкаЗаполнения (правила ввода на основании), ОбработкаПроверкиЗаполнения (дополнительные обязательные поля), ПриЗаписи (интеграционные хуки, логирование обмена). - Подписки на события (ПередЗаписью/ПриЗаписи документа) — для внешнего аудита корреспонденции без вмешательства в модуль объекта. - Дополнительные реквизиты и сведения (механизм свойств) — для маркировки писем без изменения метаданных. - Общие модули подсистемы обмена — точки для доработки логики синхронизации (сценарий 3.5) и проверки ЭП (сценарий 3.6). Поскольку документ непроводящий, добавление собственных движений (регистров) через расширение возможно, но нетипично: для отражения финансовых операций используйте профильные проводящие документы, а письмо оставляйте средством корреспонденции. Типовые ошибки (дословно из кода, release 3.0.68.1) Сообщение 1С Где возникает Условие в коде Не найдено ни одной настройки обмена 1С:ДиректБанк c поддержкой отправки писем. Форма.ФормаСписка / ЗаполнитьСпискиОрганизацийИБанков НЕ ТаблицаРезультата.Количество() Отсутствуют действующие настройки обмена 1С:ДиректБанк со Сбербанком. Форма.ПисьмоВБанк / ОформитьШапкуФормы ЭтоНовый И НЕ ТаблицаРезультата.Количество() Выберите сертификат в списке установленных подписей. Форма.Подписи / ОткрытьСертификат Элементы.ЭП.ТекущиеДанные <> Неопределено Если видите такое сообщение — проверьте условие из третьей колонки. Тексты сообщений и имена процедур требуют проверки при переходе на другой релиз — они версионно-специфичны. --- _BuhGPT — ИИ-помощник для бухгалтеров Казахстана: https://buhgpt.kz_