Три середовища — три окремі світи
У KSeF працюють три повністю окремі середовища. Кожне має власні адреси, власні дані й власне призначення. Це ключове: фактура, надіслана в одне середовище, не з'явиться в інших. Коротко:
Тестове (TE) — для перевірки технічної інтеграції та зв'язку з API.
Демо / передпродакшн (TR) — для тренування реальних сценаріїв без податкових наслідків.
Продакшн (PRD) — сюди потрапляють справжні фактури, з повними наслідками.
Кожне середовище має також окремий Aplikacja Podatnika (безкоштовний «застосунок платника» Міністерства фінансів для виставлення й отримання фактур). Це часте джерело плутанини: ви заходите в один застосунок, а фактуру надіслали в іншому середовищі — тож її там просто немає.
Тестове середовище — пісочниця для інтеграторів
Тестове середовище (позначається як TE) призначене переважно для програмістів і постачальників ПЗ. Воно служить для перевірки зв'язку з API, валідації структури фактури FA(3), обробки помилок і всієї технічної частини системи.
Фактури, надіслані сюди, не мають жодних податкових чи правових наслідків — і, що важливо, мають містити лише вигадані дані (Aplikacja Podatnika KSeF 2.0 — тестова версія, Мінфін).
Тестове API KSeF 2.0 запрацювало 30 вересня 2025 р., а тестова версія Aplikacja Podatnika — 3 листопада 2025 р. (Відкриті тести API KSeF 2.0, gov.pl). Якщо ви будуєте власну інтеграцію або хочете перевірити новий технічний сценарій — це місце для вас.
Для звичайної фірми чи бухгалтерського бюро тестове середовище рідко є правильним вибором. Щоб навчитися самого процесу, краще підходить демо.
Демо — тут тренується більшість фірм і бюро
Демо (передпродакшн, позначається як TR) — це середовище, яке на практиці цікавить більшість фірм і бухгалтерських бюро. Воно поводиться майже ідентично до продакшну, але без наслідків. Тут можна спокійно потренувати:
виставлення фактур і присвоєння їм номера KSeF,
корекції та авансові фактури,
отримання видаткових фактур від контрагентів,
завантаження UPO (Urzędowe Poświadczenie Odbioru, офіційне підтвердження прийняття) для однієї фактури або пакета.
Дані вигадані, тож ви нічого не зіпсуєте. Саме демо сьогодні найчастіше використовують для підготовки перед запуском у продакшні.
Одна практична заувага: демо буває повільнішим і має жорсткіші ліміти запитів, ніж продакшн — особливо під час масового імпорту чи багатьох паралельних операцій. Це нормально; демо не масштабоване так, як продакшн-система. Якщо щось «крутиться» довше, ніж зазвичай, не панікуйте й не надсилайте ту саму фактуру п'ять разів.
Продакшн — тут усе по-справжньому
Продакшн (PRD) працює на справжніх даних вашої фірми та контрагентів. Кожен документ, надісланий сюди, — це офіційна е-фактура в KSeF, із повними податковими наслідками. Момент присвоєння номера KSeF — це водночас момент виставлення й доставлення фактури; «відкотити» її пізніше не вийде.
З 1 лютого 2026 р. продакшн доступний лише за новими адресами. Старі адреси всіх середовищ було вимкнено 17 січня 2026 р., без подальших перенаправлень (Повідомлення Мінфіну про зміну адрес середовищ KSeF).
До 31 грудня 2026 р. триває перехідний період — за формальні помилки в KSeF поки що не загрожують адміністративні штрафи. Але з 1 січня 2027 р. набирають чинності санкції за ст. 106ni закону про ПДВ: штраф до 100% суми ПДВ із фактури, виставленої поза KSeF (а для фактур без ПДВ — до 18,7% загальної суми) (Правила дії KSeF, ksef.podatki.gov.pl; правова основа: закон від 5 серпня 2025 р., Dz.U. 2025 poz. 1203). У продакшні немає місця для «тестових» фактур — це не полігон.
«Не бачу своїх фактур» — найчастіша помилка
Якщо ви виставили фактуру й не бачите її в Aplikacja Podatnika, причина майже завжди банальна: ви перевіряєте не те середовище. Фактура з демо не з'явиться в продакшні й навпаки. Кожне середовище має окремий застосунок, окремі дозволи й окремі сертифікати.
Друга часта помилка — звичка. Після тижнів тренувань у демо легко забути перемкнутися на продакшн у день «справжнього» старту — або навпаки, надіслати вигадану фактуру в продакшн. Тому хороша програма для фактурування має чітко показувати, у якому середовищі ви зараз працюєте.
Актуальні адреси всіх середовищ (станом на 2026 р., за Міністерством фінансів):
Середовище API Aplikacja Podatnika Візуалізація QR-кодів Тестове (TE) api-test.ksef.mf.gov.pl ap-test.ksef.mf.gov.pl qr-test.ksef.mf.gov.pl Демо / передпродакшн (TR) api-demo.ksef.mf.gov.pl ap-demo.ksef.mf.gov.pl qr-demo.ksef.mf.gov.pl Продакшн (PRD) api.ksef.mf.gov.pl ap.ksef.mf.gov.pl qr.ksef.mf.gov.pl
Зверніть увагу на дрібницю, яка рятує від помилки: продакшн не має префікса в адресі (api., ap.), а середовища для тренувань мають (api-test., ap-demo. тощо).
Як тренуватися в KSeF і не наробити безладу — чекліст
Для навчання обирайте демо (TR), а не продакшн. Тестове (TE) залиште інтеграторам.
У демо й тесті використовуйте лише вигадані дані — назви, NIP (польський податковий номер), суми.
Перш ніж надіслати продакшн-фактуру, перевірте, у якому ви середовищі. Одного погляду достатньо.
Не шукайте фактури з демо в продакшн-застосунку Aplikacja Podatnika — це два різні світи.
Після 17 січня 2026 р. користуйтеся лише новими адресами (
*.ksef.mf.gov.pl); старі не працюють.Використайте перехідний період до кінця 2026 р. на спокійне навчання команди — з 2027 р. помилки можуть коштувати грошей.
Підсумок
Три середовища KSeF — це не ускладнення, а запобіжник: тестове для інтеграції, демо для тренувань, продакшн для справжніх фактур. Уся хитрість у тому, щоб завжди знати, де ви. У Biurko це видно одразу — ми чітко показуємо активне середовище, а з демо на продакшн ви переходите без зміни способу виставлення фактур. Спершу пройдіть увесь процес на вигаданих даних, а потім запускайтеся в продакшні без нервів. Спробуйте Biurko безкоштовно протягом 14 днів і перевірте свій потік фактур, перш ніж це стане «по-справжньому».
FAQ
Чим відрізняється тестове середовище від демо в KSeF? Тестове середовище (TE) призначене переважно для інтеграторів — для перевірки зв'язку з API та структури фактури. Демо (TR) — для тренування реальних сценаріїв (виставлення, корекції, отримання документів) в умовах, близьких до продакшну. Обидва працюють на вигаданих даних і не мають податкових наслідків.
Чи мають податкові наслідки фактури, виставлені в демо? Ні. Фактури в демо й тестовому середовищі не мають жодних податкових чи правових наслідків. Вони існують лише для навчання й тестів, тому мають містити вигадані дані. Податкові наслідки мають тільки фактури, надіслані в продакшн.
Чому я не бачу своїх фактур у KSeF? Найчастіша причина — перевірка не того середовища. Фактура, надіслана в демо, не з'явиться в продакшн-застосунку Aplikacja Podatnika й навпаки. Переконайтеся, що заходите в застосунок правильного середовища і що ваша програма надіслала фактуру туди, куди потрібно.
Які актуальні адреси середовищ KSeF? З 17 січня 2026 р. діє єдина адресація: продакшн — api.ksef.mf.gov.pl (Aplikacja Podatnika: ap.ksef.mf.gov.pl), демо — api-demo.ksef.mf.gov.pl, тестове — api-test.ksef.mf.gov.pl. Старі адреси було вимкнено без перенаправлень.
Чи можна тренуватися в KSeF на справжніх даних фірми? У тестовому й демо-середовищі використовуйте лише вигадані дані — це вимога Міністерства фінансів. Зі справжніми даними ви працюєте лише в продакшні, де кожна фактура є офіційним документом із повними податковими наслідками.