Перейти к основному содержимому

Настройка для ККТ АТОЛ на ОС Android

Инструкция по установке модуля ТС ПИоТ для ОС Android и ККТ АТОЛ и по настройке ПМСР (КПО) «РЕТКА» для работы с ним.

Раздел рассчитан на Android-кассы со смарт-терминалом АТОЛ, где драйвер ККТ и модуль ЕСМ работают на самом устройстве. Описание продажи в разрешительном режиме см. в разделе ТС ПИоТ, параметры подключения — в разделе Настройки Честного знака → ТС ПИоТ.

Что понадобится​

КомпонентТребование
ОСAndroid
ККТСмарт-терминал АТОЛ, подключенный по USB
«Центр приложений РЕТКА»Используется для установки и обновления компонентов
Модуль ЕСМ ТС ПИоТ (АТОЛ)Версия 1.4.1+10410
Драйвер ККТ АТОЛАктуальная версия из «Центра приложений РЕТКА»
Приложение «РЕТКА»Не ниже 1.9.84 (билд 164)
ВНИМАНИЕ

Соблюдайте порядок: сначала модуль ЕСМ ТС ПИоТ, затем драйвер ККТ АТОЛ, затем проверка ЕСМ и только после этого подключение приложения «РЕТКА».

Установка модуля ЕСМ ТС ПИоТ​

Если приложение «Центр приложений РЕТКА» ещё не установлено — Актуальную версию можете скачать тут.

  1. Откройте приложение «Центр приложений РЕТКА».
  2. Найдите приложение «ЕСМ ТС ПИоТ (АТОЛ)».
  3. Нажмите Скачать.
  4. После скачивания нажмите Установить.
ЕСМ ТС ПИоТ (АТОЛ) в Центре приложений
Карточка приложения «ЕСМ ТС ПИоТ (АТОЛ)» в Центре приложений
ВНИМАНИЕ

На 25.09.2026 рабочая версия модуля — 1.4.1+10410.

Установка драйвера ККТ АТОЛ​

  1. В «Центре приложений РЕТКА» найдите приложение «ККТ АТОЛ» (драйвер ККТ АТОЛ).
  2. Нажмите Скачать.
  3. После скачивания нажмите Установить.
Установка драйвера ККТ АТОЛ из Центра приложений
Драйвер ККТ АТОЛ в Центре приложений

Проверка работы модуля ЕСМ​

Драйвер ККТ АТОЛ​

  1. На главном экране Android откройте установленное приложение «Драйвер ККТ».
  2. Убедитесь, что подключение активно: в строке «Подключен к» отображается модель терминала и заводской номер.
Значок приложения «Драйвер ККТ»
Приложение «Драйвер ККТ» на главном экране
Драйвер ККТ: активное подключение к терминалу
Драйвер ККТ показывает активное подключение к терминалу АТОЛ

Модуль ЕСМ​

  1. Откройте приложение «ЕСМ».
  2. Дождитесь завершения проверок: по всем пунктам должны появиться галочки.
  3. Обязательно выдайте отсутствующие разрешения — нажмите Выдать разрешение в каждом красном блоке.
Значок приложения ЕСМ
Приложение «ЕСМ» на главном экране
Настройки ЕСМ: проверка доступности
Проверка доступности: ККТ, ЛМ ЧЗ и ГИС МТ отмечены галочками
ЕСМ: запросы разрешений
Отсутствующие разрешения: геолокация и состояние устройства

Ожидаемый результат: пункты ККТ, ЛМ ЧЗ и ГИС МТ отмечены галочками, а запросы разрешений закрыты.

Установка приложения «РЕТКА»​

Установите приложение «РЕТКА» версии не ниже 1.9.84 (билд 164) — из «Центра приложений РЕТКА» или вручную из дистрибутива.

Дистрибутив «РЕТКА»: Актуальную версию можете скачать тут.

Настройка подключения к модулю ЕСМ​

  1. Откройте приложение «РЕТКА».
  2. Перейдите: Продажи → ЕЩЕ (шестеренка) → Честный знак.
  3. Выберите режим проверки маркировки ТС ПИоТ.
  4. Укажите Версия протокола: для ЕСМ 1.4.1 — Протокол 1.2.
  5. Укажите Пакет ТС ПИоТ (модуль ЕСМ): Атол.
Режим проверки маркировки ТС ПИоТ
Режим «ТС ПИоТ», версия протокола и пакет ТС ПИоТ (модуль ЕСМ)
  1. Проверьте заполнение полей ПМСР:
    • Наименование;
    • Версия;
    • Токен устройства / ID ПО;
    • Токен программы — ЭЦП ПМСР.
Поля client_info (ПМСР)
Блок client_info (ПМСР): наименование, версия и токены
  1. Нажмите Проверить статус. Должна появиться надпись «Сервис подключен».

Ожидаемый результат: статус «Сервис подключен», проверка проходит без ошибок.

Проверка работы ТС ПИоТ и «РЕТКИ»​

  1. На экране настройки Честного знака и ТС ПИоТ нажмите кнопку ТЕСТ — откроется окно «Тест ТС ПИоТ».
Диалог «Тест ТС ПИоТ»
Окно «Тест ТС ПИоТ»: адрес, метод API и таймаут
  1. Сканируйте код маркировки.
  2. Дождитесь окончания проверки: тест должен завершиться «зеленым результатом» (продажа разрешена).

Что проверить после настройки​

  • индикатор ТС ПИоТ в шапке приложения «РЕТКА» в норме;
  • режим проверки маркировки — ТС ПИоТ;
  • Проверить статус возвращает «Сервис подключен»;
  • тест ТС ПИоТ дает зеленый результат на тестовой марке.

Если что-то не работает, см. Типовые проблемы → ТС ПИоТ.