KSeF 2026 и интернет-магазин: как подготовить интеграцию

KSeF становится обязательным в Польше в 2026 году, и владельцы интернет-магазинов начинают паниковать: сломается ли их WooCommerce, Shopify или самописный магазин под новые правила. Я делаю интернет-магазины и интеграции, поэтому объясню KSeF с точки зрения разработчика - и так, чтобы это было понятно русскоязычному предпринимателю в Польше. Кого касается, с какой даты, что реально меняется в коде магазина и как подключить систему, чтобы счета уходили сами, а не переписывались бухгалтером вручную.

Что такое KSeF и кого он касается в 2026

KSeF (Krajowy System e-Faktur, Национальная система электронных счетов) - это центральная платформа Министерства финансов Польши. Счета попадают туда как структурированный XML по схеме FA(3), а не как PDF. Счет юридически "появляется" только после того, как KSeF его принял и присвоил номер KSeF.

Сроки по закону такие:

• 1 февраля 2026 - обязанность для крупнейших налогоплательщиков с продажами выше 200 млн зл за 2024 год.
• 1 апреля 2026 - обязанность для всех остальных плательщиков VAT, то есть для подавляющего большинства магазинов.
• Административные штрафы (до 100% суммы VAT по ошибочному счету) включаются только с 1 января 2027, так что есть окно, чтобы спокойно внедрить и протестировать.

Важная деталь: получать счета через KSeF фактически должны почти все уже с февраля, даже если выставлять самому нужно только с апреля. Если вы закупаете товар у поставщиков по счету, эти входящие счета все равно будут лежать в KSeF.

B2B, B2C и продажи за границу - это не одно и то же

Здесь больше всего путаницы, потому что KSeF охватывает не все продажи одинаково.

• B2B (бизнесу) - ядро KSeF. Каждый счет для клиента с польским NIP идет через API как FA(3). Тут интеграция обязательна.
• B2C (частное лицо) - физлицо без фирмы не имеет учетки в KSeF. Такие счета выставляются вне системы, а продажа все равно идет через фискальную кассу. Магазин должен понимать, указал ли покупатель NIP, и направлять документ по правильному пути.
• Продажи за границу, OSS/IOSS - продажи потребителям в другие страны ЕС по процедуре OSS/IOSS живут по своим правилам и не попадают в KSeF как внутренний B2B.

Для разработчика это означает одно: в логике магазина нужна развилка. Поле NIP в корзине, валидация и решение "этот счет идет в KSeF, а тот нет". Без этого магазин либо отправит в KSeF то, что не должен, либо пропустит счет, который обязан был отправить.

Что это значит технически для Shopify, WooCommerce и самописа

Сам магазин не "разговаривает" с KSeF одной кнопкой. Нужен мост: слой, который берет данные заказа, собирает корректный XML FA(3), авторизуется в API KSeF (токеном или сертификатом/печатью), отправляет счет, получает номер KSeF и сохраняет его рядом с заказом.

• WooCommerce - больше всего свободы. Подключаю интеграцию через плагин или собственный модуль, который слушает оплаченный заказ и запускает отправку в KSeF. Сюда можно встроить любую логику B2B/B2C.
• Shopify - тут обычно все идет через приложение, связывающее Shopify с польской системой выставления счетов или бухгалтерией, у которой уже есть официальная интеграция с KSeF. Shopify ничего не знает о польских счетах, поэтому фактурование выносится наружу.
• Самописный магазин (Next.js, headless) - пишу интеграцию прямо к API KSeF или через сервис-фактуровню с API. Полный контроль над тем, когда счет уходит, как выглядит XML и что делать, если KSeF вернул ошибку.

Чаще всего разумнее не генерировать XML "с нуля" внутри магазина, а связать магазин с системой выставления счетов или бухгалтерией, у которой уже есть сертифицированная интеграция с KSeF, а магазин только передает данные заказа. Меньше риска, что изменение схемы FA(3) со стороны Минфина положит магазин.

