Jak wysłać fakturę do KSeF — przewodnik techniczny

Jak wysłać fakturę do KSeF?

Wysyłka faktury do KSeF wymaga kilku kroków. Poniżej przedstawiamy kompletny przewodnik.

Wymagania wstępne

•Token KSeF lub certyfikat kwalifikowany

•Faktura w formacie XML (schemat FA(2))

•Aktywne środowisko (testowe lub produkcyjne)

Krok 1: Przygotuj fakturę XML

Faktura musi być w formacie XML zgodnym ze schematem XSD Ministerstwa Finansów. Główne elementy:

•Dane sprzedawcy (NIP, nazwa, adres)

•Dane nabywcy

•Pozycje faktury

•Kwoty netto, VAT, brutto

•Data wystawienia i sprzedaży

Krok 2: Zwaliduj XML

Przed wysłaniem warto zwalidować XML:

•Zgodność ze schematem XSD

•Poprawność NIP

•Poprawność kwot

Krok 3: Otwórz sesję KSeF

Otwórz sesję interaktywną za pomocą tokena.

Krok 4: Wyślij fakturę

Wyślij fakturę XML w ramach otwartej sesji. API zwróci numer referencyjny.

Krok 5: Pobierz potwierdzenie

Pobierz UPO (Urzędowe Poświadczenie Odbioru) z numerem KSeF faktury.

Krok 6: Zamknij sesję

Po zakończeniu wysyłki zamknij sesję interaktywną.

Najczęstsze problemy

•Błąd walidacji XML — najczęstsza przyczyna to niezgodność ze schematem XSD

•Wygasły token — tokeny mają ograniczony czas życia

•Brak uprawnień — sprawdź czy token ma uprawnienie do wysyłki

•Limit sesji — KSeF limituje liczbę jednoczesnych sesji

Podsumowanie

Wysyłka faktury do KSeF to proces wieloetapowy. Gotowe proxy KSeF może znacząco uprościć ten proces.

Jak wysłać fakturę do KSeF — przewodnik techniczny