Inline для API ЄВПЕЗ дозволяє касі продовжити роботу, коли ДПС або сервер ARM20 тимчасово недоступні: документ надійно зберігається, а після відновлення зв’язку окремий фоновий модуль звіряє стан і передає чергу у правильному порядку.
Як працює Inline у поточній версії
- Каса формує продаж, повернення або службовий документ.
- Документ із локальним номером і UUID атомарно зберігається в надійній черзі.
- Касир може продовжити роботу; довге підписання та мережеве надсилання не блокують інтерфейс.
- Окремий послідовний фоновий модуль перевіряє стан ПРРО й надсилає документи за локальним номером.
- Перед повтором документа з невизначеним результатом ARM20 звіряє фактичний стан ДПС, щоб не створити дублікат.
- Після повернення зв’язку черга передається автоматично. Звичайний online-режим цим модулем не змінюється.
1. Постійний автоматичний Inline
- Закрийте зміну й чергу.
- Склад → Сервіс → налаштування потрібного ПРРО → «Офлайн».
- Увімкніть «Автоматично переходити в inline при відсутності зв’язку з ДПС».
- Прочитайте попередження про один ПК і збережіть.
- Перезапустіть касу. Чекбокс «ПРРО INLINE» зникає, а замість нього з’являється кольорова точка.
Автоматичний режим доступний для API ЄВПЕЗ. Для Checkbox ця опція не застосовується.
2. Ручний Inline через касу
Якщо автоматичний режим у складі вимкнений, у головному вікні каси видно чекбокс «ПРРО INLINE». Увімкніть його перед роботою без зв’язку. Якщо налаштовано автоматичний режим, ручний чекбокс навмисно приховано.
3. Тимчасовий Inline під час автономної SQLite-роботи
Якщо каса повністю втрачає зв’язок із сервером ARM20 і переходить до локальної SQLite-бази, вона тимчасово вмикає Inline для фіскальних документів. Це захищає чеки, створені під час автономної роботи, і не змінює постійне налаштування автоматичного Inline.
- Чеки та команди спочатку зберігаються у локальній SQLite-черзі.
- Після відновлення зв’язку ARM20 переносить локальні дані на сервер.
- Потім послідовно передає чергу ПРРО до ДПС.
- Тимчасовий режим завершується лише після підтвердження обох черг; каса повертається до налаштованого режиму.
Індикатор і обмеження
| Колір | Значення | Що робити |
|---|---|---|
| Зелений | ПРРО online, черга порожня. | Працюйте звичайно. |
| Жовтий | Перевіряється зв’язок або передаються накопичені документи; нові чеки тимчасово йдуть у Inline. | Не закривайте касу, дочекайтеся завершення. |
| Червоний | ДПС недоступна або черга потребує перевірки; чеки зберігаються в Inline. | Перевірте мережу, чергу й помилки. |
У режимі Inline функції, для яких потрібна негайна відповідь ДПС, можуть бути тимчасово недоступні. Каса показує окреме повідомлення; не повторюйте таку команду багато разів і не перемикайте ПРРО на інший ПК.
Як ARM20 відновлює чергу
Автоматичне виправлення виконується лише тоді, коли відповідь ДПС однозначна. Якщо стан не підтверджено, документ залишається у черзі, Inline не вимикається, а каса просить повторити перевірку або звернутися до підтримки.
| Ситуація | Безпечна дія ARM20 |
|---|---|
| Розбіжність наступного номера або попереднього хешу | Звіряє актуальний номер ПРРО, атомарно перенумеровує залежний хвіст і продовжує відправлення. |
| Відкриття/закриття зміни або інший службовий документ уже виконано в ДПС | Виключає лише підтверджений зайвий документ і перенумеровує залежні документи. |
| Службовий документ не виконано, але виник конфлікт послідовності | Зберігає сам документ, перебудовує його номер разом із чергою та повторює відправлення. |
| Z-звіт має невизначений результат | Перевіряє стан зміни та наявність Z у ДПС. Уже прийнятий Z не надсилається вдруге; неприйнятий Z за відкритої зміни може бути відновлено за фактичними підсумками ДПС. |
| ДПС не повернула підтверджений стан | Нічого не видаляє і не перенумеровує; залишає документ для наступної безпечної перевірки. |
Тимчасові помилки запиту статусу повторюються обмежено, а довгі періоди зміни читаються безпечними діапазонами. Це зменшує хибні помилки, але не скасовує правило: невідомий результат не можна «продавлювати» повторними командами.
Кожне автоматичне відновлення фіксується у журналі:
- старий і новий локальний/фіскальний номери;
- тип документа і причина;
- покоління перенумерації;
- результат відправлення.
Керування чергою
| Команда | Призначення |
|---|---|
| Черга документів | Очікуючі, помилкові та відправлені документи. |
| Помилки відправки | Причини неприйняття за період. |
| Відправити всі документи | Ручний запуск послідовної відправки. |
| Провести помилкові | Повторна обробка виправлених/безпечних помилок. |
| Журнал ПРРО | Період, події, пошук і деталі. |
| Вимкнути інлайн | Попередній план, повна відправка та вимкнення ручного й автоматичного режимів. |
Як безпечно вийти з Inline
- Натисніть «Вимкнути інлайн» у головному вікні або вікні ПРРО.
- Перевірте план: кількість продажів, повернень і службових документів, загальну суму та прогноз перенумерації.
- Натисніть «Надіслати та вимкнути».
- Дочекайтеся лічильника «надіслано N із M». Велика черга обробляється частинами і не впирається у старий ліміт вибірки.
- Якщо лишилася неоднозначна помилка, Inline не вимикається. Відкрийте помилки й журнал; не видаляйте документ без підтвердженої причини.
- Після успіху обидві ознаки — автоматична в налаштуваннях і ручна в касі — вимкнені; наступний запуск буде online.
Перехід на інший ПК
- На старому ПК відправте всю чергу.
- Натисніть «Вимкнути інлайн» і переконайтеся в успіху.
- Створіть Z-звіт/закрийте зміну за вашим сценарієм.
- Лише після цього налаштуйте ПРРО на новому ПК.
Перед Z-звітом
- індикатор зелений;
- очікуючих і невідомих документів немає;
- помилки відправки пояснені;
- ревізія всієї зміни виконана;
- Z-звіт формується з фактичної черги, а його стан підтверджено ДПС.