ПРРО не завантажує господарські одиниці: як відновити з’єднання

ПРРО не завантажує господарські одиниці: як відновити з’єднання після Error connecting with SSL / tlsv1 alert protocol version

Під час реєстрації або налаштування ПРРО в Торгсофт програма звертається до сервісів ДПС, щоб за даними КЕП отримати доступні господарські одиниці, зареєстровані ПРРО та касирів. Підприємці зазвичай запитують фахівців, чому список не завантажується, чи пов’язане повідомлення Error connecting with SSL / tlsv1 alert protocol version із ключем КЕП, яку версію Торгсофт і Windows потрібно мати, чи допоможе перевстановлення сертифікатів та в якій послідовності перевіряти комп’ютер, мережу й реєстраційні дані.

Коротка відповідь

Повідомлення Error connecting with SSL із деталлю tlsv1 alert protocol version означає, що захищене TLS-з’єднання не було узгоджено. Обмін прикладними даними з ДПС ще не почався, тому програма не могла отримати перелік господарських одиниць.

Для Торгсофт ключова перевірка — версія програми. Виправлення завантаження даних платника та підтримку TLS 1.3 додано у стабільній версії 2022.0.59; відповідні зміни були також у тестовій гілці 2022.4.12. Це підтверджують примітки до версії 2022.0.59 і примітки до версії 2022.4.12.

Практичний порядок такий:

1. Зафіксувати повний текст повідомлення та визначити комп’ютер, де фактично працює Торгсофт.

2. Перевірити дату, час, версію Торгсофт і версію Windows.

3. Оновити Торгсофт до актуальної стабільної версії на робочому комп’ютері або сервері.

4. Встановити системні оновлення Windows і перезавантажити саме цей комп’ютер або сервер.

5. Перевірити підключення через іншу довірену мережу.

6. Лише після відновлення TLS-з’єднання перевіряти КЕП, сертифікати та реєстрацію господарської одиниці в ДПС.

Базові поняття

Що таке господарська одиниця

 Господарська одиниця — магазин, склад, кіоск, інтернет-магазин або інший об’єкт, де суб’єкт господарювання здійснює діяльність. Об’єкт подається до ДПС через форму 20-ОПП, після чого з ним можна пов’язати ПРРО.

Один ФОП або одна юридична особа може мати кілька господарських одиниць. Під час налаштування Торгсофт завантажує лише ті об’єкти, до яких має доступ підписувач із вибраним КЕП.

Що таке TLS і SSL

 TLS — протокол захищеного обміну даними між програмою та сервером. Назва SSL часто залишається в текстах програмних повідомлень і бібліотек, хоча сучасне з’єднання використовує TLS.

Перед передаванням запиту сторони виконують TLS-рукостискання:

• узгоджують версію протоколу та криптографічні параметри;

• сервер надає свій TLS-сертифікат;

• програма перевіряє довіру до сертифіката;

• після успішної перевірки створюється захищений канал.

Якщо цей етап не завершився, Торгсофт не отримує від сервісу ДПС ані список господарських одиниць, ані відповідь про їхній реєстраційний статус.

TLS-сертифікат сервера і КЕП — різні речі

У діагностиці беруть участь два незалежні набори сертифікатів:

• TLS-сертифікат сервера захищає мережеве з’єднання. Його довіру перевіряють програма та операційна система.

• Кваліфікований електронний підпис (КЕП) і сертифікат підписувача ідентифікують підприємця або касира та визначають доступ до даних ПРРО.

Тому перевстановлення КЕП не є першою дією при tlsv1 alert protocol version. Спочатку потрібно відновити TLS-з’єднання. Перевірка КЕП має сенс, коли захищений канал уже працює, але ДПС не повертає потрібні об’єкти або не визнає підписувача.

Що саме означає tlsv1 alert protocol version

За специфікацією TLS, попередження protocol_version надсилається, коли сторона розпізнала запропоновану версію протоколу, але не підтримує її; таке попередження завершує з’єднання.

 Важливе уточнення: слово tlsv1 у технічній назві повідомлення не доводить, що програма обов’язково намагалася підключитися саме через TLS 1.0. Це назва класу TLS-повідомлень у бібліотеці. Для діагностики важливий фрагмент alert protocol version: клієнт, сервер або проміжний мережевий вузол не змогли погодити прийнятну версію протоколу.

