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/квитанций ЭСФ в момент получения ответа от ИС ЭСФ.
- Правила обмена/выгрузки — включение вложений ЭСФ в обмен между базами при необходимости.