1. Identification
| Parameter | Value |
|---|---|
| Object Type | Catalog |
| Full Name | Catalog.UsersESF / Catalogs.UsersESF |
| Synonym | Users of the Electronic Invoice Information System (ESF) |
| Configuration | Accounting for Kazakhstan, edition 3.0, version 3.0.74.2 |
| Navigation Link | e1cib/list/Catalog.UsersESF |
| Main Representation | Name (code — automatic numbering) |
| Hierarchy | No (simple catalog) |
| Owner | No (independent catalog) |
Purpose. The catalog stores records of users of the electronic invoice information system (ESF) of the Republic of Kazakhstan. Each element contains authentication details in the state system: username, password, and electronic certificate (digital signature). The catalog is used by accountants and administrators during the initial setup of electronic document management, when changing certificates (usually every 1–2 years due to the validity of the digital signature), and when registering new authorized employees for exchanging ESF and VAT invoices with the ESF and counterparties.
Where to find in 1C: section “Sales” → “Users of the ESF”, or through the electronic document management settings (sections VAT / electronic invoices). Direct access — via the navigation link e1cib/list/Catalog.UsersESF.
2. Attributes and Table Parts
2.1 Header Attributes (Element)
| Name | Type | Mandatory | Purpose |
|---|---|---|---|
| AuthenticationName | String | Mandatory (ShowError) | User login for accessing the ESF portal (usually IIN or registration number). Used for each connection to the state system for data exchange. |
| AuthenticationPassword | String | Not mandatory (DontCheck) | Password for authentication in the ESF. Stored in the database (encryption recommended). Not mandatory, as authentication can be done solely by certificate. |
| AuthenticationCertificate | ValueStorage | Mandatory (ShowError) | Binary data of the digital signature certificate used for signing and sending electronic invoices. Loaded from a .p12/.pfx file or from the OS certificate store. |
| CertificateDescription | String | Mandatory (ShowError) | Text representation of the certificate (owner, validity period, issuer) for convenient identification in the interface. Automatically generated when the certificate is loaded. |
Note on numbering. The catalog uses standard automatic numbering of elements (code); user-defined numbering periods, specific lengths, or types of numbers are not set — this is a simple (non-hierarchical) catalog.
2.2 Table Parts
The catalog does not contain table parts. All data is stored at the level of the element's attributes.
3. Forms
| Form Name | Purpose | Key |
|---|---|---|
| ElementForm | Main form for editing the element: entering name and password, loading/saving certificate, checking connection to the ESF, managing active sessions. | ✓ |
| NewAssistant | Step-by-step wizard for creating a new ESF user. Multi-page form (5 pages): selecting a certificate, filling in attributes, linking to the information base user, selecting structural units (branches/organizations). | ✓ |
| ListForm | List of ESF users with the ability to create a new element through the wizard. | auxiliary. |
The main scenario for initial filling goes through NewAssistant (wizard), subsequent editing — through ElementForm.
4. Key Module Procedures
Evidence with specific paths
path:stringfor procedures is not attached. Below are typical handlers for this type of object and its forms in the configuration “Accounting for Kazakhstan” 3.0; their presence and exact implementation depend on the version.
Object Module (FillingHandler, ValidationHandler):
ValidationHandler(Refusal, CheckedAttributes)— controls the filling of mandatory attributesAuthenticationName,AuthenticationCertificate,CertificateDescription(ShowError flags).BeforeSaving(Refusal)— usually synchronizesCertificateDescriptionwith the actually loaded certificate and may validate the correctness of the binary data of the digital signature.
ElementForm (form module):
OnCreateOnServer— initialization of fields, recovery of the certificate description fromValueStorage.- Command “Load Certificate” — reading the
.p12/.pfxfile (or selecting from the OS store), placing binary data inAuthenticationCertificate, automatic generation ofCertificateDescription. - Command “Check Connection” — test call to the ESF web service with current authentication attributes; output result to the user.
- Managing active sessions (opening/closing the exchange session with the ESF).
NewAssistant (form module):
- Step-by-step navigation through 5 pages (
Next/Back) with validation of each page. - Selecting a certificate → filling in attributes → linking to the information base user → selecting structural units (branches/organizations) → recording the created catalog element.
5. Posting and Movements
The catalog is a non-posting object: catalog elements do not generate accounting entries and movements in registers. The recorded data (authentication attributes, certificate) is stored in the catalog table without generating movements.
Role in the accounting circuit. The catalog element acts as an exchange parameter: it is selected in the settings of electronic document management and in the source documents (sales, receipts, invoices), from which ESF and VAT invoices are formed. The actual business operations and VAT are reflected in the source documents according to the standard chart of accounts of the RK, for example:
| Operation | Debit | Credit |
|---|---|---|
| Sale of goods to the customer | 1210 (short-term receivables from customers) | 6010 (revenue from sales) |
| VAT on sales (rate 16%, 2026) | 1210 | 3130 (VAT payable) |
| Cost of goods sold | 7010 (cost of sales) | 1330 (goods) |
| Receipt of goods from the supplier | 1330 | 3310 (payables to suppliers) |
| Receipt of money to the account | 1030 (cash in current accounts) | 1210 |
The ESF sent through the selected user of the ESF reflects the VAT amount at the rate of 16% (current rate of the RK for 2026). The catalog merely provides an account for sending — the entries are generated by the source document.
6. Related Objects and Input on the Basis
- Electronic Document Management / Exchange Settings with ESF — use the catalog element as an account for connection (authentication by login/password and certificate).
- Users of the Information Base — in the wizard
NewAssistant, the link between the ESF account and the information base user is established. - Organizations / Structural Units (Branches) — selected in the wizard, determining on whose behalf the exchange is conducted.
- Source Documents of ESF/VAT Invoices (sales, receipts, invoices, electronic invoices) — when forming and sending electronic documents, refer to the certificate and authentication attributes of the selected ESF user.
Input on the Basis. Direct commands “Input on the Basis” for this catalog are not provided; the element is created manually (through the wizard) and then selected in settings and documents.
7. Extension Points
- Configuration Extension: adding attributes (e.g., certificate expiration date, responsible person, comment) through extension without removing from support.
- Object Module Event Handlers: subscriptions to events / insertion in
BeforeSaving,ValidationHandlerfor custom certificate validation or logging of digital signature changes. - Forms: refinement of
ElementFormandNewAssistantthrough extension (additional connection check commands, automatic certificate expiration check). - Additional Attributes and Information: connecting a properties mechanism (common attributes/sets of additional information) for storing accompanying data without modifying metadata.
- Scheduled Tasks: external processing/task for monitoring certificate expiration and notifying responsible persons.
Version-specific (requires verification on a specific build 3.0.74.2): the exact composition of the commands of the
ElementFormfor connection checking and session management, as well as the method of encrypting the password in theAuthenticationPasswordattribute.
