Nowość: connector do Comarch Optima.Zobacz, jak działa

„Token nieaktywny lub brak autoryzacji” w Optimie: przyczyny w biurze z wieloma klientami

Nikodem GrzymałaNikodem Grzymała8 min czytania

Poniedziałek, 9:10. Księgowa otwiera bazę klienta w Optimie, wchodzi w faktury z KSeF i zamiast listy dostaje komunikat o braku autoryzacji. Pierwsze, co robi, to wpisuje go w Google słowo w słowo. Rozmawiam z biurami na Optimie od wielu miesięcy i widzę, że ten komunikat prawie nigdy nie oznacza jednego błędu. To worek z kilkoma różnymi przyczynami. Poniżej rozbieram go w kolejności, w jakiej warto sprawdzać.

Co naprawdę mówi ten komunikat

Optima loguje się do KSeF certyfikatem KSeF, podpisem kwalifikowanym lub pieczęcią albo tokenem. Sposób wybiera się w menu KSeF, opcją „Zmień sposób uwierzytelniania KSeF”. Z dokumentacji Comarch wynikają dwie rzeczy, które w biurze z wieloma klientami robią całą różnicę. Wklejony token zapisuje się w bazie firmowej dla konkretnego operatora. I cytat: „W tokenie są zakodowane informacje jakiej firmy on dotyczy i jakie uprawnienia ma w niej nadane”.

Czyli token jest przywiązany do jednej firmy, jednej bazy i jednej osoby w biurze. Komunikat o braku autoryzacji mówi tylko tyle, że KSeF nie przyjął poświadczenia dla tego NIP-u. Nie mówi, dlaczego. Wygasły token, token innej spółki, odebrane uprawnienia, złe środowisko: objaw ten sam.

W bazie wiedzy Comarch komunikat „Brak autoryzacji” ma numer 24098. Instrukcja: wskaż certyfikat przy generowaniu tokenu albo wygeneruj token w KSeF i wklej go w konfiguracji firmy, zapisując bez klikania „Generuj token”. Potem sprawdź listę osób uprawnionych, a jeśli błąd nie znika, Helpdesk KSeF. Dla jednej firmy to wystarczy. W biurze z sześćdziesięcioma bazami brakuje w tej instrukcji pierwszego pytania: u ilu klientów to występuje.

Jedna baza czy wszystkie

Drzewko decyzyjne: błąd autoryzacji u jednego klienta prowadzi do jego tokenu i uprawnień, u wszystkich naraz do poświadczenia biura albo przerwy KSeFbłąd u jednego klienta?taknie, u wszystkichbłąd u jednego klienta? taku wszystkich naraztoken albo uprawnieniatego jednego klientatoken wygasł lub odwołanytoken innego NIP-u / innej bazyklient nie nadał biuru uprawnieńsprawdź najpierwpoświadczenie biuraalbo przerwa KSeFcertyfikat biura wygasłlimit albo awaria KSeFstara wersja Optimynie ruszaj tokenów klientównie ruszaj tokenówDrzewko decyzyjne: błąd autoryzacji u jednego klienta prowadzi do jego tokenu i uprawnień, u wszystkich naraz do poświadczenia biura albo przerwy KSeFbłąd u jednego klienta?taknie, u wszystkichbłąd u jednego klienta? taku wszystkich naraztoken albo uprawnieniatego jednego klientatoken wygasł lub odwołanytoken innego NIP-u / innej bazyklient nie nadał biuru uprawnieńsprawdź najpierwpoświadczenie biuraalbo przerwa KSeFcertyfikat biura wygasłlimit albo awaria KSeFstara wersja Optimynie ruszaj tokenów klientównie ruszaj tokenów
Pierwsze pytanie przy błędzie autoryzacji. Zielona gałąź to ta, którą sprawdzasz najpierw.

