П'ятниця, 16:40. Ви виставляєте останню фактуру тижня, і шлюз KSeF перестає відповідати. Фактура дійсна з моменту виставлення, клієнт її отримає, але годинник уже цокає: згідно зі ст. 106nda ustawy o VAT документ із режиму offline24 передається до KSeF невідкладно, щонайпізніше наступного робочого дня.
На практиці це означає понеділок до 23:59. Якщо тільки Міністерство фінансів не оголосить збій і термін не зсунеться. Якщо тільки понеділок не святковий. Якщо тільки ви просто не забудете, бо в понеділок вранці одна п'ятнична фактура точно не перше, про що ви думаєте.
З 1 січня 2027 року за таке запізнення передбачена адміністративна санкція. Ця стаття пояснює, чому стежити за офлайн-чергою не повинна людина, і як Biurko знімає це завдання.
Термін починається не тоді, коли ви про нього згадали
Особливі режими KSeF мають різні годинники. Саме звідси більшість помилок: в інтерфейсі вони виглядають однаково, а в ustawie o VAT це три окремі норми.
Режим Коли Термін надсилання до KSeF Підстава offline24 проблема на вашому боці (немає інтернету, KSeF відповідає надто повільно) невідкладно, щонайпізніше наступного робочого дня після дня виставлення ст. 106nda offline (недоступність) MF оголошує недоступність у BIP (бюлетень публічної інформації) щонайпізніше наступного робочого дня після завершення недоступності ст. 106nh awaryjny (аварійний) MF оголошує аварію в BIP 7 робочих днів від завершення аварії ст. 106nf повна аварія повідомлення в засобах масової інформації фактури до KSeF не надсилаються ст. 106nf ч. 4
Дві речі варто запам'ятати. По-перше, "offline24" не означає 24 астрономічні години. Фактура, виставлена в п'ятницю ввечері, має термін до кінця понеділка, а якщо понеділок вихідний, то наступного робочого дня. По-друге, при недоступності й аварії термін відлічується від завершення перерви, оголошеного MF, а не від дати виставлення фактури. Якщо перерва тривала три дні й ви виставили за цей час 60 фактур, у всіх 60 буде один спільний дедлайн.
Людина погано рахує такі терміни. Планувальник завдань рахує їх ідеально.
Biurko помічає збій раніше за вас
Застосунок не чекає, поки ви натиснете "надіслати" й побачите помилку. Кожен виклик до шлюзу KSeF відстежується. Коли за короткий проміжок часу накопичується серія невдалих відповідей, Biurko переводить це середовище в стан недоступності.
Поріг навмисно поблажливий. Одна помилка 5xx не може перемкнути всю фірму в офлайн, бо шлюз KSeF цілком здатен віддати випадковий таймаут і за секунду працювати нормально. Сигналом є лише повторюваність.
Виявлення працює окремо для кожного середовища. Збій продакшену не зупиняє тести, а проблеми на demo не блокують реальні фактури. Звучить як технічна дрібниця, поки ви не ведете бухгалтерське бюро з п'ятнадцятьма фірмами в одній панелі, де одна заблокована сесія не має паралізувати решту.
Окремо оброблюється rate limiting. KSeF уміє повернути заголовок Retry-After зі значенням у тисячах секунд, що фактично заморозило б ваш екран виставлення фактур на добрих пів години, хоча шлюз оживає за кілька хвилин. Biurko обрізає це очікування до розумного максимуму й пробує знову.
Офлайн-фактура є повноцінним документом із першої секунди
Перехід в офлайн не означає, що фактура "чекає". Вона виставлена, має дату з поля P_1 структури FA(3), і клієнт може отримати її негайно.
У цей момент Biurko генерує:
XML у структурі FA(3) з позначенням режиму, у якому фактура виникла,
офлайн-код, обчислений із канонічної форми XML, унікальний для цього документа,
QR-код із позначкою OFFLINE, що веде до перевірки фактури в базі KSeF,
QR-код із сертифіката KSeF типу 2, який підтверджує особу виставника,
PDF із видимим офлайн-блоком і терміном відправки.
Це рівно той набір, якого вимагає MF при передачі фактури покупцеві поза KSeF. Іноземний контрагент, споживач або суб'єкт без NIP (польський податковий номер) отримує документ, який може перевірити ще до того, як KSeF присвоїть йому номер.
Після повернення KSeF черга рушає сама
Ось суть. Коли середовище знову справне, Biurko циклічно переглядає передачі, що чекають в офлайн-режимі, і випускає їх на відправку.
Механізм стежить за чотирма речами:
Лише своє середовище. Передача з продакшену не піде, доки не повернеться саме продакшен. Записи з інших середовищ ідуть далі своїм шляхом.
Нуль дублікатів. Кожна передача захоплюється під блокуванням рядка й позначається міткою часу. Навіть якщо черга завантажена й розгрібає накопичене, та сама фактура не полетить до KSeF двічі.
Термін. Записи, у яких законний термін минув, не проштовхуються тихо у фоні. Вони спливають як питання, яке вирішуєте ви, а не як щось заметене під килим.
Оригінальне позначення. Фактура, дoвідправлена після відновлення системи, і далі несе той офлайн-код, з яким пішла до клієнта. Той самий документ, той самий QR-код, доданий номер KSeF.
Після успішної відправки Biurko забирає UPO (офіційне підтвердження прийняття фактури системою KSeF) і надсилає сповіщення. Якщо KSeF відхилить фактуру, ви отримаєте помилку, перекладену людською мовою, а не сирий код із документації API.
Чого Biurko за вас не зробить
Чесно, бо цю частину більшість постачальників оминає.
Сертифікат KSeF типу 2 треба мати заздалегідь. Без нього неможливо згенерувати другий QR-код, а офлайн-фактура без цього коду не відповідає вимогам при передачі покупцеві поза KSeF. Сертифікат отримуєте в Aplikacji Podatnika KSeF 2.0 або через API, він дійсний 2 роки. Оформіть його до того, як він знадобиться.
Повна аварія це інша процедура. Її оголошує міністр фінансів у ЗМІ, і фактури з цього періоду до KSeF не досилаються. Автоматика тут не допоможе, бо надсилати нічого.
Коригувальна фактура потребує номера KSeF оригіналу. Якщо первинна фактура ще висить в офлайн-черзі, спершу вона має отримати номер, і тільки потім виставляється корекція. Biurko стежить за черговістю, але не обійде норму закону.
Автоматика не виправить хибних даних. Якщо NIP покупця недійсний, фактура повернеться з відмовою незалежно від того, хто і коли її надіслав.
Сценарій із життя
Марта веде невелике бухгалтерське бюро під Катовіце, обслуговує 23 фірми. У четвер о 15:20 шлюз KSeF починає віддавати таймаути. Марта цього не помічає, бо саме розмовляє з клієнтом.
Biurko бачить серію помилок і переводить продакшен в офлайн-режим. Наступні 14 фактур, виставлених того дня, отримують офлайн-коди та QR-коди й ідуть клієнтам поштою у вигляді PDF. У панелі з'являється банер із кількістю документів у черзі та терміном.
О 18:05 KSeF повертається. Марта вже вдома. Черга рушає сама, фактури отримують номери KSeF, до кожного документа підв'язується UPO. У п'ятницю вранці Марта бачить у панелі 14 зелених статусів і одне сповіщення: одна фактура відхилена, причина в неактивному NIP контрагента. Вона виправляє один документ замість того, щоб пильнувати чотирнадцять.
Чекліст: що зробити, поки KSeF ще працює
Отримайте сертифікат KSeF типу 2 і перевірте термін його дії. Без нього офлайн-фактури неможливі.
Перевірте, чи ваша система сама виявляє недоступність, чи чекає, поки ви натиснете "надіслати" й побачите помилку.
Домовтеся з контрагентами про канал передачі офлайн-фактур, щоб не було суперечок про дату отримання.
Переконайтеся, що PDF-візуалізація містить обидва QR-коди, а не лише один.
Перевірте, чи довідправка після відновлення системи автоматична і чи є захист від подвійного надсилання тієї самої фактури.
Запам'ятайте різницю: offline24 та оголошена недоступність це наступний робочий день, аварія це 7 робочих днів.
Увімкніть сповіщення про постановку фактури в офлайн-чергу та про відмову з боку KSeF.
Підсумок
Офлайн-режими не є преміум-функцією чи екзотикою для просунутих. Це звичайна частина роботи із системою, яка інколи не відповідає. Питання лише в тому, чи після збою ви сідаєте зі списком фактур і відмічаєте їх вручну, рахуючи робочі дні, чи просто бачите, що все пішло.
Biurko ставиться до офлайн-черги як до інфраструктури, а не як до вашого завдання. Виявляє, ставить у чергу, відправляє, забирає UPO і озивається лише тоді, коли справді потрібна людина.
Створіть акаунт у Biurko і протестуйте режим offline24 у тестовому середовищі, поки вас не перевірив продакшен. 14 днів безкоштовно, без картки.
FAQ
Скільки часу є на надсилання фактури до KSeF у режимі offline24? Невідкладно, щонайпізніше наступного робочого дня після дня виставлення (ст. 106nda ustawy o VAT). "24" в назві не означає 24 астрономічні години. Фактура з п'ятниці має термін до кінця понеділка, якщо понеділок робочий.
Чи може програма сама надіслати фактуру після повернення KSeF? Так, і саме так має бути. Biurko циклічно перевіряє доступність шлюзу й випускає фактури з черги автоматично, окремо для кожного середовища, з блокуванням від подвійної відправки.
Що робити, якщо під час терміну offline24 MF оголосить аварію? Тоді застосовується термін аварійного режиму: 7 робочих днів від завершення аварії. Оголошення публікуються в BIP Міністерства фінансів і передаються через інтерфейсне програмне забезпечення KSeF.
Чи потрібен сертифікат KSeF для офлайн-режиму? Так. Сертифікат KSeF типу 2 генерує QR-код, що підтверджує особу виставника. Без нього ви не передасте покупцеві офлайн-фактуру відповідно до вимог MF. Отримується в Aplikacji Podatnika KSeF 2.0 або через API, дійсний 2 роки.
Що загрожує за порушення терміну довідправки? Адміністративні санкції зі ст. 106ni ustawy o VAT діють від 1 січня 2027 року. До того часу триває перехідний період, але обов'язок надіслати фактуру існує незалежно від санкцій. Деталі: podatki.gov.pl.
Внутрішні посилання для підстановки: [SLUG-SERTYFIKAT-KSEF-TYP-2], [SLUG-QR-KODY-KSEF], [SLUG-TERMINY-KSEF-2026], [SLUG-PANEL-BUHGALTERSKOHO-BIURA]