Leer notificaciones de la AEAT y otros datos en directo¶

Esta página cubre las superficies de la AEAT de solo lectura en directo: notificaciones oficiales, historial de declaraciones, declaraciones presentadas, verificación de NIF, el catálogo de portales, el borrador y tu saldo de IVA a compensar. Todas las órdenes de esta sección descargan datos y los guardan localmente. Ninguna de ellas presenta nada ni cambia tus registros en la AEAT.

Cómo funciona una lectura en directo¶

Todas las lecturas en directo funcionan igual. Usan la autenticación que has configurado, leen de la sede de la AEAT en solo lectura y guardan una copia local cifrada en tu perfil. No aplican nada de forma automática: una descarga (pull) guarda una copia local, y aplicar un dato descargado actualiza solo tu perfil o tus registros locales, y solo después de que lo revises. Nunca se envía nada de vuelta a la AEAT. Tú sigues siendo el único que presenta. Para entender ese límite, consulta Registrar una presentación y el límite.

Dos superficies en directo tienen tu propia guía: los datos del censo se tratan en Vincular la información censal del Modelo 036, y los justificantes de presentación en Descargar y guardar el justificante.

Antes de contactar con la AEAT, toda lectura en directo ejecuta una comprobación previa de autenticación. Si no hay ningún proveedor configurado, la lectura se rechaza en esa comprobación previa; el texto del rechazo menciona una comprobación de identidad de Cl@ve (La identidad de Cl@ve Móvil no coincide...), pero la causa de fondo es que la autenticación no está configurada. Configura primero un proveedor. Consulta Autenticar Cadrumo ante la AEAT.

Antes de empezar¶

Necesitas:

un perfil activo. Crea uno en una terminal para poder elegir su frase de contraseña:
1Create the taxpayer profile interactively so the passphrase is chosen at the terminal.
aeat config profile create me
aeat config profile create me
2Confirm the selected profile is active before configuring AEAT authentication.
aeat --format json config profile list
aeat --format json config profile list
```
{
  "active_profile": "docs-sequence-sandbox",
  "command": "config.profile.list",
  "notices": [],
  "result": {
    "active_profile": "docs-sequence-sandbox",
    "profiles": [
      {
        "active": true,
        "bucket_id": "<bucket-id>",
        "name": "docs-sequence-sandbox"
      }
    ]
  },
  "schema_version": "2",
  "status": "success"
}
```
Confirm profile creation prompts for the passphrase at a terminal and leaves a selected profile active.
el identificador fiscal del contribuyente (generalizado como NIF, CIF, DNI, NIE o NII) guardado en ese perfil
la frase de contraseña del perfil que desenvuelve su clave de cifrado independiente; la herramienta la solicita.
la autenticación de lectura en directo de la AEAT configurada; consulta Autenticar Cadrumo ante la AEAT

1. Official AEAT notifications (DEHu)¶

La DEHu es el buzón electrónico oficial de la AEAT para las notificaciones (comunicaciones y notificaciones). La tarjeta muestra las lecturas de notificaciones: pull las descarga y las guarda localmente, list muestra tus notificaciones actuales de la DEHu, view abre una descarga guardada por su número de referencia y latest muestra la instantánea más reciente del perfil activo.

1Download your notifications and save them locally.

aeat app live notifications pull

aeat app live notifications pull

2Download your current DEHu notifications.

aeat app live notifications list

aeat app live notifications list

3View a specific saved download by its reference number.

aeat app live notifications view <snapshot-id>

aeat app live notifications view <snapshot-id>

4Show the most recent snapshot in the active profile.

aeat app live notifications latest

aeat app live notifications latest

2. Read documents from notifications you already opened¶

Lee un documento de notificación solo después de haber abierto personalmente esa notificación en la sede de la AEAT. Abrir una notificación electrónica no leída es un acto con consecuencias legales: da por practicada la notificación e inicia los plazos de recurso y pago. Por eso, la herramienta rechaza obtener un documento salvo que la AEAT ya informe de la notificación como leída. Abre tú una notificación no leída cuando decidas que deben comenzar esos plazos.

