Aktywacja KSeF przez POP

Cel

Połączenie konta POP z systemem KSeF (Polska) w celu wysyłania elektronicznych faktur FA(3).

Wymagania wstępne

• Konto POP z planem Basic lub wyższym.
• NIP ustawiony w danych konta.
• Środowisko produkcyjne: dostęp do podpis.gov.pl z Profilem Zaufanym lub certyfikat PKI KSeF (PKCS#12 lub PEM).
• Środowisko testowe (sandbox): brak wymagań wstępnych — podpis jest symulowany automatycznie.

Środowisko produkcyjne i testowe to osobne rejestracje: aktywacja środowiska testowego nie aktywuje automatycznie produkcyjnego i odwrotnie.

Kroki (panel konta)

1. Zarejestruj podmiot prawny — adres, miasto, kod pocztowy, e-mail do powiadomień. NIP i zarejestrowana nazwa firmy są odczytywane automatycznie z ustawień konta, nie trzeba ich wpisywać ponownie.
2. Autoryzuj dostęp:
   • Sandbox — kliknij „Rozpocznij autoryzację” (okno 10-minutowe), następnie „Aktywuj”.
   • Produkcja z Profilem Zaufanym — pobierz plik podpisu, podpisz go na podpis.gov.pl, prześlij podpisany plik XML, następnie kliknij „Aktywuj”.
   • Produkcja z certyfikatem PKI — prześlij nazwę certyfikatu, hasło i plik certyfikatu.
3. Aktywne połączenie — od tego momentu możesz wysyłać faktury KSeF za pośrednictwem API POP.

Jeśli uzyskujesz dostęp po raz pierwszy przy użyciu polskiego konta (PL), aktywacja może również nastąpić z poziomu kreatora konfiguracji, z tymi samymi dwoma krokami (rejestracja + autoryzacja).

Koszt w kredytach

Każdy dokument KSeF zużywa 2 kredyty: 1 za generowanie XML i 1 za dostarczenie.

Odłączanie

• Odłącz — wstrzymuje wysyłkę, zachowując rejestrację (można ją później ponownie aktywować).
• Usuń połączenie — usuwa również lokalne dane rejestracji.

Typowe błędy

• „KSeF Legal Entity is missing.” — podmiot prawny nie został zarejestrowany (krok 1) przed wygenerowaniem/wysłaniem dokumentu: dokończ rejestrację w panelu konta.
• Onboarding KSeF nieukończony — brakuje NIP-u lub danych konta: sprawdź ustawienia przed kontynuowaniem autoryzacji.
• Sandbox aktywny, ale nie następuje żadna rzeczywista wysyłka — oczekiwane zachowanie: środowisko testowe nie dostarcza faktycznie do KSeF, do rzeczywistej wysyłki trzeba przełączyć się na środowisko produkcyjne.

Powiązana konfiguracja

Szczegóły kontraktu API (payload, mapowanie pól FA(3)) znajdziesz w api/ksef.