KSeF: што мусіць умець ваш сайт і крама

Што такое KSeF у адным абзацы

Krajowy System e-Faktur — дзяржаўная платформа, праз якую праходзяць фактуры. Дакумент больш не PDF, адпраўлены поштай, а структураваны XML: ён трапляе ў сістэму, атрымлівае там уласны нумар KSeF і пацвярджэнне прыёму (UPO). З гэтага моманту фактурай лічыцца менавіта гэтая версія, а PDF робіцца раздрукоўкай для зручнасці.

Хто і з якой даты

• 1 лютага 2026 — абавязак выстаўляць з'яўляецца ў прадпрымальнікаў, чые продажы з падаткам перавысілі ў 2024 годзе 200 млн zł.
• 1 красавіка 2026 — астатнія прадпрымальнікі.
• Да 31 снежня 2026 — пераходны перыяд з паслабленнямі: калі фактуры за месяц у суме не перавышаюць 10 000 zł брута, іх можна выстаўляць па-за KSeF, электронна ці на паперы.
• 1 студзеня 2027 — паслабленне знікае. У KSeF выстаўляюць усе, уключна з самымі маленькімі фірмамі.

Люты 2026 закранае і вас, нават калі вы выстаўляеце адну фактуру ў квартал

Гэта самы прапушчаны пункт. Даты вышэй адносяцца да выстаўлення. Але калі буйны кантрагент з лютага пачне выстаўляць фактуры ў KSeF, ваша фірма будзе іх там атрымліваць — незалежна ад уласнага тэрміну. Фактура не прыйдзе на пошту; яна прыйдзе ў сістэму, куды трэба зайсці або падключыць праграму.

Практычная выснова: доступ і паўнамоцтвы ў KSeF варта наладзіць на пачатку 2026 года, а не ў снежні 2026, калі гэта адначасова будзе рабіць уся Польшча.

Ліміт 10 000 zł лічыцца не так, як думае большасць

Гэта не гадавы абарот фірмы і не сума нета. Гаворка пра агульны кошт продажаў з падаткам па фактурах, выстаўленых у канкрэтным месяцы. Ліміт працуе назапашальна ўнутры месяца: пакуль сума змяшчаецца, фактуры могуць ісці па-за сістэмай.

Момант перавышэння жорсткі. Фактура, якая пераходзіць за 10 000 zł, ідзе ўжо ў KSeF — і ўсе наступныя ў гэтым месяцы таксама. То бок маленькая фірма не можа запланаваць «увесь 2026 год я па-за сістэмай». Тэхнічна быць гатовым трэба да любога месяца, у якім трапіцца заказ большы.

Што з гэтага адносіцца да сайта, а не да бухгалтэрыі

Фактуры выстаўляе бухгалтарская праграма або сістэма продажаў — і размаўляе з KSeF менавіта яна. Сайт фактуры не выстаўляе. Сайт вырашае іншае: ці прыдатныя дадзеныя, якія трапяць у гэтую праграму, для электроннай фактуры наогул.

Структураваная фактура — гэта XML з канкрэтнымі палямі. У ім няма месца для «дадзеных фірмы», упісаных адным радком у поле заўваг. Патрэбныя паасобку: NIP, назва, вуліца з нумарам, паштовы індэкс, горад, краіна. Калі крама збірае гэта адным радком тэксту, нехта будзе разбіраць яго рукамі — пры кожным заказе.

Дзе ў форме заказу павінен жыць NIP

Тыповая памылка крамаў: NIP як неабавязковае тэкставае поле недзе пад адрасам, без праверкі. Туды трапляе «1234567890», «PL1234567890», «няма» і нумар з дэфісамі. Потым гэта чысцяць.

Як павінна быць:

• Спачатку пытанне, потым палі. Пераключальнік «купляю як фірма / як прыватная асоба» у пачатку, а не NIP, схаваны ўнізе. Ад гэтага адказу залежыць увесь далейшы шлях.
• Праверка пры ўводзе. Дзесяць лічбаў, кантрольная сума NIP, аўтаматычнае выдаленне прабелаў, дэфісаў і прэфікса PL. Гэта паўтара дзясятка радкоў кода, якія эканомяць гадзіны правак.
• Падстаноўка дадзеных з рэестра. Пасля ўводу карэктнага NIP назву і адрас фірмы можна атрымаць з публічнага рэестра і запоўніць палі аўтаматычна. Кліент робіць менш клікаў, а дадзеныя прыходзяць у тым фармаце, які чакае XML.
• Падзеленыя палі адраса. Вуліца, нумар, індэкс, горад, краіна — паасобку. Нават калі візуальна гэта выглядае адным радком.
• Папярэджанне для кліента. Варта адразу паведаміць, што фактура трапіць у KSeF і будзе даступная ў сістэме — гэта здымае пытанні «дзе мая фактура, на пошту нічога не прыйшло».

