Наименование модели "Водяной"
Версия 2025.11
Заявитель - ИП Тимофеев Геннадий Серафимович (ИНН 616205267707)


Контактная информация
---------------------
Сайт программы "Водяной" vodasoft.ru
info@vodasoft.ru
Телеграм @vodasoft
Макс, телеграм, ватсап: +79914253974 
контактное лицо - Геннадий Тимофеев


Ожидаемая версия драйвера ФР
-----------------------------
База настроена на взаимодействие с 32-БИТНЫМ драйвером Атол версии 10.10.7 и выше.
Программа Водяной НЕ РАБОТАЕТ с 64-битными версиями драйверов ФР!!!


Ссылки на дистрибутивы и тестовую базу
---------------------------------------
https://vodasoft.ru/firebird64.exe
https://vodasoft.ru/voda_next.msi 
(Примечание: В документации на программу (и внутри программы) приводятся ссылки на дистрибутив voda.msi. Для тестирования используйте именно voda_next.msi, т.к. на данный момент только там есть функционал, связанный с ТС ПИоТ.)

Для тестового стенда скачайте
https://vodasoft.ru/vodasoft_test.zip
и разархивируйте в любую папку.


Установка тестового комплекта
-----------------------------
1) firebird64.exe (в случае 32-битной системы можно использовать firebird32.exe), будет установлена СУБД Firebird версии 2.5.9. При установке firebird отмечаем запуск службы, если не отмечен
2) устанавливаем voda_next.msi
На рабочем столе и в меню "пуск" появится ярлык "Водяной". В программу НЕ входим, пока не будет выполнен п.3
3) запускаем install_voda.bat от имени администратора Windows, будет 
а) скопирована база данных TSPIOT.FDB в папку C:\Program Files (x86)\ctex\voda\base
б) заменен файл настроек C:\ProgramData\vodjanoj\update\vodjanoj.ini (путь к БД, список пользователей для входа)
в) записан файл настроек C:\ProgramData\vodjanoj\srv.ini (путь к БД для службы)
г) установлена (но не запущена) служба "Водяной-ККМ"

Служба Водяной-ККМ
------------------
Файл C:\Program Files (x86)\ctex\voda\vod_kkm.exe - консольное приложение, непосредственно взаимодействующее с ТС ПИоТ и драйвером ФР. Остальные компоненты ПО записывают запросы и задания через базу данных, откуда их забирает служба Водяной-ККМ.


Донастройка параметров работы с тестовым стендом
-------------------------------------------------
1) Выбираем базу "Тестирование интеграции с ТС ПИоТ", затем пользователя "Служба", вводим пароль 123.
2) Входим в справочник администрирование - торговое оборудование 
3) двойным щелчком мыши или кнопкой на панели инструментов открываем строку "Сканер ШК" на редактирование, меняем в поле "COM-порт (или ip-адрес:порт)"  значение с "COM5" на  номер порта, занятый сканером ШК. После редактирования нажимаем "сохранить и закрыть"  (справа снизу). 
4) При необходимости в строке "ККМ для СЛУЖБЫ" аналогичным образом указываем в поле "COM-порт (или ip-адрес:порт)" адрес и порт ККМ, например "192.168.1.55:5555" для регистратора, подключенного по сети или "COM1" для локального подключения через порт com1. Для работы кассы через сервис удаленного подключения Атол (службу атол-rpc) поле будет иметь вид "192.168.1.55:USB".
В настройках указан адрес ТС ПИоТ  https://esm-emu.ao-esp.ru, в случае необходимости можно изменить его.
Если касса подключена по USB, а адрес ТС ПИоТ esm-emu.ao-esp.ru, то ничего менять не требуется.
5) Выходим из базы данных (крестик в заголовке окна).
6) Запускаем (перезапускаем) службу Водяной-ККМ (через пуск-службы) для применения новых настроек ККМ
7) Через минуту после запуска в последнем по времени файле из папки "C:\ProgramData\vodjanoj\kkm" можно проконтролировать, успешно ли произошло подключение к ККМ. Если в протоколе нет серийного номера устройства, проверьте физическое подключение и правильность настроек.
Если в протоколе есть строки вида "Не удалось создать объект драйвера 10 для ККМ Атол!", то проверьте, что установлена именно 32-битная версия драйвера ФР.


Проведение тестирования
-------------------------------------------------
1) Входим в Водяной под именем Продавец, пароль не требуется.
В случае появления ошибки доступа к сканеру, выходим и повторно настраиваем порт, как описано в предыдущем параграфе.
2) В открывшемся новом документе "чек ККМ" сканируем коды, проверяемые в онлайн-режиме
В случае оповещения "НЕТ ОТВЕТА от ТС ПИоТ, либо остановлен сервер ККМ..." проверьте настройки ККМ, перезапустите службу Водяной - ККМ и повторите попытку сканирования.
3) при необходимости формирования документа на ФР нажимаем кнопку "ОК", для закрытия документа без сохранения - "закрыть".
4) если после отмены/ проведения не откроется новый документ, нажимаем клавишу F7 в журнале чеков
5) После проверки онлайн-режима выбираем в верхнем меню программы пункт обработки - "Тест интеграции с ТС ПИоТ в оффлайн"
6) сканируем коды, проверяемые в оффлайн-режиме


Инструкция для кассира:
https://vodasoft.ru/kassir.pdf


Удаление программы
----------------------
1) Запускаем от имени администратора Windows uninstall_voda.bat (удаление службы Водяной-ККМ)
2) Удаляем через панель управления программы Водяной и Firebird версии 2.5



Документация ПО "Водяной"
---------------------------
Паспорт программного продукта:
https://vodasoft.ru/passport_voda.pdf

Вики (основная актуальная документация):
https://vodasoft.ru/wiki/doku.php

Описания в pdf
Водяной - Руководство пользователя: https://vodasoft.ru/voda.pdf
Водяной - Руководство администратора: https://vodasoft.ru/admin.pdf	

Сайт программы:
https://vodasoft.ru

Запись реестра российского ПО https://reestr.digital.gov.ru/reestr/418413/
