Błąd 21111 potrafi zatrzymać autoryzację KSeF w najmniej odpowiednim momencie. Komunikat o „nieprawidłowym wyzwaniu autoryzacyjnym” wygląda groźnie, ale w praktyce najczęściej wynika z drobnych problemów technicznych podczas podpisywania pliku XML. W tym artykule wyjaśniamy, co dokładnie oznacza ten błąd, dlaczego pojawia się w trakcie autoryzacji i jak szybko go rozwiązać, żeby bez problemu połączyć się z KSeF przez Fakturowo.pl.
Co oznacza błąd 21111?
KSeF działa w oparciu o tzw. wyzwanie autoryzacyjne. W skrócie wygląda to tak: KSeF generuje jednorazowe wyzwanie, które musi zostać podpisane Profilem Zaufanym lub podpisem kwalifikowanym. Tylko poprawnie podpisane i aktualne wyzwanie pozwala potwierdzić tożsamość firmy.
Błąd 21111 oznacza, że KSeF uznał to wyzwanie za nieprawidłowe. Najczęściej nie chodzi o treść danych firmy, tylko o sam proces autoryzacji.
Najczęstsze przyczyny błędu
Z doświadczenia wiemy, że ten błąd pojawia się głównie w takich sytuacjach:
Nie. Fakturowo.pl nie generuje własnych wyzwań i nie ocenia ich poprawności. Proces wygląda następująco:
Najprostsze i najskuteczniejsze rozwiązanie to wykonanie autoryzacji od nowa.
Jeśli błąd nadal się pojawia
Jeżeli mimo wykonania powyższych kroków błąd 21111 nadal występuje, przyczyną może być problem po stronie KSeF lub środowiska podpisu. W takiej sytuacji warto spróbować ponownie po kilku minutach albo użyć innej metody podpisu, na przykład innej przeglądarki lub innego narzędzia do podpisu kwalifikowanego.
Co oznacza błąd 21111?
KSeF działa w oparciu o tzw. wyzwanie autoryzacyjne. W skrócie wygląda to tak: KSeF generuje jednorazowe wyzwanie, które musi zostać podpisane Profilem Zaufanym lub podpisem kwalifikowanym. Tylko poprawnie podpisane i aktualne wyzwanie pozwala potwierdzić tożsamość firmy.
Błąd 21111 oznacza, że KSeF uznał to wyzwanie za nieprawidłowe. Najczęściej nie chodzi o treść danych firmy, tylko o sam proces autoryzacji.
Najczęstsze przyczyny błędu
Z doświadczenia wiemy, że ten błąd pojawia się głównie w takich sytuacjach:
- Plik XML do autoryzacji został podpisany zbyt późno. Wyzwanie ma krótki czas ważności i jeśli minie kilka lub kilkanaście minut, KSeF je odrzuci.
- Podpisano inny plik niż ten, który został pobrany z Fakturowo.pl. Nawet drobna zmiana lub pomylenie plików powoduje błąd.
- Plik XML został zmodyfikowany przed podpisem, na przykład przez edytor, program pocztowy albo system operacyjny.
- Użyto nieprawidłowego typu podpisu. KSeF wymaga podpisu XAdES wewnętrznego, czyli podpis i treść muszą znajdować się w jednym pliku.
- W tle wygasła sesja lub nastąpiło przerwanie procesu autoryzacji.
Nie. Fakturowo.pl nie generuje własnych wyzwań i nie ocenia ich poprawności. Proces wygląda następująco:
- Pobierasz plik XML z naszego systemu.
- Podpisujesz go Profilem Zaufanym lub podpisem kwalifikowanym.
- Wgrywasz podpisany plik z powrotem do Fakturowo.pl.
- My przekazujemy ten plik bez żadnych zmian bezpośrednio do API KSeF.
- Komunikat 21111 pochodzi wprost z serwerów Ministerstwa Finansów.
Najprostsze i najskuteczniejsze rozwiązanie to wykonanie autoryzacji od nowa.
- Usuń aktualną autoryzację KSeF w Fakturowo.pl.
- Wygeneruj nowy plik XML do autoryzacji.
- Podpisz go od razu po pobraniu, bez zapisywania kopii i bez edycji.
- Upewnij się, że podpis to XAdES wewnętrzny.
- Nie zwlekaj z wgraniem podpisanego pliku z powrotem do systemu.
Jeśli błąd nadal się pojawia
Jeżeli mimo wykonania powyższych kroków błąd 21111 nadal występuje, przyczyną może być problem po stronie KSeF lub środowiska podpisu. W takiej sytuacji warto spróbować ponownie po kilku minutach albo użyć innej metody podpisu, na przykład innej przeglądarki lub innego narzędzia do podpisu kwalifikowanego.
