1. Идентификация
| Параметр | Значение |
|---|---|
| Тип объекта | Справочник (Catalog) |
| Имя | ПлатежноеПоручениеВходящееПрисоединенныеФайлы |
| Полное имя | Справочник.ПлатежноеПоручениеВходящееПрисоединенныеФайлы |
| Синоним | Присоединённые файлы (Платёжные поручения входящие) |
| Конфигурация | Бухгалтерия для Казахстана, редакция 3.0 (версия 3.0.74.2) |
| Валюта учёта конфигурации | тенге (₸) |
| Где найти | e1cib/list/Справочник.ПлатежноеПоручениеВходящееПрисоединенныеФайлы |
Назначение. Справочник хранит файлы, присоединённые к документам Документ.ПлатежноеПоручениеВходящее (сканы платёжек, банковские подтверждения, PDF/XML-вложения, файлы электронной подписи). Это служебный объект подсистемы «Работа с файлами» (БСП). Пользователь работает с ним не напрямую, а косвенно — через команду «Присоединённые файлы» на форме документа-владельца. В командном интерфейсе разделов как самостоятельный список справочник, как правило, не выводится.
Для каждого документа-владельца, поддерживающего присоединённые файлы, платформа/БСП создаёт отдельный справочник-хранилище с именем <ИмяВладельца>ПрисоединенныеФайлы. Данный справочник — такое хранилище именно для входящих платёжных поручений. Учётных (финансовых) данных он не содержит и на регламентированный учёт РК напрямую не влияет.
2. Реквизиты шапки и табличные части
2.1 Реквизиты шапки
| Имя | Тип | Обязательность | Назначение |
|---|---|---|---|
| Автор | СправочникСсылка.Пользователи |
ShowError | Пользователь, создавший запись о присоединённом файле. Заполняется автоматически при создании. |
| ВладелецФайла | ДокументСсылка.ПлатежноеПоручениеВходящее |
DontCheck | Ссылка на документ платёжного поручения, к которому прикреплён файл. Определяет принадлежность файла. |
| ДатаМодификацииУниверсальная | Дата (ДатаВремя) | DontCheck | Дата и время последнего изменения файла в формате UTC. Используется для синхронизации и отслеживания изменений. |
| ДатаСоздания | Дата (ДатаВремя) | ShowError | Дата и время создания записи о файле. Обязательное поле для аудита. |
| Зашифрован | Булево | DontCheck | Признак того, что файл зашифрован. Используется подсистемой криптографии. |
| Изменил | СправочникСсылка.Пользователи |
DontCheck | Пользователь, последним изменивший файл или его атрибуты. |
| ИндексКартинки | Число | DontCheck | Индекс иконки файла в коллекции изображений; определяет визуальное представление типа файла в интерфейсе. |
| Описание | Строка | DontCheck | Текстовое описание/комментарий к файлу; произвольная информация от пользователя. |
| ПодписанЭП | Булево | DontCheck | Признак наличия электронной подписи у файла. Важно для юридически значимого документооборота. |
| ПутьКФайлу | Строка | DontCheck | Путь к файлу на томе хранения (при внешнем хранилище). Заполняется при ТипХраненияФайла = ВТомахНаДиске. |
| Размер | Число | DontCheck | Размер файла в байтах; контроль занимаемого места и ограничений. |
| Расширение | Строка | DontCheck | Расширение файла (pdf, jpg, xml и т. п.); определяет тип файла и программу открытия. |
| Редактирует | СправочникСсылка.Пользователи |
DontCheck | Пользователь, который в данный момент редактирует файл (механизм блокировки/захвата). |
| СтатусИзвлеченияТекста | ПеречислениеСсылка.СтатусыИзвлеченияТекстаФайлов |
DontCheck | Статус извлечения текста для полнотекстового поиска (Извлечён / НеИзвлечён / Ошибка). |
| ТекстХранилище | ХранилищеЗначения | DontCheck | Извлечённый текст файла, сохранённый для полнотекстового поиска. |
| ТипХраненияФайла | ПеречислениеСсылка.ТипыХраненияФайлов |
ShowError | Способ хранения: в базе данных или на томе. Обязательный параметр. |
| Том | СправочникСсылка.ТомаХраненияФайлов |
DontCheck | Ссылка на том хранения файлов (при внешнем хранении). |
Стандартный реквизит Наименование хранит имя файла (без расширения). Флаг ПометкаУдаления используется механизмом удаления вложений.
2.2 Табличные части
Табличных частей нет. Содержимое файла (при хранении в ИБ) хранится в связанном регистре сведений ПлатежноеПоручениеВходящееПрисоединенныеФайлыХранилищеФайлов (ресурс типа ХранилищеЗначения — двоичные данные файла и его версий). При хранении на диске тело файла лежит в томе (Том + ПутьКФайлу), а в ИБ остаются только метаданные.
3. Формы
| Форма | Назначение |
|---|---|
| ФормаЭлемента | Карточка присоединённого файла: имя, описание, размер, автор, даты, признаки «Подписан ЭП» / «Зашифрован», команды открыть/сохранить/редактировать/закончить редактирование. |
| ФормаСписка | Список файлов, присоединённых к владельцу. Обычно открывается как «Присоединённые файлы» из формы документа с отбором по ВладелецФайла. |
| ФормаВыбора | Служебная форма выбора файла (при необходимости подобрать вложение). |
Как правило, специализированные собственные формы не создаются — используются типовые формы БСП подсистемы «Работа с файлами», общие для всех справочников присоединённых файлов, что обеспечивает единообразие интерфейса.
4. Ключевые процедуры модулей
Специфического прикладного кода в модулях данного справочника обычно нет — вся логика реализована в общих модулях БСП «Работа с файлами». Ниже — типовые обработчики для объекта этого вида (evidence по BSL не приложено — приведена стандартная схема).
- МодульОбъекта →
ПередЗаписью— контроль обязательных реквизитов (Автор,ДатаСоздания,ТипХраненияФайла), запрет изменения захваченного другим пользователем файла, обновлениеДатаМодификацияУниверсальнаяиИзменил. - МодульОбъекта →
ПередУдалением— удаление тела файла из тома приТипХраненияФайла = ВТомахНаДиске(очистка «осиротевших» файлов на диске). - МодульМенеджера — программное добавление вложений:
РаботаСФайламиСлужебный.ДобавитьФайл(...),ПрисоединенныеФайлы.ДобавитьФайл(...); получение двоичных данных:ПрисоединенныеФайлы.ПолучитьДанныеФайла(...). - Общие вызовы БСП (используются формами) —
РаботаСФайлами,РаботаСФайламиКлиент,РаботаСФайламиСлужебный,РаботаСФайламиСлужебныйКлиент: открытие, сохранение, захват/освобождение (Редактирует), извлечение текста, работа с ЭП и шифрованием.
Требует проверки (версионно-специфично): точные имена общих модулей и сигнатуры методов зависят от версии БСП, встроенной в 3.0.74.2.
5. Проведение и движения
Справочник не является документом и не проводится — движений в регистрах бухгалтерии/накопления он не формирует. Проводки по плану счетов РК формирует документ-владелец ПлатежноеПоручениеВходящее, а не хранилище его файлов.
Единственные записи, связанные с элементом справочника, — служебные:
- регистр сведений
...ХранилищеФайлов— двоичные данные файла и версий (при хранении в ИБ); - данные полнотекстового индекса (
ТекстХранилище,СтатусИзвлеченияТекста).
Для контекста — типовые проводки документа-владельца «Платёжное поручение входящее» (поступление оплаты от покупателя), по типовому плану счетов РК:
| Дт | Кт | Содержание |
|---|---|---|
| 1030 «Деньги на текущих банковских счетах» | 1210 «Краткосрочная дебиторская задолженность покупателей» | Поступление оплаты от покупателя на расчётный счёт (в ₸) |
Пример: покупатель оплачивает реализацию на сумму 1 160 000 ₸, включая НДС 16% = 160 000 ₸ (ставка НДС РК 2026 года — 16%). Начисление НДС и дохода выполняется документами реализации (Дт 1210 Кт 6010 / Кт 3130), а входящее платёжное поручение лишь закрывает дебиторку: Дт 1030 Кт 1210 — 1 160 000 ₸. Электронные документы (ЭСФ через ИС ЭСФ, СНТ) оформляются на реализацию, а их файлы-вложения могут храниться в справочниках присоединённых файлов соответствующих документов.
6. Связанные объекты и ввод на основании
- Владелец:
Документ.ПлатежноеПоручениеВходящее(реквизитВладелецФайла). - Хранилище тела файла: регистр сведений
ПлатежноеПоручениеВходящееПрисоединенныеФайлыХранилищеФайлов. - Пользователи:
Справочник.Пользователи(Автор,Изменил,Редактирует). - Тома:
Справочник.ТомаХраненияФайлов. - Перечисления:
ТипыХраненияФайлов,СтатусыИзвлеченияТекстаФайлов. - Подсистемы: «Работа с файлами», «Электронные подписи» / «Криптография», «Полнотекстовый поиск» (все из состава БСП).
Ввод на основании для этого справочника не предусмотрен. Элементы создаются только через механизм присоединения файлов к документу-владельцу (перетаскивание, «Добавить → из файла / со сканера», из почты) либо программно методами БСП.
7. Точки расширения
- Расширения конфигурации: добавление собственных реквизитов (например, признак «Проверено», ссылка на ответственного), доп. команд на форме, переопределение обработчиков
ПередЗаписью/ПередУдалением. - Дополнительные реквизиты и сведения (подсистема «Свойства») — если для объекта включён состав наборов свойств.
- Программное API БСП —
РаботаСФайлами/ПрисоединенныеФайлыдля загрузки, выгрузки, подписания и шифрования вложений из своего кода. - Подписки на события по типу
СправочникСсылка.ПлатежноеПоручениеВходящееПрисоединенныеФайлы— контроль/аудит операций с файлами. - Настройка хранения — перевод между «В информационной базе» и «В томах на диске» через параметры подсистемы «Работа с файлами» (влияет на
ТипХраненияФайла,Том,ПутьКФайлу).
При доработках не изменяйте состав стандартных реквизитов файла напрямую — используйте расширения, чтобы сохранить совместимость с обновлениями БСП и типовой конфигурации.