KSeF - komunikaty błędów – Centrum pomocy SaldeoSMART

Poniższy artykuł zawiera informacje o błędach, które mogą wystąpić podczas wysyłki lub pobierania faktur z KSeF.

⚠️ KSeF nie sprawdza faktury merytorycznie - nie waliduje kwot podatku i stawek czy poprawności danych adresowych powiązanych z NIP kontrahenta. To podatnicy są odpowiedzialni za dane, które wpisują w treści faktury. KSeF waliduje jedynie zgodność ze schemą.

Pozostałe komunikaty

Jeśli podczas wysyłania faktury do KSeF w SaldeoSMART pojawi się błąd o niepoprawnych danych firmy (dotyczy danych sprzedawcy, czyli wystawcy faktury), sprawdź, czy dane wprowadzone w programie są zgodne z informacjami rejestrowymi, np. z KRS. Różnice w danych mogą być przyczyną błędu.

lub

Zaktualizuj dane w SaldeoSMART na podstawie np. informacji z KRS lub CEIDG i ponów wysłanie faktury do KSeF. Weryfikując dane kontrahenta upewnij się, że uzupełnione jest pole Kraj.

Błąd na etapie dodawania tokena w konfiguracji: Token nie zawiera numeru NIP. Upewnij się, że jest poprawny.

Błąd wynikający z ucięcia znaków przy kopiowaniu lub błędnego formatu tokena oraz jeżeli jest "obcy" token - czyli wygenerowany na inny NIP niż NIP konta, do którego chcemy dodać.
W dzwoneczku komunikat "Nie udało się pobrać faktur z KSeF"

Komunikat może dotyczyć limitów MF w KSeF przy pobieraniu ręcznym (16 faktur na minutę i 64 faktury na godzinę). W przypadku pobierania dużej ilości faktur zalecamy korzystanie z automatycznego pobierania co godzinę.

Nie udało się wysłać faktury ponieważ nie masz wymaganych uprawnień.

W pierwszym kroku należy zweryfikować w Aplikacji Podatnika, czy zostały poprawnie nadane uprawnienia i wygenerowane certyfikaty oraz czy do SaldeoSMART certyfikaty zostały dodane poprawnie. Można porównać początkowe numery seryjne z listy certyfikatów w Aplikacji Podatnika z tymi, które są dodane w SaldeoSMART. Pamiętaj! Certyfikat uwierzytelniający należy dodać w polu dla certyfikatu uwierzytelniającego, podpis linku w polu certyfikatu offline. To najczęstsza przyczyna błędów!

Niepoprawne dane firmy. Zweryfikuj poprawność danych podstawowych oraz adresowych w zakładce Ustawienia → Konta.

Sprawdź czy REGON ma odpowiednią liczbę znaków - może mieć 9 lub 14.

Sprawdź czy BDO ma odpowiednią liczbę znaków - może mieć 9 znaków.

Sprawdź, czy dane adresowe są zgodne z danymi w rejestrach np. GUS, KRS.

Brak możliwości wysyłki do KSeF - Niepoprawny numer konta bankowego lub BIC/SWIFT wystawcy

Sprawdź w ustawieniach konta:

czy przypadkiem nie dopisałeś tam dodatkowych adnotacji (np. „EURO”). Jeśli chcesz jakoś nazwać to konto, użyj do tego pola „Nazwa konta”. Jeżeli tak, popraw dane.

Co zrobić, jeśli na wystawionej fakturze pojawił się błędny numer konta? Wystarczy, że wyedytujesz tę fakturę. W sekcji płatności wybierz poprawny numer rachunku z listy, zapisz zmiany i wyślij dokument do KSeF ponownie.

