Generowanie PDF z XML KSeF – Masowe i pojedyncze pobieranie faktur (API i Panel WWW)

Krajowy System e-Faktur (KSeF) opiera się wyłącznie na ustrukturyzowanych plikach XML w formacie FA(3). Choć dla systemów informatycznych i baz danych to idealne rozwiązanie, to dla człowieka – księgowej, managera czy klienta końcowego – surowy kod XML jest zupełnie nieczytelny. Oficjalna struktura Ministerstwa Finansów nie zawiera warstwy wizualnej. Pojawia się więc kluczowe wyzwanie: jak sprawnie generować pliki PDF z XML KSeF – zarówno pojedynczo, jak i masowo, przy użyciu wygodnego panelu WWW lub szybkiego API?

Dwie ścieżki: Pojedyncze dokumenty lub hurtowe paczki

W codziennej pracy z e-Fakturami każda firma potrzebuje elastyczności. Czasami musisz pobrać jedną konkretną fakturę dla klienta, który czeka na infolinii, a innym razem potrzebujesz zrzucić cały miesiąc sprzedaży do celów archiwalnych. W ksefservice.pl wspieramy oba te scenariusze:

• Generowanie pojedyncze – natychmiastowy podgląd i pobranie konkretnego dokumentu w formacie PDF (np. od razu po jego wystawieniu lub odebraniu z KSeF).
• Generowanie masowe (seryjne) – automatyczne przetwarzanie dziesiątek, setek lub tysięcy plików XML jednocześnie i łączenie ich w zbiorcze paczki dokumentów PDF.

Wygoda w Panelu WWW: Klikasz i pobierasz

Jeśli zarządzasz fakturami ręcznie, nasz panel przeglądarkowy daje Ci pełną kontrolę nad wizualizacją dokumentów bez potrzeby instalowania jakiegokolwiek oprogramowania.

• Pojedynczy plik PDF: Przy każdej fakturze na liście znajdziesz ikonę szybkiego podglądu. Jedno kliknięcie wystarczy, aby otworzyć czytelny dokument PDF i zapisać go na dysku.
• Masowy eksport do PDF: Potrzebujesz faktur z całego tygodnia lub miesiąca? Zaznaczasz wybrane dokumenty na liście (lub filtrujesz je po dacie/kontrahencie) i wybierasz opcję eksportu hurtowego. System wygeneruje dla Ciebie jedną wygodną paczkę ZIP zawierającą wszystkie osobne pliki PDF lub jeden scalony dokument gotowy do druku. Podobnie działa to przy imporcie z plików Excel (CSV) – wrzucasz listę, a system hurtowo przygotowuje pliki PDF.

Automatyzacja przez REST API: Obsługa faktur Online i Offline

Dla deweloperów oraz twórców systemów ERP, CRM czy sklepów internetowych przygotowaliśmy dedykowany, wysokowydajny endpoint API. Pozwala on na pełną automatyzację procesu generowania obrazu faktury bezpośrednio w Twoim własnym oprogramowaniu.

Nasz system pozwala na generowanie dokumentów PDF zarówno dla faktur online (już przetworzonych przez KSeF), jak i offline (np. przed wysyłką lub w trybie awaryjnym). Jeśli w żądaniu nie przekażesz oficjalnego numeru KSeF (wartość ksefNumber pozostanie niezdefiniowana), system automatycznie potraktuje dokument jako fakturę offline i wygeneruje poprawną wizualizację.

• Pojedyncze żądanie (Real-time): Twój system wysyła dane struktury faktury, a w odpowiedzi natychmiast otrzymuje czysty strumień danych (stream) pliku PDF z automatycznie nałożonym kodem QR. Idealne do natychmiastowej automatyzacji wysyłki mailowej.
• Zapytania masowe (Batch/Wsadowe): Nasze API bez problemu radzi sobie z seryjnym procesowaniem. Możesz przesyłać kolejne zapytania w pętli lub przekazywać paczki danych, a nasz serwer weźmie na siebie całą moc obliczeniową związaną z rysowaniem szablonów graficznych w tle.

Przykład wywołania API (generowanie wizualizacji PDF):

POST /api/v1/invoices/pdf
Headers: Content-Type: application/json

Request body:
{
  "login": "mail@mail.com",
  "password": "secret_api_password",
  "ksefNumber": "5771914812-20260105-010080DC0B87-8D",
  "api_env": "TEST",
  "validate_xsd": 1,
  "xml_file": "string_lub_base64_xml"
}

Automatyczne generowanie oficjalnego kodu QR

Warto pamiętać, że zgodnie z przepisami każda wizualizacja faktury KSeF (w tym plik PDF) przedstawiana klientowi musi posiadać specjalny kod QR do weryfikacji dokumentu. Niezależnie od tego, czy generujesz pojedynczy PDF w panelu, czy pobierasz 1000 sztuk przez API dla faktur online, ksefservice.pl automatycznie wylicza odpowiednie metadane i nanosi poprawny kod QR na każdy dokument.

Podsumowanie

Niezależnie od skali Twojego biznesu i wybranej metody, ksefservice.pl zdejmuje z Ciebie problem interpretacji skomplikowanych struktur XML FA(3). Ty decydujesz, czy wolisz klikać pojedyncze faktury w panelu, pobierać masowe paczki ZIP, czy w pełni zautomatyzować ten proces za pomocą REST API w swoim systemie ERP.

Chcesz sprawdzić, jak szybko nasz system radzi sobie z generowaniem pojedynczych i masowych PDF-ów? Załóż darmowe konto testowe i sprawdź nas w akcji lub przejdź bezpośrednio do naszej dokumentacji technicznej REST API.