440 · KSeF API / deduplikacja

Duplikat faktury: kod 440

KSeF odrzucił dokument jako duplikat, a system nie przyjął ponownej próby wysyłki.

Kod

440

Warstwa

KSeF API / deduplikacja

Skutek

Błąd blokujący

Typowy komunikat GoKSeF

Błąd pojawia się najczęściej po ręcznej albo automatycznej ponownej wysyłce tego samego dokumentu bez prawidłowego odtworzenia jego statusu.

Kod 440 najczęściej oznacza, że dokument już istnieje w KSeF, a kolejna wysyłka została zatrzymana przez mechanizm deduplikacji.

Jak to poprawić

  1. 1 Sprawdź, czy KSeF nie ma już tego dokumentu w rejestrze.
  2. 2 Zweryfikuj, czy numer dokumentu i RodzajFaktury były mapowane stabilnie.
  3. 3 Ustal, czy przyczyną nie była utrata statusu powodująca automatyczny retry.
  4. 4 Jeżeli faktura rzeczywiście już istnieje, nie zmieniaj jej numeru wyłącznie, aby ominąć błąd.
  5. 5 Przywróć deterministyczną logikę generowania jednego klucza identyfikacji na fakturę.

Sprawdź przed ponowną walidacją

  • Status i numer istniejącego dokumentu z KSeF są widoczne.
  • Brak niekontrolowanych powtórzeń tej samej faktury.
  • Logika identyfikatora faktury działa deterministycznie.

FAQ

Czy kod 440 oznacza, że faktura została przyjęta?
Najczęściej tak — KSeF już ma dokument i blokuje kolejną wysyłkę tej samej wersji.
Czy mogę zmienić numer faktury i wysłać ponownie?
Nie. Sama zmiana numeru nie usuwa przyczyny problemu i zwykle prowadzi do dalszej niespójności 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