Pobieranie dokumentu offline

GET /invoices/{environment}/offline/{id}

Pobiera dokument faktury offline w wybranym formacie. W odróżnieniu od faktur online, faktury offline obsługują dodatkowy typ cert - obraz kodu QR certyfikatu, którym został podpisany dokument offline.

Parametry ścieżki

Parametr	Typ	Wymagany	Opis
environment	string	✅	test, demo lub prod
id	string (uuid)	✅	ID faktury offline

Parametry zapytania

Parametr	Typ	Domyślnie	Opis
docType	string	xml	Format dokumentu

Dozwolone wartości docType

Wartość	Opis
xml	Podpisany XML (lub niepodpisany jeśli jeszcze nie podpisano)
pdf	PDF z 2 kodami QR: QR faktury (KOD I) i QR certyfikatu (KOD II) oraz znakiem wodnym "Offline"
qr	Kod QR faktury jako obraz PNG (KOD I — OFFLINE)
cert	Kod QR certyfikatu jako obraz PNG (KOD II — CERTYFIKAT)

Odpowiedź 200 — XML

{
  "id": "uuid",
  "invoiceNumber": "FV/2026/01/001",
  "docType": "xml",
  "contentType": "application/xml",
  "content": "PD94bWwg...base64...",
  "fileName": "FV-2026-01-001.xml"
}

Odpowiedź 200 — PDF

{
  "id": "uuid",
  "invoiceNumber": "FV/2026/01/001",
  "docType": "pdf",
  "contentType": "application/pdf",
  "content": "JVBERi0...base64...",
  "fileName": "FV-2026-01-001.pdf",
  "qrLinkInvoice": "https://qr-test.ksef.mf.gov.pl/invoice/...",
  "qrLinkCertificate": "https://qr-test.ksef.mf.gov.pl/certificate/..."
}

PDF z 2 kodami QR

PDF faktury offline zawiera dwa kody QR (jeśli są dostępne):

• KOD I (QR faktury) — weryfikuje skrót zawartości faktury
• KOD II (QR certyfikatu) — weryfikuje certyfikat podpisu

PDF zawiera również znak wodny „OFFLINE" odróżniający go od faktur online.

Odpowiedź 200 — QR / Cert

{
  "id": "uuid",
  "invoiceNumber": "FV/2026/01/001",
  "docType": "qr",
  "contentType": "image/png",
  "content": "iVBORw0...base64...",
  "fileName": "FV-2026-01-001-qr.png",
  "qrVerificationUrl": "https://qr-test.ksef.mf.gov.pl/invoice/..."
}

Dla docType=cert odpowiedź ma tę samą strukturę, ale z "docType": "cert", przyrostkiem pliku -cert-qr.png i qrVerificationUrl wskazującym na URL weryfikacji certyfikatu.

Kody błędów

Kod	Opis
400	Nieprawidłowy docType lub brak danych QR
401	Brak autoryzacji
404	Faktura offline nie znaleziona
500	Błąd generowania PDF