Інтеграція з 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. Цього вистачить?

Якщо всі фактури ви виставляєте в ній, найімовірніше, так. Інтеграція має сенс, коли фактури створюються поза програмою і сьогодні хтось передруковує їх вручну.

Розкажіть, чого хочете
досягти

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