RUKKENZH
Задать вопрос AI

Documents.ЭСФПрисоединенныеФайлы — техническое описание

СТ
Сапа Т.И. — Эксперт по 1С и бухгалтерскому учёту, преподаватель-практик
Обновлено 4 сент. 2026 г.

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 уточняйте в конфигураторе перед доработкой.

Частые вопросы

Формирует ли объект ЭСФПрисоединенныеФайлы бухгалтерские проводки?
Нет. Это хранилище файлов-вложений подсистемы «Присоединённые файлы» БСП — оно не проводится и не создаёт движений по регистрам. Проводки формирует документ-владелец ЭСФ и связанные документы реализации/поступления (например, Дт 1210 Кт 6010 на выручку и Дт 1210 Кт 3130 на НДС по ставке 16 %).
Как связаны присоединённый файл и документ ЭСФ?
Через реквизит ВладелецФайла (тип ДокументСсылка.ЭСФ). Один документ ЭСФ может иметь несколько записей присоединённых файлов; работа с ними ведётся через встроенную таблицу на форме документа ЭСФ, а не напрямую со списком объекта.
Где хранятся сами данные файла?
В зависимости от настроек — в информационной базе (ХранилищеЗначения) или на внешних томах хранения (реквизиты ПутьКФайлу и том хранения). Размер и расширение фиксируются в реквизитах Размер и Расширение, а извлечённый текст — в ТекстХранилище для полнотекстового поиска.
Зачем нужен реквизит ПодписанЭП?
Он фиксирует наличие электронной подписи на файле, что критично для юридической значимости ЭСФ в казахстанском учёте. Признак используется при контроле перед отправкой в ИС ЭСФ и в сценариях документооборота.

Источники

Была ли статья полезна?
💼 Нужна помощь с 1С или учётом? Слава КВЦ — многолетняя практика в 1С в Казахстане. Изучите разложенный НК РК 2026 или спросите в чате BuhGPT — ответит за секунды.