--- title: "Documents.ЭСФПрисоединенныеФайлы — техническое описание" country: KZ lang: ru author: Сапа Т.И. (https://buhgpt.kz/authors/sapa-ti) date: 2026-09-04 canonical: https://buhgpt.kz/suraqtar/documents-esfprisoedinennyefayly-tehnicheskoe-opisanie source: BuhGPT --- # Documents.ЭСФПрисоединенныеФайлы — техническое описание > **TL;DR:** 1. Идентификация Параметр Значение Тип объекта Документ ( Документ.ЭСФПрисоединенныеФайлы ) Имя ЭСФПрисоединенныеФайлы Синоним «Присоединенные файлы (Электронный счет-фактура)» Конфигурация Бухгалтерия для Казахстана, ред. 3.0 (3.0.74.2) Подсистема Работа с файлами / Присоедин --- 1. Идентификация Параметр Значение Тип объекта Документ (Документ.ЭСФПрисоединенныеФайлы) Имя ЭСФПрисоединенныеФайлы Синоним «Присоединенные файлы (Электронный счет-фактура)» Конфигурация Бухгалтерия для Казахстана, ред. 3.0 (3.0.74.2) Подсистема Работа с файлами / Присоединённые файлы (БСП) Навигация e1cib/list/Документ.ЭСФПрисоединенныеФайлы Назначение. Объект предназначен для хранения файлов, присоединённых к документам электронного счёта-фактуры (Документ.ЭСФ) в системе налогового учёта Республики Казахстан. Он обеспечивает связь между документом-владельцем «ЭСФ» и его файловыми вложениями: XML-файлами счетов-фактур для ИС ЭСФ, сканами, файлами электронной подписи (ЭП) и сопроводительными документами. Объект относится к подсистеме работы с электронными документами (ЭСФ, СНТ) и создаётся типовым механизмом «Присоединённые файлы» Библиотеки стандартных подсистем (БСП). Пользователи (бухгалтеры, ответственные за ЭДО) работают с вложениями через форму документа ЭСФ, а не напрямую с этим объектом. Объект обеспечивает версионность файлов, хранение и признак наличия ЭП, блокировку файла при редактировании и интеграцию с полнотекстовым поиском. Замечание по типу: в казахстанской редакции присоединённые файлы для ЭСФ реализованы объектом метаданных вида Документ (object_type_ru: "Документ"), хотя функционально это хранилище вложений, порождённое подсистемой БСП. Ниже структура описана по фактическому evidence. 2. Реквизиты и табличные части 2.1 Реквизиты шапки Имя Тип Обязательность Назначение Автор СправочникСсылка.Пользователи Обязательный (ShowError) Пользователь, первоначально присоединивший файл к ЭСФ. Используется для аудита и контроля доступа. ВладелецФайла ДокументСсылка.ЭСФ Необязательный Ссылка на документ ЭСФ — владелец файла. Обеспечивает иерархическую связь «документ → вложения». ДатаМодификацииУниверсальная ДатаВремя Необязательный Универсальное (UTC) время последнего изменения файла. Для синхронизации и отслеживания изменений. ДатаСоздания ДатаВремя Обязательный (ShowError) Момент первоначального присоединения файла. Критично для хронологии работы с ЭСФ. Зашифрован Булево Необязательный Признак шифрования файла (сценарии конфиденциального документооборота). Изменил СправочникСсылка.Пользователи Необязательный Пользователь, последним изменивший файл. Для аудита. ИндексКартинки Число Необязательный Индекс иконки файла в коллекции изображений интерфейса (зависит от расширения). Описание Строка Необязательный Текстовое описание/имя файла для удобной идентификации. ПодписанЭП Булево Необязательный Признак наличия электронной подписи. Критичен для юридической значимости ЭСФ в учёте РК. ПутьКФайлу Строка Необязательный Путь к файлу на томе хранения (при внешнем хранении на томах). Размер Число Необязательный Размер файла в байтах. Для контроля объёма и оптимизации загрузки. Расширение Строка Необязательный Расширение файла («xml», «pdf» и т.д.). Определяет способ обработки и отображения. Редактирует СправочникСсылка.Пользователи Необязательный Пользователь, взявший файл на редактирование (блокировка), предотвращает конфликты. СтатусИзвлеченияТекста ПеречислениеСсылка.СтатусыИзвлеченияТекстаФайлов Необязательный Статус извлечения текста для полнотекстового поиска (не извлечён / извлечён / ошибка). ТекстХранилище ХранилищеЗначения Необязательный Хранилище извлечённого текста для полнотекстового поиска по содержимому. Помимо перечисленных, для этого вида объектов БСП типично наличие служебных реквизитов: ВерсияХранилище/ссылки на данные версий файла, ТомХранения и ФайлХранилище (двоичные данные при хранении в ИБ). Состав хранилища данных зависит от выбранного способа хранения (в базе или на томах). 2.2 Табличные части Табличные части у объекта отсутствуют — это плоское хранилище одного файла-вложения (одна запись = один файл, привязанный к одной ЭСФ). Множественность вложений реализуется несколькими записями с одним ВладелецФайла. 3. Формы Формы порождаются подсистемой «Присоединённые файлы» БСП. Типовой состав: Форма Назначение Форма элемента (ФормаОбъекта) Просмотр/редактирование карточки вложения: описание, автор, дата, признаки ЭП и шифрования, действия «Открыть», «Сохранить как», «Редактировать»/«Закончить редактирование». Форма списка (ФормаСписка) Перечень присоединённых файлов; доступна по ссылке e1cib/list/Документ.ЭСФПрисоединенныеФайлы. Используется преимущественно для администрирования/диагностики. Форма выбора (при наличии) Выбор существующего вложения в служебных сценариях. На практике работа ведётся через встроенную таблицу «Присоединённые файлы» на форме документа ЭСФ (команды «Добавить», «Просмотреть», «Подписать ЭП», «Сохранить»), а собственные формы объекта открываются редко. 4. Ключевые процедуры модулей Отдельного прикладного BSL-кода в evidence не приложено — поведение объекта определяется общими механизмами подсистемы «Присоединённые файлы» БСП. Типовые обработчики для этого вида объекта: - Модуль объекта → ОбработкаЗаполнения — заполнение Автор, ДатаСоздания, ДатаМодификацииУниверсальная при создании вложения. - Модуль объекта → ПередЗаписью / ПриЗаписи — фиксация Изменил, актуализация ДатаМодификацииУниверсальная, обновление Размер/Расширение, сброс статуса извлечения текста при изменении содержимого. - Модуль объекта → ОбработкаПроверкиЗаполнения — контроль обязательных реквизитов Автор и ДатаСоздания (режим ShowError). - Общие модули БСП — РаботаСФайлами, РаботаСФайламиСлужебный, РаботаСФайламиВызовСервера: добавление файла, чтение/запись двоичных данных, извлечение текста для полнотекстового поиска (заполнение ТекстХранилище, СтатусИзвлеченияТекста), управление блокировкой (Редактирует), работой с ЭП (ПодписанЭП, Зашифрован) и хранением на томах (ПутьКФайлу, ТомХранения). Версионно-специфично: точные имена процедур и разбивка по общим модулям зависят от версии БСП, встроенной в 3.0.74.2 — при доработке уточните по конфигуратору. 5. Проведение и движения Объект не является проводимым документом в бухгалтерском смысле: у него нет движений по регистрам бухгалтерии и накопления и он не формирует проводок. Это хранилище файлов-вложений — реквизит «Проведение» и механизм формирования движений для него не используются. Бухгалтерские движения формирует документ-владелец ЭСФ и связанные с ним первичные документы реализации/поступления, а присоединённые файлы лишь хранят их электронные образы (XML, ЭП). Для ориентира — стандартная логика проводок по документам, к которым относится ЭСФ (числа и счета по РК на 2026 год): - Реализация товаров (типовой план счетов РК): - Дт 1210 Кт 6010 — выручка от реализации; - Дт 1210 Кт 3130 — НДС по ставке 16 % (например, при базе 1 000 000 ₸ сумма НДС = 160 000 ₸); - Дт 7010 Кт 1330 — списание себестоимости реализованных товаров. - Поступление товаров: - Дт 1330 Кт 3310 — оприходование товаров; - Дт 1420/1330 Кт 3310 — НДС, относимый в зачёт (16 %). - Оплата: Дт 1030 Кт 1210 (от покупателя), Дт 3310 Кт 1030 (поставщику). Эти проводки принадлежат документам ЭСФ/реализации/поступления, а не объекту ЭСФПрисоединенныеФайлы. 6. Связанные объекты и ввод на основании - Документ-владелец: Документ.ЭСФ — через реквизит ВладелецФайла. Один документ ЭСФ может иметь несколько присоединённых файлов. - Смежные объекты ЭДО: Документ.СНТ (сопроводительные накладные на товары) и прочие электронные документы имеют собственные объекты присоединённых файлов по той же схеме БСП. - Справочник.Пользователи — реквизиты Автор, Изменил, Редактирует. - Перечисление.СтатусыИзвлеченияТекстаФайлов — реквизит СтатусИзвлеченияТекста. - Хранение данных: двоичные данные и версии — в ИБ (ХранилищеЗначения) или на томах хранения файлов (реквизиты ПутьКФайлу, том). - Ввод на основании: ручной ввод на основании не предусмотрен и не имеет смысла — записи создаются автоматически при присоединении файла к ЭСФ через механизм БСП. 7. Точки расширения - Расширение конфигурации (Extension): добавление реквизитов (например, тип вложения, категория документа, срок хранения) и заимствование форм для доработки карточки вложения. - Подписки на события: ПередЗаписью/ПриЗаписи объекта — для дополнительного аудита, автонумерации версий, интеграции с внешним архивом. - Общие модули БСП «Работа с файлами»: переопределяемые процедуры (РаботаСФайламиПереопределяемый, РаботаСФайламиСлужебныйКлиентСервер) — управление способом хранения, ограничением расширений/размеров, обработкой ЭП. - Правила обмена/интеграция: выгрузка вложений в ИС ЭСФ и внешние архивы; контроль признака ПодписанЭП перед отправкой. - Полнотекстовый поиск: настройка извлечения текста через СтатусИзвлеченияТекста/ТекстХранилище для поиска по содержимому XML/PDF вложений ЭСФ. - Роли и RLS: ограничение доступа к вложениям по Автор/организации документа-владельца. Версионно-специфично: перечень переопределяемых процедур БСП и наличие подписок в поставке 3.0.74.2 уточняйте в конфигураторе перед доработкой. --- _BuhGPT — ИИ-помощник для бухгалтеров Казахстана: https://buhgpt.kz_