Для Торгсофт відомий конкретний історичний сценарій: у версії 2022.0.59 виправлено функцію оновлення даних платника, яка раніше завершувалася Error connecting with SSL, і додано підтримку TLS 1.3 замість раніше використаного TLS 1.2. З цього не випливає, що будь-який нинішній збій спричинений лише версією Торгсофт. Подібну відповідь може повертати також проксі-сервер, засіб перевірки HTTPS-трафіку або інший проміжний компонент мережі.

Як відрізнити TLS-збій від проблеми реєстрації в ДПС

Це розмежування економить час. Якщо після оновлення замість SSL-повідомлення з’явився порожній список, це не продовження TLS-збою. Мережевий етап уже пройдено, і потрібно переходити до перевірки реєстраційних даних.

Послідовна перевірка з’єднання

Крок 1. Зафіксуйте вихідні дані

До зміни налаштувань зробіть знімок екрана та запишіть:

• повний текст повідомлення, включно з рядком після Error connecting with SSL;

• дату й час появи;

• дію, після якої воно виникло: «Оновити дані платника», вибір господарської одиниці, реєстрація ПРРО або інша операція;

• версію Торгсофт;

• редакцію та номер збірки Windows;

• чи працює програма локально, з мережевої папки або через віддалений робочий стіл.

Не видаляйте налаштований ПРРО, господарську одиницю чи ключ. Повторне створення записів не виправляє несумісність TLS і може ускладнити подальшу перевірку.

Крок 2. Визначте, де фактично виконується Торгсофт

Це важливо для магазинів із сервером або RDP.

• Якщо Торгсофт запущено безпосередньо на касовому ПК, перевіряти й оновлювати потрібно цей ПК.

• Якщо працівник відкриває програму через віддалений робочий стіл, TLS-з’єднання ініціює сервер. Оновлення домашнього або касового комп’ютера не замінює оновлення сервера.

• Якщо ярлик запускає програму з мережевого ресурсу, потрібно з’ясувати, який виконуваний файл використовується і де розміщені його компоненти.

У зверненні до підтримки вкажіть цю схему одним реченням: наприклад, «Торгсофт запущено у RDP-сеансі на Windows Server».

Крок 3. Перевірте версію Торгсофт

Відкрийте в програмі розділ «Допомога» → «Про програму» та запишіть повний номер версії.

Орієнтир для цього конкретного повідомлення:

• 2022.0.59 — стабільна версія, де виправлено завантаження даних платника та додано TLS 1.3;

• 2022.4.12 — відповідна історична тестова гілка.

Якщо версія старіша, не витрачайте час на ручне копіювання DLL або редагування реєстру Windows. Спочатку:

1. створіть резервну копію актуальної бази Торгсофт;

2. завершіть роботу користувачів;

3. установіть актуальну стабільну версію за штатною процедурою;

4. перезавантажте програму;

5. повторіть «Оновити дані платника».

Навіть якщо встановлено 2022.0.59 або новішу версію, для робочої системи варто використовувати поточний стабільний випуск, а не зупинятися на історичному мінімумі. Актуальні випуски публікуються у журналі оновлень Торгсофт.

Крок 4. Перевірте Windows, дату і час

Натисніть Win + R, введіть winver і зафіксуйте редакцію та збірку Windows. Потім перевірте:

• правильну дату;

• правильний час;

• часовий пояс UTC+02:00 / UTC+03:00 для України залежно від сезону;

• автоматичну синхронізацію часу;

• наявність системних оновлень;

• завершення оновлення перезавантаженням.

Неправильний час може зробити чинний сертифікат «ще не чинним» або «простроченим». Застаріла система може не мати актуальних кореневих сертифікатів і криптографічних компонентів.

Не слід прирівнювати підтримку TLS у Торгсофт до системної підтримки TLS у Windows. За матрицею Microsoft Schannel нативна підтримка TLS 1.3 починається з Windows 11 і Windows Server 2022; Microsoft не радить примусово вмикати TLS 1.3 в Schannel на попередніх версіях. Водночас окрема програма може використовувати власну TLS-бібліотеку. Тому ручна зміна параметрів Schannel не є заміною оновлення Торгсофт.

Для робочого місця ПРРО доцільно використовувати операційну систему, яка отримує оновлення безпеки. Підтримка Windows 8.1 завершилася 10 січня 2023 року, а звичайна підтримка Windows 10 — 14 жовтня 2025 року. Це зазначено у життєвому циклі Windows 8.1 та довідці Microsoft щодо Windows Update. Можливість запустити Торгсофт на старішій Windows не означає, що така система й надалі отримує виправлення безпеки.

