Як перевірити, чи сталася аварія KSeF?

Ви натискаєте Надіслати, але KSeF не відповідає. Перш ніж вважати це аварією системи, з'ясуйте, де виникла проблема: на стороні Міністерства фінансів Польщі, наприклад аварія, недоступність або технічні роботи, чи на вашій стороні, наприклад інтернет, сертифікат, повноваження або помилкові дані в XML FA(3). Від діагнозу залежить режим виставлення рахунків і строк їх передання.

Офіційними джерелами інформації є повідомлення Міністерства фінансів Польщі та публічне API статусу Latarnia KSeF. KSeFGPT надає публічний монітор на сторінці ksefgpt.pl/uk/status, який отримує дані безпосередньо з Latarnia KSeF і автоматично оновлює їх кожні 60 секунд.

Строк передання залежить від стану системи. Після оголошеної недоступності рахунок потрібно передати не пізніше наступного робочого дня відповідно до ст. 106nh польського закону про ПДВ. Після аварії є 7 робочих днів відповідно до ст. 106nf. Під час повної аварії рахунки згодом не передають до KSeF. Якщо звичайна проблема зі з'єднанням виникла на вашій стороні, застосовуйте offline24 відповідно до ст. 106nda.

Відкрийте монітор статусу KSeFGPT або перевірте публічне API Latarnia KSeF Міністерства фінансів Польщі. Якщо статус показує Аварія або Повна аварія, проблема виникла на стороні Міністерства. Якщо система має статус Доступний, перевірте своє інтернет-з'єднання, сертифікат і повноваження.

Швидку діагностику виконуйте в такій послідовності:

1. Перевірте публічний статус системи. Монітор KSeFGPT на сторінці /uk/status показує поточний стан продукційної системи KSeF на основі даних Міністерства.

2. Перевірте технічні повідомлення Міністерства. Там публікують інформацію про технічні роботи, недоступність та аварії.

3. Переконайтеся, що проблема не на вашій стороні. Перевірте інтернет-з'єднання, чинність сертифіката, повноваження на виставлення рахунків-фактур і правильність даних XML.

Це найважливіше розмежування під час діагностики. Аварія на стороні Міністерства фінансів одночасно стосується всіх платників податків: Latarnia KSeF показує аварію, з'являється технічне повідомлення, а помилки виникають незалежно від програми, з якої надсилають рахунки. Локальна проблема стосується лише вас: статус Міністерства показує Доступний, а інші користувачі передають рахунки без перешкод.

Не плутайте технічну помилку HTTP, наприклад тайм-аут або відповідь 5xx, із правовим статусом аварії. Один невдалий запит ще не є аварією KSeF у розумінні польського закону про ПДВ. Міністерство фінансів має офіційно оголосити аварію. Лише після цього застосовується офлайн-режим зі строком 7 робочих днів на передання.

У таблиці наведено найпоширеніші симптоми та вказано, де шукати їхню причину.

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

Поточний стан системи надає публічне API Latarnia KSeF Міністерства за адресою api-latarnia.ksef.mf.gov.pl. Це джерело використовують зовнішні монітори статусу, зокрема KSeFGPT. Загальні новини про систему Міністерство публікує в розділі KSeF News. З індивідуальних питань можна звернутися на інфолінію KSeF за номером +48 22 330 03 30.

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

KSeFGPT надає публічний монітор статусу KSeF на сторінці ksefgpt.pl/uk/status. Він показує один поточний стан продукційної системи KSeF й отримує дані безпосередньо з публічного API Latarnia KSeF Міністерства фінансів Польщі, не змінюючи й не затримуючи інформацію.

Сторінка автоматично оновлює статус кожні 60 секунд, має кнопку ручного оновлення й показує час останньої перевірки. Вона розрізняє чотири стани: Доступний, Планова перерва, Аварія та Повна аварія. Якщо дані отримати не вдалося, відображається невідомий статус. Під статусом наведено активні повідомлення Міністерства про аварії, планові технічні перерви та відновлення доступу.

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

