Powiadomienia o nowych fakturach w KSeF

KSeF nie wysyła automatycznych powiadomień systemowych o otrzymaniu nowej faktury. Dokument może być już dostępny dla nabywcy w systemie, mimo że nikt w firmie nie dostał e-maila, SMS-a ani innego alertu.

Taką warstwę może zapewnić KSeFGPT: cyklicznie sprawdza metadane faktur w KSeF, rozpoznaje nowy dokument i uruchamia automatyzację. Domyślny przepływ wysyła pojedynczy albo zbiorczy e-mail, a własna akcja powiadomienia może użyć e-maila, Slacka, Telegrama lub webhooka.

Alert pomaga rozpocząć obsługę dokumentu, ale nie oznacza jego przeczytania, akceptacji ani zaksięgowania. Trzeba też odróżnić go od wiadomości po wysłaniu faktury wychodzącej oraz od statusu, numeru KSeF i UPO.

Dostawca wystawił fakturę, KSeF ją przyjął, a dokument jest dostępny dla firmy. Mimo to księgowość, osoba zamawiająca i właściciel firmy nie otrzymali żadnej wiadomości. Nie musi to oznaczać awarii ani błędu sprzedawcy, ponieważ sam KSeF nie pełni funkcji skrzynki wysyłającej alert o każdym nowym dokumencie.

Ministerstwo Finansów wyjaśnia, że to oprogramowanie podatnika powinno sprawdzać KSeF, a funkcję powiadamiania można zbudować lokalnie w programie finansowo-księgowym. W praktyce powstają więc trzy osobne momenty: udostępnienie faktury w KSeF, wykrycie jej przez aplikację i dostarczenie alertu człowiekowi. Warto rozumieć tę różnicę, zanim firma ustali własny obieg dokumentów.

1. Czy KSeF wysyła powiadomienia o nowych fakturach?

2. Jak program wykrywa nową fakturę w KSeF?

3. Trzy zdarzenia, których nie należy mylić

4. Co powinno znaleźć się w dobrym alercie?

5. Jak kierować powiadomienia do właściwych osób?

6. Powiadomienie nie oznacza akceptacji ani zaksięgowania

7. Jak KSeFGPT zamienia nową fakturę w działanie?

8. Najczęściej zadawane pytania

Dobrze zaprojektowane powiadomienie łączy zdarzenie w KSeF z konkretną odpowiedzialnością w firmie, ale nie zastępuje kontroli dokumentu.

Nie. Podręcznik KSeF 2.0, część II, rozdział 6.4, strona 98 wskazuje wprost: „KSeF nie wysyła automatycznie powiadomień systemowych o otrzymaniu nowej faktury w systemie”. Materiał Ministerstwa Finansów dodaje, że oprogramowanie podatnika musi odpytywać KSeF, a funkcję powiadamiania można wprowadzić w używanym programie finansowo-księgowym. Stan materiałów sprawdzono 23 lipca 2026 r.

Brak alertu nie oznacza, że faktura nie została otrzymana w systemie. W standardowym trybie online faktura przyjęta przez KSeF jest dostępna dla nabywcy wskazanego przez NIP, a podręcznik wiąże jej otrzymanie z nadaniem numeru KSeF. Dostępność dokumentu i wiadomość wysłana człowiekowi to jednak dwa różne zdarzenia.

Dostępność w KSeF: dokument może już znajdować się po stronie nabywcy.

Powiadomienie: dodatkowa informacja może zostać wysłana przez program korzystający z danych KSeF.

Działanie firmy: wyznaczona osoba nadal musi sprawdzić dokument i skierować go do dalszej obsługi.

Oficjalny przewodnik MF zaleca regularne sprawdzanie, czy firma otrzymała fakturę, ponieważ informacja ta jest potrzebna do dalszej obsługi dokumentu i płatności. Szerzej opisujemy ten proces w poradniku jak odbierać faktury przez KSeF. Skoro KSeF nie wysyła alertu, kolejnym pytaniem jest sposób wykrywania nowych faktur przez oprogramowanie.

Uprawnione oprogramowanie odpytuje KSeF o metadane faktur i porównuje wynik z zapamiętanym stanem. KSeFGPT wykorzystuje do tego punkt startowy oraz rozpoznane numery KSeF, aby wskazać nowe pozycje. Dopiero po wykryciu dokumentu może uruchomić regułę biznesową, na przykład wysłać wiadomość albo przekazać dane do innego systemu.

Źródło danych: KSeF udostępnia informacje o fakturach przez API.

