1. Идентификация
| Параметр | Значение |
|---|---|
| Тип объекта | Справочник (Catalog) |
| Имя | СчетФактураПолученныйНалоговыйАгентПрисоединенныеФайлы |
| Полное имя | Справочник.СчетФактураПолученныйНалоговыйАгентПрисоединенныеФайлы |
| Синоним | «Присоединённые файлы (Счёт-фактура полученный налоговый агент)» |
| Конфигурация | Управление торговлей для Казахстана, ред. 3.4 (сборка 3.4.5.21) |
| Подчинён (владелец) | Документ СчетФактураПолученныйНалоговыйАгент |
| Подсистема | «Работа с файлами» / «Присоединённые файлы» (БСП) |
| Где найти | e1cib/list/Справочник.СчетФактураПолученныйНалоговыйАгентПрисоединенныеФайлы |
Назначение. Служебный справочник хранения файлов, присоединённых к конкретному документу «Счёт-фактура полученный (налоговый агент)». Это один из семейства однотипных справочников «…ПрисоединенныеФайлы», автоматически формируемых механизмом БСП «Работа с файлами» для объектов-владельцев, к которым разрешено прикреплять файлы (сканы бумажного счёта-фактуры, PDF-квитанции ИС ЭСФ, подтверждения по НДС налогового агента и т. п.).
Справочник не отражается в интерфейсе как самостоятельный раздел и не предназначен для ручного создания элементов пользователем напрямую. Работа с ним идёт через команду «Присоединённые файлы» в форме документа-владельца и через общие формы подсистемы. Прямой список (e1cib/list/...) используется преимущественно администратором и разработчиком для диагностики.
Специфика РК/2026 (ставка НДС 16 %, МРП 4 325 ₸, ЭСФ/ИС ЭСФ) относится к документу-владельцу и его расчётам; сам справочник присоединённых файлов налоговых данных не хранит и в расчётах не участвует.
2. Реквизиты и табличные части
Структура типовая для присоединённых файлов БСП. Основные реквизиты шапки:
| Реквизит | Тип | Назначение |
|---|---|---|
Владелец |
ДокументСсылка.СчетФактураПолученныйНалоговыйАгент |
Документ, к которому присоединён файл. Задаётся автоматически при добавлении. |
Наименование |
Строка | Имя файла без расширения (описание). |
Расширение |
Строка | Расширение файла без точки (pdf, xml, png…). |
ХранилищеФайла |
ХранилищеЗначения | Тело файла при хранении в информационной базе. Пусто, если файл в томах на диске. |
Том |
СправочникСсылка.ТомаХраненияФайлов |
Том хранения при размещении файла на диске. |
ПутьКФайлуВоТоме / ПутьКФайлу |
Строка | Относительный путь к файлу внутри тома. |
ОбъемФайла |
Число | Размер файла в байтах. |
ДатаСоздания |
Дата | Дата создания файла. |
ДатаМодификацииУниверсальная |
Дата | Дата последнего изменения (UTC). |
Автор |
СправочникСсылка.Пользователи |
Пользователь, добавивший файл. |
ИзменилПользователь |
СправочникСсылка.Пользователи |
Кто вносил последнее изменение. |
РедактируетсяПользователем (BeingEditedBy) |
СправочникСсылка.Пользователи |
Признак/владелец блокировки на время редактирования (захват файла). |
ПодписанЭП |
Булево | Файл содержит электронную подпись. |
Зашифрован |
Булево | Файл зашифрован сертификатами. |
ТекстХранилище / ИзвлеченныйТекст |
ХранилищеЗначения/Строка | Извлечённый текст для полнотекстового поиска. |
СтатусИзвлеченияТекста |
Перечисление | Не извлекался / Извлечён / Ошибка. |
Табличные части (стандартные для БСП):
| Таб. часть | Ключевые поля | Назначение |
|---|---|---|
ЭлектронныеПодписи (ЭлектронныеПодписиФайлов) |
Подпись, Штамп, ДатаПодписи, Сертификат, КемВыдан, КомуВыдан, ДействителенДо | Хранение присоединённых электронных подписей файла. |
ШифрованиеСертификаты |
Отпечаток, Представление, Сертификат | Сертификаты, которыми файл зашифрован. |
Точный состав служебных реквизитов (
РазмерРисункаЭскиза,Подписан, признаки томов и т. д.) версионно-зависим — при точечной доработке сверяйтесь с конфигуратором сборки 3.4.5.21.
3. Формы
| Форма | Назначение |
|---|---|
ФормаЭлемента (карточка файла) |
Просмотр/редактирование свойств одного файла: наименование, расширение, автор, даты, размер, подписи, шифрование. Обычно открывается общей формой БСП. |
ФормаСписка |
Служебный список всех файлов, присоединённых к документам-владельцам данного вида. Для администрирования/диагностики. |
На практике интерфейс работы с файлами реализуют общие формы подсистемы «Работа с файлами», а не собственные формы справочника:
ОбщаяФорма.ПрисоединенныеФайлы— список файлов конкретного владельца (вызывается командой «Присоединённые файлы» из документа);ОбщаяФорма.ПросмотрФайла, формы подписания/шифрования, формы выбора тома.
Собственные формы у справочника часто отсутствуют или минимальны — управление ведётся централизованно через БСП.
4. Ключевые процедуры модулей
В приложенном evidence присутствует только фасет «назначение»; исходный код (путь:строка) не приложен. Поэтому ниже — типовые обработчики и API этого вида объекта в БСП «Работа с файлами». Логика справочника не переопределяется прикладно, а делегируется общим модулям.
Модуль объекта / модуль менеджера справочника:
ПередЗаписью— служебная проверка блокировки редактирования (РедактируетсяПользователем), актуализацияДатаМодификацииУниверсальная,ИзменилПользователь.ПередУдалением— при хранении в томах инициирует удаление физического файла с диска (черезРаботаСФайламиСлужебный).
Общие модули, обслуживающие справочник:
РаботаСФайлами— клиентское/серверное API: добавление файла к владельцу, открытие, сохранение копии, захват/освобождение, обновление из файла на диске.РаботаСФайламиСлужебный/…СлужебныйВызовСервера— создание элемента справочника, запись тела вХранилищеФайлалибо в том, извлечение текста, подсчётОбъемФайла.УправлениеФайламиИнформационнойБазы/РаботаСФайламиВТомах— маршрутизация «в базе / в томе» согласно настройкам.ЭлектронныеПодписиКлиент/Сервер— подписание и проверка ЭП, заполнение таб. частиЭлектронныеПодписи.
Типовые функции менеджера: ПрисоединитьФайл, ФайлЗаписан (событие для подсистем), функции получения ссылки/двоичных данных файла.
5. Проведение и движения
Справочник проведения не выполняет и движений в регистрах не формирует — это объект метаданных типа «Справочник», а не документ. Никаких проводок по плану счетов РК он не создаёт.
Учётные последствия возникают у документа-владельца СчетФактураПолученныйНалоговыйАгент. Для контекста — типовая схема РК (ставка НДС 16 %, план счетов РК):
- начисление НДС налогового агента (обязательство перед бюджетом) — по счёту 3130 «НДС к уплате»;
- отражение приобретения/расчётов с поставщиком — 3310 «Краткосрочная КЗ поставщикам», оплата — 1030 «Деньги на текущих счетах»;
- при связи с реализацией/себестоимостью в цепочке применяются 6010, 7010, 1330, 1210.
Электронное сопровождение — ЭСФ (ИС ЭСФ) и СНТ; присоединённый файл здесь выступает лишь вложением (скан/квитанция/xml), не влияя на суммы.
Пример суммы для контекста: услуга 1 000 000 ₸, НДС налогового агента 16 % = 160 000 ₸ (не 12 %). Эта сумма — область документа-владельца, не справочника файлов.
6. Связанные объекты и ввод на основании
- Владелец: документ
СчетФактураПолученныйНалоговыйАгент— единственный источник элементов справочника. Файлы добавляются командой «Присоединённые файлы» из формы этого документа. - Общая подсистема: «Работа с файлами» БСП —
ТомаХраненияФайлов,НастройкиХраненияФайлов, регистры сведений подсистемы (версии, настройки). - Электронные подписи и шифрование: подсистема «Электронная подпись» БСП (сертификаты, программы).
- Полнотекстовый поиск: извлечённый текст файлов индексируется общим механизмом ППД.
Ввод на основании для служебного справочника присоединённых файлов не предусмотрен (в командах ввода на основании не участвует).
7. Точки расширения
- Расширение конфигурации: добавление реквизитов/подписок на события
ПередЗаписью/ПередУдалениемобъекта справочника; переопределение форм БСП через собственные — не рекомендуется. - Подписки на события: обработка
ФайлЗаписан/ событий подсистемы «Работа с файлами» для автозадач (например, автозагрузка вложения в архив, уведомление). - Программное API: использовать
РаботаСФайлами.ДобавитьФайл(...),…ЗахватитьФайл/ОсвободитьФайл, функции получения двоичных данных — вместо прямой записи справочника. - Настройки хранения: переключение «в ИБ ↔ в томах» через регистр настроек хранения файлов (без изменения кода).
- Электронная подпись/шифрование: расширение сценариев подписания через API подсистемы «Электронная подпись».
Прямое создание/изменение элементов справочника в обход БСП не поддерживается: нарушается учёт блокировок, версий и размещения в томах.