Pobieranie faktur offline
GET /invoices/{environment}/offline
Zwraca listę faktur offline (tryb awaryjny) dla danego środowiska.
Parametry ścieżki
| Parametr | Typ | Wymagany | Opis |
|---|---|---|---|
environment | string | ✅ | test, demo lub prod |
Parametry zapytania
| Parametr | Typ | Domyślnie | Opis |
|---|---|---|---|
status | string | unsent | Filtr statusu |
Dozwolone wartości status
| Wartość | Opis |
|---|---|
unsent | Domyślnie: obejmuje pending, signed, error, processing |
pending | Oczekujące na podpis |
signed | Podpisane, gotowe do wysłania |
error | Z błędem |
processing | W trakcie przetwarzania |
sent | Wysłane do KSeF |
all | Wszystkie statusy |
Odpowiedź 200
{
"invoices": [
{
"id": "uuid",
"invoiceNumber": "FV/2026/01/001",
"issueDate": "2026-01-15",
"buyerName": "Klient ABC",
"buyerNip": "1234567890",
"netAmount": 1000.00,
"grossAmount": 1230.00,
"vatAmount": 230.00,
"currency": "PLN",
"status": "signed",
"errorMessage": null,
"ksefReferenceNumber": null,
"qrLinkInvoice": "https://...",
"qrLinkCertificate": "https://...",
"createdAt": "2026-01-15 10:00:00"
}
],
"totalCount": 1
}
| Pole | Typ | Opis |
|---|---|---|
invoices | array | Lista faktur offline |
totalCount | integer | Łączna liczba faktur w wyniku |
Pola faktury offline:
| Pole | Typ | Opis |
|---|---|---|
id | string (uuid) | ID faktury offline |
invoiceNumber | string | Numer faktury |
issueDate | string | Data wystawienia (YYYY-MM-DD) |
buyerName | string | Nazwa firmy nabywcy |
buyerNip | string | NIP nabywcy |
netAmount | number | Kwota netto |
grossAmount | number | Kwota brutto |
vatAmount | number | Kwota VAT |
currency | string | Kod waluty |
status | string | Status faktury: pending, signed, error, processing, sent |
errorMessage | string | null | Komunikat błędu (tylko gdy status to error) |
ksefReferenceNumber | string | null | Numer referencyjny KSeF (tylko po wysłaniu paczki) |
qrLinkInvoice | string | null | URL weryfikacyjny QR dla faktury |
qrLinkCertificate | string | null | URL weryfikacyjny QR dla certyfikatu |
createdAt | string | Data utworzenia |
Kody błędów
| Kod | Opis |
|---|---|
| 401 | Brak autoryzacji |