Przejdź do głównej treści
VeriFactu

Błędy VeriFactu w Odoo: jak czytać to, co mówi AEAT, i co Twój system zatrzymuje wcześniej

Błąd VeriFactu może przyjść z dwóch miejsc: od AEAT, która na każdą wysyłkę odpowiada statusem i kodem, albo z Twojego własnego systemu, który blokuje fakturę przed wysłaniem, jeśli czegoś brakuje, na przykład certyfikatu albo prawidłowego NIF. Rozróżnienie ich oszczędza czas, bo naprawia się je w różnych miejscach. Oto obie grupy.

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

Najważniejsze

Moduł
VeriFactu
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
3 min

Co odpowiada AEAT

Każda wysyłka zawiera od 1 do 1000 rekordów. Odpowiedź przynosi status całej wysyłki (Correcto, ParcialmenteCorrecto albo Incorrecto), status każdego rekordu (Correcto, AceptadoConErrores albo Incorrecto) i czas oczekiwania do następnej wysyłki.

AEAT publikuje swój oficjalny katalog błędów, z 247 kodami, w trzech rodzinach:

RodzinaCo oznaczaCo zrobić
4xxx: odrzucona cała wysyłkaNic z tej wysyłki nie zostało zarejestrowane.Usuń przyczynę i wyślij ponownie całą wysyłkę.
Odrzucony rekordTen rekord nie jest przyjęty; reszta wysyłki tak.Popraw ten rekord i wyślij ponownie tylko jego.
2xxx: przyjęty z błędamiRekord jest zarejestrowany, ale coś trzeba poprawić.Nie wysyłaj go ponownie jako nowego: popraw to, co wskazuje kod.

Dwa konkretne przypadki warto rozpoznawać od razu. Kod 3000 oznacza zdublowany rekord: jeśli już figuruje jako poprawny albo przyjęty z błędami, nie trzeba go wysyłać ponownie. A odcisk cyfrowy (huella), czyli skrót SHA-256 powiązany z poprzednim rekordem, AEAT przelicza sama: jeśli się nie zgadza, rekord zostaje przyjęty z błędem, który trzeba poprawić.

Lista błędów zwróconych przez AEAT w Odoo
Błędy AEAT, rekord po rekordzie i pogrupowane według kodu, w Odoo. Zrzut ekranu Odoo z danymi demonstracyjnymi; odpowiedzi AEAT są symulowane.

Zanim dotrze do AEAT: certyfikat

AEAT identyfikuje wystawcę po certyfikacie przedstawionym przy połączeniu. Bez certyfikatu jej usługa przekierowuje na stronę błędu 4033, „nie wykryto certyfikatu”. Z certyfikatem, który nie przechodzi weryfikacji, na stronę 4011. W Odoo te przypadki są zatrzymywane wcześniej:

  • No active certificate for company …: firma nie ma aktywnego certyfikatu. Wgraj go w Configuration › Certificates.
  • The certificate … of company … has expired.: certyfikat wygasł. Jest codzienne ostrzeżenie o wygasaniu, żeby do tego nie doszło.

Co Twój system blokuje przed wysłaniem

KomunikatCzego brakujeRozwiązanie
Company … has no NIF for Veri*Factu.Firma nie ma NIF.Uzupełnij go w danych firmy.
Invalid NIF length: "…" (must be 9 chars)NIF klienta nie ma 9 znaków.Sprawdź NIF w kontakcie.
Invalid NIF digits: "…"NIF zawiera nieprawidłowe znaki.Popraw go w kontakcie.
Cannot post invoice: invalid counterparty identifier.Identyfikator klienta jest nieprawidłowy.Popraw identyfikator przed zaksięgowaniem.
Record … has no tax breakdown (Desglose) to declare.Faktura nie ma rozbicia podatków.Sprawdź podatki w pozycjach.
Record … is chained to a previous record that does not exist.Łańcuch rekordów jest przerwany.Nie poprawiaj go ręcznie: sprawdź stan łańcucha i napisz do nas.
The AEAT accepts at most 1000 records per request.Wysyłka z większą liczbą rekordów, niż wolno.Kolejka je dzieli; jeśli to widzisz, daj nam znać.
Katalog błędów AEAT załadowany w Odoo
Katalog błędów AEAT w Odoo, z 247 kodami, żeby czytać każdy z nich bez wychodzenia z systemu. Zrzut ekranu Odoo z danymi demonstracyjnymi.

Gdzie szukać w Odoo

Kolejka wysyłek jest przetwarzana co minutę i znajduje się w AEAT Submission › Submission Queue. Błędy zwrócone przez AEAT mają własną listę w AEAT Errors, a pełny katalog kodów jest w AEAT Error Catalogue. Te trzy ekrany rozwiązują większość przypadków bez otwierania dokumentu technicznego AEAT, choć poniżej jest do niego link, gdyby był potrzebny.

Kolejka wysyłek do AEAT w Odoo
Kolejka wysyłek: co czeka, co zostało wysłane i co się nie powiodło. Zrzut ekranu Odoo z danymi demonstracyjnymi; odpowiedzi AEAT są symulowane.

Moduł jest opublikowany dla Odoo 17, 18, 19 i 20. Jeśli jakiegoś kodu nie ma w katalogu, wyślij nam dokładny tekst odpowiedzi: znajdziemy go w oficjalnym dokumencie walidacji.

Czytaj dalej

VeriFactu: terminy 2027, prognoza na 2028 i co w tym czasie zrobić w OdooKalendarz VeriFactu na listopad 2026: terminy z RDL 15/2025, prognoza ministerstwa o przesunięciu na październik 2028 i co przygotować w Odoo już teraz.VeriFactu: mity i fakty dla firm, które fakturują w OdooPopularne przekonania o VeriFactu sprawdzone z AEAT i samym systemem: odcisk cyfrowy, przyjęte błędy, anulowania, migracje, terminy i moduł Odoo.
Sprawdzone w kodzie źródłowym modułu (wersja 20.0) i w podlinkowanych źródłach

Źródła