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