Brak numeru KSeF lub duplikaty? Najpierw ustalmy stan dokumentu
Odtwarzamy historię dokumentu pomiędzy ERP, warstwą integracyjną i KSeF 2.0. Dzięki temu wiadomo, czy potrzebna jest korekta danych, bezpieczne ponowienie, uzgodnienie statusu czy zmiana mechanizmu integracji.
Kiedy warto działać
Pozornie ten sam objaw może mieć kilka różnych przyczyn
Komunikat użytkownika często nie pokazuje, czy problem powstał przed wysyłką, podczas przetwarzania w KSeF, przy odbiorze odpowiedzi czy podczas zapisu wyniku w ERP.
- ERP nie pokazuje numeru KSeF, choć dokument mógł zostać przyjęty.
- Automatyczne retry powtarza operację bez sprawdzenia jej poprzedniego wyniku.
- Status „w toku” nie ma limitu czasu ani właściciela eskalacji.
- Log techniczny istnieje, lecz nie pozwala znaleźć pełnej historii konkretnej faktury.
Diagnozujemy dokument, mechanizm i warunki awarii
Nie maskujemy błędu kolejnym ponowieniem. Łączymy identyfikatory, statusy, logi, XML i zapis w ERP, aby ustalić przyczynę oraz bezpieczny następny krok.
Brak numeru KSeF
Sprawdzamy, czy dokument nie został przyjęty, czy odpowiedź nie wróciła do ERP albo czy proces zatrzymał się na statusie pośrednim.
Duplikaty i idempotencja
Analizujemy identyfikatory techniczne i biznesowe, politykę ponowień oraz warunki, w których ta sama operacja może zostać wykonana drugi raz.
Statusy i ponowienia
Porządkujemy automat stanów dokumentu, limity prób, odstępy między ponowieniami i moment przekazania sprawy człowiekowi.
Błędy FA(3) i danych
Lokalizujemy niespójność między danymi ERP, modelem pośrednim, wygenerowanym XML i odpowiedzią walidatora.
Limity i opóźnienia API
Oddzielamy rzeczywiste odrzucenie od chwilowego ograniczenia, długiego przetwarzania lub problemu komunikacyjnego.
Uprawnienia i certyfikaty
Weryfikujemy kontekst podatnika, zakres uprawnień, ważność używanych poświadczeń i sposób obsługi ich wymiany.
Niespójny zapis w ERP
Sprawdzamy, czy numer, status i identyfikatory techniczne są przypisane do właściwego dokumentu źródłowego.
Kolejka wyjątków
Projektujemy widok spraw wymagających decyzji użytkownika wraz z przyczyną, historią i bezpieczną akcją naprawczą.
Bezpieczna obsługa incydentu
Od ręcznego ponawiania do jednoznacznego stanu
Działanie bez diagnozy
- Ponowienie wysyłki na podstawie komunikatu użytkownika
- Ręczne dopisywanie numeru bez pełnej historii dokumentu
- Łączenie błędów walidacji, dostępu i komunikacji w jeden status
- Brak dowodu, które operacje zostały wykonane
Kontrolowana obsługa błędu
- Sprawdzenie stanu przed ponowieniem operacji
- Korelacja dokumentu ERP, żądania, sesji i odpowiedzi KSeF
- Osobne ścieżki dla błędu danych, dostępu i niedostępności
- Historia decyzji oraz mierzalne kryterium zamknięcia sprawy
Plan wdrożenia
Jak lokalizujemy źródło błędu
Zakres zależy od objawu i architektury, ale każda diagnoza powinna zachować dowody oraz chronić przed wykonaniem tej samej operacji w niekontrolowany sposób.
- 1
Identyfikacja dokumentu
Łączymy numer ERP, identyfikator integracji, sesję, żądanie i dostępny status KSeF.
- 2
Oś czasu
Odtwarzamy kolejne próby, odpowiedzi, timeouty, zmiany statusu i działania użytkowników.
- 3
Weryfikacja danych
Porównujemy źródło w ERP, model pośredni, XML FA(3) i rezultat walidacji.
- 4
Test hipotezy
Na bezpiecznym środowisku lub kontrolowanej próbce potwierdzamy rzeczywistą przyczynę.
- 5
Plan uzgodnienia
Określamy, jak przywrócić spójność bez nadpisania historii i tworzenia kolejnych duplikatów.
- 6
Zapobieganie
Dodajemy regułę, alert lub test, który pozwoli wcześniej wykryć podobny przypadek.
Nie wykonujemy nieodwracalnych zmian na podstawie samego komunikatu błędu
Diagnoza techniczna nie zastępuje decyzji podatkowej ani prawnej. Korekta dokumentu, jego ujęcie w księgach lub zmiana danych produkcyjnych wymagają zatwierdzenia przez odpowiedzialne osoby po stronie firmy.
Najczęstsze pytania: diagnostyka błędów ksef
Czy brak numeru KSeF oznacza, że faktura nie została przyjęta?
Nie zawsze. Przyczyną może być odrzucenie dokumentu, status nadal przetwarzany, utracona odpowiedź albo brak zapisu wyniku w ERP. Przed ponowieniem trzeba ustalić rzeczywisty stan dokumentu.
Czy można po prostu wysłać fakturę ponownie?
Ponowienie bez sprawdzenia stanu i identyfikatorów może zwiększyć ryzyko duplikatu albo utrudnić uzgodnienie dokumentów. Najpierw odtwarzamy historię żądania i odpowiedzi.
Jak rozpoznać duplikat?
Potrzebna jest jednoznaczna reguła oparta na identyfikatorach technicznych i biznesowych, a nie wyłącznie na numerze dokumentu widocznym dla użytkownika. Regułę dopasowujemy do architektury integracji.
Czy diagnoza wymaga zatrzymania integracji?
Nie zawsze. Zwykle zaczynamy od logów, kolejki i wybranych dokumentów. Jeżeli zachodzi ryzyko pogłębiania niespójności, rekomendujemy kontrolowane ograniczenie konkretnego przepływu, a nie automatycznie całego systemu.
Czy naprawiacie też dane w ERP?
Najpierw wskazujemy źródło i bezpieczny sposób uzgodnienia. Zmiany danych produkcyjnych wymagają osobnego planu, kopii bezpieczeństwa, akceptacji właściciela danych i możliwości odtworzenia operacji.
Czy to jest konsultacja podatkowa?
Nie. Diagnozujemy techniczny stan dokumentu, komunikację systemów i zapis danych. Sposób podatkowego ujęcia dokumentu powinien zatwierdzić właściwy specjalista.
Powiązane rozwiązania
Audyt powdrożeniowy KSeF
Szersza kontrola integracji, procesów, uprawnień i scenariuszy awaryjnych.
Monitoring KSeF
Alerty i wskaźniki pozwalające wykrywać problem przed eskalacją użytkownika.
Integracja KSeF z ERP
Architektura wymiany, mapowanie FA(3), kolejki i obsługa wielu podmiotów.
12 błędów integracji KSeF
Materiał edukacyjny o objawach, walidacji, statusach, duplikatach, limitach i sesjach.
Pokaż nam objaw i historię dokumentu
Opisz używany ERP, widoczny status i moment, w którym proces się zatrzymał. Ustalimy bezpieczny zakres diagnozy — bez obietnicy naprawy przed poznaniem przyczyny.