Przejdź do głównej treści
VeriFactu

Błędy VeriFactu przy klientach zagranicznych: 1239 i kody IDOtro

Gdy klient nie ma hiszpańskiego numeru NIF, faktura identyfikuje go w bloku IDOtro za pomocą trzech danych: kraju, rodzaju dokumentu i numeru. AEAT ma ponad tuzin kodów na wypadek, gdy ta kombinacja się nie zgadza, a najbardziej ogólny z nich, 1239, mówi tylko, że w bloku Destinatario jest błąd. Tutaj są wszystkie, wraz z tym, co Odoo wysyła w każdym przypadku.

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
4 min

Jak Odoo identyfikuje klienta zagranicznego

Moduł ustala rodzaj identyfikatora w chwili zatwierdzenia faktury, na podstawie dwóch pól kontaktu: kraju i numeru NIF.

Klient z krajem Hiszpania lub bez kraju
Wysyłany w polu NIF. Jeśli numer zaczyna się od X, Y lub Z, traktowany jest jako NIE.
Klient z innego kraju UE
Wysyłany w IDOtro z IDType 02 (NIF-IVA) i bez CodigoPais.
Klient spoza UE
Wysyłany w IDOtro z CodigoPais jego kraju i IDType 04, albo z IDType 03 (paszport), jeśli numer ma więcej niż 20 znaków lub żadnego znaku alfanumerycznego.

Numer przekazywany jest maksymalnie z 20 znakami. Mając to na uwadze, niemal każdy z poniższych kodów wyjaśnia się, patrząc na kraj i numer NIF kontaktu.

Karta błędów IDOtro w VeriFactu
Błąd 1239 i trzynaście kodów bloku Destinatario omówionych na tej stronie, wszystkie z sekcji, która odrzuca wpis.

Kody, jeden po drugim

KodCo mówi AEATCo sprawdzić
1239Error en el bloque Destinatario.Cały blok: kraj, numer NIF i nazwę kontaktu.
1101El valor del campo CodigoPais es incorrecto.Kraj kontaktu.
1102El valor del campo IDType es incorrecto.Rodzaj dokumentu, który został ustalony.
1103El valor del campo ID es incorrecto.Numer kontaktu.
1111El campo CodigoPais es obligatorio cuando IDType es distinto de NIF-IVA (02).Klient bez kraju w Odoo.
1122El campo CodigoPais indicado no coincide con los dos primeros dígitos del identificador.Numer z prefiksem innego kraju.
1126El valor del CodigoPais solo puede ser ES cuando el IDType sea Pasaporte (03) o No Censado (07)…Klient hiszpański wysłany przez IDOtro.
1131El valor del campo ID ha de ser el NIF de una persona física cuando el campo IDType tiene valor No Censado (07).Typ 07, którego moduł nie używa.
1222El valor del campo ID del bloque IDOtro es incorrecto.Numer klienta spoza Hiszpanii.
1232, 1233 i 1234IDOtro z CodigoPais ES wymaga IDType 03, 07 lub jednego z tych dwóch.Kraj Hiszpania przy kliencie z paszportem.
1254 i 1255Numery NIF-IVA z Wielkiej Brytanii: XI nie jest przyjmowane przed 01/01/2021, a GB nie jest przyjmowane od 01/02/2021.Data operacji i prefiks.

Dla IDType 02 AEAT sprawdza dodatkowo, czy numer ma strukturę NIF-IVA państwa członkowskiego i czy jest pisany wielkimi literami. W praktyce NIF klienta europejskiego musi być zapisany w Odoo z prefiksem kraju, tak jak weryfikuje go VIES.

Co dzieje się w Odoo, gdy AEAT to odrzuci

Te kody odrzucają wpis, a nie wysyłkę: pozostałe faktury z tego samego żądania przechodzą. Kolejka oznacza odrzucony wpis jako Retrying i wysyła go ponownie z coraz dłuższymi przerwami, od 2 minut do 12 godzin; przy szóstej próbie przenosi go do Dead Letter, a wpis otrzymuje status „Error permanente”.

