RUKKENZH
Ask AI
Sections1C configuration objects
Reference «PurchaseOfReturnablePackagingByCustomerAttachedFiles»" reference is redundant — let me give a clean translation:

"ВыкупВозвратнойТарыКлиентомПрисоединенныеФайлы" Catalog (Trade Management
Article language:🇷🇺 RU🇰🇿 KK🇬🇧 EN🇨🇳 ZH
Article version:📘 For accountants⚙️ For technical specialists

Reference «PurchaseOfReturnablePackagingByCustomerAttachedFiles»" reference is redundant — let me give a clean translation: "ВыкупВозвратнойТарыКлиентомПрисоединенныеФайлы" Catalog (Trade Management

Applies to: 1С:Управление торговлей для Казахстана, release 3.4.5.21 (9 July 2026) · by 1C-Sapa Group, 1C partner
СТ
Сапа Т.И. — 1C and accounting expert, practising trainer
Prepared by the BuhGPT editorial team

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%.


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.

Frequently asked questions

Does this catalog generate postings or register movements?
No. This is a service catalog for storing attached files of the "Working with Files" BSP subsystem. All postings and movements (income 6010, VAT 3130 at a 16% rate, cost of sales 7010, AR 1210, etc.) are generated by the owner document "Client's Repurchase of Returnable Packaging," not by the file catalog.
How does a user add a file to this catalog?
Through the form of the "Client's Repurchase of Returnable Packaging" document → the "Attached Files" command → "Add" (from disk, from a scanner, or from the clipboard). Direct creation of an item from the catalog list is not intended.
Where are the files themselves physically stored?
It depends on the settings in "Administration → File Handling Settings": either in the information base (the FileStorage attribute of the ValueStorage type), or in volumes on disk (the Volume and PathToFile attributes, the FileStorageVolumes catalog).
Why is the VAT rate 16% in the example, and not 12%?
Since 2026, a VAT rate of 16% has been in effect in the Republic of Kazakhstan. The 12% value is an outdated rate from earlier periods and is not applied in current calculations for Trade Management for Kazakhstan 2026.
Can the catalog be extended without removing the configuration from support?
Yes. Through a configuration extension, attributes, form elements, and event subscriptions can be added; storage, versioning, and restrictions are configured in the standard way through the overridable BSP modules and file handling settings.

Read also

Latest answers

Sources

Was this article helpful?
💼 Need help with 1C or accounting? Слава КВЦ — many years of 1C practice in Kazakhstan. Explore the annotated Tax Code of RK 2026 or ask in the BuhGPT chat — answers in seconds.