KOMUNIKAT W SALDEOSMART	CO OZNACZA?
Wystąpił nieoczekiwany błąd podczas wysyłki faktur do KSeF. Pracujemy nad rozwiązaniem problemu. Spróbuj ponownie później.	Wystąpił problem ze strukturą dokumentu. Nasz zespół pracuje nad rozwiązaniem problemu.
Token uwierzytelniający do KSeF jest nieprawidłowy lub nie istnieje. Sprawdź możliwe przyczyny błędu w Centrum Pomocy lub zgłoś problem administratorowi.	Komunikat pojawia się, gdy token jest nieprawidłowy, nieaktywny, unieważniony lub nie istnieje. Należy sprawdzić jego poprawność lub zgłosić problem administratorowi w celu zweryfikowania przyczyny błędu.
Wystąpił problem z autoryzacją lub uwierzytelnieniem po stronie KSeF. Sprawdź poprawność tokenu i spróbuj ponownie. Dowiedz się więcej.	Komunikat dotyczy błędu w autoryzacji lub uwierzytelnienia po stronie KSeF i świadczy o problemie związanym z tokenem. Należy upewnić się, czy token jest poprawny i aktywny lub skontaktować się z administratorem.
System KSeF jest tymczasowo niedostępny. Spróbuj ponownie za chwilę.	Komunikat dotyczy sytuacji, w której usługa KSeF jest niedostępna z przyczyn od nas niezależnych.
Nie udało się wysłać faktury, ponieważ wystąpił kod błędu: 425. Kliknij, aby wysłać ponownie.	Komunikat najczęściej dotyczy błędów walidacji XML np. numer REGON firmy wprowadzony ze spacjami, błędnie wprowadzony SWIFT, błędnie wprowadzony numer rachunku, za długa nazwa pozycji na fakturze itd. Dane nie są zgodne z wymaganiami schemy. Jeżeli nie uda się zweryfikować co powoduje błąd zachęcamy do kontaktu z działem obsługi klienta: obsluga@saldeosmart.pl
Nieprawidłowy token.	Dla jakiego środowiska Aplikacji Podatnika został wygenerowany token? W SaldeoSMART obecnie obsługiwany jest token dla produkcyjnej wersji Aplikacji Podatnika 2.0. Nie dodawaj do SaldeoSMART tokena wygenerowanego w Aplikacji Podatnika 2.0 wersji testowej i/lub w demo.
Nieprawidłowe żądanie. Sprawdź poprawność wprowadzonych danych. 21 115: Nieprawidłowy certyfikat.	Możliwe przyczyny błędu: certyfikat jest przypisany do innego NIP-u niż ten, dla którego wykonywana jest autoryzacja błędnie wgrane certyfikaty (uwierzytelniający jako offline, offline jako uwierzytelniający) używany jest certyfikat z innego środowiska (np. DEMO zamiast PROD), certyfikat nie pasuje do klucza prywatnego (.crt i .key nie są parą), certyfikat wygasł lub został cofnięty,
Nie masz uprawnień do pobrania faktur z KSeF. Skontaktuj się z administratorem. 415: Uwierzytelnienie zakończone niepowodzeniem.	Kod 415 jest zwracany bezpośrednio przez system KSeF i wynika z braku skutecznie nadanych uprawnień po stronie Ministerstwa Finansów.
Coś poszło nie tak. Spróbuj ponownie później.	Błąd może mieć dwa źródła: kiedy certyfikat/token jest poprawny i przejdziemy autoryzacje, ale przy wyszukaniu KSeF zwróci, że nie mamy dostępu do tych zasobów kiedy po 3 ponowieniach próby wyszukania, KSeF nie zwrócił nam żadnej konkretnej informacji, ani wyników, ani błędu
Nie udało się wysłać faktury (kod 450). Sprawdź dane firmy (NIP, REGON, BDO) lub skorzystaj z Centrum Pomocy. Kliknij, aby wysłać ponownie.	Błąd weryfikacji semantyki dokumentu faktury. Błędne dane Błąd może być związany z niepoprawnie wprowadzonymi danymi kontrahenta (nabywcy) lub sprzedawcy (dane w konfiguracji konta SaldeoSMART) tj. błędy w NIP, za krótki lub za długi REGON, błędy w numerze telefonu, e-mail. Np. w polu telefon, numer wprowadzony dwa razy, wprowadzone są litery itd. Należy zweryfikować: dane kontrahenta (Nabywcy): poprawność numeru NIP, adresu e-mail oraz numeru telefonu czy w polu przeznaczonym na numer telefonu lub e-mail dane nie zostały wpisane dwukrotnie (np. dwa numery telefonów w jednym polu) czy w danych kontrahenta pole „Kraj” jest uzupełnione i czy jest uzupełnione poprawnie czy w polu REGON na koncie wprowadzono odpowiednią 9 lub 14 znaków czy numer telefonu ma 16 znaków łącznie z wszystkimi spacjami? - po przekroczeniu również pojawi się błąd wysyłki czy w ustawieniach konta poprawnie jest wprowadzone BDO (9 cyfr, bez dopisku BDO, bez dodatkowych znaków) Należy też zweryfikować dane wystawcy faktury, czyli dane wprowadzone na koncie SaldeoSMART. Są przypadki, gdzie faktury otrzymują błąd 450, ponieważ w polu REGON oprócz numeru wprowadzone są znaki specjalne. ⚠️ Pamiętaj! Jeżeli edytujesz dane sprzedawcy lub kontrahenta po wystawieniu faktury, pamiętaj o ich aktualizacji przed wysyłką do KSeF. Wejdź w edycję faktury i w sekcji „Nabywca” kliknij przycisk „Aktualizuj dane”. Po aktualizacji danych ponów wysyłkę do KSeF. Data wystawienia późniejsza niż bieżąca Błąd 450 może również pojawić się przy próbie wysłania do KSeF faktury z datą wystawienia późniejszą niż bieżąca (Wystawianie faktur z datą przyszłą) Błędne kodowanie nazwy pozycji Błąd może również dotyczyć nazwy pozycji na fakturze, w sytuacji kiedy kopiowana z innego systemu. Podczas kopiowania dochodzi do błędu, który widoczny jest w XML KSeF opisany jako STX, co sugeruje błędne kodowanie. Rozwiązaniem będzie edycja faktury i ręczne wprowadzenie nazwy pozycji z klawiatury. Za długa przyczyna korekty Wpisując przyczynę korekty w SaldeoSMART, należy pamiętać, że zgodnie ze schemą ministerialną limit wynosi 256 znaków. Przekroczenie tego limitu skutkuje błędem 450.
Nie udało się wysłać faktury (kod 440), ponieważ faktura o podanym numerze już istnieje w systemie KSEF. Kliknij, aby wysłać ponownie.	Duplikat faktury. Faktura o identycznych parametrach została już w KSeF zarejestrowana.
Błąd uwierzytelnienia 460.	Kod błędu oznacza, że certyfikat uwierzytelniający jest nieprawidłowy lub nie istnieje. Zalecamy sprawdzenie konfiguracji w Aplikacji Podatnika.
Brak autoryzacji 21 301 Nieprawidłowe żądanie. Sprawdź poprawność wprowadzonych danych i spróbuj ponownie.	Błąd może pojawić się w sytuacji, kiedy token został unieważniony w Aplikacji Podatnika, ale nie został usunięty w SaldeoSMART. Zalecamy sprawdzenie listy tokenów w Aplikacji Podatnika i w razie potrzeby wygenerowanie nowego tokena i dodanie go do SaldeoSMART.
Dostęp zabroniony. Użyty token lub certyfikat nie posiada wystarczających uprawnień.	Brak uprawnień po stronie KSeF. W zależności od wybranej metody uwierzytelniania, na etapie generowania tokena należy nadać mu konkretne uprawnienia (np. wystawianie lub przeglądanie faktur). Niestety, po zapisaniu tokena w Aplikacji Podatnika nie ma możliwości późniejszej weryfikacji, jakie uprawnienia zostały mu przypisane. W przypadku problemów zalecamy unieważnienie obecnego tokena, usunięcie go z SaldeoSMART i wygenerowanie nowego, zwracając szczególną uwagę na zaznaczone zgody. Jeśli korzystasz z uwierzytelniania za pomocą certyfikatu, pamiętaj o wcześniejszym nadaniu odpowiednich uprawnień bezpośrednio w Aplikacji Podatnika. Bez nich wysyłka oraz pobieranie faktur z KSeF nie będą możliwe. Nadane uprawnienia można zweryfikować w Aplikacji Podatnika w sekcji Uprawnienia. Konfiguracja uprawnień KSeF dla Biura Rachunkowego działającego jako spółka z reprezentantem na ZAW-FA KSeF - obsługa spółki
Przekroczono limit zapytań. Spróbuj ponownie później. Obowiązują limity MF: 30 zapytań na minutę 120 zapytań na godzinę Wyszukiwanie faktur będzie dostępne ponownie o godz. (podana konkretna godzina)	Błąd nie pochodzi z SaldeoSMART - jest błędem komunikowanym przez Ministerstwo Finansów i dotyczy wszystkich programów komunikujących się z KSeF. Skąd się bierze? Ministerstwo Finansów ogranicza liczbę zapytań kierowanych do systemu KSeF. Obowiązujące limity to: - 30 zapytań na minutę - 120 zapytań na godzinę Jeśli w danym czasie trafi do KSeF zbyt wiele zapytań, system automatycznie blokuje kolejne do końca danego okresu. Informacja o tym, kiedy pobieranie będzie ponownie możliwe, pojawia się bezpośrednio w komunikacie błędu. Jak są liczone te limity? Limity są naliczane per konto klienta (NIP konta). Co zrobić? Wystarczy poczekać i ponowić próbę po upływie wskazanego czasu.

Powiązane artykuły