Dla programistów i architektów

API KSeF — techniczny przewodnik po integracji

Poznaj architekturę REST API Krajowego Systemu e-Faktur. Autoryzacja, workflow wysyłki faktur, formaty danych i przykłady zastosowań.

Zapytaj o pomoc z APIDokumentacja

Architektura API KSeF

API KSeF to interfejs REST udostępniany przez Ministerstwo Finansów. Umożliwia programistyczną komunikację z Krajowym Systemem e-Faktur — wysyłanie faktur, pobieranie dokumentów, zarządzanie uprawnieniami i sesjami.

API działa w dwóch środowiskach: testowym (do developmentu i testów) oraz produkcyjnym (do rzeczywistej wymiany faktur). Każde środowisko wymaga osobnej konfiguracji tokenów i certyfikatów.

Workflow integracji z API KSeF

🔑
Krok 1

Autoryzacja

Otwarcie sesji KSeF za pomocą tokena lub certyfikatu kwalifikowanego. Otrzymanie identyfikatora sesji.

📄
Krok 2

Przygotowanie faktury

Wygenerowanie faktury w formacie XML (FA_VAT) zgodnym ze schematem XSD Ministerstwa Finansów.

📤
Krok 3

Wysyłka faktury

Wysłanie faktury XML do API KSeF w ramach aktywnej sesji. Otrzymanie numeru referencyjnego.

✅
Krok 4

Potwierdzenie UPO

Pobranie Urzędowego Poświadczenia Odbioru (UPO) z numerem KSeF faktury.

📥
Krok 5

Pobieranie faktur

Pobieranie faktur przychodzących — zakupowych — z KSeF w ramach sesji interaktywnej.

🔒
Krok 6

Zamknięcie sesji

Zamknięcie sesji interaktywnej po zakończeniu operacji.

Autoryzacja w API KSeF

Token autoryzacyjny

Token generowany w systemie KSeF po uwierzytelnieniu certyfikatem. Służy do otwierania sesji interaktywnych bez konieczności każdorazowego użycia certyfikatu.

  • ✓ Automatyzacja wysyłki
  • ✓ Bez interakcji użytkownika
  • ✓ Idealny do systemów serwerowych

Certyfikat kwalifikowany

Podpis kwalifikowany (np. karta kryptograficzna) do uwierzytelniania w KSeF i podpisywania faktur. Wymagany do wygenerowania tokena.

  • ✓ Najwyższy poziom bezpieczeństwa
  • ✓ Wymagany do zarządzania uprawnieniami
  • ✓ Generowanie tokenów

Przykłady zastosowań API KSeF

Integracja ERP

System ERP automatycznie wysyła faktury sprzedażowe do KSeF i pobiera faktury zakupowe.

E-commerce

Platforma e-commerce generuje faktury KSeF po złożeniu zamówienia i dołącza UPO do dokumentu.

Biuro rachunkowe

Centralne zarządzanie fakturami wielu firm — wysyłka i odbiór przez jedno API.

Aplikacja mobilna

Aplikacja dla przedstawicieli handlowych wystawia faktury KSeF w terenie.

Potrzebujesz pomocy z API KSeF?

Pomagamy programistom i firmom w integracji z API Krajowego Systemu e-Faktur. Konsultacje, wdrożenia, gotowe proxy.

Zapytaj o pomoc technicznąDla programistów