---
title: "WebKassa Integration Settings in 1C:Accounting for Kazakhstan 3.0 — Complete Guide"
country: KZ
lang: en
author: Сапа Т.И. (https://buhgpt.kz/authors/sapa-ti)
date: 2026-09-07
canonical: https://buhgpt.kz/suraqtar/nastroykiintegraciiwebkassa-v-1s-buhgalteriya-dlya-kazahs-en
source: BuhGPT
---

# WebKassa Integration Settings in 1C:Accounting for Kazakhstan 3.0 — Complete Guide

> **TL;DR:** Checked on release 3.0.74.2 "Accounting for Kazakhstan" (version 3.0). The cash register stopped in the middle of the day. The customer has already counted the money, and on the 1C screen, there is a red "Authorization error in the WebKassa service: incorrect login or password

---

Checked on release 3.0.74.2 "Accounting for Kazakhstan" (version 3.0).

The cash register stopped in the middle of the day. The customer has already counted the money, and on the 1C screen, there is a red "Authorization error in the WebKassa service: incorrect login or password." The receipt cannot be processed, the queue is waiting, and the fiscal operator is waiting for sales data. In nine out of ten cases, the culprit is one record — the settings card IntegrationSettingsWebKassa, where the login, password, and unique number of your online cash register are stored. Let's figure out how to set it up correctly once and not return to it.

1. Purpose

The directory stores the connection parameters of 1C to the cloud fiscalization service WebKassa (fiscal data operator of the RK). Through this record, the program sends receipts from the cash register to the OFD, receives the fiscal sign, and prints the receipt with a QR code. The directory itself does not make any entries — it is the "key" to the service used by the documents Cash Register Receipt and Retail Sales Report.

2. Where to find

Path in the interface:

- Sales section (or "Bank and Cash") → group Settings → Integration settings with WebKassa.

- Or through "Administration" → "Connected Equipment" / "Exchange with OFD", if you have the corresponding functional option enabled.

To open the directory directly, insert the navigation link in the field "Main Menu → Service → Go to Navigation Link":

e1cib/list/Directory.IntegrationSettingsWebKassa

If the menu item is missing — enable the exchange with OFD: "Administration" → "Program Settings" → "Sales" (or "Organizations and Accounting Policy") → checkbox for using online cash registers / WebKassa.

2a. How to know your release

"Help" → "About the Program" (or the ℹ️ icon in the upper right corner). There are two lines: platform version (for example, 8.3.24.xxxx) and configuration release — "Accounting for Kazakhstan, version 3.0 (3.0.74.2)". The second line must match the one in the header of this manual. If your release is older — some fields may be named differently.

3. How to fill

Open the directory, click "Create". Fill in the fields from top to bottom.

Field
Required
Purpose and what will happen in case of error

Name
✅
How the record is visible in the lists. Write clearly: "WebKassa — store on Abay." If you leave the default "Setting 1" and have several cash registers — you will confuse them, and receipts will go to the wrong cash register.

Organization
✅
Which organization the receipts are sent from. An error here = the receipt goes under someone else's BIN, the OFD will reject it.

Service Address (URL API)
✅
API entry point for WebKassa (https://api.webkassa.kz/api/). A typo in the address — there will be no connection at all, "service unavailable." For the test environment, the address is different — do not confuse it with the production one.

Login
✅
Email of the cashier-user from the WebKassa personal account. Incorrect login = "Authorization error," the receipt will not be processed.

Password
✅
Password of the same user. Stored in the database; when changing the password in the WebKassa account, do not forget to change it here as well.

Token
—
Session key. Usually automatically filled after clicking "Check Connection" / "Authorize." Do not enter manually — it is temporary and updated by the program.

Unique (registration) number of the cash register (KassaUniqueNumber)
✅
Identifier of a specific cash register from the WebKassa account. This is what the receipt "binds" to. An incorrect number — the receipt will go to another cash register or return an error "Cash register not found."

Cash Register / Point of Sale
✅
Link to the element of the "Cash Registers" directory in 1C, where the model, factory, and registration number are specified. Connects the setting with the place of sale.

Active / Use
—
Activity checkbox. Uncheck — 1C will stop sending receipts through this setting (convenient when re-registering the cash register instead of deleting).

Rounding / receipt format
—
Display parameters (rounding to tenge, printing the buyer's email). Version-specific: the set of fields depends on the release and requires verification in your build.

After filling in, click "Check Connection" (or "Authorize"). Success = green "Connection established," the token is filled in. Only then "Save and Close".

4. Analyzed example with entries

The sole proprietor "Aktiv" sells one item to the customer for cash. The price on the price tag is 11,600 ₸ including VAT 16%. The accounting cost of the item is 7,000 ₸.

First, we highlight the VAT "including":

- VAT = 11,600 × 16 / 116 = 1,600 ₸

- Income without VAT = 11,600 − 1,600 = 10,000 ₸

The cashier processes the Cash Register Receipt, which goes to the OFD through the WebKassa setting, receives the fiscal sign, and prints the receipt. At the end of the day, a Retail Sales Report is generated, which makes the entries:

Debit
Credit
Amount, ₸
Description

1010 (or 1030)
6010
10,000
Revenue from sales without VAT

1010 (or 1030)
3130
1,600
VAT payable, 16%

7010
1330
7,000
Cost of goods sold written off

Result: 11,600 ₸ entered the cash register/account, income 6010 — 10,000 ₸, VAT liability (3130) — 1,600 ₸, financial result from this sale — 10,000 − 7,000 = 3,000 ₸ gross profit.

Important: the WebKassa card does not make any entries — it only ensured the sending of the receipt to the OFD. The accounting result is formed by the Cash Register Receipt / Retail Sales Report.

5. Types of operations (what the directory provides)

Through the WebKassa setting, cash documents perform operations:

- Sale — regular sales receipt.

- Return of sale — return to the customer, reduces revenue and VAT.

- Cash deposit into the cash register (service operation).

- Withdrawal (cash collection) from the cash register.

- Opening / closing of shift (X and Z reports) — sending to the OFD the start and end of the shift.

The set of available operations is not set in the card itself, but in the documents that use it; the setting only routes them to WebKassa.

6. What is formed when working through this setting

- In the OFD (WebKassa): fiscal receipt with fiscal sign, QR code, and link for verification; when closing the shift — Z report.

- In 1C — Cash Register Receipt document: movements in sales registers, settlements with the customer, retail revenue.

- Entries (through Retail Sales Report / when closing the shift): Debit 1010, 1030 — Credit 6010, 3130; Debit 7010 — Credit 1330 (see example).

- Connection of the receipt with electronic documents: when wholesale shipping to a legal entity, an electronic invoice (ESF) is additionally issued, and when dealing with traceable/marked goods — SNT. A retail cash register receipt does not require an ESF by itself, but at the buyer's request, an ESF is issued as a separate document.

7. Printed forms

- Fiscal receipt WebKassa — with QR code, fiscal sign, BIN/IIN, cash register number, and link to consumer.oofd/webkassa for verification.

- Goods receipt — if necessary, with the fiscal one.

- X report (without cancellation) and Z report (with shift cancellation).

- Cash register / shift status report — service form from the cabinet/integration.

The directory itself does not have a printed form — documents sent through it are printed.

8. Common errors

- "Authorization error in the WebKassa service: incorrect login or password." The login/password in the card do not match the WebKassa account (most often the password was changed in the account, but forgotten in 1C). Update the password, click "Check Connection."

- "Cash register with the specified unique number not found." Typo in the "Unique cash register number" field or the cash register is deactivated in the account. Verify the number with the WebKassa personal account character by character.

- "Service unavailable / failed to establish a connection." Incorrect URL API or no internet/blockage. Check the address https://api.webkassa.kz/api/ and network access.

- "Shift exceeded 24 hours, close the shift." The Z report was not generated on time. Close the shift (Z report) and reopen it.

- "Token expired." Click "Authorize" again — 1C will automatically receive a new token.

- The receipt went under another organization. The wrong "Organization" was selected in the card — the BIN in the receipt did not match. Correct the organization and reprocess the documents.

9. FAQ

Q: Does the directory make accounting entries?
A: No. It only stores connection parameters to WebKassa. The entries are made by the Cash Register Receipt and Retail Sales Report.

Q: What VAT rate should be applied to the receipt in 2026?
A: The main one — 16%. For goods/services, it is highlighted "including": VAT = amount × 16 / 116.

Q: Where to get the unique cash register number?
A: In the WebKassa personal account in the cash register card (KassaUniqueNumber / registration number). Duplicate it in the "Cash Registers" directory as well.

Q: Is it necessary to enter the token manually?
A: No. The token is automatically filled in after successful authorization and is periodically updated. Manual entry will lead to a session error.

Q: Can multiple cash registers be set up?
A: Yes. Create a separate record for each cash register/point of sale and specify different unique numbers and, if necessary, different users.

Q: Does the retail cash register receipt replace the ESF?
A: No. For legal entity buyers, the ESF is issued separately in the ESF system. The cash register receipt records retail payment; when dealing with traceable goods, an SNT is additionally issued.

Q: What to do when returning goods?
A: Process the "Return of Sale" operation — the return receipt will go to WebKassa and reduce revenue (reverse Debit 6010, Credit 3130) and cost (restoration Debit 1330, Credit 7010).

Q: How to temporarily disable the cash register without deleting the setting?
A: Uncheck the "Active / Use" checkbox. The data will be saved, but receipts will not be sent through it.

Q: Where to look when complaining "the receipt does not reach the customer"?
A: Check that the receipt includes the buyer's email/phone and that the receipt format in the settings allows sending — this is managed by the receipt format parameters in the card.

10. Related documents

- Based on the setting, the following work: Cash Register Receipt, Retail Sales Report, documents for opening/closing shifts (Z report).

- Related directories: "Cash Registers" (model, factory, and registration number), "Organizations," "Warehouses/Points of Sale."

- Further down the chain: sales → if necessary ESF (ESF system) and SNT; retail results go into turnover on accounts 1010/1030, 6010, 3130, 7010, 1330.

How to know your release: "Help" → "About the Program" — there you will find the platform version and configuration release.

The manual was prepared and verified on release 3.0.74.2 "Accounting for Kazakhstan" (version 3.0). The numerical norms of the RK are provided for the year 2026: VAT 16%, MRP 4,325 ₸, MSP 85,000 ₸.

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