Przy obowiązkowym KSeF ten sam koszt przychodzi nawet trzema drogami: system pobiera fakturę z KSeF po NIP firmy, dostawca dosyla PDF mailem, a na biurko trafia papierowy wydruk. Bez reguły deduplikacji dokument ląduje w ewidencji dwa razy, a błąd wychodzi przy zamknięciu miesiąca. Poniżej: kanoniczny identyfikator, okna pobierania i procedura. Stan sprawdzony 03.09.2026.
Skąd się biorą duplikaty
Mechanika jest ta sama w sklepie i w usługach: dostawca wysyła fakturę do KSeF i równolegle PDF mailem, papierowy wydruk ktoś wpisuje ręcznie, pobrania z API nachodzą oknami, a przy błędzie NIP wraca korekta i drugi dokument. Do tego oddziały dostawcy w różnych seriach numeracji mylą proste porównania po numerze. Osobno niegroźne, razem dają podwójne koszty.
Sześć scenariuszy, jedna tabela decyzji
| Scenariusz | Co się stało | Który dokument liczy się w ewidencji |
|---|---|---|
| KSeF + PDF z maila | Ten sam dokument pobrany z KSeF i załączony mailem przez dostawcę | Wpis z KSeF z numerem KSeF; PDF tylko podgląd roboczy |
| KSeF + papierowy wydruk | Wydruk zaniesiony do księgowości i wpisany ręcznie | Wpis z KSeF; wydruk niszczyć po sparowaniu albo archiwizować poza ewidencją |
| Dwa pobrania z API | Nachodzące okna czasowe pobrały tę samą paczkę | Jeden wpis; drugi odrzuca deduplikacja po numerze KSeF |
| Faktura zagraniczna | Dokument spoza polskiego KSeF przyszedł tylko mailem | Wpis z maila lub OCR; w KSeF tego dokumentu nie ma i nie będzie |
| Błędny NIP u dostawcy | Faktura poszła do KSeF z cudzym NIP, potem korekta i nowa faktura | Tylko nowa faktura z poprawnym NIP; korekta zerowa do wglądu |
| Korekta faktury kosztowej | Korekta jako nowy dokument powiązany z fakturą pierwotną | Oba dokumenty w ewidencji: pierwotna plus korekta, nie zamiast |
Zasada ogólna jest jedna: dokument krajowy od polskiego dostawcy rozstrzyga się w KSeF, a mail i papier są kanałami pomocniczymi. Wyjątkiem są faktury zagraniczne, które do polskiego KSeF nie trafiają i trzeba je importować ręcznie lub przez OCR (ksefakt.pl, 21.04.2026).
Kanoniczny klucz: numer KSeF
Numer KSeF to unikalny identyfikator nadawany fakturze po przyjęciu do systemu i zwracany w UPO (Urzędowe Poświadczenie Odbioru); nie jest elementem pliku XML (ksef.podatki.gov.pl, 30.06.2025; modyfikacja 06.02.2026). Data otrzymania faktury to data nadania numeru, niezależnie od momentu pobrania. W sporze „który wpis prawdziwy" wygrywa ten z numerem KSeF.
Eksport z API zwraca paczkę z plikiem _metadata.json z numerami KSeF wszystkich faktur, a deduplikacja odrzuca powtórzone numery (DistinctBy KsefNumber we wzorcach CIRFMF; repo CIRFMF/ksef-api, pobieranie przyrostowe). Pobieranie pracuje przylegającymi oknami ze znacznikiem HWM: kolejne okno startuje w punkcie poprzedniego, a nakładki usuwa deduplikacja po metadanych. Po przekroczeniu tempa API odpowiada 429 z nagłówkiem do ponowienia: klient zwalnia i powtarza, nie dubluje zapytań.
Osobny mechanizm działa po stronie wystawiania. KSeF wykrywa duplikaty globalnie na kombinacji NIP sprzedawcy, rodzaju faktury i numeru faktury z pola P_2, zwraca wtedy kod 440 („Duplikat faktury"), a unikalność trzymana jest przez 10 pełnych lat od końca roku wystawienia (CIRFMF/ksef-api, rozdział o weryfikacji faktury). Dla odbiorcy wniosek praktyczny: dopasowanie robocze rób po czwórce NIP wystawcy plus numer plus data plus kwota, ale rozstrzygnięcie zawsze po numerze KSeF.
Procedura: pięć kroków do czystej ewidencji
Krok 1: Ustal kolejność kanałów na piśmie: KSeF rozstrzyga dokumenty krajowe, mail i papier służą do podglądu i faktur zagranicznych. Wpis ręczny z papieru wymaga sparowania z KSeF tego samego dnia.
Krok 2: Ustaw jedno okno pobierania z HWM. Dla małej firmy wystarczy pobieranie raz dziennie rano, wszystkie faktury z dnia poprzedniego są już dostępne (ksefakt.pl, 21.04.2026). Włącz obsługę metadanych z paczki eksportu i deduplikację po numerze KSeF przed zapisem do ewidencji, a nie po.
Krok 3: Sparuj zaległości. Dla kosztu bez numeru KSeF sprawdź wpis o tym samym NIP, numerze, dacie i kwocie. Jeśli istnieje, wpis ręczny usuwasz, a papier archiwizujesz poza ewidencją. Jeśli nie, koszt zostaje z maila lub OCR do czasu odpowiednika w KSeF albo klasyfikacji jako zagraniczny.
Krok 4: Domknij przypadki specjalne. Faktura zaliczkowa zapisuje numer KSeF zaliczki, faktura końcowa wiąże się z nią automatycznie; korekta kosztowa aktualizuje ewidencję jako nowy dokument powiązany z pierwotną (ksefakt.pl, 21.04.2026). Przy błędnym NIP żądasz od dostawcy korekty zerowej i nowej faktury z poprawnym NIP, starego wpisu nie księgujesz.
Krok 5: Zepnij z JPK. Zatwierdzona faktura trafia do ewidencji zakupów JPK_V7M z numerem KSeF; struktura JPK_VAT wymaga numeru po obu stronach (ksef.podatki.gov.pl; JPK_V7M(3) i JPK_V7K(3) od 01.02.2026). Faktura leży w KSeF 10 lat, opóźnione pobranie nic nie gubi.
Sklep a biuro rachunkowe: dwie różne wrażliwości
Sklep internetowy z setkami faktur kosztowych miesięcznie (towar, logistyka, reklama, prowizje platform) najbardziej cierpi na duplikaty z kanału mailowego: marketplace i operatorzy dosyłają PDF, a KSeF i tak ma oryginał. Tu wygrywa twarda reguła „najpierw KSeF, mail tylko do faktur zagranicznych" plus automatyczne reguły importu po NIP dostawcy z przypisaniem kont i MPK (ksefakt.pl, 21.04.2026).
Biuro rachunkowe ma odwrotny problem: dziesiątki klientów i ich pracownicy wpisujący papiery ręcznie. Tu wygrywa procedura sparowania tego samego dnia i weryfikacja NIP dostawcy w białej liście przy każdym pobraniu, z ostrzeżeniem przy nieaktywnym NIP (ksefakt.pl, 21.04.2026). Uprawnienie odbioru per NIP klienta przez token API musi być nadane z wyprzedzeniem, inaczej koszty klienta w ogóle nie spłyną (ksef.podatki.gov.pl, 27.04.2026).
Uczciwie: kiedy deduplikacja to przerost formy
Przy kilku fakturach kosztowych miesięcznie od stałych dostawców pełna mechanika okien, HWM i metadanych to przerost formy. Wystarczy poranny rzut oka na sekcję faktur otrzymanych w Aplikacji Podatnika i ręczne sparowanie z mailami. Automatyczną deduplikację warto wdrażać, gdy miesięcznie przewija się kilkadziesiąt dokumentów, gdy koszty spływają z trzech kanałów naraz albo gdy księgowość łapie duplikaty częściej niż raz na kwartał. Poniżej tego progu tańsza jest dyscyplina niż integracja.
Co dalej
Jeśli ten temat dotyczy Twojej firmy, zacznij od kroku 3 procedury: jednorazowego sparowania zaległości. Dopiero czysta ewidencja pokazuje, czy potrzebujesz automatyzacji, czy wystarczy reguła kanałów. [UZUPEŁNIJ-LINK-KONSULTACJI]
Zachowanie konkretnych programów księgowych przy duplikatach (który wpis wygrywa w ich imporcie i czy ostrzegają) - DO POTWIERDZENIA (metoda: test na koncie demo dwóch popularnych programów przed publikacją artykułu). Komunikaty aplikacji przy kodzie 440 i praktyka dostawców przy korektach zerowych - DO POTWIERDZENIA (metoda: dokumentacja dostawcy i testowe wystawienie w środowisku demo KSeF przed publikacją).