Для користувача програми аварія зазвичай виглядає так: надсилання завершується помилкою або не закінчується, документ не отримує номера KSeF, а UPO, тобто офіційне підтвердження прийняття, не з'являється попри правильно підготовлений файл. Для інтегратора симптомами є тайм-аути з'єднання, відповіді 5xx від шлюзу KSeF і сесії, які не переходять у кінцевий стан.

Остерігайтеся хибних тривог. Статус рахунка 100, прийнято для подальшої обробки, і статус 150, триває обробка, є нормальними перехідними станами, а не ознаками аварії. Великі пакети документів можуть оброблятися певний час. Відсутність UPO також не завжди свідчить про проблему системи: документ може ще оброблятися або його могли відхилити з конкретним кодом помилки.

Перш ніж вважати ситуацію аварією, перевірте статус того самого рахунка й тієї самої сесії. Докладніше читайте у матеріалах Як перевірити статус рахунка в KSeF після надсилання та Немає UPO в KSeF. Якщо документ відхилено з кодом помилки, перейдіть до статті Рахунок відхилено KSeF.

Польські норми розрізняють кілька станів системи, і для кожного передбачено окремий порядок роботи та строк передання рахунків. Оголошену недоступність, зокрема технічні роботи, публікують заздалегідь у BIP MF. Аварія є незапланованою і оголошується в BIP MF та офіційних повідомленнях. Повна аварія є винятковим станом, про який оголошують у засобах масової інформації.

Для порівняння в таблиці також наведено offline24. Це не стан системи, а добровільний вибір платника податків, коли локальна проблема, наприклад відсутність інтернету, виникла на його стороні, а KSeF працює нормально.

Якщо статус і повідомлення Міністерства підтверджують аварію або недоступність, перейдіть в офлайн-режим. Ви й надалі готуєте структурований рахунок-фактуру: датою виставлення є дата з поля P_1 у файлі XML FA(3), а покупцеві передаєте візуалізацію з QR-кодами. Для правильного позначення документів в офлайн-режимі потрібен сертифікат KSeF. Отримайте його заздалегідь, а не подавайте заяву вже під час недоступності.

Ведіть простий список рахунків, виставлених під час аварії або недоступності, і контролюйте строк їх передання. Після повідомлення Міністерства про завершення аварії є 7 робочих днів відповідно до ст. 106nf польського закону про ПДВ. Після оголошеної недоступності рахунок потрібно передати не пізніше наступного робочого дня відповідно до ст. 106nh. Запізнення може мати наслідки за загальними нормами польського податкового кримінального законодавства, тому не сприймайте весь строк як запас часу.

Перш ніж повторно надіслати той самий рахунок під час проблем із системою, перевірте статус початкової сесії. Якщо перше надсилання все ж потрапило до KSeF, повторна спроба після відновлення сервісу завершиться помилкою дубліката 440 й ускладнить відстеження операції.

Якщо проблема на вашій стороні, а KSeF працює, відновіть з'єднання, сертифікат або повноваження й передайте рахунок онлайн. Якщо виправлення потребує більше часу, скористайтеся offline24 і передайте документ негайно, не пізніше наступного робочого дня після виставлення. Усі строки для онлайн-режиму, offline24, недоступності та аварії зібрано у статті Скільки часу є на передання рахунка до KSeF.

1. Проблему з власним інтернет-з'єднанням або сертифікатом вважають аварією Міністерства. Якщо статус показує Доступний і проблема стосується лише вас, ст. 106nf не застосовується.

2. Планову технічну перерву плутають з аварією. Про технічні роботи повідомляють заздалегідь, і строк передання після них інший: наступний робочий день відповідно до ст. 106nh замість 7 робочих днів після аварії відповідно до ст. 106nf.

3. Тривалий статус 100 або 150 сприймають як аварію. Це нормальні перехідні стани обробки. Контролюйте той самий рахунок замість повторного надсилання.

4. Відсутність UPO ототожнюють з аварією. Рахунок може ще оброблятися, його могли відхилити, або ви шукаєте підтвердження в іншій сесії чи неправильному контексті NIP.

