Najczęstsze błędy SAF-T UA: dlaczego urząd skarbowy odrzuca Twój plik i jak to naprawić
Wysłałeś SAF-T UA do urzędu skarbowego i w odpowiedzi otrzymałeś listę błędów walidacji? Nie jesteś sam. Co miesiąc setki firm boryka się z odrzuceniem plików z powodu błędów wykrywanych przez system przy odbiorze Potwierdzenia nr 2.
Państwowa Służba Podatkowa używa około 150 reguł walidacji do sprawdzania poprawności struktury i danych w plikach SAF-T UA. Te reguły obejmują wszystko — od formatu XML po logikę biznesową i salda kont.
W tym artykule analizujemy najczęstsze błędy SAF-T UA spotykane w praktyce, wyjaśniamy ich przyczyny i pokazujemy konkretne sposoby ich usunięcia.
Szybka nawigacja po błędach
Kliknij kod błędu, aby natychmiast przejść do szczegółowego opisu i rozwiązania:
Dlaczego urząd skarbowy odrzuca pliki SAF-T?
System walidacji urzędu skarbowego sprawdza pliki SAF-T UA na kilku poziomach:
- Walidacja strukturalna — zgodność ze schematem XML i polami obowiązkowymi;
- Walidacja logiczna — spójność danych między różnymi sekcjami pliku;
- Walidacja słownikowa — sprawdzanie kodów według państwowych klasyfikatorów;
- Reguły biznesowe — kontrola sald, zgodności debetu i kredytu.
Każdy błąd ma unikalny kod (np. FE-20 lub RE-1), który dokładnie wskazuje na problem.
Błędy formatu SAF-T UA (FE)
FE-20Walidacja Klucz-Odniesienie RefTaxDifferenceTransactionsAccount
Opis: Konto różnic podatkowych nie znalezione w planie kont (GeneralLedgerAccounts). System wymaga, aby każde konto używane w transakcjach podatkowych było wcześniej zadeklarowane w sekcji GeneralLedgerAccounts.
Jak naprawić:
- Sprawdź sekcję MasterFiles > GeneralLedgerAccounts
- Dodaj brakujące konto do planu kont
- Upewnij się, że numer konta dokładnie pasuje we wszystkich sekcjach pliku
FE-37Walidacja Klucz-Odniesienie RefPaymentLineCustomer - KeyCustomer
Opis: Identyfikator klienta w dokumentach płatności nie odpowiada żadnemu rekordowi w katalogu kontrahentów.
Jak naprawić:
- Dodaj brakującego klienta do sekcji MasterFiles > Customers
- Sprawdź format CustomerID — musi być identyczny we wszystkich odwołaniach
- Unikaj dodatkowych spacji i znaków specjalnych w identyfikatorach
FE-41Walidacja Klucz-Odniesienie RefGLTransactionLineCustomer1 - KeyCustomer
Opis: Klient określony w sekcji III Operacje księgowe (GeneralLedgerEntries) brakuje w katalogu II.5 Klienci (Customers).
Rozwiązanie:
Zsynchronizuj katalog Customers z danymi w sekcji GeneralLedgerEntries.
FE-42Walidacja Klucz-Odniesienie RefAssetSupplier - KeySupplier
Opis: Dostawca powiązany ze środkiem trwałym firmy w sekcji II.14 Środki trwałe (Assets) nie został znaleziony w katalogu dostawców.
Rozwiązanie:
Dodaj dostawcę do sekcji MasterFiles > Suppliers lub usuń odniesienie z sekcji Assets, jeśli dane są nieaktualne.
FE-43Walidacja Klucz-Odniesienie RefGLTransactionLineSupplier - KeySupplier
Opis: W zapisach księgowych sekcji III (GeneralLedgerEntries) określono dostawcę, którego brakuje w katalogu II.6 Dostawcy (Suppliers).
Rozwiązanie:
Upewnij się, że wszyscy kontrahenci-dostawcy są obecni w sekcji Suppliers przed użyciem ich w transakcjach.
FE-45Walidacja Klucz-Odniesienie RefPaymentLineSupplier - KeySupplier
Opis: Identyfikator dostawcy w wierszach płatności nie pasuje do żadnego rekordu w katalogu II.6 Dostawcy (Suppliers).
Rozwiązanie:
Dodaj wszystkich dostawców do katalogu Suppliers lub sprawdź poprawność pisowni SupplierID.
FE-48Walidacja Klucz-Odniesienie RefOtherSourceDocumentLineAccountSupplier
Opis: W innych dokumentach źródłowych IV.6 Informacje o certyfikatach księgowych i innych dokumentach źródłowych (OtherSourceDocuments) użyto odniesienia do nieistniejącego dostawcy z sekcji II.6 Dostawcy (Suppliers).
FE-50Walidacja Klucz-Odniesienie RefGLTransactionLineSupplier1 - KeySupplier
Opis: W sekcji operacji księgowych III (GeneralLedgerEntries) określono dostawcę (pole SupplierID1), którego brakuje w katalogu II.6 Dostawcy (Suppliers).
FE-76Walidacja Klucz-Odniesienie RefStockMovementLineUnitOfMeasure
Opis: Jednostka miary produktu w sekcji IV.4 Operacje magazynowe (MovementOfGoods) nie odpowiada żadnej jednostce miary zadeklarowanej w katalogu II.8 Tabela jednostek miary (UOMTable).
Jak naprawić:
- Sprawdź sekcję MasterFiles > UOMTable
- Dodaj brakujące jednostki miary (szt, kg, l, m itp.)
- Używaj standardowych kodów jednostek miary według klasyfikatora
FE-99Walidacja Klucz-Odniesienie RefStockMovementLineSubType - KeyMovementType
Opis: Typ ruchu magazynowego w sekcji IV.4 Operacje magazynowe (MovementOfGoods) nie został znaleziony w katalogu II.10 Tabela typów ruchów (MovementTypeTable). Sprawdź poprawność wypełnienia katalogu typów operacji magazynowych.
FE-104Walidacja Klucz-Odniesienie RefStockMovementLineStockAccountNo
Opis: Konto księgowe magazynu w sekcji IV.4 Operacje magazynowe (MovementOfGoods) brakuje lub ma nieprawidłowy format. Dodaj odpowiednią wartość do pola StockAccountNo w sekcji II.12 Zapasy fizyczne (PhysicalStock).
FE-113Walidacja Klucz-Odniesienie RefTaxDifferenceTransactionsTransactionReference
Opis: Odniesienie do transakcji w sekcji II.15 Różnice podatkowe (TaxDifferences) nie odpowiada żadnej transakcji w sekcji III Operacje księgowe (GeneralLedgerEntries). Sprawdź poprawność pola TransactionID.
FE-114Walidacja Klucz-Odniesienie RefPurchaseInvoiceTransactionReference
Opis: Numer transakcji w sekcji IV.2 Informacje o zakupach (PurchaseInvoices) nie został znaleziony w sekcji III Operacje księgowe (GeneralLedgerEntries).
Rozwiązanie:
Każda transakcja musi być jednoznacznie zidentyfikowana i obecna w sekcji III Operacje księgowe (GeneralLedgerEntries).
FE-115Walidacja Klucz-Odniesienie RefPaymentTransactionReference
Opis: Odniesienie do transakcji w płatnościach nie pasuje do istniejących transakcji. Zsynchronizuj dane między sekcjami Payments i Transactions.
FE-116Walidacja Klucz-Odniesienie RefAssetTransactionTransactionReference
Opis: W transakcjach aktywów użyto nieistniejącego klucza transakcji. Sprawdź zgodność między Assets i SourceDocuments.
FE-117Walidacja Klucz-Odniesienie RefOtherSourceDocumentTransactionReference
Opis: Odniesienie do transakcji w innych dokumentach źródłowych jest nieprawidłowe. Upewnij się, że wszystkie TransactionReferences istnieją.
FE-118Walidacja Klucz-Odniesienie RefStockMovementLineTransactionReference
Opis: W ruchach magazynowych określono TransactionReference, który nie istnieje. Dodaj odpowiednią transakcję lub popraw odniesienie.
FE-119Nieunikalne klucze KeyAnalysisID, KeySupplier, KeyCustomer
Jeden z najczęstszych błędów SAF-T UA!
Występuje, gdy w pliku są duplikaty identyfikatorów:
- KeyAnalysisID — powtarzający się identyfikator analityki
- KeySupplier — dwóch lub więcej dostawców z tym samym ID
- KeyCustomer — duplikaty klientów
Jak naprawić:
- Przeprowadź deduplikację katalogów
- Używaj unikalnych identyfikatorów dla każdego rekordu
- Zautomatyzuj generowanie ID, aby uniknąć duplikatów
FE-121Walidacja Klucz-Odniesienie RefSalesInvoiceTransactionReference
Opis: Odniesienie do transakcji w fakturach sprzedaży jest nieprawidłowe. Sprawdź sekcję SalesInvoices i upewnij się o zgodności kluczy.
Błędy logiki biznesowej SAF-T UA (RE)
RE-1Nieprawidłowo określony kod kategorii konta
Opis: Niezgodność między numerem konta a jego kategorią według Planu kont (AccountID, GroupingCategory, GroupingCode, StandardAccountID).
Przykłady:
- AccountID:13X ma GroupingCategory:1 i GroupingCode:13, ale StandardAccountID:13X
Potrzebna konsultacja: Aby naprawić ten błąd, skontaktuj się z naszymi specjalistami w celu konsultacji.
RE-2Odchylenie 1:AccountID (niezgodność salda)
Krytyczny błąd! Pokazuje niezgodność między debetu a kredytem dla konkretnego konta.
Przykłady:
- AccountID:37XX Odchylenie: 100021.56
- AccountID:37X Odchylenie: 527231.36
Potrzebna konsultacja: Aby naprawić ten błąd, skontaktuj się z naszymi specjalistami w celu konsultacji.
RE-5Dane należności niezbilansowane
Opis: Rozbieżność między saldami otwarcia i zamknięcia klientów/dostawców a operacjami okresu.
Przykłady:
- CustomerID:XXXXXXXX AccountID:38X Odchylenie:-299501.76
- CustomerID:XXXXXXXX AccountID:38X Odchylenie:-109294.66
Potrzebna konsultacja: Aby naprawić ten błąd, skontaktuj się z naszymi specjalistami w celu konsultacji.
RE-6Dokumenty źródłowe niezbilansowane z należnościami
Opis: Różnica między sumami dokumentów źródłowych a ostatecznym długiem kontrahenta.
Przykłady:
- SupplierID:XXXXXXXX AccountID:37XX Odchylenie:613835.39
- SupplierID:XXXXXXXX AccountID:37XX Odchylenie:-625908.75
Potrzebna konsultacja: Aby naprawić ten błąd, skontaktuj się z naszymi specjalistami w celu konsultacji.
RE-16Kody jednostek miary brakują w klasyfikatorach
Opis: Użyto jednostki miary z kodem 0000 lub inną nieprawidłową wartością, której nie ma w państwowym klasyfikatorze jednostek miary.
Jak naprawić:
- Zamień kod 0000 na prawidłowy kod z klasyfikatora
- Używaj tylko kodów z oficjalnego katalogu jednostek miary
RE-18SAF-T przesłany bez odpowiedniego żądania
Opis: Plik SAF-T UA został wysłany do urzędu skarbowego bez oficjalnego żądania jego złożenia. Obecnie SAF-T jest składany tylko w odpowiedzi na żądanie urzędu skarbowego podczas audytu dokumentacyjnego.
Jak uniknąć błędów SAF-T UA?
Większość błędów występuje z powodu:
- Nieprawidłowego wydobywania danych z systemu księgowego
- Braku walidacji pliku przed wysłaniem do urzędu skarbowego
- Używania przestarzałych lub niekompatybilnych rozwiązań programowych
- Niekompletnych katalogów (kontrahenci, konta, analityka)
Rekomendacje:
- Używaj specjalistycznego oprogramowania do generowania SAF-T UA
- Przeprowadzaj wstępną walidację pliku przed wysłaniem do urzędu skarbowego
- Regularnie aktualizuj katalogi i klasyfikatory
- Sprawdzaj saldo danych na etapie generowania pliku
MySAF-T — rozwiązanie do poprawnego generowania SAF-T UA
Do automatyzacji generowania i weryfikacji SAF-T UA polecamy użycie MySAF-T od EMEA IT Consulting — platformy opracowanej specjalnie dla ukraińskiego biznesu.
Korzyści MySAF-T:
- Automatyczna walidacja pliku przed wysłaniem do urzędu skarbowego
- Wykrywanie błędów FE-20, FE-37, FE-119, RE-1, RE-2 i innych na etapie generowania
- Obsługa wszystkich aktualnych wersji SAF-T UA
- Integracja z popularnymi systemami księgowymi
- Szczegółowe raporty o wykrytych błędach z rekomendacjami naprawczymi
Potrzebujesz pomocy w naprawieniu błędów SAF-T UA?
Jeśli otrzymałeś listę błędów od urzędu skarbowego i nie wiesz, jak je naprawić — pomożemy.
Nasi specjaliści zapewniają:
- Analizę błędów walidacji SAF-T UA (FE, RE, inne kody)
- Konsultacje dotyczące korygowania danych księgowych
Umów się na konsultację, aby uzyskać profesjonalną pomoc w rozwiązywaniu problemów z SAF-T UA i przygotować się do audytów podatkowych bez stresu.
SAF-T UA to nie tylko wymóg techniczny. To narzędzie, które pomaga firmom być transparentnymi wobec państwa i pewnym poprawności swojej księgowości. Właściwe przygotowanie pliku dzisiaj to spokój podczas audytu jutro.