Модуль ККТ: онлайн-касса по сети

Публикация № 1109732

Программирование - Внешние компоненты

ККТ 54-ФЗ RDP ККМ Касса

6
Одна онлайн-касса для нескольких программ

Мы предлагаем программу, которая позволяет подключить онлайн-кассу к локальной сети. Это позволит:

  1. Подключаться к одной онлайн-кассе сразу нескольким программам 1С
  2. Подключаться к онлайн-кассе при работе в 1С через удаленный рабочий стол (RDP)
  3. Подключаться к онлайн-кассе при работе в 1С в режиме WEB-клиента
  4. Подключаться к онлайн-кассе при работе в мобильной версии 1С («Мобильное приложение» и «Мобильный клиент»)
  5. Подключаться к онлайн-кассе при работе в старых конфигурациях (7.7, 8.0, 8.1, 8.2) используя самые свежие драйвера для 8.3

Поддерживаемые платформы 1С:

  • 8.3 по технологии Native API
  • 7.7, 8.0, 8.1, 8.2, 8.3 по технологии COM

Причем все эти программы могут быть одновременно подключены к одной онлайн-кассе. 

 

Принцип работы 

Программа «Сервер ККТ» умеет работать с драйверами ККТ точно так же, как это делает платформа 1С. Подключившись к кассовому аппарату, программа «Сервер ККТ» открывает доступ к нему по сетевому протоколу TCP. 

В комплект поставки программы входят драйвера «Клиент ККТ», с помощью которых из 1С можно подключиться к «Серверу ККТ».

 

Настройка «Сервера ККТ» сводиться к трем шагам. На компьютер, непосредственно к которому подключается онлайн-касса:

  1. Устанавливаются драйвера из комплекта поставки онлайн-кассы
  2. Устанавливается программа «Сервер ККТ» (в виде службы, работает по протоколу TCP)
  3. В программе «Сервер ККТ» указываются параметры подключения к онлайн-кассе (модель, COM-порт и т.д.)

На клиентских компьютерах в базе 1С устанавливается драйвер «Клиент ККТ». В настройках драйвера указывается имя компьютера (или ip-адрес) и порт «Сервера ККТ». Драйвера от производителя ККТ (из комплекта поставки) на клиентские компьютеры устанавливать не нужно. 

Требования

  1. Онлайн-касса должна поставляться с драйверами для 1С в соответствии с «Требованиями к разработке драйверов подключаемого оборудования» не ниже версии 2.2. Драйвера от производителя могут быть выполнены по технологии Native API (например, драйвер АТОЛ 10.4.х) или по технологии COM (например, ШТРИХ-М 4.14.х).
  2. Базы 1С также должны поддерживать стандарт «Требования к разработке драйверов подключаемого оборудования» не ниже версии 2.2. Данный стандарт поддерживается в «1С:Библиотека подключаемого оборудования» начиная с версии 2.0.4.
  3. Программа «Сервер ККТ» должна устанавливаться на операционную систему Windows XP или более поздние версии (Windows 7, 8, 10)
  4. Драйвер «Клиент ККТ» по технологии Native API предназначен для платформы 1С версии 8.2.9.356 и выше (8.2, 8.3 любых версий)
  5. Драйвер «Клиент ККТ» по технологии COM предназначен для платформы 1С версии 7.70.027, 8.0.3.15 и выше (8.0, 8.1, 8.2, 8.3 любых версий)
Примечания
  1. Все крупные производители онлайн-касс такие драйвера предоставляют, более того, типовые конфигурации 1С эти драйвера уже содержат.

  2. Дистрибутив содержит два комплекта драйверов «ККТ-клиент»:
    • выполненные по технологии Native API - поддерживает win32, win64, Google Chrome, Filefox, Android. Предназначен для платформы 1С 8.2 и 8.3 любых версий
    • выполненные по технологии COM - для старых версий платформ (7.7, 8.0, 8.1, 8.2). Предназначен для платформы 1С версии 7.7 и 8.х любых версий

Внимание

Может потребоваться адаптация типовых конфигураций 1С, если в них не предусмотрено использование одного устройства ККТ на нескольких рабочих местах.

Преимущества

  1. Не зависит от модели онлайн-кассы
  2. Не привязана к конкретному драйверу. Для перехода на новый драйвера от производителя кассы достаточно изменить настройки
  3. Возможность быстрой перенастройки всех клиентских 1С на другую онлайн-кассу: достаточно изменить имя компьютера в настройках
  4. Возможность вести протокол работы онлайн-кассы: вся история работы онлайн-кассы сохраняется в текстовой файл
  5. Возможность включить режим «Эмуляция ККТ» – для отладки и тестирования
  6. Возможность работать на платформах 8.х и 7.7
  7. Возможность сначала попробовать, а потом купить (наличие демо-версии)