Крок 5. Перевірте мережевий шлях

Виконайте три контрольні тести:

1. Відкрийте офіційний сайт ДПС у браузері на тому самому комп’ютері або сервері.

2. Повторіть завантаження господарських одиниць у Торгсофт.

3. Тимчасово підключіть цей комп’ютер до іншої довіреної мережі, наприклад через мобільну точку доступу, та повторіть дію.

Результати трактуються так:

• Браузер і Торгсофт не працюють — перевірте інтернет, DNS, шлюз, проксі та загальні мережеві обмеження.

• Браузер відкриває сайт, а Торгсофт показує TLS-повідомлення — це не спростовує проблему TLS. Браузер і програма можуть використовувати різні бібліотеки, набори протоколів і сховища сертифікатів.

• Через мобільний інтернет Торгсофт працює, а через мережу магазину — ні — причина найімовірніше в локальному маршрутизаторі, проксі, фаєрволі, DNS-фільтрі або перевірці HTTPS-трафіку.

• В обох мережах результат однаковий — поверніться до версії Торгсофт, Windows і криптографічних компонентів на цьому комп’ютері.

Якщо в компанії використовується проксі або антивірус із HTTPS inspection, передайте адміністратору точний час спроби та назву виконуваного файла Торгсофт. Адміністратор має перевірити журнали блокування і правила вихідного HTTPS-з’єднання.

Не вимикайте фаєрвол або антивірус на постійній основі й не створюйте широкі винятки для всього диска чи всіх програм. Якщо контрольний тест потребує тимчасової зміни захисту, його має виконати відповідальний адміністратор із подальшим відновленням налаштувань.

Крок 6. Перевірте TLS-сертифікати тільки за відповідним симптомом

Якщо текст змінився на недовіру до сертифіката, перевірте:

• системну дату й час;

• установлені оновлення Windows;

• чи не підмінює проксі або антивірус сертифікат сервера власним;

• чи довіряє Windows корпоративному кореневому сертифікату, якщо HTTPS-перевірка справді використовується;

• чи повторюється результат в іншій мережі.

Не встановлюйте випадкові кореневі сертифікати з форумів і не додавайте їх до довірених лише тому, що назва схожа на потрібну. Кореневий сертифікат дає можливість підтверджувати довіру до сайтів, тому джерело й призначення мають бути перевірені.

Крок 7. Перевірте КЕП і криптографічні компоненти

До цього кроку переходьте, якщо TLS-з’єднання вже відновлено або повідомлення прямо стосується ключа.

Перевірте:

• чи вибрано ключ потрібного ФОП або юридичної особи;

• чи не завершився строк дії сертифіката;

• чи не був ключ відкликаний;

• чи правильно введено пароль;

• чи зареєстровано в ДПС саме сертифікат підписання, а не шифрування;

• чи має обліковий запис Windows доступ до папки криптографічних компонентів.

Для повідомлення «Сертифікат ключа не знайдено» Торгсофт рекомендує оновити компоненти ІІТ офіційним інсталятором «Користувач ЦСК», після чого перезавантажити комп’ютер або сервер. Детальний сценарій наведено в довідці Торгсофт про відсутній сертифікат.

Якщо з’являється «Операція не підтримується» або повідомлення про неініціалізовану бібліотеку, перевірте шлях до встановленого «Користувача ЦСК» і права того облікового запису, під яким реально запущено Торгсофт. Не надавайте Everyone повний доступ до програмних папок без аналізу: достатні права потрібно видати конкретному користувачеві або службовому обліковому запису.

Якщо КЕП замінено через закінчення строку дії, спочатку зареєструйте новий ключ у ДПС через форму 5-ПРРО, дочекайтеся квитанції №2, а потім виберіть новий ключ у Торгсофт. Опис заміни є в інструкції Торгсофт щодо нового КЕП.

Крок 8. Перевірте реєстрацію господарської одиниці

Якщо SSL-текст зник, ключ читається, але список господарських одиниць порожній, перевіряйте документи в такому порядку:

1. 20-ОПП — господарську одиницю подано та взято на облік.

2. 1-ПРРО — ПРРО зареєстровано на правильну господарську одиницю та він має чинний статус.

3. 5-ПРРО — до ПРРО прив’язано сертифікат саме того підписувача, чий КЕП вибрано в Торгсофт.