Zanim ktokolwiek zacznie generować nowe tokeny, otwórz drugą bazę i spróbuj pobrać faktury. To dwie minuty, które oszczędzają godzinę. Wynik dzieli problem na trzy zupełnie różne sytuacje.

  • Błąd u jednego klienta. Reszta pobiera normalnie. Przyczyna leży po stronie tego klienta: jego token, jego uprawnienia, jego baza.
  • Błąd u wszystkich naraz. Coś wspólnego przestało działać: certyfikat biura, przerwa albo limit po stronie KSeF, wersja Optimy. Nowy token dla pierwszej firmy z listy niczego nie da.
  • Błąd tylko u jednej osoby w biurze. Koleżanka na tej samej bazie pobiera, ty nie. Token w Optimie jest zapisany per operator, więc nowy pracownik musi mieć własne uwierzytelnienie. Operator potrzebuje też parametru „Prawo do odbierania e-Faktur” na swojej karcie; bez niego Optima pokazuje informację 35248 „Operator nie posiada uprawnień do pobierania e-Faktur z KSeF”.

Błąd u jednego klienta: token i uprawnienia

Z rozmów z biurami wychodzi, że tu mieści się większość przypadków.

  • Token wygasł albo został odwołany. Klient mógł unieważnić go w Aplikacji Podatnika, bo zmieniał program do fakturowania albo „sprzątał” uprawnienia. Biuro dowiaduje się o tym z komunikatu w Optimie. Nowy token trzeba wkleić ponownie.
  • Token wygenerowany dla innego NIP-u. Klient ma dwie spółki i przysłał token tej, której baza stoi obok. Token koduje firmę, więc KSeF odmówi. Gdy token generuje sama Optima, bierze NIP z pieczątki firmy; ostrzeżenie 35245 „Aby utworzyć lub usunąć token uzupełnij NIP w pieczątce firmy” mówi, skąd program go czyta. Pusty albo stary NIP w pieczątce daje ten sam efekt co cudzy token.
  • Token wklejony do niewłaściwej bazy. Dwie bazy o podobnych nazwach, dwa maile od klientów tego samego dnia. Porównaj NIP z pieczątki bazy z NIP-em firmy, dla której klient generował token.
  • Klient nie nadał biuru uprawnień albo je odebrał. Comarch opisuje dwie drogi do tokenu klienta: klient generuje go sam i przesyła, albo biuro generuje go na stronie KSeF, „jeśli Klient nada odpowiednie uprawnienia dla biura”. Bez tych uprawnień żaden certyfikat ani token biura nie otworzy faktur tej firmy. Tego nie naprawi biuro. Musi to zrobić klient w Aplikacji Podatnika.
  • Środowisko testowe zamiast produkcyjnego. W konfiguracji KSeF dla bazy wybiera się „demo (przedprodukcyjne)” albo „produkcyjne”. Według Comarch demo jest zaznaczane domyślnie dla nowych baz i baz po konwersji. Token z produkcji w bazie, która wciąż stoi na demo, dostaje odmowę. Przy przełączaniu na produkcję program ostrzega, że usunie informacje powiązane z KSeF w tej bazie, więc token i tak wklejasz od nowa.
  • Baza odtworzona z kopii. Comarch podaje, że przy odtwarzaniu bazy firmowej z kopii odznaczany jest parametr „Aktywuj wymianę danych z KSeF”, a dane uwierzytelniające operatorów są usuwane. Jeśli informatyk w nocy przywracał bazę jednego klienta, rano ten jeden klient nie pobiera.

Błąd u wszystkich naraz: poświadczenie biura albo przerwa KSeF