Использование демо-версии

В разделе "Файлы" доступна для скачивания демо-версия программы. Демо-версия позволяет:

  1. Протестировать программу на вашем устройстве ККТ
  2. Протестировать драйвера 1С "Клиент-ККТ" на вашей конфигурации
  3. Использовать программу в качестве эмулятора ККТ
  4. Записывать в файл лога все обращения к драйверу ККТ (можно использовать для отладки и тестирования)

Ограничение демо-версии: не более 5 чеков после запуска службы (если перезапустить службу, то можно снова печатать 5 чеков)

 

Использование эмулятора

В программу встроен эмулятор ККТ, который может работать в двух режимах:

  1. В соответствии с «Требованиями к разработке драйверов подключаемого оборудования» версии 2.5
  2. В соответствии с «Требованиями к разработке драйверов подключаемого оборудования» версии 3.1

Для использования эмулятора достаточно демо-версии программы

 

Использование программы для тестирования работы конфигураций

В программе есть возможность включить запись логов: вся информация о вызовах методов драйвера ККТ будет записываться в текстовой файл:


21.08.2019 10:47:25	Start on port 52111
Server mode: Native   InterfaceRevision: 2004   Dll: C:\Program Files\Modul\KKT\fptr10_1c_win32_10_4_2_0.dll

21.08.2019 10:50:02	ClientConnect 192.168.1.176

21.08.2019 10:50:02	Command Open
Параметр1=Неопределено

21.08.2019 10:50:03	Command completed

21.08.2019 10:50:03	Return
Параметр1="ATOL_KKT_1C83_V10#1"
Результат=Истина

21.08.2019 10:50:03	ClientDisconnect 192.168.1.176

21.08.2019 10:50:03	ClientConnect 192.168.1.176

21.08.2019 10:50:03	Command ProcessCheck
Параметр1="ATOL_KKT_1C83_V10#1"
Параметр2=Ложь
Параметр3="<?xml version="1.0" encoding="UTF-8"?>
<CheckPackage>
	<Parameters CashierName="Иванов Иван Иванович" PaymentType="1" SenderEmail="" CustomerPhone=""/>
	<Positions>
		<FiscalString Name="63155 Пакет-майка" Quantity="1" PriceWithDiscount="5" SumWithDiscount="5" Tax="none" SignCalculationObject="1"/>
		<Barcode BarcodeType="CODE39" Barcode="DA00-00032994210819"/>
	</Positions>
	<Payments Cash="5" ElectronicPayment="0" Credit="0" AdvancePayment="0" CashProvision="0"/>
</CheckPackage>"
Параметр4=0
Параметр5=0
Параметр6=""
Параметр7=""

21.08.2019 10:50:07	Command completed
Mode=work
21.08.2019 10:50:07	Return
Параметр1 без изменений
Параметр2 без изменений
Параметр3 без изменений
Параметр4=7435
Параметр5=97
Параметр6="4149700262"
Параметр7="www.nalog.ru"
Результат=Истина

21.08.2019 10:50:07	ClientDisconnect 192.168.1.176

21.08.2019 10:50:07	ClientConnect 192.168.1.176

21.08.2019 10:50:07	Command Close
Параметр1="ATOL_KKT_1C83_V10#1"

21.08.2019 10:50:07	Command completed

21.08.2019 10:50:07	Return
Параметр1 без изменений
Результат=Истина

21.08.2019 10:50:07	ClientDisconnect 192.168.1.176

Информация в файле лога ориентирована на программистов. В ней содержится:

  • Имя вызываемого метода компоненты
  • Входные параметры
  • Выходные параметры (т.е. параметры после вызова метода)
  • Признак успешности выполнения
  • Возвращаемый результат

Для сбора логов с целью тестирования конфигурации достаточно демо-версии программы

 

Инструкция по установке и настройке

1. Установка

Запустить файл KKT_Setup.exe:

После установки в указанном каталоге появятся файлы:

  • KKT_Server.exe - служба «Сервер ККТ»
  • KKT_Server_Setting.exe - программа для настройки параметров
  • 1С\KKT_Client_хххх.zip - драйвер для 1С по технологии Native API
  • 1С\KKT_Client_хххх_Android.zip - драйвер для мобильного приложения 1С
  • 1С\KKT_Client_хххх_77.zip - драйвер для старых версий платформ (7.7, 8.0, 8.1, 8.2) по технологии COM
  • 1С\МодульКлиентККТ_хххх.epf - обработка обслуживания ККТ для конфигураций УТ10.х, КА1.х и т.п.
  • 1С\MKClient_хххх.efd и MKClient_хххх.ert - обработка обслуживания ККТ для конфигурации 1С:7.7 Торговля и склад 9.2