5. Покладаються лише на соціальні мережі. Аварію у правовому розумінні визначають повідомлення Міністерства фінансів, а не кількість дописів користувачів про проблеми.

6. Повторно надсилають той самий рахунок під час аварії. Після відновлення системи є ризик отримати помилку дубліката 440. Спочатку перевірте початкову сесію.

Як перевірити, чи сталася аварія KSeF? - Перевірте публічний статус системи. Монітор на ksefgpt.pl/uk/status показує поточний стан продукційної системи KSeF на основі даних API Latarnia KSeF Міністерства фінансів Польщі. Підтвердження можна знайти в технічних повідомленнях на ksef.podatki.gov.pl. Якщо статус показує Аварія або Повна аварія, проблема виникла на стороні Міністерства.

Де Міністерство фінансів оголошує про аварію KSeF? - Міністерство фінансів Польщі оголошує про аварії KSeF у Бюлетені публічної інформації BIP MF та в офіційних повідомленнях, а технічну інформацію публікує в розділі технічних повідомлень на ksef.podatki.gov.pl. Статус системи також надає публічне API Latarnia KSeF. Про повну аварію додатково оголошують у засобах масової інформації.

Чим аварія відрізняється від планової технічної перерви? - Про планову недоступність повідомляють заздалегідь у BIP MF. Рахунок-фактуру потрібно передати не пізніше наступного робочого дня після її завершення відповідно до ст. 106nh польського закону про ПДВ. Аварія є незапланованою і оголошується офіційно. Після її завершення на передання рахунка є 7 робочих днів відповідно до ст. 106nf.

Скільки часу є на передання рахунка-фактури після аварії KSeF? - Рахунки-фактури, виставлені в офлайн-режимі під час аварії, потрібно передати до KSeF протягом 7 робочих днів після її завершення відповідно до ст. 106nf польського закону про ПДВ. Після оголошеної недоступності строк коротший: не пізніше наступного робочого дня відповідно до ст. 106nh.

Що робити, якщо KSeF не працює, але статус показує Доступний? - Тоді проблема, найімовірніше, на вашій стороні. Перевірте інтернет-з'єднання, чинність сертифіката, повноваження на виставлення рахунків-фактур і правильний контекст польського податкового номера NIP. Якщо відхилено лише один рахунок із кодом помилки, це помилка валідації, а не аварія. Перегляньте деталі відповіді. У разі проблеми зі з'єднанням можна скористатися режимом offline24.

Чи можна продовжувати виставляти рахунки-фактури під час аварії? - Так. Під час аварії, оголошеної Міністерством фінансів, структуровані рахунки-фактури виставляють в офлайн-режимі. Датою виставлення документа є дата з поля P_1, а покупцеві передають візуалізацію з QR-кодами. Після завершення аварії рахунки потрібно передати до KSeF протягом 7 робочих днів відповідно до ст. 106nf польського закону про ПДВ.

Що таке повна аварія KSeF? - Повна аварія є винятковим станом, про який Міністерство фінансів Польщі оголошує в засобах масової інформації. Поки вона триває, рахунки-фактури виставляють поза KSeF у паперовій або електронній формі й не передають до KSeF після відновлення системи. Це єдиний стан, за якого подальше передання не потрібне.

Коли KSeF перестає відповідати, дійте в незмінній послідовності: перевірте публічний статус системи, з'ясуйте, на чиїй стороні виникла проблема, виберіть правильний режим виставлення й передання, а потім дотримайтеся встановленого строку.

Ці чотири статті допоможуть на наступних етапах діагностики:

Як перевірити статус рахунка в KSeF після надсилання - що означають статуси 100, 150 і 200 та як читати статус сесії й документа.

Немає UPO в KSeF - повна діагностика ситуації, коли підтвердження не видно після надсилання.

Рахунок відхилено KSeF - як читати коди помилок і що виправити перед повторним надсиланням.

Скільки часу є на передання рахунка до KSeF - строки для онлайн-режиму, offline24, недоступності та аварії в одному місці.