Gdy komunikat pojawia się w każdej bazie, zostaw tokeny klientów w spokoju. Szukaj tego, co łączy bazy.

  • Certyfikat biura wygasł albo został unieważniony. W modelu, który Comarch opisuje dla biur na wersji 2026, klient nadaje biuru uprawnienia jako podmiotowi pośredniczącemu, biuro nadaje odczyt pracownikom po numerach PESEL, a pracownik generuje w Aplikacji Podatnika własny certyfikat. Obejmuje on, cytuję, „wszystkich Klientów, którzy nadali dla tego biura uprawnienia w KSeF”. Jeden plik, wszyscy klienci. Gdy wygaśnie, staje wszystko w jednej chwili. Certyfikat KSeF jest ważny najwyżej dwa lata, więc datę zapisz tam, gdzie pilnujesz terminów VAT.
  • Przerwa albo limit po stronie KSeF. KSeF liczy zapytania na godzinę dla NIP-u i miewa niedostępności. Odmowa przychodzi wtedy wszystkim naraz i mija sama. Zanim ktoś wygeneruje 60 nowych tokenów, sprawdź komunikaty o dostępności KSeF na stronie ministerstwa. Ponawianie w kółko tylko wydłuża blokadę.
  • Wersja Optimy. Comarch podał w nowościach wersji 2026.5.1, że w wersji 2026.3.1 lub starszej dostęp do KSeF kończy się z dniem 1 sierpnia 2026 roku. Biuro, które odkładało aktualizację, zobaczy błąd we wszystkich bazach tego samego dnia. Ta sama dokumentacja dodaje, że przy odtworzeniu lub podłączeniu bazy konfiguracyjnej usuwane są ustawienia sposobu uwierzytelniania operatorów w KSeF.
  • Koniec tokenów według rozporządzenia. Przepisy dopuszczają tokeny do 31 grudnia 2026. Projekt MF z 27 października 2026 przewiduje ich utrzymanie ze skróconą ważnością 365 dni, ale to projekt. Biuro z 60 tokenami od klientów może 2 stycznia zobaczyć ten komunikat w 60 bazach naraz. Jak się przygotować: Tokeny czy certyfikaty KSeF.

Kolejność sprawdzania

Każdy krok zamyka jedną grupę przyczyn, zanim przejdziesz do następnej.

  1. 1Otwórz drugą i trzecią bazę i spróbuj pobrać faktury. Ustal, czy błąd jest u jednego klienta, u wszystkich, czy tylko u jednej osoby w biurze.
  2. 2Jeśli u wszystkich: sprawdź datę ważności certyfikatu biura, komunikaty o dostępności KSeF, wersję Optimy i to, czy w nocy ktoś nie odtwarzał baz. Dopiero potem dotykaj czegokolwiek w bazach klientów.
  3. 3Jeśli u jednej osoby: zajrzyj do karty operatora i parametru „Prawo do odbierania e-Faktur”, a potem do jej własnego uwierzytelnienia. Komunikat „Nie możesz wykonać tej operacji, ponieważ dla Twojego operatora nie skonfigurowano metody uwierzytelniania” mówi dokładnie o tym.
  4. 4Jeśli u jednego klienta: porównaj NIP z pieczątki bazy z NIP-em firmy, dla której klient generował token, i środowisko bazy („demo” czy „produkcyjne”) ze środowiskiem, w którym token powstał.
  5. 5Zapytaj klienta, czy coś zmieniał w Aplikacji Podatnika: nowy program do faktur, porządki w uprawnieniach, zmiana osoby reprezentującej. Odebrane uprawnienie wygląda z Optimy identycznie jak wygasły token.
  6. 6Poproś o nowy token dla właściwego NIP-u i środowiska albo, jeśli klient nadał biuru uprawnienia, wygeneruj go sam. Wklej, zapisz bez „Generuj token”, sprawdź pobranie.
  7. 7Zapisz przyczynę w jednym miejscu dla całego biura. Po kilku wpisach widać wzór, najczęściej tokeny przysyłane przez klientów. To najlepszy argument za certyfikatem biura i uprawnieniami nadanymi przez klientów.

Jak to wygląda w Taxso