Число в имени файла обозначает:

  • 2005 - соответствие требованиям к разработке драйверов подключаемого оборудования версии 2.2 - 2.5
  • 3001 - соответствие требованиям к разработке драйверов подключаемого оборудования версии 3.0 - 3.1


Необходимо удостовериться, что служба установлена: Пуск – Панель управления – Администрирование – Службы:

Перед запуском службы нужно настроить параметры (см. ниже). При необходимости, службу можно установить/удалить вручную:
KKT_Server.exe –i (для установки)
KKT_Server.exe –u (для удаления)

2. Настройка параметров

Запустить файл KKT_Server_Setting.exe:

  • В поле «Порт» указать номер порта TCP, который будет использован «Сервером ККТ».
  • В поле «Драйвер КТТ» указать путь к драйверу 1С из комплекта поставки онлайн-кассы.
  • В поле «Имя класса» указать имя компоненты (выбирается по кнопке «...»).
  • При необходимости поставить галку «Записывать log» и указать имя файла для записи (Если файла не существует, он будет создан).
  • При необходимости поставить галку «Режим эмуляции». В этом режиме данные не будут отправляться в онлайн-кассу, но будут сохраняться в log. Режим предназначен для тестирования.

Настроить параметры подключения можно по кнопке «Параметры»

Проверить связь с онлайн-кассой можно по кнопке «Тест устройства»

 

3. Настройка 1С (на примере «1С:Розница 2.2»)

Установка драйвера ККТ-клиент:

Меню Администрирование–Подключаемое оборудование–Драйверы оборудования–Добавить новый драйвер из файла, указать файл KKT_Client_2005.zip или KKT_Client_3001.zip

Важно правильно выбрать драйвер "ККТ-клиент", чтобы он был совместим с драйвером производителя ККТ. Как выбрать драйвер?

При тестировании устройства в программе KKT_Server_Setting.exe выдается подсказка: "Ревизия интерфейса драйвера NNNN".

  • если ревизия интерфейса от 2002 до 2005, значит в 1С нужно использовать KKT_Client_2005
  • если ревизия интерфейса от 3000 и выше, значит в 1С нужно использовать KKT_Client_3001


Далее нажать кнопки «Записать» и «Функции–Установить драйвер»:

 

Установка ККТ:

Меню Администрирование–Подключаемое оборудование, указать «Тип оборудования»: ККТ с передачей данных, далее нажать кнопку «Создать». Выбрать драйвер оборудования «Модуль:ККТ-клиент»:

 

Нажать кнопку «Настроить...» и указать параметры «Сервер» и «Порт» - компьютер и номер порта, на котором работает «Сервер ККТ». Для проверки связи нужно нажать кнопку «Тест подключения»:

Понятие «Сервер» в параметрах подключения обозначает компьютер, непосредственно к которому подключен кассовый аппарат.
  • Если вы настраиваете 1С на том же самом компьютере, то в параметре "Сервер" можно указать "127.0.0.1"
  • Если вы настраиваете 1С на другом компьютере, то в параметре "Сервер" нужно указать имя (или ip-адрес) того компьютера, к которому подключен кассовый аппарат
Если вы используете нашу программу подключения к онлайн-кассе, то во всех программах 1С, которые будут работать с этой кассой, подключение должно настраиваться через драйвер "ККТ-клиент".

Не получиться использовать на одном компьютере драйвер производителя, а на другом – драйвер "ККТ-клиент", т.к. один из драйверов "захватит" устройство, а второй драйвер получит ошибку "Порт занят".

 

4. Настройка WEB-клиента (на примере «Google Chrome» и «1С:Розница 2.2»)

1. Нужно установить Расширение для работы с 1С:Предприятием. Чтобы проверить, установлено ли расширение, нужно набрать в адресной строке браузера chrome://extensions/

2. В режиме "толстого" или "тонкого" клиента в базу должен быть загружен драйвер KKT_Client.zip (см. "Установка драйвера ККТ")

3. Далее в режиме WEB-клиента: меню Администрирование–Подключаемое оборудование, указать «Тип оборудования»: ККТ с передачей данных, далее нажать кнопку «Создать». Выбрать драйвер оборудования «Модуль:ККТ-клиент»:

Нажать кнопку "Записать и закрыть"

4. В форме списка подключаемого оборудования нажать кнопки "Настроить", "Установить драйвер" и "Продолжить":

Будет загружен файл "1CExtensionXXX.exe". Нажать "Открыть":

