Przejdź do głównej treści
Portugal SAF-T (PT) File Checks

Błędy Portugal SAF-T (PT) File Checks: kiedy pojawia się każdy komunikat i co zrobić

Komunikaty Portugal SAF-T (PT) File Checks są po angielsku i prawie wszystkie mówią już, co poszło nie tak, a często także, jaki jest następny krok: wygeneruj przed walidacją, sprawdź log, skonfiguruj certyfikat i klucz ATCUD albo spróbuj później. Poniżej znajdziesz każdy komunikat dosłownie, kiedy się pojawia według jego własnej treści i co zrobić, bez zakładania niczego, czego komunikat nie mówi.

FlexigoTech · Odpowiada: Víctor Gómez · Aktualizacja: 4 listopada 2026

Najważniejsze

Wersje
Odoo 17, 18, 19 i 20
Sprawdzone
w kodzie źródłowym modułu, wersja 20.0 · w źródłach podanych na końcu
Czas czytania
5 min

Jak czytać komunikat Portugal SAF-T (PT) File Checks

Każdy komunikat ma tekst, który często kończy się na %s albo ma %d w środku. W to miejsce moduł wstawia konkretną informację: szczegóły błędu, zapisaną wartość, adres lub liczbę prób. Gdy widzisz dwukropek, a po nim tekst, właśnie ta część mówi, co się stało w Twoim przypadku.

W tabeli poniżej komunikaty są podane dokładnie tak, jak zapisuje je moduł, z %s i %d na swoim miejscu. Na ekranie zobaczysz w ich miejscu prawdziwe dane.

Tabela błędów: komunikat, kiedy się pojawia i co zrobić

KomunikatKiedy się pojawiaCo zrobić
SAF-T generation failed: %sGenerowanie pliku SAF-T kończy się błędem.Przeczytaj szczegóły po dwukropku i popraw to, co wskazują, zanim wygenerujesz plik ponownie.
No SAF-T file generated. Run generation first.Nie ma jeszcze wygenerowanego pliku SAF-T.Najpierw wygeneruj plik, tak jak prosi komunikat.
SAF-T validation failed. Check validation log for details.Plik SAF-T nie przechodzi walidacji.Otwórz rejestr walidacji (validation log) i sprawdź szczegóły.
SAF-T validation failed: %sWalidacja się nie udaje, a komunikat podaje przyczynę.Przeczytaj przyczynę po dwukropku.
Failed to fetch SAF-T schema from %s: %sNie da się pobrać schematu SAF-T z danego adresu.Komunikat pokazuje adres i szczegóły: sprawdź jedno i drugie.
SAF-T file must be an XML filePlik SAF-T nie jest plikiem XML.Użyj pliku XML.
Period start must be before period endPoczątek okresu nie jest wcześniejszy niż koniec.Popraw daty tak, żeby początek był przed końcem.
XML export failed: %sEksport do XML kończy się błędem.Przeczytaj szczegóły po dwukropku.
CSV export failed: %sEksport do CSV kończy się błędem.Przeczytaj szczegóły po dwukropku.
Annual statistics generation failed: %sGenerowanie statystyk rocznych kończy się błędem.Przeczytaj szczegóły po dwukropku.
NIF must be exactly 9 digits. Current value: %sNIF nie ma dokładnie 9 cyfr.Komunikat pokazuje bieżącą wartość: zostaw dokładnie 9 cyfr.
Invalid ATCUD endpoint URL formatFormat adresu URL endpointu ATCUD jest nieprawidłowy.Sprawdź, jak zapisany jest adres URL endpointu.
ATCUD certificate and key must be configured in SAF-T settingsCertyfikat i klucz ATCUD nie są skonfigurowane.Skonfiguruj je w ustawieniach SAF-T.
ATCUD rejected the submission. Check error log for details.ATCUD odrzuca wysyłkę.Sprawdź rejestr błędów (error log).
Failed to contact ATCUD after %d attempts. Try again later.Nie udaje się połączyć z ATCUD po kilku próbach; komunikat podaje ile.Spróbuj później.
ATCUD submission failed. Please try again later.Wysyłka do ATCUD się nie udaje.Spróbuj później.
Submission can only be retried from error statePróbujesz ponowić wysyłkę, która nie jest w stanie błędu.Ponawiaj tylko wysyłki w stanie błędu.
No submissions found for this companyDla tej firmy nie ma żadnych wysyłek.Sprawdź, czy to firma, którą chciałeś przejrzeć.
No email configured for companyFirma nie ma skonfigurowanego adresu e-mail.Skonfiguruj e-mail firmy.
Email test failed: %sTest poczty e-mail się nie udaje.Przeczytaj szczegóły po dwukropku.
Several contacts match "%s": enter the email or the tax ID of the data subject.Kilka kontaktów pasuje do tego, co wpisałeś.Wpisz e-mail lub identyfikator podatkowy (tax ID) osoby, której dane dotyczą.
DSAR processing failed: %sPrzetwarzanie DSAR kończy się błędem.Przeczytaj szczegóły po dwukropku.

NIF, URL, e-mail i certyfikat: komunikaty o danych