Как идет внедрение у меня и сколько стоит

Обычно делаю это в несколько шагов: аудит продаж (доля B2B против B2C, есть ли OSS/IOSS), выбор пути (прямое API или через фактуровню), подключение генерации FA(3), авторизация в KSeF, обработка ответа и номера KSeF, плюс тесты на предпродакшн-среде Минфина до того, как что-то уйдет в боевой режим.

Ориентировочные цены:

• Интеграция магазина с KSeF на базе готовой фактуровни с API - от 1500-2500 €, в зависимости от числа случаев (B2B, B2C, заграница, корректировки).
• Самописный магазин с прямым API KSeF и собственной логикой - от 4000 €.
• Сам новый интернет-магазин под ключ - от 2500 € (Shopify/Woo), headless от 4000 €, а интеграцию KSeF добавляю модулем.

Бесплатную фиксированную оценку даю за 24 часа. Подробнее о создании магазина - в услуге интернет-магазина.

Частые ошибки, которых стоит избегать

• Считать KSeF генератором PDF. Это не красивая распечатка, а структурированный XML, который Минфин валидирует. Неверная структура - счет отклонен.
• Нет обработки ошибок API. KSeF иногда не отвечает или возвращает ошибку. Если у магазина нет очереди повторных попыток и логов, счета тихо "пропадают" и никто не замечает до конца месяца.
• Игнорировать дату выставления. Номер KSeF присваивается в момент приема документа, и это влияет на то, когда счет формально выставлен. Это нужно аккуратно сопоставить с датой продажи.
• Делать все по-старому вручную. Раз уж все равно надо лезть в код, лучше сразу связать KSeF с бухгалтерией, чтобы данные шли автоматически, а не через выгрузку в Excel.

Если у вас магазин и непонятно, попадаете ли вы под обязанность с апреля 2026 и как технически подключить KSeF, напишите - разберу ваш случай и предложу самый простой путь интеграции. Оставьте заявку на странице контактов, оценка за 24 часа.

FAQ

С какой даты KSeF обязателен для моего магазина? Для крупнейших фирм (продажи выше 200 млн зл за 2024) с 1 февраля 2026, для всех остальных плательщиков VAT с 1 апреля 2026. Административные штрафы включаются только с 1 января 2027, так что время на внедрение и тесты есть. Получать счета через KSeF фактически должны почти все уже с февраля.

Касается ли KSeF продаж частным лицам (B2C)? Не так, как B2B. Частное лицо без фирмы не имеет учетки в KSeF, поэтому счета B2C выставляются вне системы, а продажа все равно идет через фискальную кассу. Магазин должен понимать, указал ли покупатель NIP, и направлять документ соответственно. Продажи OSS/IOSS в другие страны ЕС тоже считаются отдельно.

Как технически подключить KSeF к WooCommerce или Shopify? В WooCommerce через плагин или собственный модуль, который слушает оплаченный заказ, собирает XML FA(3) и отправляет в API KSeF. В Shopify обычно через приложение, связывающее магазин с польской системой выставления счетов, у которой уже есть интеграция с KSeF. В самописном магазине пишу интеграцию прямо к API или через сервис-фактуровню с API.

Сколько стоит интеграция магазина с KSeF? На базе готовой фактуровни с API - от 1500-2500 € в зависимости от числа случаев (B2B, B2C, заграница, корректировки). Самописный магазин с прямым API KSeF и своей логикой - от 4000 €. Оценка бесплатно за 24 часа.

Нужно ли мне самому генерировать XML FA(3)? Вручную делать не нужно. Чаще всего лучше связать магазин с системой выставления счетов или бухгалтерией с сертифицированной интеграцией KSeF, которая сама формирует корректный XML, а магазин только передает данные заказа. Это снижает риск, что изменение схемы FA(3) со стороны Минфина сломает фактурование.