Synchronizacja: aplikacja pobiera dane dostępne dla danego podmiotu i rozpoznaje nowe dokumenty.

Akcja: program uruchamia wybrany kanał komunikacji lub dalszy proces.

W produkcyjnym KSeF API 2.0, według stanu zweryfikowanego 23 lipca 2026 r., istnieje operacja pobierania metadanych faktur według filtrów. Dokumentacja przyrostowego pobierania wskazuje także wymagane uprawnienie i sposób porządkowania wyników. Te informacje opisują mechanizm techniczny KSeF, a nie gwarantowany czas alertu w zewnętrznej aplikacji.

Na czas dostarczenia wiadomości wpływają co najmniej moment udostępnienia faktury, sposób synchronizacji używanego programu i działanie wybranego kanału. Nie ma więc podstaw, by obiecywać jeden stały czas dla każdego alertu. Wiedząc, skąd bierze się wiadomość, można rozdzielić zdarzenia, które w codziennej rozmowie bywają nazywane powiadomieniem KSeF.

Sformułowanie powiadomienie o fakturze może opisywać trzy różne sytuacje. Rozdzielenie ich zapobiega błędnemu założeniu, że wiadomość dla kontrahenta, wewnętrzny alert zakupowy i UPO są wymienne.

Faktura przychodząca: wiadomość ma skierować dokument do osoby, która rozpocznie jego obsługę po stronie nabywcy.

Faktura wychodząca: osobny komunikat może poinformować kontrahenta albo zespół, że wysyłka do KSeF zakończyła się powodzeniem.

Potwierdzenia systemowe: status, numer KSeF i UPO dokumentują kolejne elementy procesu, ale nie dowodzą przeczytania faktury przez nabywcę.

Prawidłowa sekwencja dla alertu zakupowego wygląda tak: KSeF udostępnia fakturę, aplikacja ją wykrywa, reguła wybiera odbiorcę, kanał przekazuje alert, a człowiek wykonuje następną czynność. Żaden z tych etapów nie powinien być automatycznie utożsamiany z akceptacją dokumentu. Osobne poradniki wyjaśniają, jak sprawdzić status faktury po wysyłce oraz co potwierdza UPO w KSeF. Skoro zdarzenia są rozdzielone, można określić zawartość użytecznej wiadomości.

Dobry alert nie powinien być kopią całej faktury wysłaną do każdego kanału. Ma szybko odpowiedzieć na dwa pytania: kto powinien zareagować i co ma zrobić dalej. Zakres wiadomości należy dopasować do procesu firmy, odbiorcy oraz zasad ochrony danych.

Kontekst dokumentu: informacje pozwalające rozpoznać sprawę, na przykład kontrahent, kwota lub termin, jeśli wynikają z konfiguracji wiadomości.

Odbiorca: osoba albo grupa odpowiedzialna za dany rodzaj faktury.

Oczekiwane działanie: jasna informacja, czy dokument trzeba sprawdzić, zaakceptować, wyjaśnić albo przekazać dalej.

Bezpieczny dostęp: odnośnik do właściwego widoku zamiast automatycznego rozsyłania pełnego XML lub nadmiarowych danych.

Poniższe elementy są rekomendacją projektową, a nie obietnicą stałej zawartości każdej wiadomości KSeFGPT. Ich dostępność i zakres zależą od wybranego procesu oraz konfiguracji. Po określeniu treści alertu trzeba jeszcze zdecydować, do kogo powinien trafić.

Jedna wspólna skrzynka dla wszystkich faktur szybko zmienia alerty w szum. Reguła powinna łączyć zdarzenie z warunkiem, miejscem dostarczenia i następną czynnością. W KSeFGPT akcja powiadomienia wskazuje adres e-mail albo skonfigurowaną integrację: Slack, Telegram lub webhook.

Edytor warunków podpowiada liczbę dokumentów, numer faktury i numer KSeF, a także pozwala wskazać własne pole danych wyzwalacza. Ponieważ zdarzenie nowej faktury zawiera jej metadane, zaawansowana reguła może odwołać się na przykład do kwoty brutto lub danych sprzedawcy. Nie jest to jednak bezpośredni wybór użytkownika ani grupy organizacyjnej jako odbiorcy automatyzacji.

Kwota: własny warunek może porównać wartość brutto z wewnętrznym progiem firmy. Taki próg jest zasadą organizacyjną, a nie limitem wynikającym z prawa.