Część komunikatów dotyczy danych, które wpisujesz sam. Ten o NIF jest najprostszy: wymaga dokładnie 9 cyfr i pokazuje, co jest zapisane (Current value: %s), więc od razu widzisz, czego jest za dużo lub brakuje. Ten o URL (Invalid ATCUD endpoint URL format) mówi tylko, że format jest nieprawidłowy, więc trzeba sprawdzić, jak zapisany jest ten adres.

Do wysyłki do ATCUD moduł wymaga certyfikatu i klucza w ustawieniach SAF-T: jeśli ich brakuje, pojawia się ATCUD certificate and key must be configured in SAF-T settings. Podobnie jest z pocztą: No email configured for company oznacza, że firma nie ma adresu e-mail, a Email test failed: %s pojawia się, gdy test poczty się nie powiedzie, ze szczegółami na końcu.

Nowy formularz konfiguracji ATCUD z sekcjami firmy, ATCUD, e-maila, powiadomień i przesyłania
Formularz konfiguracji ATCUD w Fakturowaniu, jeszcze bez zapisanych danych: wypełniony jest tylko URL endpointu, a dolna część jest ucięta.

Te, które odsyłają do logu lub każą poczekać

Dwa komunikaty nie zawierają szczegółów i odsyłają gdzie indziej: SAF-T validation failed. Check validation log for details. do rejestru walidacji, a ATCUD rejected the submission. Check error log for details. do rejestru błędów. W takich przypadkach przyczyny nie ma w oknie komunikatu, tylko w logu, który komunikat wskazuje.

Dwa inne wymagają tylko cierpliwości: Failed to contact ATCUD after %d attempts. Try again later. i ATCUD submission failed. Please try again later. Pierwszy mówi, ile prób wykonał moduł. W obu tekst każe spróbować ponownie później.

Lista SAF-T Error Logs z pięcioma rekordami i kolumnami daty, typu błędu, ważności, komunikatu i rozwiązania
Invoicing › SAF-T Error Logs: pięć rekordów z datą, typem, ważnością i komunikatem, a znacznik rozwiązania jest niezaznaczony.

Generuj, waliduj i ponawiaj: kolejność, którą wyznaczają komunikaty

Niektóre komunikaty mówią, w jakiej kolejności pracować. No SAF-T file generated. Run generation first. jasno wskazuje, że najpierw trzeba wygenerować plik SAF-T. Submission can only be retried from error state oznacza, że wysyłkę można ponowić tylko ze stanu błędu. A Period start must be before period end wymaga, by początek okresu był przed jego końcem.

Jeśli problem dotyczy samego pliku, zwróć uwagę na SAF-T file must be an XML file i komunikaty eksportu (XML export failed: %s, CSV export failed: %s), które mają szczegóły na końcu. Ustawienia i stany, przez które przechodzi każdy rekord, opisuje wdrożenie modułu, a menu i zadania jak to działa od środka.

Lista Generate SAF-T Files z sześcioma rekordami firmy, okresu i stanu
Invoicing › SAF-T Accounting › Generate SAF-T Files: sześć rekordów w stanach Draft, Generated, Validated, Validation Failed i Submitted, z zerowym rozmiarem pliku i liczbą transakcji.
Przegląd list statystyk rocznych SAF-T, SAF-T Error Logs i Generate SAF-T Files
Od statystyk rocznych (firma, rok, łączna liczba dokumentów, łączna wartość i stan Draft lub Exported) do listy błędów i listy wygenerowanych plików SAF-T.

Jak pomaga FlexigoTech

Jeśli komunikat Cię blokuje albo chcesz sprawdzić konfigurację przed wysyłką, w FlexigoTech wdrażamy Odoo 17, 18, 19 i 20 oraz tworzymy konektory i integracje na zamówienie. Moduł kosztuje 9 € za wersję Odoo w Odoo Apps, jednorazowo netto (bez VAT), dla 17, 18, 19 i 20 (strona w Odoo Apps); lokalna usługa FlexigoTech Cloud to 29 €/mies. lub 290 €/rok netto (bez VAT). Wszystkie szczegóły znajdziesz na stronie modułu.

Czytaj dalej

Jak działa Portugal SAF-T (PT) File Checks w Odoo od środkaJakie menu dodaje Portugal SAF-T (PT) File Checks we Fakturowaniu, jakie modele stoją za nim, jakie statusy widzisz na listach i co korzysta z usługi zewnętrznej.Wdrożenie Portugal SAF-T (PT) File Checks w Odoo, opowiedziane na przykładzieWdrożenie Portugal SAF-T (PT) File Checks w Odoo na zmyślonym przykładzie: konfiguracja ATCUD, kluczowe pola, statusy i co sprawdzać w pierwszym tygodniu.Portugal SAF-T (PT) File Checks: co obejmuje, czego potrzebujesz i w jakiej wersji OdooCo obejmuje Portugal SAF-T (PT) File Checks według README, czego potrzebujesz przed instalacją (NIF, ATCUD, poczta) i w jakich wersjach Odoo działa.
Sprawdzone w kodzie źródłowym modułu (wersja 20.0) i w podlinkowanych źródłach

Źródła