4. Квитанція №2 — документ прийнято, а не лише відправлено.

5. KeyID — ідентифікатор сертифіката у квитанції збігається з ідентифікатором вибраного ключа.

Після прийняття реєстраційної форми дані можуть з’явитися не миттєво. У роз’ясненні Торгсофт про відсутні господарські одиниці рекомендовано після квитанції №2 зачекати від 15 хвилин до однієї-двох годин і повторити завантаження.

ДПС також пояснює, що доступні касиру господарські одиниці та ПРРО визначаються за KeyID підписувача. Для входу використовується ідентифікатор сертифіката підписання, зазначений у повідомленні про сертифікати відкритих ключів. Див. роз’яснення ДПС щодо відсутніх господарських одиниць.

Якщо документи прийняті, але об’єкт не з’явився, додатково перевірте, чи не заблоковано ПРРО формою 2-ПРРО та чи не припинено роботу касира.

Крок 9. Повторіть контрольний сценарій

Після кожної суттєвої зміни перевіряйте один і той самий сценарій:

1. Запустіть Торгсофт під тим самим обліковим записом Windows.

2. Відкрийте «Налаштування» → «Програмний РРО» → «Реєстрація ПРРО».

3. Виберіть підприємство та потрібний КЕП.

4. Виконайте оновлення даних платника.

5. Відкрийте вибір господарської одиниці.

Успішний результат має дві окремі ознаки:

• TLS-повідомлення не з’являється;

• у списку є очікувана господарська одиниця або ДПС повертає зрозумілу відповідь про її статус.

Якщо TLS-повідомлення зникло, але потрібної одиниці немає, не повертайтеся до перевстановлення TLS-компонентів: переходьте до 20-ОПП, 1-ПРРО, 5-ПРРО та KeyID.

Практичні сценарії

Умова: у браузері інтернет працює, але під час оновлення даних платника Торгсофт показує tlsv1 alert protocol version; версія програми старіша за 2022.0.59.

Причина: браузер і Торгсофт використовують різні TLS-компоненти. Справний браузер не оновлює мережеву бібліотеку старої версії Торгсофт.

Дія: резервна копія бази, оновлення Торгсофт до актуальної стабільної версії, перезапуск і повторна перевірка.

Умова: версія Торгсофт актуальна; через мобільну точку доступу перелік завантажується, через основного провайдера магазину — ні.

Причина: проблема знаходиться на мережевому шляху магазину — проксі, фаєрвол, DNS-фільтрація, маршрутизатор або перевірка HTTPS.

Дія: передати адміністратору точний час тесту й результат порівняння мереж, перевірити журнали захисту та вихідні HTTPS-з’єднання.

Умова: TLS-текст більше не з’являється, пароль КЕП приймається, але програма повідомляє про відсутність доступних господарських одиниць.

Причина: транспортний рівень уже працює; ДПС не пов’язує вибраний KeyID із чинною господарською одиницею або зміни ще не синхронізовано.

Дія: перевірити прийняття 20-ОПП, 1-ПРРО та 5-ПРРО, квитанцію №2 і збіг KeyID; після прийняття останньої форми зачекати до двох годин.

Умова: касир підключається з Windows 11 до сервера зі старою Windows Server, а Торгсофт працює в RDP-сеансі.

Причина: TLS-запит виконує сервер, а не комп’ютер касира.

Дія: перевірити й оновити Торгсофт, Windows, час, сертифікати та мережеві правила саме на сервері.

Чого не слід робити

• Не копіюйте вручну libssl, libcrypto чи інші DLL з випадкових джерел. Невідповідна розрядність або версія може зробити програму нестабільною.

• Не редагуйте реєстр Windows, щоб примусово ввімкнути TLS 1.3 на системі, для якої Microsoft цього не підтримує.

• Не видаляйте папки налаштувань ПРРО і не створюйте реєстратор повторно, доки не зафіксовано вихідні дані.

• Не вимикайте захист постійно та не додавайте весь диск у винятки антивірусу.

• Не встановлюйте невідомі кореневі сертифікати для обходу перевірки довіри.

• Не подавайте повторно реєстраційні форми навмання. Спочатку перевірте статус і квитанцію №2 попередньої форми.

• Не передавайте технічній підтримці файл приватного ключа та пароль. Для діагностики достатньо назви надавача, строку дії, відкритого сертифіката або KeyID без секретних даних.

