Тестовий KSeF і Demo (KSeF testowy): як потренуватися без ризику
Коротко: тестовий KSeF (KSeF testowy) це безкоштовне середовище Міністерства фінансів, де фактури не мають юридичних наслідків. Для тренування є два середовища: тестове, де ви входите вигаданими даними на будь-який NIP, і передвиробниче Demo, де входите справжніми даними, але фактури все одно заповнюєте вигаданими. Сертифікати і права з робочого KSeF там не діють, тому для тестів генеруєте окремі.
Тестове, Demo і робоче середовище: відмінності
MF відкрило три публічні середовища KSeF 2.0. Кожне має власну Aplikacja Podatnika і власне API.
| Тестове (TE) | Передвиробниче (Demo) | Робоче (produkcja) | |
|---|---|---|---|
| Aplikacja Podatnika | ap-test.ksef.mf.gov.pl | ap-demo.ksef.mf.gov.pl | ap.ksef.mf.gov.pl |
| API | api-test.ksef.mf.gov.pl | api-demo.ksef.mf.gov.pl | api.ksef.mf.gov.pl |
| Вхід | вигадані дані, будь-який NIP („uwierzytelnienie testowe”) | справжні дані (наприклад, Profil Zaufany), що збігаються з реєстрами | справжні дані |
| Дані у фактурах | лише вигадані | лише вигадані | справжні |
| Юридичні наслідки | немає | немає | фактура в юридичному обігу |
| Ліміти запитів API | за замовчуванням у 10 разів вищі, ніж у робочому | як у робочому | робочі |
| Дані видаляються | періодично | періодично | ні, архів 10 років |
Джерела: сторінки тестової і передвиробничої версій Aplikacja Podatnika KSeF 2.0 і документація API KSeF 2.0 („Środowiska”, „Limity żądań API”). MF пояснює різницю так: у тестовій версії можлива симуляція облікових даних, тобто вхід у контексті будь-якого NIP, а в Demo вхід працює як у робочому середовищі (FAQ MF, категорія „Zagadnienia techniczne”, пит. 7).
У тестових середовищах щодня з 16:00 до 18:00 можуть тривати сервісні роботи, тож не плануйте тести на цей час.
Яке середовище обрати
- Тестове, якщо хочете побачити, як працює KSeF, потренувати виставлення фактур і коригування або перевірити інтеграцію без жодних формальностей. Profil Zaufany і права не потрібні.
- Demo, якщо хочете пройти весь шлях як у робочому KSeF: вхід через login.gov.pl (наприклад, Profil Zaufany) у контексті NIP фірми, генерування сертифіката, надання прав бухгалтерці. Це добра генеральна репетиція перед першою справжньою фактурою.
Як виглядає вхід у робочому KSeF, пояснюємо в статті як увійти в KSeF.
Тестовий NIP і вхід
У тестовому середовищі оберіть в Aplikacja Podatnika „Zaloguj uwierzytelnieniem testowym”, впишіть контекст, тобто NIP, від імені якого хочете діяти, і натисніть „Uwierzytelnij do aplikacji testowej”. Застосунок сам підпише запит тестовим сертифікатом. Profil Zaufany у тестовому середовищі не працює (Instrukcja uwierzytelnienia w Aplikacji Podatnika KSeF 2.0, wersja testowa, розд. 1.1-1.2).
Який NIP вписати? Вигаданий. Три правила:
- Не використовуйте дані справжньої фірми, зокрема своєї. MF нагадує, що в тестовому середовищі не слід вводити реальні дані (FAQ MF, „Zagadnienia techniczne”, пит. 6).
- Обережно з випадковими NIP. Якщо випадковий NIP належить реальній фірмі, вона потенційно має доступ до даних такої фактури (те саме пит. 6). Вписуйте у фактури вигадані назви, адреси і суми.
- Середовище спільне. У TE багато інтеграторів можуть увійти в контексті тієї самої фірми, тож дані не ізольовані (документація API KSeF 2.0, „Środowiska”).
У Demo ви входите справжніми даними, тому NIP ваш, але зміст фактур усе одно має бути вигаданим.
Тестовий сертифікат і токен
Сертифікати і права з робочого KSeF у тестових середовищах не працюють, і навпаки. MF пише, що дії в передвиробничій версії не впливають на права і сертифікати в робочій, а робочі недоступні в Demo. Тому:
- Увійдіть в Aplikacja Podatnika обраного середовища (тестового або Demo).
- Згенеруйте сертифікат KSeF так само, як у робочому: „Wnioskuj o certyfikat”, назва, пароль, призначення „Uwierzytelnienie w systemie KSeF”, завантаження файлу. Детальні кроки в статті сертифікат KSeF.
- Або згенеруйте токен у меню „Generuj token”, див. токен KSeF.
- Завантажте сертифікат або токен у програму, налаштовану на те саме середовище.
Найчастіша помилка: сертифікат із Demo в програмі, яка з'єднується з робочим KSeF (або навпаки). З'єднання не вийде, бо кожне середовище має свої сертифікати.
Що перевірити в магазині
Пройдіть сценарії, які справді трапляються у вашому магазині:
- Звичайне замовлення з NIP, оплачене карткою: фактура йде в KSeF, повертається номер KSeF, PDF має QR-код із номером.
- Кілька ставок VAT в одному замовленні, наприклад 23% і 8%, плюс доставка.
- Знижка і промокод: чи збігаються суми у фактурі із замовленням до гроша.
- Замовлення в євро: суми у валюті, VAT у злотих, курс і дата курсу у фактурі.
- Повернення частини товару: фактура-коригування (faktura korygująca) з посиланням на номер KSeF первинної фактури.
- Повне повернення: коригування до нуля.
- Неправильний NIP: як магазин реагує до виставлення фактури і як виглядає коригування до нуля.
- Дубль номера фактури: KSeF відхиляє другий файл із тим самим номером у того самого продавця.
- Замовлення приватної особи: чи магазин не виставляє фактуру в KSeF там, де не повинен.
- QR-код: відскануйте його телефоном і перевірте, чи відкривається фактура в тестовому середовищі (адреси qr-test.ksef.mf.gov.pl або qr-demo.ksef.mf.gov.pl).
- Права: у Demo надайте бухгалтерці перегляд фактур і перевірте, чи вона їх бачить.
Якщо фактуру відхилено, прочитайте код помилки і виправте дані. Типові причини розбираємо в статті помилка у фактурі KSeF.
Чого тест не покаже
- Юридичних і податкових наслідків. Тестова фактура не є фактурою. На ній не перевірити, чи правильно ви обрали ставку VAT або курс валюти. Це досі завдання для księgowej.
- Перевірки NIP. Контрольна сума NIP продавця і покупця перевіряється лише в робочому середовищі (документація API KSeF 2.0, „Weryfikacja faktury”). Фактура з помилковим NIP може пройти тест, а в робочому KSeF бути відхиленою.
- Навантаження. У TE ліміти запитів за замовчуванням удесятеро вищі. Великому магазину варто перевірити надсилання в Demo, де ліміти як у робочому.
- Справжнього покупця. Клієнт не побачить тестову фактуру у своєму KSeF.
- Сталості даних. Дані тестової версії і Demo періодично видаляються, тож це не архів.
Перехід у робочий KSeF
- У робочому середовищі (ap.ksef.mf.gov.pl) згенеруйте новий сертифікат KSeF або токен. Тестові файли видаліть із програми.
- Перемкніть програму або застосунок магазину на робоче середовище.
- Приберіть тестові налаштування: вигаданий NIP продавця, тестові серії нумерації.
- Виставте першу справжню фактуру і перевірте в Aplikacja Podatnika, що вона є в KSeF із номером.
- Відтепер кожна фактура, як попереджає MF, вводиться в юридичний обіг. Помилку виправляють уже коригуванням.
Наш застосунок KSeF Faktury для Shopify ми тестуємо в тестовому середовищі KSeF 2.0 MF. Якщо хочете виставити першу фактуру вручну, див. як виставити фактуру в KSeF.
Питання і відповіді
Чи дійсна фактура, виставлена в тестовому KSeF?
Ні. Фактури в тестовій і передвиробничій версіях не мають юридичних наслідків (FAQ MF, „Zagadnienia techniczne”, пит. 6 і 7).
Чи платний тестовий KSeF?
Ні. Тестова і передвиробнича версії Aplikacja Podatnika безкоштовні, як і робоча.
Чи можна увійти в тестовий KSeF через Profil Zaufany?
Ні. У тестовому середовищі входять через тестову автентифікацію. Profil Zaufany працює в Demo і в робочому KSeF.
Я згенерував сертифікат у Demo. Чи спрацює він у справжньому KSeF?
Ні. Сертифікати і права з Demo діють лише в Demo. У робочому середовищі генеруєте нові.
Джерела
- Aplikacja Podatnika KSeF 2.0: wersja testowa, MF
- Aplikacja Podatnika KSeF 2.0: wersja przedprodukcyjna (Demo), MF
- Instrukcja uwierzytelnienia w Aplikacji Podatnika KSeF 2.0, wersja testowa, MF, listopad 2025, розд. 1.1-1.2
- Pytania i odpowiedzi KSeF 2.0: категорія „Zagadnienia techniczne”, пит. 6 і 7
- Dokumentacja API KSeF 2.0, MF: „Środowiska”, „Limity żądań API”, „Weryfikacja faktury”, „Kody QR”
- Podręcznik KSeF 2.0, cz. I (06.08.2026), крок 7 „Testowanie KSeF 2.0”
- Aplikacja Podatnika KSeF 2.0, MF
Правовий стан на 19 жовтня 2026 р.
Стаття має загальний інформаційний характер і не є податковою консультацією.