Sprzedawca: własny warunek może rozpoznać dane dostawcy dostępne w metadanych i uruchomić powiadomienie w wybranym kanale.

Wiele dokumentów: domyślny przepływ rozróżnia jedną nową fakturę od kilku wykrytych podczas tego samego sprawdzenia i może wysłać zbiorczy e-mail.

Odpowiedzialność: wspólny kanał Slack lub Telegram może udostępnić alert zespołowi także wtedy, gdy jedna osoba jest niedostępna.

Poniższe scenariusze pokazują model projektowania procesu, a nie instrukcję konfiguracji funkcji. Gdy odbiorca i następna czynność są już określone, trzeba zachować granicę między powiadomieniem a decyzją księgową.

Alert sygnalizuje zdarzenie techniczne lub operacyjne. Nie rozstrzyga, czy faktura dotyczy rzeczywistego zakupu firmy, czy dane są poprawne, czy koszt został zaakceptowany ani jak dokument powinien zostać ujęty w księgowości. Te decyzje wymagają osobnego etapu i odpowiedzialnej osoby.

To rozróżnienie jest szczególnie ważne, gdy w KSeF pojawi się dokument od nieznanego sprzedawcy albo faktura niepasująca do zamówienia. Samo udostępnienie dokumentu przez system nie potwierdza gospodarczego sensu zakupu. Dalszy sposób postępowania opisuje poradnik Co robić, gdy na koncie KSeF pojawi się faktura za nie nasze zakupy?.

Dojrzały obieg oddziela wykrycie dokumentu, przypisanie właściciela, kontrolę merytoryczną i decyzję księgową. Automatyzacja może skrócić drogę informacji do właściwej osoby, ale nie powinna usuwać kontroli tam, gdzie potrzebna jest ocena umowy, dostawy albo zasadności kosztu.

Nie ma też podstaw, by z samego braku alertu wyprowadzać uniwersalne wnioski o utracie prawa do odliczenia VAT, naruszeniu terminu płatności lub sankcji. Skutki zależą od konkretnej sytuacji i właściwych przepisów. W tym procesie warto traktować powiadomienie jako początek obsługi, a nie jej wynik.

KSeFGPT nie czeka na powiadomienie push z KSeF, ponieważ KSeF takiego alertu nie wysyła. Mechanizm produktu cyklicznie pobiera metadane faktur, zapamiętuje już rozpoznane numery KSeF i uruchamia przepływ automatyzacji tylko dla nowych dokumentów.

Po zapisaniu danych dostępowych KSeF produkt tworzy aktywny domyślny przepływ powiadomień na adres e-mail użytkownika. Przy uruchomieniu monitorowania KSeFGPT ustala punkt początkowy, aby nie odtwarzać alertów o starszych fakturach. Domyślny przepływ wysyła pojedynczy e-mail dla jednej nowej faktury albo zbiorczą wiadomość, gdy podczas jednego sprawdzenia wykryje ich więcej.

Wykrycie: KSeFGPT sprawdza metadane dostępne w KSeF i porównuje je z zapamiętanym stanem.

Warunek: domyślna reguła rozróżnia jedną fakturę od wielu, a własne warunki mogą korzystać z pól danych wyzwalacza.

Odbiorca: informacja trafia na skonfigurowany adres e-mail, kanał Slack, czat lub kanał Telegram albo do połączonego systemu przez webhook.

Akcja: zespół przechodzi do kontroli, akceptacji, wyjaśnienia lub innej czynności przewidzianej w firmie.

Ten przepływ dotyczy nowej faktury przychodzącej. Nie należy utożsamiać go z wiadomością dla kontrahenta po wystawieniu faktury wychodzącej ani ze statusem lub UPO. To odrębne zdarzenia i procesy.

Widok przepływów w KSeFGPT pozwala kontrolować aktywność, uruchomienia i błędy procesu bez zamieniania tego artykułu w instrukcję konfiguracji. Pełny opis możliwości znajdziesz na stronie Automatyzacje KSeFGPT.

Jak odbierać faktury przez KSeF? - poznaj różnicę między dostępnością dokumentu w systemie a jego dalszą obsługą w firmie.

Co robić, gdy na koncie KSeF pojawi się faktura za nie nasze zakupy? - sprawdź, dlaczego nowy dokument wymaga kontroli merytorycznej.

Jak sprawdzić status faktury w KSeF po wysyłce? - zobacz, jak czytać wynik procesu dla faktury wychodzącej.

UPO w KSeF - dowiedz się, co potwierdza UPO i jak różni się od operacyjnego alertu.