Помилки ПРРО: що означають коди ДПС і що робити

Опубліковано

Коли програмна каса надсилає чек, сервер податкової або приймає його, або відповідає помилкою. Помилка приходить у такому вигляді: «Код помилки: 5 ShiftNotOpened» і пояснення українською. Кодів усього 13, і всі вони описані в офіційній документації ДПС. Нижче кожен простими словами і що з ним робити.

Якщо податкова відповіла помилкою, чек не зареєстровано. Виправте причину й пробийте чек ще раз.

Схема: каса надсилає чек, сервер ДПС приймає його й дає фіскальний номер або повертає код помилки, і тоді чек не зареєстровано; приклади кодів — 2 немає доступу, 5 зміну не відкрито, 9 помилка в чеку, 12 проблема з ключем

Помилки зміни

4. Зміну для ПРРО наразі відкрито. Каса намагається відкрити зміну, яка вже відкрита. Часто зміну відкрили на іншому пристрої чи іншою програмою. Якщо її відкрив інший касир, працювати не вийде, доки він її не закриє. Закрийте зміну там, де її відкрили, або продовжуйте в ній.

5. Зміну для ПРРО наразі не відкрито. Чек пробивають без відкритої зміни. Відкрийте зміну й пробийте чек знову.

6. Останній документ, зареєстрований перед закриттям зміни, повинен бути Z-звітом. Зміну намагаються закрити без Z-звіту. Спершу зробіть Z-звіт, потім закривайте зміну.

8. Z-звіт наразі зареєстрований для поточної зміни. Z-звіт за цю зміну вже є. Другий не потрібен: закрийте зміну.

Помилки доступу й реєстрації

1. ПРРО не зареєстрований. Цієї каси немає в реєстрі податкової. Буває, що реєстрацію ще не завершено, у налаштуваннях вказано не той фіскальний номер або реєстрацію скасовано. Податкова скасовує її автоматично, зокрема коли ФОП припинив діяльність або точку продажу повідомлено як закриту (Порядок № 317, розд. III п. 3). Перевірте стан каси в Електронному кабінеті.

2. Відсутній доступ до ПРРО для користувача. Ключ, яким підписують чек, не дозволений для цієї каси. Працювати на ПРРО можуть лише люди, чиї ключі внесено до реєстру через повідомлення за формою № 5-ПРРО (ДПС, запитання № 10, 37). Новий касир чи новий ключ без такого повідомлення дає саме цю помилку. Подайте 5-ПРРО в Електронному кабінеті.

3. В документі зазначено реєстраційний код платника, що не дорівнює реєстраційному коду господарської одиниці. Чек підписали ключем одного підприємця, а каса зареєстрована на іншого. Це трапляється, коли в магазині кілька ФОП і ключі переплутали. Перевірте, що ключ належить тому ФОП, на якого зареєстровано ПРРО.

12. Помилка криптографічних функцій. Проблема з підписом: ключ пошкоджений, сертифікат прострочений або не той. Підписувати документи можна лише чинним сертифікатом (ДПС, запитання № 14). Програма каси має попереджати про кінець строку ключа щонайменше за тиждень (Порядок № 317, розд. V п. 3). Перевірте строк дії ключа й за потреби отримайте новий.

Помилки в самому чеку

9. Помилка валідації документа. Податкова знайшла помилку в даних чека. Після коду завжди йде пояснення, і саме воно підкаже причину. Ось два справжні тексти, які наш двигун ПРРО отримав від податкової у жовтні 2026:

Літера 'Д'. В рядку зазначено ставку податку/збору '0.00', що не відповідає значенню із попередніх документів '20.00'

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

Не визначений фіскальний номер документа, для якого здійснюється повернення

Чек повернення має посилатися на чек продажу. Без його номера податкова повернення не прийме.

7. Некоректний локальний номер чека. Каса нумерує чеки по порядку, і податкова звіряє цей номер. Помилка буває, коли тим самим ПРРО користуються з двох пристроїв або програму перевстановили і вона «забула» нумерацію. Дані між пристроями самі не синхронізуються (ДПС, запитання № 48). Не працюйте одним ПРРО з двох пристроїв одночасно й зверніться до постачальника каси.

Інші помилки

10. Помилка валідації пакета офлайн-документів. Чеки, пробиті без інтернету, податкова приймає пакетом і перевіряє цілим. Наприклад, вона звіряє Z-звіт із сумою чеків. Справжня відповідь, яку ми отримали під час перевірки двигуна:

Підсумки реалізації. Розрахована загальна сума без заокруглення 12.57 не дорівнює сумі в документі 287.77

Таку помилку касир сам не виправить: це робота постачальника каси. Як працює офлайн, читайте в статті «Каса без інтернету».

11. Некоректний параметр запиту. Програма запитала в податкової щось у неправильному вигляді. Наприклад, на запит звіту за кілька місяців податкова відповідає: «Запит дозволяється в межах одного місяця». Розбийте запит на частини або зверніться до постачальника.

13. Запитані дані відсутні. Податкова не має того, що запитали: наприклад, чека чи звіту за цей номер. Сама по собі це не збій.

Коли податкова блокує касу

Сервер податкової блокує ПРРО у двох випадках (опис API ДПС, розділ «Блокування роботи ПРРО»):

  • каса перевищила 36 годин офлайну поспіль або 168 годин за місяць. Блокування знімається з початком нового періоду;
  • подано повідомлення за формою № 2-ПРРО з позначкою «несправність».

Як це в PosPLUS

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

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

Спробуйте 30 днів безкоштовно.

Джерела:

Матеріал довідковий. Стан на 21.10.2026.

Читайте також