Błędy AEAT w Odoo z 1239 w Dead Letter
Błąd 1239 po sześciu próbach, w Dead Letter, obok dwóch wysyłek w 4134. Zrzut ekranu Odoo 20 z danymi demonstracyjnymi i symulowanymi odpowiedziami AEAT.

Ponowienie nic nie zmieni, jeśli dane są błędne, ponieważ wysyłka powstaje z wpisu utworzonego przy zatwierdzaniu faktury, a nie z kontaktu. Dlatego naprawa ma dwie części:

  1. Popraw kraj lub numer NIF kontaktu, aby kolejne faktury były poprawne.
  2. Dla faktury już odrzuconej AEAT przewiduje rejestrację po odrzuceniu, z Subsanacion S i RechazoPrevio X. Opublikowany moduł nie generuje tego wpisu sam z siebie: napisz na comercial@flexigobe.com z numerem faktury, a rozwiążemy to razem.

Kody z tej strony z tekstem AEAT

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

KodTekst AEAT
1239Error en el bloque Destinatario.
1101El valor del campo CodigoPais es incorrecto.
1102El valor del campo IDType es incorrecto.
1103El valor del campo ID es incorrecto.
1111El campo CodigoPais es obligatorio cuando IDType es distinto de NIF-IVA (02).
1122El campo CodigoPais indicado no coincide con los dos primeros dígitos del identificador.
1126El valor del CodigoPais solo puede ser ES cuando el IDType sea Pasaporte (03) o No Censado (07). Si IDType es No Censado (07) el CodigoPais debe ser ES (España).
1131El valor del campo ID ha de ser el NIF de una persona física cuando el campo IDType tiene valor No Censado (07).
1222El valor del campo ID del bloque IDOtro es incorrecto.
1232Si se identifica a través de la agrupación IDOtro y CodigoPais tiene valor ES (España), el campo IDType debe valer Pasaporte (03).
1233Si se identifica a través de la agrupación IDOtro y CodigoPais tiene valor ES (España), el campo IDType debe valer No Censado (07).
1234Si se identifica a través de la agrupación IDOtro y CodigoPais tiene valor ES (España), el campo IDType debe valer Pasaporte (03) o No Censado (07).
1254Si FechaOperacion (FechaExpedicionFactura si no se informa FechaOperacion) es anterior a 01/01/2021 no se permite el valor 'XI' para Identificaciones NIF-IVA
1255Si FechaOperacion (FechaExpedicionFactura si no se informa FechaOperacion) es mayor o igual que 01/02/2021 no se permite el valor 'GB' para Identificaciones NIF-IVA

Jeśli kodu, który widzisz, nie ma w tej tabeli, pełny katalog znajduje się w Envío a AEAT › Catálogo de Errores AEAT, z dosłownym tekstem AEAT.

Czytaj dalej

Błędy VeriFactu z NIP klienta: rejestr, format i nazwaBłędy VeriFactu dotyczące NIP klienta: rejestr (1109, 1110, 1121, 1193, 1154), format (1123, 1290) i nazwa (1283). Skąd się biorą i co sprawdza Odoo przed wysyłką.Błędy 1189, 1190, 1191 i 1192 w VeriFactu: typ faktury i odbiorca muszą się zgadzaćBłędy VeriFactu łączące typ faktury z odbiorcą (1189, 1190, 1191, 1192, 1106 i 1156): reguła AEAT i to, co Odoo ustala przy zatwierdzeniu faktury.Błąd 2001 VeriFactu: NIF Twojego klienta nie figuruje w rejestrze AEATBłąd 2001 w VeriFactu: NIF odbiorcy nie figuruje w rejestrze AEAT. Dlaczego faktura mimo to przechodzi i co zrobić w Odoo 17–20.
Sprawdzone w kodzie źródłowym modułu (wersja 20.0) i w podlinkowanych źródłach

Źródła