KSeF API do integracji z własnym systemem

KSeF API w ElektroniczneFaktury to jedno połączenie, przez które twój system sprzedaży albo ERP wystawia faktury, sprawdza ich status i odbiera faktury zakupowe. Integracja z KSeF nie wymaga wtedy samodzielnej obsługi uprawnień, formatów i trybów awaryjnych.

Zakres integracji

Wystawianie faktur i korekt z twojego systemu
Sprawdzanie statusu wysyłki i numeru KSeF
Odbiór faktur zakupowych
Pobieranie plików XML i PDF
Praca na wielu podmiotach w jednym koncie

Integracja z KSeF bez własnego klienta

Własna obsługa KSeF to uwierzytelnienie, kontrola schematu i obsługa awarii. Z naszym API przekazujesz dane faktury, a my odpowiadamy za dalszą drogę do systemu. Dzięki temu skupiasz się na własnym produkcie.

Uwierzytelnianie i format

Każde zapytanie wysyłasz na adres https://elektronicznefaktury.pl/api/v1/ z nagłówkiem Authorization: Bearer i tokenem wygenerowanym w panelu, w zakładce API. Dane przesyłasz jako JSON z nagłówkiem Content-Type: application/json, odpowiedzi też są w JSON. Limit to 120 zapytań na minutę na token. Token działa w planie Biznes i Biuro.

Lista endpointów

GET /podmioty zwraca podmioty konta z identyfikatorem, nazwą, NIP i stanem połączenia z KSeF
GET /podmioty/{podmiotId}/faktury zwraca listę faktur, z filtrami kierunek (sprzedaz lub zakup), od, do, ksef_stan i strona
POST /podmioty/{podmiotId}/faktury wystawia fakturę i kieruje ją do kolejki KSeF
GET /podmioty/{podmiotId}/faktury/{id} zwraca dane faktury, stan KSeF i numer KSeF
GET /podmioty/{podmiotId}/faktury/{id}/xml pobiera plik XML w formacie FA(3)
GET /podmioty/{podmiotId}/faktury/{id}/pdf pobiera wizualizację PDF
POST /podmioty/{podmiotId}/faktury/{id}/korekta wystawia korektę z pozycjami po zmianie
POST /podmioty/{podmiotId}/zakupowe/pobierz pobiera nowe faktury zakupowe z KSeF

Wystawienie faktury

W treści zapytania podajesz nabywca_nazwa, nabywca_nip, nabywca_adres, data_sprzedazy, opcjonalnie termin_platnosci i uwagi oraz tablicę pozycje. Każda pozycja ma nazwa, ilosc, cena oraz stawka (23, 8, 5, 0 lub zw), opcjonalnie jednostka. Odpowiedź o kodzie 201 zawiera id, numer i ksef_stan. Błędy danych wracają z kodem 422 i opisem pola, którego dotyczą.

Plan Biznes i Biuro

API wchodzi w plan Biznes i Biuro. Jest dla firm z własnym systemem sprzedaży, sklepem internetowym, software house'ów i biur rachunkowych, które łączą KSeF ze swoim programem. Porównanie planów: cennik.

Co jeszcze w pakiecie

Poza API dostajesz role, archiwum 10 lat, import z plików i eksport do księgowości. Jeśli wolisz obsługę z przeglądarki, zobacz wystawianie faktur i pobieranie faktur z KSeF.

Pytania

Najczęstsze pytania

W którym planie dostępne jest API?

API wchodzi w plan Biznes i plan Biuro. Plan Start obejmuje wystawianie w panelu, bez dostępu przez API.

Czy mogę zaimportować faktury z plików?

Tak, import z plików jest częścią planów Biznes i Biuro.

Zacznij wystawiać faktury w KSeF bez przepisywania

Załóż konto, połącz firmę z KSeF i wystaw pierwszą fakturę według instrukcji na ekranie.