Obtén un documento apto en custodia local cifrada, consulta un documento almacenado sin contactar con la AEAT o enumera las cifras informadas por cada documento analizado:

1Pull one already-opened notification document into encrypted custody.

aeat app live notifications document pull <certificado-id>

aeat app live notifications document pull <certificado-id>

2View one notification document already held in encrypted custody.

aeat app live notifications document view <certificado-id>

aeat app live notifications document view <certificado-id>

3List the reported figures from stored notification documents.

aeat app live notifications document history

aeat app live notifications document history

Trata el historial como un registro de documentos, no como un saldo. No suma las cifras, no indica qué se debe pagar actualmente ni sustituye el registro de recaudación que comunica la consulta de deudas de la AEAT. Un documento por sí solo no demuestra si su importe se pagó, recurrió, redujo o sustituyó.

3. Declaration history (expedientes)¶

Los expedientes son el registro oficial de la AEAT de tus declaraciones pasadas: cada declaración presentada para cada modelo y ejercicio, con su estado y su fecha de presentación.

La tarjeta muestra las lecturas de expedientes: pull descarga el historial de un modelo y un ejercicio, pull con un rango de años abarca varios ejercicios a la vez (omite --modelo para descargar el historial de todos tus modelos registrados), list muestra las descargas guardadas, view abre los detalles de una descarga (declaraciones individuales, estado, fechas y enlaces a justificantes) y latest muestra la instantánea más reciente.

1Download the declaration history for a specific form and year.

aeat app live expedientes pull --modelo 100 --year 2026

aeat app live expedientes pull --modelo 100 --year 2026

2Download history for a range of years.

aeat app live expedientes pull --from-year 2020 --to-year 2026 --modelo 303

aeat app live expedientes pull --from-year 2020 --to-year 2026 --modelo 303

3List saved downloads.

aeat app live expedientes list

aeat app live expedientes list

4View a specific download's details.

aeat app live expedientes view <snapshot-id>

aeat app live expedientes view <snapshot-id>

5Show the most recent expedientes snapshot.

aeat app live expedientes latest

aeat app live expedientes latest

4. Filed declaration detail¶

Descarga los valores casilla por casilla de una declaración que ya hayas presentado ante la AEAT.

La tarjeta muestra las lecturas de detalle de lo presentado. filed list enumera las declaraciones presentadas que tiene la AEAT sin guardar sus valores de casilla (aun así lee de la AEAT en directo, así que necesita autenticación configurada como cualquier otra orden en directo). filed pull descarga y guarda los valores completos de las casillas de una declaración o de un rango de años, y filed pull-sources descarga las declaraciones de origen de las que depende una presentación objetivo (por ejemplo, las declaraciones del Modelo 303 que necesita el resumen anual del Modelo 390).

1List the filed returns AEAT holds, without saving their box values.

aeat app live filed list --modelo 303 --from-year 2020 --to-year 2026

aeat app live filed list --modelo 303 --from-year 2020 --to-year 2026

2Download and save the full box values from a specific filed return.

aeat app live filed pull --modelo 303 --year 2026 --period 1T

aeat app live filed pull --modelo 303 --year 2026 --period 1T

3Download all filed returns across a year range.

aeat app live filed pull --from-year 2020 --to-year 2026

aeat app live filed pull --from-year 2020 --to-year 2026

4Download the source declarations that a target filing depends on.

aeat app live filed pull-sources --modelo 303 --year 2026 --period 1T

aeat app live filed pull-sources --modelo 303 --year 2026 --period 1T

5. NIF and EU VAT verification¶

Verifica si un NIF está registrado a efectos de IVA intracomunitario (el registro VIES), o comprueba un NIF español en el registro ROI español.

