Dokumentacja KSeF

Dokumentacja techniczna integracji z Krajowym Systemem e-Faktur. Autoryzacja, tokeny, certyfikaty, formaty XML, workflow i rozwiązywanie problemów.

🔐

Autoryzacja

Autoryzacja tokenem

Jak otworzyć sesję KSeF za pomocą tokena autoryzacyjnego. Workflow challenge-response, konfiguracja.

Autoryzacja certyfikatem

Otwarcie sesji KSeF za pomocą certyfikatu kwalifikowanego. Podpisywanie challenge, konfiguracja PKCS#11.

Sesje interaktywne

Zarządzanie sesjami interaktywnymi KSeF. Otwarcie, operacje w ramach sesji, zamknięcie, timeout.

🔑

Tokeny i certyfikaty

Generowanie tokenów

Krok po kroku jak wygenerować token autoryzacyjny KSeF. Wymagania, uprawnienia, konfiguracja.

Konfiguracja certyfikatów

Instalacja i konfiguracja certyfikatu kwalifikowanego do pracy z KSeF. Karta kryptograficzna, certyfikat w chmurze.

Uprawnienia

System uprawnień w KSeF. Typy uprawnień, nadawanie, delegowanie, odwoływanie.

📄

Faktury XML

Schemat XML faktury

Opis schematu XML faktury KSeF (FA_VAT). Wymagane pola, struktury danych, walidacja XSD.

Przykłady XML

Przykładowe faktury XML zgodne ze schematem KSeF. Różne scenariusze: standardowa, korekta, zaliczka.

🔄

Workflow integracji

Wysyłka faktury

Kompletny workflow wysyłki faktury do KSeF. Od otwarcia sesji przez wysyłkę po pobranie UPO.

Odbiór faktur

Pobieranie faktur zakupowych z KSeF. Zapytania synchroniczne i asynchroniczne.

Request/Response

Przykłady request i response dla głównych endpointów API KSeF. JSON, nagłówki, kody odpowiedzi.

🛠️

Rozwiązywanie problemów

Najczęstsze błędy

Lista najczęstszych błędów API KSeF z opisem przyczyn i rozwiązań. Kody błędów, troubleshooting.

FAQ techniczne

Odpowiedzi na najczęstsze pytania techniczne dotyczące integracji z KSeF.

Potrzebujesz pomocy technicznej?

Jeśli dokumentacja nie odpowiada na Twoje pytania — skontaktuj się. Oferujemy konsultacje techniczne dla programistów i firm integrujących KSeF.