Sprawdzanie statusu faktury

Wysłanie zapytania do KSeF Pipe jeszcze nie powoduje wysyłki do KSeF - ta odbywa się asnychronicznie w tle i może chwilę trwać. Ponadto, sam KSeF przetwarza faktury przez jakiś czas. W celu sprawdzenia, czy faktura została już przetworzona oraz zaakceptowana przez KSeF, wykonaj następujące zapytanie do API:

GET /api/v1/taxpayers/:nipNumber/invoices/sale/:invoiceNumber

gdzie:

• w miejsce :nipNumber podstaw NIP firmy, której dotyczy faktura,
• w miejsce :invoiceNumber podstaw zakodowany przy użyciu base64url numer faktury, której status chcesz sprawdzić.

wskazówka

Numery faktur często zawierają znaki specjalne, np. spacje oraz ukośniki. W związku z tym należy je zakodować metodą base64url, która gwarantuje prawidłowe przekazanie znaków specjalnych. Możesz skorzystać z konwertera lub jednej z implementacji do popularnych języków.

Faktury w kolejce

Jeśli faktura jest w kolejce do wysyłki, uzyskasz status 200 i następującą odpowiedź:

{
  "number": "FV 1/2026",
  "status": "pending",
  "ksefNumber": null,
  "ksefRejectionReason": null,
  "createdAt": "2026-03-08T14:44:12.561112+00:00",
  "updatedAt": "2026-03-08T14:44:15.868539+00:00",
  "uploadedAt": null
}

Faktury w trakcie przetwarzania

Jeśli faktura jest w trakcie przetwarzania przez KSeF, uzyskasz status 200 i następującą odpowiedź:

{
  "number": "FV 1/2026",
  "status": "processing",
  "ksefNumber": null,
  "ksefRejectionReason": null,
  "createdAt": "2026-03-08T14:44:12.561112+00:00",
  "updatedAt": "2026-03-08T14:44:15.868539+00:00",
  "uploadedAt": "2026-03-08T14:44:14.125614+00:00"
}

gdzie pole status może miec wartość:

• uploaded (wysłano ale KSeF jeszcze nie rozpoczął przetwarzania), lub
• processing (wysłano i KSeF rozpoczął przetwarzanie).

Faktury odrzucone

Jeśli faktura została wysłana ale została odrzucona przez KSeF, uzyskasz status 200 i następującą odpowiedź:

{
  "number": "FV 1/2026",
  "status": "rejected",
  "ksefNumber": null,
  "ksefRejectionReason": "duplicateInvoice",
  "createdAt": "2026-03-08T14:44:12.561112+00:00",
  "updatedAt": "2026-03-08T14:44:15.868539+00:00",
  "uploadedAt": "2026-03-08T14:44:14.125614+00:00"
}

W polu ksefRejectionReason znajduje się kod błędu na podstawie którego KSeF odrzucił fakturę.

Faktury zaakceptowane

Jeśli faktura została wysłana i zaakceptowana przez KSeF, uzyskasz status 200 i następującą odpowiedź:

{
  "number": "FV 1/2026",
  "status": "accepted",
  "ksefNumber": "1234567819-20260308-6EA715400000-15",
  "ksefRejectionReason": null,
  "createdAt": "2026-03-08T14:44:12.561112+00:00",
  "updatedAt": "2026-03-08T14:44:15.868539+00:00",
  "uploadedAt": "2026-03-08T14:44:14.125614+00:00"
}

W polu ksefNumber znajduje się numer faktury nadany przez KSeF.