B2B і B2C — два розныя шляхі

Продаж фірме і продаж спажыўцу разыходзяцца адразу пасля кошыка.

B2B. Фактура мусіць трапіць у KSeF. Сістэма прысвойвае ёй нумар і вяртае UPO — доказ, што дакумент існуе. Пакупнік забірае фактуру з сістэмы; адпраўка PDF поштай цяпер проста ветлівасць.

B2C. Выстаўленне спажывецкіх фактур у KSeF застаецца добраахвотным. Але калі вы перадаяце такую фактуру па-за сістэмай, на ёй мусіць быць QR-код, які дазваляе праверыць дакумент у сістэме Міністэрства фінансаў. То бок PDF, які крама генеравала дагэтуль, мяняе выгляд — і нехта мусіць паправіць гэты шаблон.

Як тэхнічна выглядае перадача фактуры

Схема аднолькавая незалежна ад платформы крамы:

• крама вызначае тып пакупніка і збірае поўны набор дадзеных;
• заказ ідзе ў сістэму, якая выстаўляе фактуры, — бухгалтарскую, ERP або модуль крамы;
• гэтая сістэма адпраўляе XML у KSeF праз API і атрымлівае нумар KSeF і UPO;
• нумар вяртаецца ў заказ, каб яго потым можна было знайсці і звязаць з аплатай.

Слабое звяно амаль заўсёды першае. Інтэграцыя з KSeF — гатовае рашэнне на баку бухгалтэрыі; карэктныя дадзеныя з формы заказу — праца на баку сайта.

Што пасыплецца ў лютым — спіс з практыкі

• Заказы ад фірмаў без NIP, бо поле было неабавязковым і кліент яго прапусціў.
• NIP з прэфіксам краіны ці дэфісамі, які не прымае праверка на баку бухгалтарскай праграмы.
• Адрас адным радком — разбіраць уручную пры кожным заказе.
• Адсутнасць QR-кода на спажывецкіх фактурах, якія перадаюцца па-за сістэмай.
• Форма, якая наогул не пытаецца, ці купляе фірма, — і кліент дапісвае NIP у заўвазе да заказу.

Што зрабіць цяпер

• Адкрыйце ўласную краму і аформіце заказ як фірма. Праверце, ці можна ўказаць NIP, ці правяраецца ён і ці разбіваецца адрас на палі.
• Спытайце бухгалтэрыю, праз якую праграму фактуры пойдуць у KSeF і якіх палёў яна патрабуе. Потым параўнайце з тым, што збірае форма.
• Вызначце, ці выстаўляеце вы фактуры спажыўцам. Калі так — шаблону PDF патрэбны QR-код.
• Наладзьце доступ і паўнамоцтвы ў KSeF на пачатку 2026 года, нават калі ваш абавязак выстаўляць пачынаецца пазней: атрымліваць фактуры вы пачняце раней.
• Калі крама збірае дадзеныя абы-як, паправце форму да пачатку сезона. Пасля 1 лютага любая праўка будзе рабіцца спехам.

Коратка

Буйныя выстаўляюць у KSeF з лютага 2026, астатнія з красавіка, самыя маленькія са студзеня 2027 — але атрымліваць фактуры трэба ўмець значна раней. Ліміт 10 000 zł — гэта сума брута па фактурах за месяц, назапашальна, таму будаваць на ім план на год нельга. Для сайта ўсё зводзіцца да аднаго: сабраць карэктныя дадзеныя пакупніка ў тым фармаце, які прыме электронная фактура.

Калі хочаце, каб мы паглядзелі форму заказу ў вашай краме і сказалі, што паправіць, — напішыце нам. Пра тое, як мы падыходзім да крамаў і інтэграцый, — на старонцы Распрацоўка сайтаў.

Victor Parhimchik, заснавальнік вэб-студыі IT Deweloper