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.
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.
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.
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
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.