пРРО не переходить в онлайн і “завис” в офлайн: 502 / 404 / PackageValidationError / InvalidQueryParameter
Коротко: ця інструкція для випадків, коли програмний РРО (пРРО) не переходить в режим онлайн
, накопичує чергу чеків, або показує помилки зв’язку/валідації під час синхронізації з Державною податковою службою — ДПС.
Ця інструкція передбачає наявність у користувача базового досвіду адміністрування облікових систем. Звертаємо вашу увагу, що будь-які самостійні зміни в налаштуваннях або видалення системних файлів виконуються під вашу відповідальність, а помилкові дії можуть призвести до зупинки роботи каси та безповоротної втрати фіскальних даних. Щоб убезпечити бізнес, перед початком робіт обов'язково створіть актуальну резервну копію бази даних. Якщо на будь-якому етапі у вас виникають сумніви, або ви не до кінця розумієте технічні наслідки описаних кроків, наполегливо рекомендуємо утриматися від подальших дій та довірити вирішення цього питання фахівцям технічної підтримки.
Коли пРРО не виходить з офлайн
-
Потрібно завершити офлайн-роботу та відправити накопичені чеки на сервер ДПС.
-
пРРО довго не переходить в онлайн після відновлення інтернету.
-
При синхронізації з’являються помилки 502, 404, 10 PackageValidationError, 11 InvalidQueryParameter.
Які помилки вказують на збій синхронізації
-
Статус пРРО впродовж тривалого часу офлайн
і не стає онлайн
. -
Є “черга” документів/чеків, які не відправляються на сервер ДПС.
-
Помилки:
-
502 Bad Gateway / 404 Not Found (зв’язок/доступність сервера)
-
10 PackageValidationError (критична помилка структури офлайн-пакету)
-
11 InvalidQueryParameter (попередній запит “ще обробляється”, процес завис)
Чому пРРО зависає офлайн
-
Тимчасова недоступність або перевантаження сервера ДПС (часто дає 502/404).
-
Проблема з інтернет-каналом/маршрутизацією (інтернет “є”, але до ДПС не проходить).
-
Завислий запит до ДПС (помилка 11).
-
Пошкоджена/некоректна офлайн-сесія (валідація пакета не проходить — помилка 10).
Рішення: що робити
Крок 1. Діагностика зв’язку (перед видаленням пакета)
-
Переконайтесь, що на ПК є стабільний інтернет (перевірка відкриття сайтів/ресурсів).
-
Якщо помилки 502/404 — це зазвичай тимчасова недоступність сервера ДПС:
- якщо ваш офлайн-ліміт не вичерпано — продовжуйте роботу в офлайні та повторіть синхронізацію пізніше;
-
не видаляйте офлайн-пакет лише через 502/404 (поки не впевнені, що це не тимчасовий збій ДПС).
Крок 2. Якщо “триває обробка іншого запиту” (11 InvalidQueryParameter)
Це означає, що попередній запит завис і блокує наступні.
-
Налаштування → Програмний РРО → Аналітика за програмним РРО.
-
Виконайте сервісну команду Встановити стан “Готовий”.
-
Після цього повторіть спробу переходу в онлайн / синхронізації.
Крок 3. Якщо критична валідація офлайн-пакета (10 PackageValidationError)
Пакет не приймається сервером ДПС через помилку в одному або декількох документах (наприклад, порушення нумерації, змішані фіскальні та нефіскальні товари в чеку тощо).
КРИТИЧНО ВАЖЛИВО: якщо у вас в офлайні накопичилося багато чеків, НЕ НАТИСКАЙТЕ одразу кнопку «Видалити офлайн-пакет»! Ця дія повністю видаляє з черги відправки всі документи поточної офлайн-сесії. Якщо у вас в черзі 50 чеків, а «зламаним» є лише 49-й, натискання цієї кнопки знищить усю чергу, і вам доведеться вручну перепроводити всі 50 продажів.
Як діяти:
Варіант А. Якщо в офлайн-сесії багато чеків (рекомендований):
-
Уважно прочитайте текст помилки — система часто вказує, який саме документ викликав збій (наприклад, "Помилка обробки документа за № 45 в пакеті").
-
Зверніться до технічної підтримки Торгсофт. Фахівці підключаться, точно визначать проблемний чек та за допомогою спеціальних команд або запитів видалять лише його і ті чеки, що були створені після нього.
-
Це дозволить врятувати попередні чеки (наприклад, перші 48), успішно відправити їх до податкової, і вам залишиться перепровести лише 1-2 проблемні документи.
Варіант Б. Якщо в офлайн-сесії всього 1–3 чеки (і ви готові їх перепровести самостійно):
-
Перейдіть у меню: Налаштування → Програмний РРО → Аналітика за програмним РРО.
-
Знайдіть документи зі статусом офлайн/помилкою (застряглі).
-
Натисніть Видалити офлайн-пакет. Важливо: це прибирає лише технічну спробу відправки чеків до ДПС, самі продажі з бази Торгсофт не видаляються.
-
Виконайте сервісну команду Встановити стан “Онлайн” (за потреби — спочатку встановіть стан “Готовий”).
-
Після переходу в онлайн перепроведіть видалені з черги чеки через пРРО.
Якщо в тексті помилки система показує, що «для ПРРО заборонено роботу в режимі офлайн» — причина у налаштуваннях реєстрації самого пРРО в кабінеті ДПС (при реєстрації не було встановлено дозвіл на офлайн-режим). У такому разі чеки, створені без звʼязку, сервер не прийме взагалі. Доведеться прибрати їх із черги відправки, подати форму №1-ПРРО зі змінами (дозволити офлайн) та перепровести продажі в онлайні за регламентом вашого обліку.
Крок 4. Синхронізувати (дозавантажити) чеки з сервера ДПС
Після очищення/відновлення онлайн-статусу потрібно вирівняти розбіжності між локальною базою та ДПС.
-
Налаштування → Програмний РРО → Завантаження чеків із сервера.
-
Вкажіть діапазон локальних номерів (зазвичай програма пропонує його автоматично).
-
Натисніть Завантажити.
-
Перевірте, що підтягнулися фіскальні дані до відповідних документів. Якщо локальний документ видалено — чек може відобразитись як “нерозпізнаний”.
Крок 5. Перепровести чеки, яких немає на сервері ДПС
Якщо після завантаження видно, що частина реалізацій без ознаки фіскалізації:
-
Переконайтесь, що пРРО онлайн (
). -
Знайдіть реалізації без фіскального номера та виконайте повторну фіскалізацію (наприклад, Друк чека / “Фіскалізувати” у потрібному місці інтерфейсу).
-
Якщо була безготівкова оплата — перед повторним друком перевірте, щоб не було повторного списання з термінала (за потреби тимчасово вимкніть зв’язок із терміналом на час друку).
Як перевірити, що пРРО знову працює онлайн
-
Індикатор пРРО зелений (онлайн).
-
В “Аналітиці за програмним РРО” немає застряглих офлайн-документів/помилок.
-
Нові чеки фіскалізуються та отримують фіскальні реквізити (QR/номер).
Як не допустити повторного зависання
-
Майте резервний інтернет-канал.
-
Не допускайте “накопичення” офлайн-черги: перевіряйте стан пРРО регулярно.
Висновок
-
502/404 → зазвичай проблема доступності ДПС: не видаляйте пакет одразу, повторіть синхронізацію пізніше.
-
11 InvalidQueryParameter → примусово поставте стан “Готовий”, потім повторіть синхронізацію.
-
10 PackageValidationError → видалити офлайн-пакет → поставити “Онлайн” → завантажити чеки з сервера → перепровести ті, що не зареєстровані.
-
05.03.2026
Посадова інструкція касира з використання Програмного РРО (пРРО) в системі Торгсофт
Інструкція касира з пРРО у Торгсофт: перевірка обладнання, фіскалізація продажів і повернень, офлайн-ліміти, Z-звіт
-
01.03.2026
Що таке РРО, касовий апарат, фіскальний реєстратор і пРРО
Що таке РРО, фіскальний реєстратор і пРРО, чим вони відрізняються та які варіанти фіскалізації підтримує Торгсофт.
-
09.02.2026
Як зробити товар фіскальним?
Програма обліку, пРРО і податкова: продаж фіскальних і нефіскальних товарів, як зробити товар фіскальним в програмі Торгсофт, акциз та ПДВ у фіскальному чеку









Повернутися до попереднього кроку