Instructions for integrating third-party application Software with cash register equipment manufactured by ATOL

Section 1: Integration of software and cash register "ATOL" using the libraries Driver KKM 2

Section 2: Software integration using the Lower Level Command Exchange Protocol. 3

Section 1: Integration of software and cash register "ATOL" using the KKM Driver libraries

Support for 54-FZ is implemented in driver versions starting from 8.10.2.0 for DTO8 and 9.7.0. for DTO9.

For integration, you must have distribution kits of KKM Drivers:

"ATOL: KKM 8 Driver"

The driver is an external component for the 1C:Enterprise system and an OLE Automation and ActiveX server running Windows 2003 x86 / XP x86 / Vista x86 / 7 x86 / 7 x64 / 8 x86 / 8 x64. It can be used in any development environment that supports OLE Automation technology.

Drivers for commercial equipment 8 are available for download from the link below:

Installation

Launch installation file DTO _8_12_ Full . exe . Install the driver following the instructions. It is recommended to leave all values ​​at their defaults. If the system asks you to confirm the installation of additional software, answer in the affirmative.

During installation, the driver management application will launch (by default installed in:

C:\Program Files(x86)\ATOL\Drivers8\

The Mode column should be set to " Free version", otherwise you need to set the required value by clicking on the "..." button in the "Free version" column. Document "Programmer's Guide" included in the distribution. After installation, DTO8 is available in the following path (by default):

C:\Program Files (x86)\ATOL\Drivers8\Doc\Drivers8_FprnM_PM.pdf

The following models support work under Federal Law-54 in the driver:

Table 1


Model

Model code

ATOL 30F (ATOL FPrint-30ENVD)

61

ATOL 77F (ATOL FPrint-77ENVD)

69

ATOL FPrint-22PTK (ATOL FPrint-22ENVD)

63

ATOL 55PTK (ATOL FPrint-55ENVD)

62

ATOL 11F (ATOL FPrint-11ENVD)

67

ATOL 5200F (ATOL FPrint-5200ENVD)

64

ATOL 25F

57

The models listed in Table 1 are supported by Protocol 3.x and higher.
After successful installation of the DTO, it is necessary to establish a connection between the driver and the cash register equipment. To do this you need to use the documentation:

Connecting Projects to different environments Programming

After installing DTO8, Connection examples are copied in various environments, which will make the integration process easier for software developers.

C:\Program Files (x86)\ATOL\Drivers8\Samples\FprnM
Manual FPrint -22PTK :

using the example of the ATOL FPrint-22PTK model (ATOL FPrint-22ENVD). IN this document The processes of installing the DTO, connecting, searching and configuring equipment are described. For each specific model You must use the documentation in the Operation Manual for the CCP model you are using.

"ATOL: KKM 9 Driver"

The driver is a set of libraries (*.dll) for operating systems Windows NT / Windows CE family, or (*.so) for Linux, intended for use in applications written in C++.

Drivers for commercial equipment 9 are available for download from the link below:

1.Unpack the downloaded archive X _X. zip to any available place. Next, unpack the archive containing the folders:

android– libraries for Android

doc– documentation

include– header files

linux-armhf– libraries for arm architecture

linux-x64– libraries for Linux x64

linux-x86– libraries for Linux x32

nt-x86-mingw– libraries for Windows

samples- examples of using
2. In a folder Retail_equipment_drivers_9_X_X\doc unpack the archive doxygen.tar.bz2 V docs. Inside a folder docs\html open file in browser index.html– will open home page documentation from detailed description internal structure DTO9. The differences when working with FZ-54 compatible models are also described.

In the ATOL:KKM Driver section there are examples of using the driver and connection in some ((C++), (Java), (Android)) software development environments:


Section 2: Software integration using the Lower Level Command Exchange Protocol.

To interact the software with cash register equipment produced by ATOL according to the Protocol, you must use the document
KKM operating protocol 3. x - Programmer's Guide this protocol describes the interaction of software and hardware using lower-level commands, including new protocol commands. It also describes the main points for connecting and setting up a cash register for exchange with the OFD.

There are two types of Lower Level Protocol.

Lower Level v2 – p.10

Lower Levelv3 – p.19 Redesigned protocol with a modified algorithm for interaction at the lower level.

Both protocols support both the implementation of 54-FZ and the old order.

Appendix 1: Notes and links to download additional software:


  1. The CCP registration utility is built into the DTO8 distribution. Instructions after installing DTO8 are available in the following path:
C:\Program Files (x86)\ATOL\Drivers8\DOC\Registration Utility User Guide.pdf

To establish a connection with the cash register, you need to transfer the DF to the Cash Register Protocol 3.0 by programming the value of Table 2 Row 1 Field 85 – 2. Or use service menu.


  1. The EoU utility for transmitting data to the OFD via an Ethernet channel is built into the Driver Management Utility. Exchange channel from PC – USB.COM

Before installing the driver, you must convert to desired mode cash machine. To do this, you need to turn off the device, then press the tape feed button and hold it, turn on the device again. 4 to follow sound signals. After a few seconds, but before the 5th signal follows, the tape advance button must be released. The device will issue a receipt on which a list of available options in service mode will be printed. One of possible options presented in the following image:

1- Output, 2 – Exchange channel, 3 – Exchange protocol

The desired mode is selected by the appropriate number of clicks on the tape advance button. So, in the example above, pressing the button 1 time will exit the service mode, 2 clicks will provide access to setting up the exchange channel, and 3 clicks will provide access to setting the exchange protocol.

To install the driver, the cash register must be switched to the “Exchange Channel” mode. In our example, press the tape advance button 2 times. The user will see the available exchange channels, for example, the list may look like this:

  1. Exit
  2. RS-232

From the list above, you must select USB. In our example, this will require pressing the tape advance button 3 times. If everything is done correctly, the device will confirm that USB is turned on:

Now, using the same method, you need to select the exchange protocol - Atol 3.0. To do this, in the service mode menu you need to select the “Exchange Protocol” item. In our example, this is point 3, therefore, the tape advance button must be pressed three times. The device will display a list of available protocols, for example, as in the following image:

Now, by pressing the tape advance button three times (in our case), you need to select the Atol 3.0 protocol. To confirm your selection, the device will print the message “Atol 3.0 is enabled.”

Now you can exit the service mode. To do this, in our example, you need to press the tape feed button once (menu item “Exit”). The device will indicate that it is ready for use:

So, everything is ready to install the driver.

If something goes wrong at the previous stages, it is recommended to run the entire algorithm from the very beginning. If the CCP cannot be switched to the desired mode, contact the manufacturer.

Driver installation

The driver for KKT Atol is located at https://install.kontur.ru/atol

After clicking the “Next” button, the user can select components to install or install them by default:

When the installation is complete, the computer must be restarted:

The driver is now installed and ready for configuration.

Driver setup

First of all, you need to open the Windows Device Manager: “Start” – “Control Panel” – “Device Manager”. Next, you need to expand the “Ports (COM and LTP)” list item and select “Serial port (COM)” (or “Device with serial interface(COM)"). By right-clicking, a menu will appear in which you need to select “Update driver”:

In the window that opens, select “Search for drivers on this computer”:

Next, click “Select a driver from the list of already installed drivers”:

At the next stage, you need to click the “Install from disk...” button:

In the window that appears, you must specify the path to the Atol driver. By default it is C:\Program Files (x86)\ATOL\Drivers8\USB_Drivers. When the driver is selected, click the “OK” button:

In the window that then appears on the screen, you need to uncheck the “Only compatible devices” option:

The user will see a driver selection menu. In the left column you should select “ATOL group”, and in the right column – “ATOL FPrint USB”:

After clicking the “Next” button, the system will issue a warning - the user should click the “Yes” button:

The system will install the driver, and if everything goes well, its name will appear in the “Device Manager” in the “Ports (COM and LTP)” section:

The same operation must be repeated for the second port:

Setting up Ethernet over USB

In order to connect the Atol cash register with the fiscal data operator, you will need to configure the Ethernet over USB (EoU) service. But first you need to make sure that all the files for this service are installed. You need to open the folder C:\Program Files (x86)\ATOL\EthOverUsb and check that it has a structure like the image below:

If all the files are in place, you can proceed to setting up the service.

You will need a standard Windows notepad, which should be run as administrator. In notepad, you need to open the settings.ini file and correct the line number = “number”. You need to enter the COM port number on which the services will run. In order to find it out, you will need to check the data from the Atol cash register registration utility and the “Device Manager”. In our example, the device is connected to port COM3, and the utility shows COM4. This value needs to be changed in the settings.ini file and written as shown in the figure below:

Note: This article was written for ATOL cash register systems that comply with Federal Law-54 (Online cash register). If you have a cash register old model, then in steps 3 and 6 you will have one COM port, skip steps 11-13.

1. Install the ATOL driver as an administrator. Follow the installer's recommendations:

2. Connect your device via USB cable to PC.

3. Open “Device Manager”, KKT ATOL should be displayed as “Unknown device”, or as shown in the figure (when connecting KKT ATOL via USB cable, two devices should be displayed):

4. Click right click mouse on each device and select “update driver”.

5. Select “Search for drivers on this computer”:

6. Install drivers from the following folder: C:\Program Files\ATOL\Drivers8\USB_Drivers. At correct installation Device drivers will have an ATOL mark:

7. Now open the “KKM Driver” (you can find it by searching on your computer) and click “Setting Properties”:

8. Now select the “Search for equipment” item:

9. In the “search parameters”, indicate the model of your cash register and click “search”. The driver must find the device, indicate its operating speed and COM port:

10. Next, in the “communication parameters” we indicate the same values ​​that the driver gave us in the previous paragraph (in the search for equipment), and also indicate the model of your device and click “test connection”. If everything is configured correctly, your device will be displayed in the “Result” line:

12. Now launch “Manage Drivers” as an administrator. The KKM field contains arbitrary information that defines the KKM. In the COM port field, enter the port number for exchange with the OFD (This is the second of the ports that is displayed in your “device manager”, not used in the “KKM driver”) Check the “Autorun” checkbox and click the “Run” button:

13. Check the logs that the port is configured correctly. There should be a record in the logs that the port was detected correctly:

14. Now install the Subtotal application, following the installer’s instructions:

15. After launching the Subtotal application, open “Settings” and select the “KKM” section:

16. Select “connect fiscal registrar” and enter the main login and password from Subtotal, select a store and point of sale:

17. In the final settings, specify the ATOL driver, payment codes “0” and “1”. Next, click on the blue gear and specify the parameters exactly the same as in the “KKM driver” (point 10):

18. Click “Finish” and “ok”, the application will reboot - this completes the setup.

ATOL drivers are a special program required for the interaction of a cash register with a computer. Given software will significantly speed up the process of payment to the buyer, and also simplify financial accounting.

Features and functionality

ATOL is necessary so that any user, even those with minimum set knowledge of working with cash registers, could successfully interact with it. Thanks to this software, you will be able to manage your fiscal apparatus, entering information about all expenses and income into special program. To work with ATOL there is no need to create a personal profile or perform additional settings– all ready-made configurations can be found in the menu. They just need to be adjusted correctly. The settings will be automatically saved and restored in case of system failures.

The program can search for connected equipment, supports working with several cash registers connected to one computer, and can also work with remote cash registers connected to a PC via a network. When managing a cash register, the user can carry out sales operations, pay, return, print and cancel printing of a receipt, reset counters, reset settings, obtain various readings and perform many other actions.

Compatibility

ATOL drivers are compatible with such fiscal registrars– ATOL, Shtrikh-M, Pilot, Iskra, MultiSoft, ServicePlus, IKC-Techno, NCR, Resonance, NPF Unisystem and Newton. Regarding the programs with which it can “get along”, we can list the products of the company 1C, Microsoft Office, Microsoft Visual FoxPro/Basic/C++/C# and others.

Key Features

  • supports Windows 7 and earlier versions of this OS;
  • necessary for automated operation of a cash register;
  • makes it possible to work with remote equipment;
  • compatible with software products from 1C;
  • allows you to work not only with ATOL cash registers, but also with other cash registers;
  • can interact with multiple devices connected to one PC.

There is a working 1c 8.3 x32 and all Atol 8 KKT drivers work!

PC:
Windows Server 2008 x64, RDP mode
1C:Enterprise 8.3 x32 (8.3.11.2867)
Enterprise Accounting, edition 3.0 (3.0.54.20)
KKT Atol-FPrint-22PTK
Atol driver 8.15.3.8197

We install 1C:Enterprise 8.3 x64 in the hope of using DTO 8 from Atol, and we get this “Not installed on the current computer. Type not defined: AddIn.ATOL_KKM_1C82_54FZЭ”:

And in 1C:Enterprise 8.3 x32 NOW WE GET THIS TOO.

Reinstalling 1C:Enterprise 8.3 x32 does not help.
Only DEMOLISH 1C:Enterprise 8.3 x64 and even without a reboot, everything works fine IMMEDIATELY!


Internet searches yield nothing (oddly enough, 2017)

The answer comes in a rather stupid way. Downloading new drivers ATO 10.1.1 after unpacking daddy was spotted installer, which also contains the distribution kit KKT10-10.1.1.0-windows64-setup.exe (and KKT10-10.1.1.0-windows32-setup.exe).

Let's launch KKT10-10.1.1.0-windows64-setup.exe and further, for example, in 1C:Enterprise 8.3 (8.3.11.2867) x64 The drivers install perfectly and the CCT works (the drivers are detected as 9 for some reason).


If you run 1c 8.3 x32, then the DTO 9 drivers will not work there. Why is this necessary - let’s say you also use Shtrikh-M fR (it only works under 1C 8.3 x32). We need everything to work together - then we roll back 1C to x32.
We are returning Atol drivers for 1C x32. If you install KKT10-10.1.1.0-windows64-setup.exe in parallel KKT10-10.1.1.0-windows32-setup.exe, then in 1s 8.3 x32 DTO 9 and DTO 8 will not work as before.

Only completely cleaning the PC from Atol helped. Moreover, in the removal utility Windows programs Atol is encrypted and does not write that it is Atol - for example, the KKT 10 driver....). Be careful. For example, I had DTO6, DTO8, DTO9, and DTO10 (installed twice). Another license master.