ENATIV Logo
ENATIV
Powrót
© 2026 ENATIV
ProjektyOfertaBaza wiedzyKontakt
kontakt@enativ.pl
  1. Baza wiedzy
  2. ›
  3. Integracje
  4. ›
  5. KSeF

KSeF

Integracja z API Krajowego Systemu e-Faktur: dane faktury, środowisko testowe i awarie.

IntegracjeUżywam od 2025 · Wyróżniony projekt: The Travelling Cows

Kategoria
Integracje
Używam od
2025
Wyróżniony projekt
The Travelling Cows

W praktyce

KSeF to krajowy system e-faktur Ministerstwa Finansów, a integrację z jego API robię wtedy, gdy faktury powstają w Twojej własnej aplikacji. W The Travelling Cows system wystawia faktury VAT i B2B i wysyła je do KSeF automatycznie, bez ręcznego przepisywania.

Czym jest KSeF?

KSeF, czyli Krajowy System e-Faktur, to platforma do wystawiania, przesyłania, otrzymywania i przechowywania faktur. Portal i dokumentację API publikuje Ministerstwo Finansów, a faktury mają postać ustrukturyzowaną i elektroniczną. Dla programisty oznacza to fakturę jako dane w ustalonej strukturze, które system przyjmuje i zwraca przez API.

Przez API aplikacja może się uwierzytelnić, otworzyć sesję interaktywną lub wsadową oraz wysyłać i pobierać faktury. API obsługuje też tryby offline i kody QR, a do prób służy środowisko testowe z danymi testowymi.

Jak pracuję z KSeF

Zaczynam od pytania, skąd w Twoim systemie biorą się dane faktury, bo od ich jakości zależy reszta. Przepisów nie interpretuję: o tym, co i kiedy trzeba wysyłać, decyduje Twoja księgowość, a ja dopasowuję do tego kod i kolejność wysyłki.

  1. Zakres i środowisko testowe

    Ustalam, które faktury trafiają do KSeF i kto je wystawia: sprzedaż detaliczna, rezerwacje czy rozliczenia z firmami. Pierwsze wywołania robię w środowisku testowym z danymi testowymi, a nie na produkcji.

  2. Faktura z własnego systemu

    W The Travelling Cows system generuje faktury VAT i B2B i wysyła je do KSeF automatycznie, więc nikt nie przepisuje ich ręcznie.

  3. Błędy i niedostępność

    Planuję, co się dzieje, gdy KSeF nie odpowiada albo odrzuca fakturę. KSeF ma tryby offline i korektę techniczną, a portal publikuje komunikaty o utrudnieniach.

Kiedy tak, a kiedy nie

Własna integracja ma sens tam, gdzie faktury powstają w Twojej aplikacji.

Sprawdza się, gdy

  • Platforma rezerwacji lub sklep, które same wystawiają faktury z danych zamówienia, bez drugiego programu.
  • System, który prowadzi faktury VAT i B2B w jednym panelu, obok zamówień.
  • Księgowość, która ma dostawać faktury od razu i bez przepisywania.
  • Firma, której oprogramowanie do faktur nie ma gotowego połączenia z KSeF.

Nie sprawdza się, gdy

  • Kilka faktur w miesiącu, które wystawia się ręcznie.
  • Firma, której program do fakturowania już łączy się z KSeF i wystarcza do pracy.
  • Projekt bez osoby, która pilnuje zmian w przepisach i w dokumentacji API.

Zamiast własnej integracji można wystawiać faktury w aplikacji podatnika, którą udostępnia portal KSeF, albo w programie z gotową obsługą systemu. Panel zbudowany na Payload CMS albo sklep z własną logiką zamówień to już przypadek na integrację bezpośrednią.

Często zadawane pytania

Nie. Faktury można wystawiać także w aplikacji podatnika, którą udostępnia portal KSeF. Własna integracja z API ma sens, gdy faktury powstają w Twoim systemie, na przykład z rezerwacji albo z zamówień, i nie chcesz ich wprowadzać drugi raz w innym narzędziu.
Nie podaję tu dat ani progów, bo zależą od Twojej sytuacji podatkowej i mogą się zmienić. Aktualne zasady sprawdź na portalu KSeF Ministerstwa Finansów, który prowadzi kalendarium wdrożenia, albo u księgowej. Ja odpowiadam za część techniczną, nie za interpretację przepisów.
Na taki przypadek są tryby offline i korekta techniczna, a portal ogłasza utrudnienia. Dlatego z reguły planuję ponawianie wysyłki i nie blokuję sprzedaży, gdy system chwilowo nie odpowiada. Szczegóły ustalamy z księgową, bo to ona zna Twoje obowiązki, a ja znam API i to, jak aplikacja ma się zachować.
Od tego, skąd biorą się dane faktury. Gdy system ma już poprawne dane sprzedawcy i nabywcy oraz pozycji faktury, integracja to głównie uwierzytelnienie i wysyłka, a potem obsługa błędów. Gdy dane są rozproszone, najpierw je porządkuję, i to zwykle zajmuje więcej czasu niż samo API.

Na tej stronie

  • W praktyce
  • Czym jest KSeF?
  • Jak pracuję z KSeF
  • Kiedy tak, a kiedy nie
  • Często zadawane pytania

Powiązane hasła

  • KSeF
  • InPost
  • Shopify
  • Payload CMS
  • Next.js

W ofercie

  • E-CommerceSklepy internetowe: headless Shopify, Medusa.js i niestandardowe rozwiązania ze Stripe.

Faktury powstają w Twoim systemie i mają trafiać do KSeF?

Opisz, skąd bierzesz dane faktury i kto je dziś wystawia. Powiem, czy wystarczy gotowy program, czy potrzebna jest integracja z API, i czego dowiem się od księgowej.

Opisz swój projektZobacz The Travelling Cows