SiteFlow
Усі статті українською
KSEF3 листопада 2026 р. · 3 min

Ця стаття також: Polski · Русский

Фактура в KSeF: зразок, візуалізація і QR-код. Як виглядає фактура поза системою

Фактура в KSeF це файл XML, а не графічний бланк. Як виглядає її візуалізація, що містить QR-код і коли під ним стоїть номер KSeF, а коли напис OFFLINE.

На питання «де взяти зразок фактури KSeF» коротка відповідь: графічного зразка немає. Фактура в KSeF це файл XML за структурою FA(3), а те, як вона виглядає на екрані чи на папері, залежить від програми. Натомість правила визначають, що обов'язково має бути на візуалізації, якщо ви передаєте фактуру поза KSeF: QR-код, а під ним номер KSeF або напис OFFLINE.

Зразок фактури KSeF: структура замість шаблону

Міністерство фінансів Польщі публікує структуру FA(3), тобто перелік полів і правил, з яких складається файл фактури. Це і є «зразок», лише для програми, а не для людини. Детально структуру описано в статті про структуровану фактуру FA(3) (польською). Програма, в якій ви виставляєте фактуру, складає з цих полів зрозумілий документ: PDF, перегляд у браузері або роздруківку. Кожна програма робить це по-своєму.

Коли потрібна візуалізація з QR-кодом

  • Покупець не має доступу до KSeF: наприклад, іноземна фірма або приватна особа (konsument).
  • Ви надсилаєте фактуру електронною поштою в PDF або кладете роздруківку в посилку.
  • Фактуру виставлено в режимі offline, і вона ще не отримала номер KSeF.

QR-код дозволяє будь-кому перевірити, що фактура є в KSeF і що її ніхто не змінював, а також завантажити її файл XML без звернення до продавця.

Що містить QR-код на фактурі KSeF

QR-код (KOD I) це посилання на сервіс перевірки Міністерства фінансів. Воно складається з адреси сервісу, NIP продавця, дати виставлення з поля P_1 у форматі ДД-ММ-РРРР і хешу SHA-256 файлу фактури в кодуванні Base64URL. Через хеш зміна навіть одного знака у файлі дає інше посилання, тож підроблена фактура перевірку не пройде. Код генерує програма продавця локально, і він має відповідати стандарту ISO/IEC 18004:2024.

QR-код: фактура online і offline
Фактура onlineФактура offline
Скільки QR-кодівОдин (KOD I)Два (KOD I і KOD II)
Напис під KOD IНомер KSeF фактуриOFFLINE, поки немає номера KSeF
KOD IIНемаєПідтверджує продавця сертифікатом KSeF типу Offline

Деталь із документації: напис OFFLINE буває й на фактурі online, яка ще чекає номер KSeF, наприклад під час великого навантаження на систему. Зазвичай номер присвоюється одразу після надсилання. Режим offline описано в статті про offline24 (польською).

Що потрібно зробити інтернет-магазину

Фактура з магазину в часи KSeF
  1. 1

    Надсилання XML до KSeF

    Магазин або програма для фактур надсилає фактуру і чекає номер KSeF.

  2. 2

    PDF з QR-кодом

    Клієнт отримує електронною поштою візуалізацію з QR-кодом і номером KSeF під ним.

  3. 3

    Посилання в кабінеті клієнта

    Ту саму фактуру можна завантажити в акаунті клієнта, не шукаючи її в пошті.

Що має бути на зрозумілій візуалізації фактури

  • Усі дані з файлу XML у звичному вигляді фактури: продавець, покупець, позиції, ставки, суми, оплата.
  • QR-код такого розміру, щоб його можна було відсканувати телефоном з роздруківки, з номером KSeF або написом OFFLINE під ним.
  • Дата виставлення з поля P_1, а не дата створення PDF.
  • Для іноземного клієнта зрозумілі описи його мовою. Файл XML залишається польським, а візуалізація може бути двомовною.

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

Джерело: QR-коди в документації KSeF 2.0 (польською).

›Чи можна зробити власний дизайн фактури KSeF?

Так. Вигляд візуалізації залежить від програми. Обов'язковий QR-код із правильним написом, якщо ви передаєте фактуру поза KSeF.

›Чи можна замінити QR-код посиланням?

Якщо формат даних не дозволяє розмістити код на фактурі, документація вимагає передати його отримувачеві окремим графічним файлом або посиланням. У PDF і на роздруківці QR-код це стандарт.

›Звідки взяти номер KSeF для візуалізації?

KSeF присвоює його після прийняття фактури. З чого він складається, описано в статті про номер KSeF, а всю роботу на боці магазину я беру на себе в послузі інтеграція з KSeF (сторінка польською).

Потрібна інтеграція KSeF, сайт або магазин?

Пишіть будь-якою мовою (українською, російською, польською, англійською): відповім особисто протягом 24 годин у робочі дні. Форма польською, але заповнити її можна будь-якою мовою.