Интеграция с KSeF: магазин, CRM и система фирмы через API

Интеграция с KSeF: фактура из магазина или CRM попадает в систему сама

Если фактуры создаются в вашем интернет-магазине, CRM или системе заказов, эта система должна уметь общаться с KSeF, польской государственной системой электронных фактур. Я подключаю её к API KSeF так, чтобы никто не перепечатывал фактуры вручную, а сбой на стороне Министерства финансов не останавливал продажи.

НАПРЯМУЮ

API KSeF 2.0

ИСТОЧНИК ФАКТУР

Магазин / CRM

СРЕДЫ МИНФИНА

Тест → прод

Нужна ли вам интеграция с KSeF?

KSeF (Krajowy System e-Faktur) обязателен для крупных фирм с 1 февраля 2026 года, для остальных с 1 апреля 2026 года, а для самых маленьких (продажи по фактурам до 10 тыс. zł в месяц) с 1 января 2027 года, согласно графику Министерства финансов. Нужна ли вам интеграция, зависит от того, где создаются ваши фактуры:

Бухгалтерская программа или интеграция?

	Хватит бухгалтерской программы	Нужна интеграция
Где создаётся фактура	В программе (wFirma, inFakt, Fakturownia…)	В магазине, CRM, системе заказов
Сколько фактур	Несколько или несколько десятков в месяц, вручную	Десятки и сотни, автоматически
Что вы делаете	Включаете KSeF в программе	Я подключаю вашу систему к API KSeF или к программе

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

KSeF в интернет-магазине

Самый частый случай: магазин на WooCommerce, Shopify, PrestaShop, продажи через Allegro и BaseLinker или магазин на заказ, который после оплаты заказа должен выставить фактуру. Путей два:

Магазин → бухгалтерская программа → KSeF. Магазин передаёт данные заказа в программу с готовой интеграцией KSeF. Меньше кода, но вы зависите от того, что программа умеет принять.
Магазин → API KSeF напрямую. Магазин сам собирает электронную фактуру в структуре FA(3), отправляет её и сохраняет номер KSeF в заказе. Полный контроль и журнал каждой отправки.

Какой путь выбрать, зависит от вашей бухгалтерии, числа каналов продаж и того, выставляете ли вы фактуры частным покупателям. Это я определяю в самом начале, вместе с вашим бухгалтером.

Безопасная интеграция с KSeF: где ловушки

Отправить фактуру это самая маленькая часть работы. Спокойно ли работает интеграция, решают пограничные случаи:

Что должна уметь хорошая интеграция

1
Права и токены
Безопасное хранение доступов, никогда в коде или в таблице.
2
Сопоставление данных
Покупатель, позиции, ставки VAT, оплата, валюты: всё правильно в структуре электронной фактуры.
3
Корректировки и авансы
Корректирующие (faktura korygująca), авансовые и итоговые фактуры, а не только обычная продажа.
4
KSeF недоступен
Очередь, повторная отправка, аварийный режим: продажи не встают, когда система не отвечает.
5
Отказы и журнал
Уведомление, если фактура не прошла проверку, и полная история отправок.

Каждую интеграцию я сначала проверяю на тестовой среде Министерства финансов и только потом переключаю на рабочую. Подробнее о всём процессе в статье интеграция с KSeF шаг за шагом (на польском).

Как я работаю

Короткое описание фактур

Где создаются, сколько их, какие виды (корректировки, авансы, частные покупатели).

Выбор пути

Напрямую через API KSeF или через бухгалтерскую программу, с конкретной ценой.

Разработка и тесты

Интеграция на тестовой среде Минфина, проверка на настоящих случаях.

Запуск и мониторинг

Переключение, контроль первых отправок, передача документации.

Частые вопросы

›Сколько стоит интеграция с KSeF?

Зависит от того, сколько мест в фирме выставляют фактуры и каких видов. Подключить один магазин к бухгалтерской программе обычно небольшой модуль; прямая интеграция с API с корректировками и загрузкой входящих фактур это отдельный проект. Цену называю после короткого описания ваших фактур.

›Можно ли подключить WooCommerce и Shopify к KSeF?

Да. В обоих случаях можно передавать заказы в бухгалтерскую программу с KSeF или отправлять фактуры напрямую. Для Shopify обычно удобнее путь через программу (подробности и цена: KSeF в Shopify), для WooCommerce и магазинов на заказ возможны оба.

›Что будет, если KSeF не работает?

Правила предусматривают аварийный и офлайн-режимы. Хорошая интеграция складывает фактуры в очередь и отправляет их, когда система вернётся, а магазин продаёт как обычно.

›Можно ли загружать и входящие фактуры?

Да. Интеграция может автоматически забирать из KSeF фактуры от поставщиков и передавать их в бухгалтерию или привязывать к проектам и заказам.

›У меня уже есть программа с KSeF. Этого хватит?

Если все фактуры вы выставляете в ней, скорее всего, да. Интеграция имеет смысл, когда фактуры создаются вне программы и сегодня кто-то перепечатывает их вручную.