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