Przejdź do głównej treści
VeriFactu

Błędy VeriFactu 4120–4133: nagłówek dobrowolnego przesłania i przesłania na wezwanie

Istnieją dwa sposoby przesyłania rekordów do AEAT: z własnej inicjatywy, jako system VERI*FACTU, albo gdy AEAT ich żąda w wezwaniu („requerimiento”), jako system No VERI*FACTU. Każdy ma własne pola w nagłówku przesyłki i nie można ich mieszać. Dziesięć kodów pilnuje tej granicy i wszystkie odrzucają całe żądanie.

FlexigoTech · Odpowiada: Víctor Gómez · Aktualizacja: 4 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

Pola każdego trybu

Dokument walidacji AEAT rozdziela pola nagłówka w następujący sposób:

FechaFinVeriFactu
Tylko w systemach wystawiających faktury weryfikowalne. Od 1 stycznia 2027 roku musi mieć format 31-12-20XX, a rok równy roku systemu AEAT lub roku poprzedniemu.
Incidencia
Tylko w systemach wystawiających faktury weryfikowalne.
RefRequerimiento
Tylko w systemach wystawiających faktury niepodlegające weryfikacji, i w nich obowiązkowe. Odnośnik musi istnieć w AEAT.

Tak jak każdy błąd w nagłówku, także te odrzucają całą przesyłkę: żadna faktura nie zostaje przyjęta.

Karta kodów nagłówka VeriFactu według trybu
Dziesięć kodów nagłówka według trybu, zaznaczonych na czerwono: wszystkie odrzucają całe żądanie.

Różnica nie dotyczy jednak wyłącznie pól. W przesyłaniu na wezwanie, zgodnie z punktem 4.3.2 dokumentu AEAT, błędy biznesowe nie podlegają korekcie: rekordy wysyła się tak, jak zostały zachowane w systemie w momencie ich generowania, a te błędy są oznaczane jako dopuszczalne, z wyjątkiem tych dotyczących identyfikacji NIF lub IDOtro.

Dziesięć kodów

KodCo mówi AEAT, w skrócie
4120Nieprawidłowe FechaFinVeriFactu: musi wynosić 31-12-20XX, roku bieżącego lub poprzedniego.
4121Nieprawidłowa wartość w Incidencia.
4122Nieprawidłowa wartość w RefRequerimiento.
4125W przesyłce na wezwanie RefRequerimiento jest obowiązkowe.
4126RefRequerimiento występuje tylko w przesyłkach odpowiadających na wezwanie.
4127Przesłanie dobrowolne zgłasza się tylko w systemach VERI*FACTU.
4129FinRequerimiento jest obowiązkowe.
4130FinRequerimiento występuje tylko w systemach No VERI*FACTU.
4131Nieprawidłowa wartość w FinRequerimiento.
4133RefRequerimiento nie jest alfanumeryczne.

Jaki nagłówek wysyła nasz moduł

Nagłówek budowany przez moduł zawiera tylko dwie rzeczy: podmiot zobowiązany do wystawiania, z nazwą i NIF firmy, oraz Representante, gdy przesyła doradca podatkowy. Nie ma w nim bloku przesłania dobrowolnego ani bloku wezwania, ani żadnego z pól wymienionych wyżej. Dlatego tych dziesięciu kodów nie może wygenerować żadna z jego przesyłek.

Moduł zna oba tryby: każda seria faktur ma swój własny, a w danych systemu informatycznego deklaruje, że nie jest używany wyłącznie jako VERI*FACTU. Do AEAT wysyła rejestracje i anulowania w przesłaniu dobrowolnym.

Serie faktur VeriFactu w Odoo wraz z ich trybem
Serie faktur VeriFactu firmy, każda z prefiksem, trybem i środowiskiem AEAT. Zrzut ekranu Odoo 20 z danymi demonstracyjnymi.

Co zrobić, jeśli taki kod się pojawi

Jeśli zobaczysz jeden z tych kodów, przesyłka nie pochodziła z naszego modułu w postaci, w jakiej go opublikowaliśmy: albo ktoś zmienił sposób budowania nagłówka, albo inny program wysyła z Twoim NIF. W obu przypadkach:

  1. Sprawdź w Wysyłka do AEAT › Błędy AEAT, które przesyłki mają ten kod i do której firmy należą.
  2. Zachowaj pełną odpowiedź przesyłki, pole Raw Response z kolejki.
  3. Napisz na adres comercial@flexigobe.com, zanim cokolwiek ponownie wyślesz.

Kody z tej strony wraz z tekstem AEAT

Każdy kod z dosłownym tekstem, tak jak podaje go lista błędów AEAT:

KodTekst AEAT
4120Error en la cabecera: el valor del campo FechaFinVeriFactu es incorrecto, debe ser 31-12-20XX, donde XX corresponde con el año actual o el anterior.
4121Error en la cabecera: el valor del campo Incidencia es incorrecto.
4122Error en la cabecera: el valor del campo RefRequerimiento es incorrecto.
4125Error en la cabecera: Si el envío es por requerimiento el campo RefRequerimiento es obligatorio.
4126Error en la cabecera: el campo RefRequerimiento solo debe informarse en sistemas en remisiones al endpoint del servicio a usar para la contestación a requerimientos de registros de facturación.
4127Error en la cabecera: la remisión voluntaria solo debe informarse en sistemas VERIFACTU.
4129Error en la cabecera: el campo FinRequerimiento es obligatorio.
4130Error en la cabecera: el campo FinRequerimiento solo debe informarse en sistemas No VERIFACTU.
4131Error en la cabecera: el valor del campo FinRequerimiento es incorrecto.
4133Error en la cabecera: el valor del campo RefRequerimiento no es alfanumérico.

A jeśli AEAT wyśle mi wezwanie?

Opublikowany moduł sam nie odpowiada na wezwania, ponieważ nie buduje nagłówka wezwania. Jeśli taki otrzymasz, napisz do nas, a zastanowimy się razem, jak go obsłużyć.

Czytaj dalej

Błędy VeriFactu z NIP Twojej firmy: 4104, 4107, 4109, 4115, 4116 i rodzina IDEmisorFacturaBłędy VeriFactu dotyczące NIP wystawcy (4104, 4107, 4109, 4115, 4116, 1108, 1215…): co sprawdza AEAT, z którego pola Odoo pochodzi i jak ponowić wysyłkę.Błędy 4105, 4117, 4123 i 4124 VeriFactu: gdy za Ciebie wysyła biuro doradczeBłędy VeriFactu w bloku Representante (4105, 4117, 4123, 4124), gdy wysyła je Twoje biuro doradcze: co sprawdza AEAT i które pola Odoo wypełniają ten blok.Błąd 4134 VeriFactu: „Servicio no activo”, co dzieje się z Twoimi fakturami i jak je ponownie wysłaćCo oznacza błąd 4134 AEAT w VeriFactu, dlaczego odrzuca całe wysłanie i jak ponownie przesłać faktury z Odoo 17, 18, 19 i 20 bez utraty żadnej.
Sprawdzone w kodzie źródłowym modułu (wersja 20.0) i w podlinkowanych źródłach

Źródła