Taxso rozdziela te warstwy od początku. Poświadczenie KSeF biura, czyli certyfikat albo token, jest jedno na całe biuro i wgrywa je administrator na ekranie KSeF, ze środowiskiem Testowe albo Produkcyjne. Każda firma tylko nadaje biuru uprawnienia w Aplikacji Podatnika, a przy pobieraniu zmienia się wyłącznie kontekst, NIP firmy. Co wybrać i co z końcem tokenów: Token czy certyfikat. Pytanie „jedna baza czy wszystkie” odpada, bo przy każdej firmie na jednej liście stoi plakietka: autoryzacja OK, brak autoryzacji KSeF z przyciskiem Poproś klienta o uprawnienia, brak NIP-u, brak poświadczenia biura albo limit KSeF - stan nieznany. Testuj połączenie sprawdza jedną firmę bez włączania pobierania.

Samo pobieranie działa w tle, co 15 minut dla każdej firmy. Przy limicie KSeF widzisz wstrzymane do HH:MM i automat sam wraca o tej godzinie, przy awarii ponawiamy o HH:MM, a gdy klient nie nadał uprawnień, firma dostaje stan Wymaga działania z etykietą brak uprawnień w KSeF, a pozostałe pobierają dalej. Wygasły certyfikat ma etykietę KSeF odrzuca poświadczenie biura, a wcześniej przypomnienie Certyfikat ważny do <data> z plakietką zostało N dni. W Obiegu karta Synchronizacja pokazuje wiersz KSeF ze stanem wstrzymane do <czas>, wyłączone albo brak pobrań, a na karcie firmy stoi NIP i karta Akceptacja klienta · KSeF. Każdy komunikat z przyczyną i krokiem naprawczym: Komunikaty i co zrobić. Całość w pracy biura: Taxso dla biur.

Najczęstsze pytania

Czy komunikat o braku autoryzacji w Optimie zawsze oznacza wygasły token?+

Nie. Ten sam komunikat daje token wygenerowany dla innego NIP-u, token wklejony do niewłaściwej bazy, odebrane przez klienta uprawnienia i niezgodność środowiska demo z produkcyjnym. Dlatego najpierw sprawdź, czy błąd występuje u jednego klienta, czy u wszystkich.

Dlaczego koleżanka pobiera faktury z tej samej bazy, a ja widzę błąd?+

Optima zapisuje token w bazie firmowej dla konkretnego operatora, więc każda osoba w biurze uwierzytelnia się osobno. Operator potrzebuje też parametru Prawo do odbierania e-Faktur na swojej karcie w konfiguracji programu. Bez niego program pokazuje informację, że operator nie ma uprawnień do pobierania e-Faktur z KSeF.

Błąd pojawił się we wszystkich bazach naraz. Co sprawdzić najpierw?+

To, co łączy wszystkie bazy: datę ważności certyfikatu biura, komunikaty o dostępności KSeF, wersję Optimy i to, czy ktoś nie odtwarzał bazy konfiguracyjnej. Generowanie nowych tokenów dla klientów w takiej sytuacji nic nie da, a przy limicie KSeF tylko wydłuża blokadę.

Czy biuro może samo wygenerować token klienta?+

Tak, jeśli klient nadał biuru odpowiednie uprawnienia w KSeF. Comarch opisuje tę drogę obok przesłania tokenu przez klienta. W praktyce uprawnienia nadane biuru są też podstawą do pracy na certyfikacie biura, bez zbierania tokenów od każdego klienta.

Co się stanie z tokenami klientów po 31 grudnia 2026?+

Obowiązujące rozporządzenie dopuszcza tokeny do końca 2026 roku. Projekt MF z października 2026 przewiduje ich utrzymanie ze skróconą ważnością, ale nie jest jeszcze prawem. Biuro na kilkudziesięciu tokenach powinno mieć plan na oba scenariusze.

Udostępnij:LinkedInFacebookWhatsApp