Запуститься установщик внешней компоненты "ККТ-клиент для Chrome и Firefox". После завершения установки должно появиться сообщение "Установка драйвера завершена":

5. Далее нужно указать параметры подключения "Сервер" и "Порт" и нажать кнопку "Тест подключения":

Примечания:

Внешняя компонента "ККТ-клиент для Chrome и Firefox" устанавливается в каталог "Program files" для всех пользователей системы. Для установки может потребоваться запуск браузера с правами администратора.

Перед установкой новой версии компоненты необходимо удалить старую версию через "Панель управления" - "Программы и компоненты":


5. Регистрация программы

Сразу после установки программа работает в демо-режиме: не более 5 чеков после запуска службы. Регистрация программы привязывает полученный пин-код к ИНН организации, от имени которой будут пробиваться чеки. 

Для регистрации нужно запустить программу KKT_Server_Setting.exe и нажать кнопку "Еще - Регистрация":

Далее нужно указать пин-код, полученный при покупке программы и ИНН организации, от имени которой будут пробиваться чеки. 

При нажатии кнопки "ОК" программа проверит пин-код на сервере регистрации (для этого должен быть доступен выход в Интернет) и создаст файл типа хххххх.inn, где хххххх - указанный ИНН. Этот файл должен находиться в той же папке, где находится файл KKT_Server.exe.

Одну программу можно регистрировать несколько раз для разных ИНН. Для этого потребуются приобрести нужное количество пин-кодов.

В случае потери файла хххххх.inn (например, при переустановке ОС), можно повторно зарегистрировать программу, указав пин-код и соответствующий ИНН.

 

Проверить режим работы программы (демо или полный) можно по кнопке "Еще - Режим".

Далее нужно перезапустить службу "Сервер ККТ".


 
Пример адаптации конфигурации "1С:Розница 2.2"

 
Пример адаптации конфигурации "1С:Управление Торговлей 10.3"

 
Подключение к "Серверу ККТ" из 1С:7.7

 
Диагностика сети

Причины купить

Лицензия привязывается к ИНН организации. Нет ограничений на количество ККТ, количество пользователей и на срок лицензии.

Достоинства

  1. Не зависит от модели онлайн-кассы
  2. Не привязана к конкретному драйверу: для перехода на новый драйвер от производителя кассы достаточно изменить настройки
  3. Наличие демо-версии: перед покупкой протестировать все компоненты
  4. Возможность быстрой перенастройки всех клиентских 1С на другую онлайн-кассу: достаточно изменить имя компьютера в настройках
  5. Возможность вести протокол работы онлайн-кассы: вся история работы онлайн-кассы сохраняется в текстовой файл
  6. Возможность включить режим «Эмуляция ККТ» – для отладки и тестирования
  7. Возможность печатать чеки с платформ 8.0, 8.1, 8.2, 8.3
  8. Возможность печатать чеки с мобильной платформы
  9. Возможность печатать чеки с платформы 7.7, при этом использовать самые свежие драйвера от 8.3
  10. Поддержка стандартов «Требованиями к разработке драйверов подключаемого оборудования»  от версии 2.2 до версии 3.1
  11. Не зависит от других библиотек (таких как .NET,  Visual C++ redistributable, Java SDK и т.п.)

Гарантия возврата денег

ООО "Инфостарт" гарантирует Вам 100% возврат оплаты, если программа не соответствует заявленному функционалу из описания. Деньги можно вернуть в полном объеме, если вы заявите об этом в течение 14-ти дней со дня поступления денег на наш счет.

Программа настолько проверена в работе, что мы с полной уверенностью можем дать такую гарантию. Мы хотим, чтобы все наши покупатели оставались довольны покупкой.

Для возврата оплаты просто свяжитесь с нами.

6

Скачать файлы

Наименование Файл Версия Размер
Пример адаптации конфигурации "Розница 2.2" (для версии 2.2.13.8)
.cfe 111,19Kb
27.08.19
0
.cfe 111,19Kb Скачать бесплатно
Модуль ККТ: демо-версия
.exe 5,26Mb
27.08.19
4
.exe 2.0.8.11 5,26Mb 4 Скачать бесплатно
Утилита TCP_test
.exe 429,00Kb
26.08.19
1
.exe 429,00Kb 1 Скачать бесплатно
Пример использования компоненты "ККТ-клиент" на 1С:7.7
.ert 29,00Kb
27.08.19
1
.ert 29,00Kb 1 Скачать бесплатно
Модуль ККТ 12 мес. 3 мес.
27.08.2019
2.0.8.11 3 2500 руб.

Моментальная
доставка

27.08.2019
1 1000 руб.


Новый вопрос

E-mail*
Тема (вопрос)*

См. также

Специальные предложения