Майже всі демо програм для фактур закінчуються рівно там, де починається складне: на гарній формі й кнопці «Wystaw». Те, від чого залежить, чи фактура взагалі існує з погляду польської податкової — прийом на шлюзі, номер KSeF, UPO (urzędowe poświadczenie odbioru — офіційне підтвердження отримання) — лишається за кадром.
Тому я записав весь шлях без монтажу, з таймером у кутку екрана: реєстрація, дані фірми з реєстру, підключення KSeF, контрагент, позиція, виставлення, відправка, номер, UPO. Сім хвилин із копійками.
Питання не теоретичне. З 1 квітня 2026 року обов'язок виставляти фактури в KSeF (Krajowy System e-Faktur — національна система е-фактур) стосується практично кожного чинного платника VAT, а захисний період завершується 31 грудня 2026 року: за даними Міністерства фінансів, у період 1.02.2026–31.12.2026 штрафи за невиконання обов'язків KSeF не накладаються, а санкційні норми (ст. 106ni закону про VAT) починають діяти з 1 січня 2027 року. Тобто на спокійне тренування лишилося кілька тижнів.
Нижче — таймкоди, транскрипт і чесний перелік того, чого в записі немає.
Що саме показує запис
Один дубль, одна фірма, одна фактура. Таймер не зупинявся жодного разу.
Таймкод Крок Що відбувається 0:00 Реєстрація Пошта, пароль, підтвердження. Без картки. 0:35 Фірма за NIP Вводжу NIP — назва, адреса, правова форма і статус VAT приходять із реєстру GUS 1:20 Підключення KSeF Вибір середовища (тест/продакшн), автентифікація, надання повноважень 3:05 Контрагент Знову NIP; поряд — перевірка статусу в реєстрі платників VAT 3:50 Позиція фактури Назва послуги, нетто, ставка 23%, позначка GTU 4:40 Виставлення Номер із шаблону нумерації, перевірка XML за схемою FA(3) 5:25 Відправка до KSeF Відкривається сесія, документ іде на шлюз, статус processing 6:10 Номер KSeF Повертається 35-значний номер — фактуру виставлено 6:40 UPO Завантаження офіційного підтвердження у файл 7:05 Візуалізація PDF із кодом перевірки, лист клієнту
Найважливіше тут — пропорції. Власне «виписати фактуру» (контрагент, позиція, сума) займає менш ніж дві хвилини. Усе інше — разове налаштування фірми й KSeF, яке більше не повторюється.
Умови запису — чого там немає
Запис зроблено на тестовому середовищі KSeF (api-test.ksef.mf.gov.pl), на фірмі, створеній для демо. Із цього випливають три речі, які варто сказати прямо:
Надання повноважень не завжди миттєве. Якщо у вашій фірмі ще ніхто не має повноважень у KSeF, перше надання йде через заяву ZAW-FA до податкової — це окремий, адміністративний шлях. У демо фірма повноваження вже мала; інакше таймер показував би дні, а не хвилини.
Фактури із вкладенням потребують окремої згоди податкової адміністрації; на продакшні відповідь може йти до трьох робочих днів. У записі фактура без вкладення.
Тестовий шлюз буває швидшим за продакшн. У бойовому середовищі очікування між відправкою і номером KSeF може бути на десятки секунд довшим, особливо ближче до 25 числа.
Отже, сім хвилин — це час роботи в програмі, а не час залагодження формальностей із урядом. Якщо у вашій фірмі ще немає нікого з повноваженнями в KSeF, починайте з ZAW-FA; решта справді займає стільки, скільки показує таймер.
Транскрипт (скорочено, з таймкодами)
0:00 — «Починаємо з порожньої скриньки. Акаунт створюю на адресу, якої система ніколи не бачила, щоб не було сумнівів, ніби щось підготовлено заздалегідь».
0:35 — «Я не вводжу назву фірми й адресу. Я вводжу NIP. Дані приходять із реєстру GUS. Статус VAT перевіряється окремо, у переліку платників. Якщо щось не збігається з реальністю — розійшовся реєстр, а не форма».
1:20 — «Тепер єдиний крок, який вимагає уваги: підключення KSeF. Обираю середовище — тут тестове. На продакшні цей вибір фактично незворотний у тому сенсі, що надіслані туди документи є фактурами в правовому обігу. Автентифікую фірму, і з цієї миті Biurko діє як уповноважений суб'єкт: надсилає й отримує документи від її імені, у межах наданого повноваження».
3:05 — «Контрагент — знову NIP, знову реєстр. Поряд видно статус у переліку платників VAT, перевірений на сьогодні. Це не прикраса: у випадку фактури поза KSeF саме покупець мав би перевіряти, чи документ виставлено правильно».
3:50 — «Одна позиція: послуги з розробки, 4 200 zł нетто, ставка 23%, GTU_12. Позначку GTU програма підказує, але рішення — за платником: програма не знає вашого PKWiU краще за вас».
4:40 — «Виставляю. Документ отримує номер із шаблону нумерації й перевіряється за схемою FA(3). Якщо XML не проходить перевірку, ви дізнаєтесь про це тут, а не від шлюзу».
5:25 — «Відправка. Відкривається сесія, документ іде до KSeF, статус processing. Це єдиний момент, коли доводиться чекати».
6:10 — «Є номер:
6343060594-20260917-0A1B2C3D4E5F-7C
Тридцять п'ять знаків: NIP продавця, дата, ідентифікатор документа, контрольна сума. Фактуру виставлено саме з цієї миті — а не з моменту, коли я натиснув кнопку».
6:40 — «UPO. Завантажую файл і лишаю його в документах фірми. Це доказ надсилання, який неможливо відтворити з PDF».
7:05 — «Наостанок візуалізація — PDF із кодом перевірки — і лист клієнту. PDF не є фактурою. Це зображення фактури, яка живе в KSeF».
Три місця, де цей процес ламається
1. Немає повноважень у KSeF. Найчастіша причина скарги «інтеграція не працює». Програма не може надати собі доступ — це робить платник зі свого боку, а якщо первинних повноважень немає ні в кого, шлях починається із ZAW-FA.
2. Відмова за схемою. Фактура, правильна «по-людськи», може бути невалідною щодо FA(3): бракує обов'язкового вузла, невірна комбінація ставки й підстави звільнення, іноземний контрагент без належного ідентифікатора. Саме тому перевірка перед відправкою має сенс — код помилки зі шлюзу пояснює менше, ніж повідомлення біля поля.
3. Ставлення до PDF як до фактури. Від моменту, коли на фірму поширився обов'язок, надісланий поштою PDF — це візуалізація, а не фактура. А з 1 січня 2027 року номер KSeF має бути в призначенні платежу між чинними платниками VAT — що неможливо, якщо номера ніхто не отримав.
Чекліст: повторіть це на власному NIP
Перевірте, чи має хтось у вашій фірмі повноваження в KSeF. Якщо ні — подайте ZAW-FA, перш ніж щось налаштовувати.
Спершу тестове середовище. Виставте три документи: звичайну фактуру, korektę і zaliczkową.
Переконайтеся, що отримуєте і номер KSeF, і UPO — і що знайдете їх через два тижні.
Перевірте шаблон нумерації на січень: безперервність нумерації — ваш обов'язок, не програми.
Перейдіть на продакшн і виставте першу справжню фактуру до кінця захисного періоду, а не в січні.
Визначте, що робите під час збою шлюзу (режим offline24), і відрепетируйте це один раз, спокійно.
Підсумок
Сім хвилин — це не маркетингова обіцянка, а міра однієї речі: скільки триває шлях від нуля до документа, що має номер KSeF і UPO. Усе інше — корекції, авансові фактури, імпорт закупівельних документів, реєстри VAT — починається вже за цією точкою, але без неї не починається нічого.
Якщо хочете пройти той самий шлях на власному NIP: створіть акаунт на biurko.io — 14 днів безкоштовно, з тестовим середовищем KSeF від першої хвилини. Запис і повний транскрипт — під статтею.
3. FAQ
Скільки насправді триває виставлення першої фактури в KSeF? Близько семи хвилин роботи в програмі, з яких п'ять — разове налаштування фірми й підключення до KSeF. Наступні фактури займають менш ніж хвилину. Адміністративний час (отримання повноважень через ZAW-FA) рахується окремо, у днях.
Що таке номер KSeF і звідки він береться? Це 35-значний ідентифікатор, який система присвоює після прийняття документа; містить NIP продавця, дату й контрольну суму. Самостійно його не присвоюють — він повертається зі шлюзу після відправки. З 1 січня 2027 року його треба вказувати в призначенні платежу між чинними платниками VAT.
Чи потрібне UPO, якщо вже є номер KSeF? Так. Номер ідентифікує фактуру, а UPO засвідчує сам факт і момент надсилання. Це два різні докази, і тримати варто обидва, попри те що оригінал фактури зберігає KSeF.
Чи можна протестувати KSeF без ризику? Так — тестове середовище Міністерства фінансів відокремлене від бойового, і виставлені там документи не мають податкових наслідків. До того ж до 31 грудня 2026 року триває перехідний період без адміністративних штрафів.
Чи достатньо надіслати клієнту PDF? Він не замінює фактуру. Після поширення обов'язку документом є структурована фактура в KSeF, а PDF — її візуалізація, яку надсилають для зручності отримувача, а не замість е-фактури.