Відповіді на поширені питання

Не обов’язково. Це частина технічної назви TLS-попередження. Визначальним є alert protocol version: сторони не погодили прийнятну версію протоколу.

Браузер і Торгсофт можуть використовувати різні TLS-бібліотеки, сховища сертифікатів і мережеві правила. Перевірка браузером підтверджує лише загальний доступ до інтернету, але не працездатність конкретного з’єднання Торгсофт.

Для tlsv1 alert protocol version — зазвичай ні, тому що збій відбувається до перевірки доступу підписувача. КЕП перевіряють, коли програма повідомляє про сертифікат ключа, строк дії, пароль, KeyID або відсутність доступних одиниць.

Очікування до однієї-двох годин доречне після прийняття форми та отримання квитанції №2, якщо TLS-з’єднання вже працює. Несумісність версій TLS очікуванням не виправляється.

Для робочої системи потрібно встановити актуальний стабільний випуск, сумісний із вашою базою та конфігурацією, а перед оновленням зробити резервну копію.

Факт запуску програми не дорівнює підтримці операційної системи виробником. Windows 7 і 8.1 не отримують звичайних оновлень безпеки, а звичайна підтримка Windows 10 завершилася 14 жовтня 2025 року. Для касового робочого місця варто планувати перехід на підтримувану Windows або відповідну серверну редакцію.

Спочатку — той комп’ютер або сервер, де фактично виконується проблемна операція. У мережевій інсталяції оновлення версій потрібно узгодити, щоб клієнти й серверні компоненти працювали в підтримуваній конфігурації.

Не в першу чергу. Позитивний тест через іншу мережу вказує на локальний мережевий шлях. Потрібно перевірити маршрутизатор, проксі, фаєрвол, DNS-фільтрацію та HTTPS inspection.

Тому що це інший етап. З’єднання вже встановлено, але вибраний КЕП може не мати доступу до об’єкта. Перевірте послідовність 20-ОПП → 1-ПРРО → 5-ПРРО, квитанції №2 та KeyID.

Що підготувати для технічної підтримки

Щоб фахівець не починав діагностику з повторного збору даних, надішліть:

• знімок екрана з повним текстом повідомлення;

• точний час останньої невдалої спроби;

• номер версії Торгсофт;

• редакцію й збірку Windows із winver;

• опис розміщення: локальний ПК, мережева папка чи RDP-сервер;

• назву інтернет-провайдера та результат тесту через іншу мережу;

• назву надавача КЕП і строк дії сертифіката без файла ключа та пароля;

• статуси 20-ОПП, 1-ПРРО, 5-ПРРО і наявність квитанції №2, якщо TLS уже працює;

• чи з’явилося повідомлення після оновлення Windows, Торгсофт, заміни КЕП, маршрутизатора або антивірусу.

Звернення з Торгсофт створюється через «Допомога» → «Запит на техпідтримку». Актуальні контакти:

• телефон: +38 (067) 558-37-84, понеділок–субота, 09:00–18:00;

• Telegram: @torgsoft_help щодня.

• електронна пошта: info@torgsoft.ua.

Контакти й графік оприлюднені на сторінці технічної підтримки Торгсофт та в інструкції зі створення звернення.

Підсумковий алгоритм

Якщо Торгсофт не завантажує господарські одиниці та показує Error connecting with SSL / tlsv1 alert protocol version, перевіряйте систему за рівнями:

1. Програма: актуальна версія Торгсофт; історичне виправлення є з 2022.0.59.

2. Комп’ютер: правильні дата й час, оновлена підтримувана Windows, перезавантаження фактичного ПК або сервера.

3. Мережа: порівняння основного підключення з іншою довіреною мережею, перевірка проксі, фаєрвола та HTTPS inspection.

4. TLS-сертифікати: аналіз довіри лише тоді, коли повідомлення стосується сертифіката сервера.

5. КЕП: строк дії, відкликання, АЦСК, криптобібліотеки, права користувача й правильний сертифікат підписання.

6. Реєстр ДПС: 20-ОПП, 1-ПРРО, 5-ПРРО, квитанція №2 і збіг KeyID.

Така послідовність дає змогу не змішувати транспортний TLS-збій із відсутністю реєстраційного доступу. Спочатку програма має встановити захищене з’єднання, потім ДПС ідентифікує підписувача, і лише після цього Торгсофт може показати доступні господарські одиниці.