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.

Typ

Przewodnik

Warstwa

KSeF API / status

Skutek

Błąd blokujący

Typowy komunikat GoKSeF

Po ponownej wysyłce system zwraca informację, że dokument już istnieje albo został rozpoznany jako duplikat.

Najczęściej jest to problem idempotencji i odzyskania statusu poprzedniej próby, a nie potrzeba generowania nowego pliku XML.

Jak to poprawić

  1. 1 Przerwij automatyczne lub ręczne ponawianie tej samej wysyłki.
  2. 2 Sprawdź, czy pierwsza próba nie zakończyła się przyjęciem dokumentu w KSeF.
  3. 3 Odtwórz status poprzedniej próby po numerze faktury, identyfikatorze sesji albo numerze KSeF.
  4. 4 Popraw logikę retry tak, aby nie wysyłała ponownie dokumentu bez weryfikacji poprzedniego wyniku.
  5. 5 Jeśli KSeF już ma dokument, przywróć stan ERP przez synchronizację, nie przez zmianę numeru faktury.

Sprawdź przed ponowną walidacją

  • Masz rozpoznany wynik pierwszej próby.
  • Retry nie wysyła ślepo tej samej faktury.
  • ERP odzyskał prawidłowy stan dokumentu.

FAQ

Czy to zawsze oznacza kod 440?
Najczęściej tak lub coś bardzo bliskiego temu mechanizmowi, ale użytkownik często widzi tylko efekt biznesowy, nie sam kod.
Czy zmiana numeru faktury jest dobrym obejściem?
Nie. To zwykle maskuje problem i niszczy spójność procesu.

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

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.

Sprawdź poprawiony plik

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

Przejdź do walidatora Inne błędy