Помилки KSeF: чому систему відхилила вашу фактуру і як це виправити
Натискаєте «відправити», а замість номера KSeF отримуєте повідомлення про відхилення. Або гірше — фактура проходить, але з неправильними даними, які вже не можна просто «скасувати». Це дві принципово різні проблеми, і виправляються вони по-різному.
Якщо ви ведете бізнес у Польщі — як JDG (jednoosobowa działalność gospodarcza, аналог ФОП) чи через spółkę — ставки зростають. KSeF (Krajowy System e-Faktur — національна система електронних фактур Польщі) став обов'язковим для великих платників з 1 лютого 2026 р., а для решти підприємців — з 1 квітня 2026 р. Перехідний період без штрафів закінчується 31 грудня 2026 р.: з 1 січня 2027 р. податкова може накладати грошові санкції за порушення, пов'язані з KSeF (biznes.gov.pl).
У цій статті розбираємо шість найчастіших помилок відправлення — від відхиленого XML до дубліката з кодом 440 — і показуємо, коли достатньо виправити файл і відправити повторно, а коли без коригувальної фактури не обійтися.
Правило №1: відхилений файл ≠ виставлена фактура
Перш ніж перейти до конкретних помилок, один принцип, який економить багато нервів: якщо KSeF відхилив файл, фактура юридично взагалі не була виставлена. Коригувальна фактура не потрібна — ви виправляєте дані й відправляєте документ ще раз. Це чиста «друга спроба».
Коригування (faktura korygująca) потрібне лише тоді, коли фактура пройшла валідацію, отримала номер KSeF, а помилка стосується змісту: не той покупець, не та сума, не та ставка VAT (польський ПДВ). Кнопки «скасувати» в KSeF немає — кожну прийняту фактуру з помилкою можна виправити тільки коригуванням.
Помилка 1: файл не відповідає схемі FA(3)
З 1 лютого 2026 р. діє логічна структура FA(3). KSeF не оцінює, як фактура виглядає — він перевіряє, чи XML відповідає схемі: чи заповнені всі обов'язкові поля, чи дати у форматі РРРР-ММ-ДД, чи NIP (польський податковий номер) записаний як 10 цифр без дефісів і префікса PL, чи все закодовано в UTF-8.
Типові причини відхилення:
відсутнє обов'язкове поле (наприклад, дата виставлення
P_1або дата продажуP_6),NIP у форматі
123-456-78-90замість1234567890,файл згенеровано за старою версією схеми (FA(2) замість FA(3)),
недопустимі символи або неправильне кодування в текстових полях.
Як виправити: прочитайте повідомлення про помилку. API KSeF 2.0 повертає конкретний код (exceptionCode) і опис у полі Details. Повний перелік кодів — у документації для інтеграторів на ksef.podatki.gov.pl та в офіційному репозиторії CIRFMF/ksef-docs. Виправте вказане поле і відправте повторно. Якщо ви користуєтеся програмою для фактурування (а не XML «вручну»), хороша система звалідує файл до відправлення — і до відхилення взагалі не дійде.
Помилка 2: дублікат фактури (код 440)
KSeF 2.0 вважає фактуру дублікатом, коли збігаються три параметри з уже наявною в системі фактурою: NIP продавця, тип фактури і номер фактури (поле P_2). Сума і покупець значення не мають. Унікальність перевіряється глобально, по всій системі — і контролюється протягом 10 років.
Найтиповіший сценарій: система не отримала підтвердження (тайм-аут, обрив з'єднання), користувач тисне «відправити» ще раз — а перше відправлення насправді дійшло.
Як виправити: перш ніж повторювати відправлення, перевірте статус першої сесії — можливо, фактура вже має номер KSeF. Якщо помилка 440 виникла через реально задубльовану нумерацію (наприклад, дві програми виставляють з однієї серії), змініть номер фактури і залиште одне джерело нумерації.
Помилка 3: дата виставлення з майбутнього
Дата в полі P_1, пізніша за момент відправлення файлу, — гарантоване відхилення. Зворотна ситуація легальна: якщо в P_1 стоїть дата, ранішa за день відправлення, KSeF приймає фактуру як виставлену в режимі offline24, і датою виставлення вважається дата з поля P_1.
Як виправити: виправте дату і відправте повторно. Якщо ви готуєте фактури наперед — притримайте відправлення до потрібного дня або налаштуйте систему так, щоб документи ставали в чергу.
Помилка 4: проблеми з авторизацією — токен, сертифікат, повноваження
Друга велика група помилок не стосується змісту фактури, а доступу: прострочений токен, недійсний сертифікат KSeF, відсутні повноваження виставляти фактури від імені суб'єкта. Для українських власників бізнесу в Польщі це особливо актуально: повноваження для spółki часто треба спершу заявити до податкової (наприклад, формою ZAW-FA), а бухгалтерська контора (biuro rachunkowe), що виставляє фактури як уповноважена особа, мусить мати явно надані права.
Як виправити: оновіть або згенеруйте новий токен/сертифікат і перевірте повноваження в модулі прав KSeF. Покрокову процедуру надання доступу публікує Міністерство фінансів Польщі на ksef.podatki.gov.pl. Важливо: документ, відправлений особою без повноважень, відхиляється — отже, фактури не існує. Після впорядкування доступу відправляєте її звичайним способом.
Помилка 5: фактуру прийнято — але зі змістовною помилкою
Тут починаються справжні проблеми, бо KSeF не перевіряє фактури по суті. Система не контролює, чи правильно порахований VAT, чи коректна ставка, чи NIP покупця належить фірмі, якій ви насправді продали. Файл, що відповідає схемі, пройде — разом з помилками — і ви все одно отримаєте номер KSeF.
Два найчастіші випадки з перших місяців обов'язкового KSeF:
Не той покупець — зазвичай після функції «клонувати фактуру», коли забули замінити контрагента. Єдиний шлях: коригувальна фактура «до нуля» плюс нова фактура з правильними даними. Якщо помітите помилку ще в місяці продажу — уникнете «подвійного» VAT.
Арифметична помилка або не та ставка VAT — виправляється звичайним коригуванням «плюс/мінус», без обнулення всієї фактури.
Системне рішення: перенесіть валідацію на етап до відправлення — перевірка NIP контрагента в офіційному реєстрі платників VAT (biała lista), контроль сум позицій, блокування відправлення при неповних даних. KSeF цього за вас не зробить.
Помилка 6: відсутність моніторингу статусів і недоступність системи
Відсутність повідомлення про відхилення не означає, що фактуру прийнято — інколи це означає лише те, що ваша система не отримала відповіді. Фактура без перевіреного статусу і без UPO (Urzędowe Poświadczenie Odbioru — офіційне підтвердження отримання) — це фактура «в підвішеному стані».
Окремий випадок — аварія чи технічна перерва на боці KSeF. Польські норми передбачають на цей випадок офлайн-режим та аварійний режим: фактуру виставляють поза системою і завантажують до KSeF після відновлення доступності, у встановлений законом строк.
Як виправити: моніторте статуси відправлень (бажано автоматично), завантажуйте UPO і стежте за повідомленнями Мінфіну про доступність системи. В інтеграціях через API варто мати механізм повторного відправлення з контролем дублікатів — див. помилку 2.
Чекліст: перш ніж натиснути «відправити до KSeF»
[ ] Файл згенеровано за актуальною схемою FA(3), не FA(2)
[ ] Усі NIP записані як 10 цифр — без дефісів і префікса
PL[ ] Дата виставлення (
P_1) не з майбутнього[ ] Номер фактури унікальний — одне джерело нумерації для всіх каналів виставлення
[ ] Дані покупця перевірені (особливо після клонування попередньої фактури)
[ ] Токен/сертифікат KSeF дійсний, повноваження надані й підтверджені
[ ] Після відправлення: статус перевірено, UPO завантажено — лише тоді питання закрите
Відправляйте правильно з першого разу
Більшість помилок KSeF діляться на дві категорії: технічні (виправив — відправив повторно) і змістовні (чекає коригування). І ті, й інші найкраще ловити до відправлення — бо з 1 січня 2027 р. помилки перестануть бути просто прикрими і почнуть коштувати грошей.
Biurko валідує кожну фактуру за схемою FA(3), перевіряє NIP контрагента, пильнує нумерацію та автоматично завантажує UPO — ще до того, як щось потрапить до KSeF. Інтерфейс доступний і зрозумілий для бізнесу, що працює в Польщі. Спробуйте Biurko безкоштовно 14 днів на biurko.io — і припиніть воювати з кодами помилок.
FAQ
Що робити, якщо KSeF відхилив фактуру?
Відхилена фактура юридично не була виставлена, тому коригування не потрібне. Прочитайте код помилки у відповіді системи, виправте вказані дані — найчастіше це схема FA(3), формат NIP, відсутнє поле або дата — і відправте документ повторно.
Що означає помилка 440 у KSeF?
Код 440 — це дублікат фактури. KSeF 2.0 визначає його за трьома полями: NIP продавця, тип фактури і номер фактури (P_2). Перевірте, чи перше відправлення вже не було прийняте і чи нумерація не дублюється між вашими програмами.
Чи можна скасувати фактуру, вже відправлену до KSeF?
Ні. Фактура, що отримала номер KSeF, вважається виставленою — її не можна ні скасувати, ні відредагувати. Будь-яку змістовну помилку (покупець, сума, ставка VAT) виправляють лише коригувальною фактурою, у крайньому разі — коригуванням «до нуля» і новою фактурою.
Чи перевіряє KSeF суми і ставки VAT?
Ні. KSeF валідує лише відповідність XML структурі FA(3), а також повноваження і дублікати. За суми, ставки й дані контрагента відповідає той, хто виставляє фактуру — тому змістовну перевірку варто мати у програмі для фактурування, до відправлення.
З якого моменту діють штрафи за помилки в KSeF?
Грошові санкції за порушення, пов'язані з KSeF, можуть накладатися з 1 січня 2027 р. До 31 грудня 2026 р. триває перехідний період без штрафів, але обов'язок виставляти фактури в системі діє вже з 1 лютого 2026 р. (великі платники) та з 1 квітня 2026 р. (решта).