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 часов в рабочие дни. Форма на польском, но заполнить её можно на любом языке.