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.

Typ

Przewodnik

Warstwa

KSeF API / status

Skutek

Ostrzeżenie

Typowy komunikat GoKSeF

System lokalny pokazuje status „w trakcie przetwarzania”, a numer KSeF ani wynik końcowy nie są jeszcze dostępne.

Jest to stan pośredni. Najpierw należy potwierdzić status dokumentu po stronie KSeF, a dopiero potem ocenić, czy chodzi o opóźnienie, rozjazd statusu czy błąd obsługi odpowiedzi.

Jak to poprawić

  1. 1 Sprawdź bezpośrednio w KSeF, czy dokument nadal jest przetwarzany, czy ma już wynik końcowy.
  2. 2 Odczekaj rozsądny czas zgodny z praktyką integracji i dopiero potem wykonaj ponowne odpytywanie statusu.
  3. 3 Nie ponawiaj wysyłki tego samego dokumentu, dopóki nie masz pewności, że poprzednia próba nie zakończyła się przyjęciem.
  4. 4 Sprawdź, czy integracja prawidłowo zapisuje identyfikator sesji, identyfikator dokumentu i odpowiedź zwrotną.
  5. 5 Jeżeli status w KSeF jest końcowy, ale ERP nadal pokazuje przetwarzanie, potraktuj to jako problem synchronizacji, nie walidacji XML.

Sprawdź przed ponowną walidacją

  • Status końcowy dokumentu jest znany po stronie KSeF.
  • ERP zapisuje wynik końcowy i nie pozostaje w stanie przejściowym.
  • Nie uruchomiono zbędnej ponownej wysyłki.

FAQ

Czy status przetwarzania oznacza błąd faktury?
Nie zawsze. Często oznacza stan pośredni, który trzeba odróżnić od błędu semantycznego albo problemu integracyjnego.
Czy można od razu wysłać dokument jeszcze raz?
Nie. To jeden z najprostszych sposobów, by doprowadzić do duplikatu i utraty kontroli nad statusem dokumentu.

Powiązane artykuły

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.

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