---
title: "Reference «PurchaseOfReturnablePackagingByCustomerAttachedFiles»\" reference is redundant — let me give a clean translation:\n\n\"ВыкупВозвратнойТарыКлиентомПрисоединенныеФайлы\" Catalog (Trade Management "
country: KZ
lang: en
author: Сапа Т.И. (https://buhgpt.kz/authors/sapa-ti)
date: 2026-09-23
canonical: https://buhgpt.kz/suraqtar/spravochnik-vykupvozvratnoytaryklientomprisoedinennyefayl-en
source: BuhGPT
---

# Reference «PurchaseOfReturnablePackagingByCustomerAttachedFiles»" reference is redundant — let me give a clean translation:

"ВыкупВозвратнойТарыКлиентомПрисоединенныеФайлы" Catalog (Trade Management 

> **TL;DR:** 1. Object Identification Parameter Value Object type Catalog Name ВыкупВозвратнойТарыКлиентомПрисоединенныеФайлы Full name Catalog.ВыкупВозвратнойТарыКлиентомПрисоединенныеФайлы Synonym "Attached Files (Client Buyback of Returnable Packaging)" Configuration Trade Management fo

---

1. Object Identification

Parameter
Value

Object type
Catalog

Name
ВыкупВозвратнойТарыКлиентомПрисоединенныеФайлы

Full name
Catalog.ВыкупВозвратнойТарыКлиентомПрисоединенныеФайлы

Synonym
"Attached Files (Client Buyback of Returnable Packaging)"

Configuration
Trade Management for Kazakhstan, edition 3.4 (version 3.4.5.21)

Owner
Document.ВыкупВозвратнойТарыКлиентом

Hierarchy
None (simple linear list)

Where to find
e1cib/list/Catalog.ВыкупВозвратнойТарыКлиентомПрисоединенныеФайлы

Purpose. A service catalog implementing the "Attached Files" subsystem (SSL, StandardSubsystems.AttachedFiles) for the "Client Buyback of Returnable Packaging" document. Each catalog item is a card for one file (a scanned act, contract, photo of packaging, PDF of a primary document, an ESF/SNT as an attachment, etc.) attached to a specific owner document. The user works with it not directly, but through the "Attached Files" command in the document form. The catalog stores file metadata and (depending on settings) the binary data of the file itself or a reference to the storage volume.

This is a typical "satellite" object of the file-handling subsystem. It does not participate in goods/monetary or tax accounting, does not generate postings, and does not affect the calculation of VAT (16% in Kazakhstan since 2026), individual income tax, mandatory pension contributions, etc. The corresponding numeric norms are given in section 5 for the context of the owner document's accounting, but apply to this catalog only indirectly (through the primary documents stored in the files).

2. Header Attributes and Tabular Sections

The object contains no tabular sections. Below is the standard set of attributes of the SSL attached files catalog.

Standard (system) attributes

Attribute
Type
Purpose

Ref
CatalogRef
Unique identifier of the file card

Code
String/Number
Internal item code (usually not shown to the user)

Description
String (150)
File name without extension — shown to the user

Owner
DocumentRef.ВыкупВозвратнойТарыКлиентом
The document to which the file is attached

DeletionMark
Boolean
Marked-for-deletion flag

Predefined
Boolean
Not used (no predefined items)

Attributes of the "Attached Files" subsystem

Attribute
Type
Purpose

FileStorage
ValueStorage
Binary file data when stored in the infobase (empty when stored in volumes)

PathToFile
String
Relative path to the file in the volume (when stored on disk/in volumes)

Volume
CatalogRef.FileStorageVolumes
Storage volume, if the file is stored outside the infobase

Extension
String
File extension (pdf, jpg, xml, docx, etc.)

Size
Number
File size in bytes

FileDescription
String
Free-form text description/comment about the file

CreationDate
Date
File creation date (from the source file's attributes)

ModificationDate
Date
File modification date

UniversalModificationDate
Date
Date the card was last modified (UTC), for synchronization

EditProhibition
Boolean
"Read only" flag

BeingEditedBy
CatalogRef.Users
User who has checked out the file for editing (lock)

SignedWithES
Boolean
File is signed with an electronic signature

Encrypted
Boolean
File is encrypted

TextExtraction / TextStorage
ValueStorage
Extracted file text for full-text search

TextExtractionStatus
String/Enumeration
Text indexing state (Not extracted / Extracted / Error / Extraction unavailable)

AutomaticCleanup
Boolean
Participation in scheduled cleanup of outdated versions

Version tabular section (if the versioning mechanism is enabled)

Storage of file versions is usually implemented via a separate subordinate catalog ...AttachedFilesFileVersions or a tabular section with fields: VersionNumber, FileStorage/PathToFile, Size, Author, CreationDate, Comment. In the base delivery, versioning for document attached files is usually disabled.

3. Forms

Form
Purpose

ItemForm (ObjectForm)
File card: name, description, size, author, dates, "Open," "Save as…," "Edit"/"Finish editing," "Sign with ES," "Encrypt" buttons. Main interface for working with a single file

ListForm
Full list of attached files (opened via a navigation link). Generally a service form — a regular user does not typically open the whole list

Selection form
Select a file from those already attached (used by related mechanisms)

The user's main working environment is not the catalog's own forms, but the common subsystem form CommonForm.AttachedFiles (or the managed attached-files form), invoked via the "Attached Files" command from the ВыкупВозвратнойТарыКлиентом document form. It displays the list of files for the given document and provides commands to add (from disk, from scanner, from clipboard), open, delete, and print the list.

4. Key Module Procedures

The attached evidence contains only the naznachenie (purpose) facet; the BSL sources and exact path:line addresses were not provided. Below is a typical set of handlers for the SSL attached-files catalog. The specific procedure names are version-stable within the SSL supplied with Trade Management for Kazakhstan 3.4.

Object module (ObjectModule)

- BeforeWrite(Cancel) — records the universal modification date, checks whether the file is checked out for editing, updates signature/encryption flags.

- BeforeDelete(Cancel) — when stored in volumes, initiates deletion of the physical file from the volume (via FileOperationsInternal), cleans up versions.

- OnCopy(CopiedObject) — resets service fields (locks, ES) on the copy.

Manager / common subsystem modules

The logic resides in SSL common modules; the catalog only provides attributes for storage:

- FileOperations / FileOperationsClient — adding a file, opening, saving, editing in an external program.

- FileOperationsInternal / ...ServerCall — writing binary data to the infobase or volume, reading, moving between volumes, obtaining a file reference.

- FileFunctions / FileOperationsInternalClientServer — calculating size, generating the path in the volume, determining extension and MIME type.

- TextExtractionServer — extracting text for full-text search (populating TextExtraction, TextExtractionStatus).

- The OnDefiningFileOperationsSettings handler (in the owner document's module or an overridable module) — registers the catalog as the file storage for the ВыкупВозвратнойТарыКлиентом document.

Forms

- ItemForm.OnCreateAtServer / OnOpen — populates card attributes, configures command availability based on the EditProhibition, SignedWithES, Encrypted flags.

5. Posting and Movements

The catalog is not posted and generates no register movements — it is a file storage object, not an accounting document.

Business postings and movements are generated by the owner document, "Client Buyback of Returnable Packaging". For context, below is a typical accounting model for this operation under the Kazakhstan chart of accounts and 2026 Kazakhstan tax rules.

Owner document registers (typical set)

- AccumulationRegister.RevenueAndCostOfSales

- AccumulationRegister.GoodsInWarehouses / AvailableBalances

- AccumulationRegister.SettlementsWithClients (or SettlementsWithPartners)

- AccumulationRegister.VATAccrued

- Registers for generating ESF (ESF IS) and SNT electronic documents.

Typical postings under the Kazakhstan chart of accounts

Operation
Debit
Credit

Recognized income from sale of packaging to client
1210 (short-term receivables from buyers)
6010 (sales revenue)

VAT 16% accrued payable
1210
3130 (VAT payable)

Cost of packaging written off
7010 (cost of sales)
1330 (inventory)

Payment received from client
1030 (cash on current accounts)
1210

Example. Packaging is sold for 100,000 ₸ excluding VAT. VAT 16% = 16,000 ₸. Total payable: 116,000 ₸.

- Dr 1210 Cr 6010 — 100,000 ₸;

- Dr 1210 Cr 3130 — 16,000 ₸;

- Dr 7010 Cr 1330 — cost (at book value);

- Dr 1030 Cr 1210 — 116,000 ₸ upon receipt of payment.

An ESF is issued for the operation, and an SNT is drawn up if necessary.

Reference Kazakhstan tax constants for 2026 (used in the company's accounting, not directly related to files): MCI = 4,325 ₸, minimum wage = 85,000 ₸; individual income tax 10% up to 8,500 MCI of annual income and 15% above; basic individual income tax deduction — 30 MCI/month (no more than 360 MCI/year); mandatory pension contributions 10% (base cap of 50 minimum wages), employer pension contributions 3.5%, mandatory employer social health insurance 2%, mandatory social health insurance 3%, social contributions 5%, social tax 6%.

6. Related Objects and Entering Based On

Relationship
Object
Nature of the relationship

Owner
Document.ВыкупВозвратнойТарыКлиентом
Parent; when the document is marked for deletion, the presence of attached files is checked

Subsystem
StandardSubsystems.FileOperations (SSL)
All file storage/handling functionality

Storage volumes
Catalog.FileStorageVolumes
Physical location of files when stored outside the infobase

Electronic signatures
DigitalSignature subsystem
Signing/encrypting files

Users
Catalog.Users
File author, editing user (lock)

File versions
...AttachedFilesFileVersions (when versioning is enabled)
Storage of version history

Entering based on. Not applicable. Catalog items are created exclusively through the mechanism of attaching a file to the owner document (the "Attached Files" → "Add" button). Manually creating an item via the list is impractical and usually not available interactively.

7. Extension Points

- File storage. Configured in the "Administration → File operations settings" section: storage in the infobase or in volumes (FileStorageVolumes), maximum size limit, list of prohibited extensions.

- Configuration extension (without removal from support). Adding attributes to the catalog and columns/commands to the common attached-files form; subscribing to BeforeWrite/BeforeDelete events.

- Overridable SSL modules. FileOperationsOverridable, FileOperationsInternalOverridable — registering storage settings, restrictions, additional processing when adding/deleting.

- Versioning. Enabling file version storage and retention depth.

- Full-text search. Indexing TextExtraction for searching attachment content.

- Scheduled jobs. "Cleanup of outdated file versions," "File text extraction," "Moving files to volumes."

- ES and encryption. Connecting signing and encryption of attachments via the digital signature subsystem (relevant for ESF/SNT stored as files).

Requires verification in the specific version 3.4.5.21: the presence/composition of the subordinate file-versions catalog and the exact set of text-indexing attributes — depend on the SSL version built into this assembly. The rest of the attribute composition and logic for attached-files catalogs are stable.

---
_BuhGPT — ИИ-помощник для бухгалтеров Казахстана: https://buhgpt.kz_