Pobieranie dokumentów

GET /invoices/{environment}/{ksefNumber}

Pobiera dokument faktury z KSeF w wybranym formacie. Zawartość zwracana jest jako string zakodowany w base64. Wymaga aktywnej sesji KSeF.

Parametry ścieżki

Parametr	Typ	Wymagany	Opis
environment	string	✅	test, demo lub prod
ksefNumber	string	✅	Numer KSeF faktury

Parametry zapytania

Parametr	Typ	Domyślnie	Opis
docType	string	xml	Typ dokumentu

Dostępne typy dokumentów (docType)

Wartość	Opis	Content-Type
xml	XML faktury KSeF	application/xml
pdf	PDF faktury (wygenerowany przez ksef-pdf-generator z QR)	application/pdf
qr	Obrazek QR w PNG	image/png

info

docType=pdf generuje pełny PDF po stronie serwera za pomocą ksef-pdf-generator, obsługując schematy FA(1), FA(2), FA(3) i FA_RR, z kodem QR weryfikacyjnym.

UPO

Aby pobrać UPO (Urzędowe Poświadczenie Odbioru), użyj dedykowanego endpointu: GET /invoices/{environment}/status/{referenceNumber}/{ksefNumber}/upo

Odpowiedź 200 — XML

{
  "ksefNumber": "1234567890-20260101-ABCDEF-12",
  "docType": "xml",
  "contentType": "application/xml",
  "content": "PD94bWwgdmVyc2lvbj0i...",
  "fileName": "1234567890-20260101-ABCDEF-12.xml"
}

Odpowiedź 200 — PDF

{
  "ksefNumber": "1234567890-20260101-ABCDEF-12",
  "docType": "pdf",
  "contentType": "application/pdf",
  "content": "JVBERi0xLjQK...",
  "fileName": "1234567890-20260101-ABCDEF-12.pdf",
  "qrVerificationUrl": "https://qr-test.ksef.mf.gov.pl/invoice/..."
}

Odpowiedź 200 — QR

{
  "ksefNumber": "1234567890-20260101-ABCDEF-12",
  "docType": "qr",
  "contentType": "image/png",
  "content": "iVBORw0KGgoAAAA...",
  "fileName": "1234567890-20260101-ABCDEF-12-qr.png",
  "qrVerificationUrl": "https://qr-test.ksef.mf.gov.pl/invoice/..."
}

Pole	Typ	Opis
ksefNumber	string	Numer KSeF faktury
docType	string	Żądany typ dokumentu (xml, pdf, qr)
contentType	string	Typ MIME zawartości
content	string	Zawartość dokumentu zakodowana w base64
fileName	string	Sugerowana nazwa pliku
qrVerificationUrl	string	URL weryfikacyjny QR (tylko dla typów pdf i qr)

Kody błędów

Kod	Opis
400	Nieprawidłowy parametr docType
401	Brak autoryzacji
404	Brak aktywnej sesji KSeF lub faktura nie znaleziona
500	Błąd generowania PDF
502	Błąd KSeF