La tarjeta muestra las lecturas de verificación. verify nif-iva comprueba si un número de IVA de otro país de la UE es válido, y verify tgvi comprueba si un NIF o NIE español aparece en el registro ROI español (añade --expected valid|invalid|unknown para comparar con un resultado esperado). verify list muestra las verificaciones anteriores, verify view abre una por su id de observación y verify latest muestra la última observación de un NIF.

1Check whether a foreign EU VAT number is valid.

aeat app live verify nif-iva ESB12345674

aeat app live verify nif-iva ESB12345674

2Check whether a Spanish NIF or NIE appears in the Spanish ROI register.

aeat app live verify tgvi 12345678A

aeat app live verify tgvi 12345678A

3List past verifications you have run.

aeat app live verify list --surface tgvi

aeat app live verify list --surface tgvi

4View details of a specific verification.

aeat app live verify view <observation-id>

aeat app live verify view <observation-id>

5Show the latest verification observation for a NIF.

aeat app live verify latest --surface nif_iva --nif ESB12345674

aeat app live verify latest --surface nif_iva --nif ESB12345674

6. Official AEAT portal catalogue¶

La tarjeta muestra las lecturas del catálogo de portales. portals list muestra los portales oficiales en línea de la AEAT que la herramienta conoce y sus requisitos de autenticación; acótalo a un modelo con --modelo o a una categoría con --category (las categorías admitidas son auth, filing, censo, consultation, borrador, payment y calendar_reference). Usa --modelo o --category, no ambos: son mutuamente excluyentes. portals view abre los detalles de un portal.

1View the official AEAT online portals and their authentication requirements.

aeat app live portals list

aeat app live portals list

2Narrow the list to the portals for one form.

aeat app live portals list --modelo 303

aeat app live portals list --modelo 303

3Narrow the list to one category.

aeat app live portals list --category filing

aeat app live portals list --category filing

4View one portal's details.

aeat app live portals view <portal-id>

aeat app live portals view <portal-id>

7. Borrador (draft Modelo 100)¶

El borrador es el borrador precalculado del Modelo 100 del IRPF que la AEAT pone a disposición de los perceptores de rendimientos del trabajo. La tarjeta muestra las lecturas del borrador: list muestra las instantáneas, view abre los valores de casilla de un borrador y latest muestra el último borrador activo de un ejercicio.

1Download and list the active borrador snapshots.

aeat app live borrador 100 list --state active

aeat app live borrador 100 list --state active

2View a specific borrador's box values.

aeat app live borrador 100 view <snapshot-id>

aeat app live borrador 100 view <snapshot-id>

3Show the latest active draft for a filing year.

aeat app live borrador 100 latest --filing-year 2026

aeat app live borrador 100 latest --filing-year 2026

8. IVA compensation balance¶

Tu saldo de IVA a compensar es el importe de IVA pagado de más en trimestres anteriores que se puede deducir en futuras presentaciones del Modelo 303. La tarjeta muestra las lecturas del monedero de IVA. pull descarga y hace seguimiento de tu saldo actual, pull-history reconstruye las decisiones de compensación pasadas a partir de presentaciones anteriores del Modelo 303, pull-evidence captura declaraciones pasadas y la evidencia de IVA actual en una única ejecución de solo lectura, y history enumera los saldos y las decisiones persistidos que se guardan localmente.

1Download and track your current IVA compensation balance.

aeat app live iva-wallet pull --year 2026 --period 4T

aeat app live iva-wallet pull --year 2026 --period 4T

2Reconstruct the history of past compensation decisions.

aeat app live iva-wallet pull-history --from-year 2020 --to-year 2026

aeat app live iva-wallet pull-history --from-year 2020 --to-year 2026

3Capture past returns and the current IVA evidence in one read-only run.

aeat app live iva-wallet pull-evidence --from-year 2020 --to-year 2026 --target-year \
  2026 --target-period 4T

aeat app live iva-wallet pull-evidence --from-year 2020 --to-year 2026 --target-year `
  2026 --target-period 4T

4List the persisted compensation balances and decisions.

aeat app live iva-wallet history --as-of-year 2026

aeat app live iva-wallet history --as-of-year 2026