Przewodnik · KSeF API / status

Faktura wysłana do KSeF, ale brak numeru KSeF albo UPO

Dokument został przekazany do KSeF, ale numer KSeF albo UPO nie są jeszcze dostępne.

Typ

Przewodnik

Warstwa

KSeF API / status

Skutek

Błąd blokujący

Typowy komunikat GoKSeF

System ERP pokazuje wysyłkę dokumentu, lecz nie zwraca numeru KSeF, UPO ani końcowego statusu przetwarzania.

Taki stan najczęściej oznacza opóźnienie po stronie KSeF albo rozjazd między statusem dokumentu w KSeF i statusem zapisanym w ERP. Zanim pojawią się kolejne działania, warto potwierdzić rzeczywisty status dokumentu bezpośrednio po stronie KSeF.

Jak to poprawić

  1. 1 Potwierdź zgodność środowiska: test/demo i produkcja nie mogą się mieszać.
  2. 2 Sprawdź token i uprawnienia do odczytu statusów.
  3. 3 Pobierz status dokumentu bezpośrednio z KSeF i odczytaj, czy jest nadal "w trakcie".
  4. 4 Jeżeli faktura jest w KSeF odrzucona jako duplikat, przerwij kolejną wysyłkę.
  5. 5 Sprawdź mapowanie ID faktury w ERP i synchronizuj je z identyfikatorem zwrotnym z KSeF.
  6. 6 Wyczyść cache statusów integracji i odśwież pobieranie danych.

Sprawdź przed ponowną walidacją

  • Status faktury po stronie KSeF jest jasno rozpoznawany.
  • Numer KSeF albo UPO zostały poprawnie pobrane i zapisane.
  • ERP nie wykonuje nadmiarowych ponownych wysyłek.
  • Mapowanie identyfikatora faktury między systemami jest stabilne.

FAQ

Czy faktura może być wysłana bez numeru KSeF przez jakiś czas?
Tak. Krótkie opóźnienie jest możliwe. Najpierw potwierdź status dokumentu w API KSeF, a dopiero potem podejmuj dalsze działania.
Czy w takiej sytuacji można wysyłać od nowa?
Co do zasady nie. Najpierw wyklucz opóźnienie, rozjazd statusu i ryzyko duplikatu.

Powiązane artykuły

Przewodnik · KSeF API / status

Faktura w trakcie przetwarzania w KSeF — co to znaczy

Status przetwarzania nie musi oznaczać błędu, ale wymaga świadomej kontroli i dalszej diagnostyki.

Przewodnik · KSeF API / status

Brak UPO w KSeF — jak diagnozować problem

Sam brak UPO nie przesądza jeszcze, czy problem dotyczy wysyłki, pobrania potwierdzenia czy synchronizacji statusu.

Przewodnik · ERP / synchronizacja statusu

Faktura jest w KSeF, ale nie widać jej w ERP

Taki objaw zwykle wskazuje na problem integracyjny po stronie systemu lokalnego, a nie na błąd samego XML.

Przewodnik · KSeF API / status

Ponowna wysyłka faktury do KSeF kończy się duplikatem

Kolejna wysyłka nie rozwiązuje problemu, jeżeli poprzednia próba została już przyjęta albo utknęła bez prawidłowego odtworzenia statusu.

Sprawdź poprawiony plik

Po poprawieniu danych źródłowych wygeneruj XML ponownie i sprawdź nowy plik w GoKSeF.

Przejdź do walidatora Inne błędy