Llegeix les notificacions de l’AEAT i altres dades en directe

Aquesta pàgina tracta les superfícies de l’AEAT de només lectura en directe: notificacions oficials, historial de declaracions, declaracions presentades, verificació de NIF, el catàleg del portal, el borrador i el saldo de compensació d’IVA. Totes les ordres d’aquesta secció descarreguen dades i les desen localment. Cap d’elles no presenta res ni canvia els teus registres de l’AEAT.

Com funciona una lectura en directe

Cada lectura en directe funciona igual. Utilitza l’autenticació que tens configurada, llegeix de la sede de l’AEAT en només lectura i desa una còpia local xifrada al teu perfil. No aplica res automàticament: una descàrrega (pull) desa una còpia local, i aplicar una dada descarregada només actualitza el teu perfil o registres locals, i només després que la revises. Mai no s’envia res de tornada a l’AEAT. Tu continues sent l’únic que presenta. Per entendre aquest límit, consulta Registrar una presentació i el límit.

Dues superfícies en directe tenen la seva pròpia guia: les dades censals es tracten a Enllaça la informació censal del Model 036, i els justificants de presentació (justificantes) a Descarrega i desa el justificante.

Abans de contactar amb l’AEAT, cada lectura en directe executa un preflight d’autenticació. Si no hi ha cap proveïdor configurat, la lectura es nega en aquest preflight; el text del rebuig esmenta una comprovació d’identitat de Cl@ve (La identidad de Cl@ve Móvil no coincide...), però la causa subjacent és que l’autenticació no està configurada. Configura primer un proveïdor. Consulta Autentica’t amb l’AEAT.

Abans de començar

Necessita:

  • un perfil actiu. Creeu-ne un en un terminal per poder triar-ne la frase de contrasenya:

    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.

  • l’identificador fiscal del contribuent (generalitzat com a NIF, CIF, DNI, NIE o NII) desat en aquest perfil

  • la frase de contrasenya del perfil que desempaqueta la seva clau de xifratge independent; l’eina la demana.

  • l’autenticació de lectura en directe de l’AEAT configurada; consulta Autentica’t amb l’AEAT

1. Official AEAT notifications (DEHu)

La DEHu és la bústia electrònica oficial de l’AEAT per a les notificacions (comunicaciones i notificaciones). La targeta mostra les lectures de notificacions: pull les descarrega i les desa localment, list mostra les teves notificacions actuals de la DEHu, view obre una descàrrega desada pel seu número de referència i latest mostra la instantània més recent del perfil actiu.

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

Llegeix un document de notificació només després d’haver obert personalment aquella notificació a la seu de l’AEAT. Obrir una notificació electrònica no llegida és un acte amb conseqüències legals: dona per practicada la notificació i inicia els terminis de recurs i pagament. Per això l’eina rebutja obtenir un document llevat que l’AEAT ja informi que la notificació s’ha llegit. Obre tu una notificació no llegida quan decideixis que han de començar aquests terminis.

Obtén un document apte en custòdia local xifrada, consulta un document desat sense contactar amb l’AEAT o enumera les xifres informades per cada document analitzat:

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

Tracta l’historial com un registre de documents, no com un saldo. No suma les xifres, no indica què es pot pagar actualment ni substitueix el registre de recaptació que comunica la consulta de deutes de l’AEAT. Un document per si sol no estableix si el seu import s’ha pagat, recorregut, reduït o substituït.

3. Declaration history (expedientes)

Els expedientes són el registre oficial de l’AEAT de les teves declaracions anteriors: cada declaració presentada de cada model i any, amb el seu estat i la data de presentació.

La targeta mostra les lectures d’expedientes: pull descarrega l’historial d’un formulari i any, pull amb un interval d’anys cobreix diversos anys alhora (omet --modelo per descarregar l’historial de tots els formularis que tens registrats), list mostra les descàrregues desades, view obre els detalls d’una descàrrega (declaracions individuals, estat, dates i enllaços als justificantes) i latest mostra la instantània més recent.

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

Descarrega els valors casella per casella d’una declaració que ja has presentat a l’AEAT.

La targeta mostra les lectures del detall presentat. filed list llista les declaracions presentades que l’AEAT té sense desar-ne els valors de les caselles (tot i així llegeix de l’AEAT en directe, de manera que necessita autenticació configurada com qualsevol altra ordre en directe). filed pull descarrega i desa els valors complets de les caselles d’una declaració o d’un interval d’anys, i filed pull-sources descarrega les declaracions font de què depèn una presentació objectiu (per exemple, les declaracions del Model 303 que necessita un resum anual del Model 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

Comprova si un NIF està registrat a efectes d’IVA intracomunitari (el registre VIES), o comproves un NIF espanyol al registre ROI espanyol.

La targeta mostra les lectures de verificació. verify nif-iva comprova si un número d’IVA estranger de la UE és vàlid, i verify tgvi comprova si un NIF o NIE espanyol apareix al registre ROI espanyol (afegeixes --expected valid|invalid|unknown per comparar-ho amb un resultat esperat). verify list mostra les verificacions anteriors, verify view n’obre una pel seu id d’observació i verify latest mostra l’última observació d’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 targeta mostra les lectures del catàleg del portal. portals list mostra els portals en línia oficials de l’AEAT que l’eina coneix i els seus requisits d’autenticació; acota-ho a un formulari amb --modelo o a una categoria amb --category (les categories admeses són auth, filing, censo, consultation, borrador, payment i calendar_reference). Usa --modelo o --category, no tots dos: són mútuament excloents. portals view obre els detalls d’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 és l’esborrany precalculat del Model 100 d’IRPF que l’AEAT posa a disposició dels assalariats. La targeta mostra les lectures del borrador: list mostra les instantànies, view obre els valors de les caselles d’un borrador i latest mostra l’últim esborrany actiu d’un any de presentació.

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

El teu saldo de compensació d’IVA (saldo a compensar) és l’import d’IVA pagat en excés de trimestres anteriors que es pot deduir de presentacions futures del Model 303. La targeta mostra les lectures de la cartera d’IVA. pull descarrega i fa el seguiment del teu saldo actual, pull-history reconstrueix les decisions de compensació anteriors a partir de presentacions prèvies del Model 303, pull-evidence captura declaracions anteriors i l’evidència d’IVA actual en una sola execució de només lectura, i history llista els saldos i les decisions persistits localment.

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

Passos següents