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