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ć
| Komunikat | Kiedy się pojawia | Co zrobić |
|---|---|---|
SAF-T generation failed: %s | Generowanie 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: %s | Walidacja się nie udaje, a komunikat podaje przyczynę. | Przeczytaj przyczynę po dwukropku. |
Failed to fetch SAF-T schema from %s: %s | Nie 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 file | Plik SAF-T nie jest plikiem XML. | Użyj pliku XML. |
Period start must be before period end | Początek okresu nie jest wcześniejszy niż koniec. | Popraw daty tak, żeby początek był przed końcem. |
XML export failed: %s | Eksport do XML kończy się błędem. | Przeczytaj szczegóły po dwukropku. |
CSV export failed: %s | Eksport do CSV kończy się błędem. | Przeczytaj szczegóły po dwukropku. |
Annual statistics generation failed: %s | Generowanie statystyk rocznych kończy się błędem. | Przeczytaj szczegóły po dwukropku. |
NIF must be exactly 9 digits. Current value: %s | NIF nie ma dokładnie 9 cyfr. | Komunikat pokazuje bieżącą wartość: zostaw dokładnie 9 cyfr. |
Invalid ATCUD endpoint URL format | Format adresu URL endpointu ATCUD jest nieprawidłowy. | Sprawdź, jak zapisany jest adres URL endpointu. |
ATCUD certificate and key must be configured in SAF-T settings | Certyfikat 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 state | Pró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 company | Dla tej firmy nie ma żadnych wysyłek. | Sprawdź, czy to firma, którą chciałeś przejrzeć. |
No email configured for company | Firma nie ma skonfigurowanego adresu e-mail. | Skonfiguruj e-mail firmy. |
Email test failed: %s | Test 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: %s | Przetwarzanie 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.

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.

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.

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.
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
Sprawdzone w kodzie źródłowym modułu (wersja 20.0) i w podlinkowanych źródłach
Źródła
- Kod modułu: flexigo_portugal_saf_t_accounting_atcud_submission_tool 20.0 (6935c20f): models/saft_annual_statistics.py
- Kod modułu: flexigo_portugal_saf_t_accounting_atcud_submission_tool 20.0 (6935c20f): models/saft_config.py
- Kod modułu: flexigo_portugal_saf_t_accounting_atcud_submission_tool 20.0 (6935c20f): models/saft_dsar_request.py
- Kod modułu: flexigo_portugal_saf_t_accounting_atcud_submission_tool 20.0 (6935c20f): models/saft_exporter.py
- Kod modułu: flexigo_portugal_saf_t_accounting_atcud_submission_tool 20.0 (6935c20f): models/saft_submission.py
- apps.odoo.com/apps/modules/20.0/flexigo_portugal_saf_t_accounting_atcud_submission_tool
- apps.odoo.com/apps/modules/17.0/flexigo_portugal_saf_t_accounting_atcud_submission_tool
- apps.odoo.com/apps/modules/18.0/flexigo_portugal_saf_t_accounting_atcud_submission_tool
- apps.odoo.com/apps/modules/19.0/flexigo_portugal_saf_t_accounting_atcud_submission_tool
- flexigotech.com/en/services.html
- flexigotech.com/precios.html
