Concilia un modelo presentat contra el seu justificante

Aquesta pàgina tracta el justificante, el rebut PDF signat que l’AEAT emet quan presentes al portal, i la conciliació: com baixar el rebut de l’AEAT i conservar-lo com a evidència xifrada al teu perfil, i com comparar-lo amb el teu registre de presentació local perquè una errada d’escriptura al portal, un període incorrecte o un valor local obsolet apareguin ara en lloc de durant una revisió posterior.

Hi ha dues maneres d’aportar el justificante:

  • Baixa’l de l’AEAT amb reconcile pull - l’eina recupera el rebut de la sede de l’AEAT (només lectura), en desa una còpia xifrada al teu perfil i concilia en un sol pas.

  • Fes servir un PDF local amb reconcile import --file: has descarregat tu mateix el justificant; la comprovació és local i no contacta mai amb l’AEAT.

Abans de començar

Necessites:

  • un perfil actiu

  • una unitat de treball presentada localment (has executat aeat app modelo work file per a aquesta presentació) que es va presentar al portal de l’AEAT

  • per a les ordres de baixada: una autenticació de l’AEAT que funcioni: consulta Autentica’t amb l’AEAT

  • per a reconcile import: el PDF del justificant al disc

Per crear un perfil, consulta Configura el teu perfil de contribuent. Per al flux de treball de presentació, consulta la guia ràpida. Cada ordre d’aquesta pàgina necessita la teva contrasenya de clau mestra; l’eina la demana.

Baixa i desa el justificante

Conserva el rebut amb els teus registres: és l’evidència oficial que hi ha darrere de cada període presentat. Recupera el justificante d’un període presentat i desa’l al teu perfil sense conciliar encara. Això llegeix de la sede de l’AEAT, de manera que es mostra com a marc il·lustratiu:

1Fetch and store the justificante for one filed period (a live AEAT read).
aeat app live justificante pull --modelo 130 --year 2026 --period 1T
aeat app live justificante pull --modelo 130 --year 2026 --period 1T

pull és només en directe: llegeix de l’AEAT (només lectura) i necessita la sessió d’autenticació configurada. --modelo, --year i --period són tots obligatoris. Quan l’autenticació no està configurada, la baixada es nega abans de contactar amb l’AEAT amb un missatge d’identitat de Cl@ve (La identidad de Cl@ve Móvil no coincide...); en una primera execució, la causa real sol ser que encara no hi ha cap sessió de l’AEAT configurada.

La sortida informa de la captura desada: el seu id d’instantània, l’expediente a què pertany, el codi de verificació CSV imprès al rebut, l’empremta del contingut del PDF i quan es va capturar. Els bytes del PDF es desen xifrats dins del teu perfil, de manera que no cal que conservis una còpia descarregada a part. Tornar a baixar-lo per al mateix modelo, any i període desa una captura nova i marca l’anterior com a substituïda, de manera que l’últim rebut sempre és l’actiu.

Llista cada captura desada al perfil actiu i, tot seguit, inspecciona’n una (n’hi ha prou amb un prefix inequívoc de l’id d’instantània). Totes dues llegeixen les captures desades a través de la superfície de justificantes en directe, de manera que es mostren com a marcs il·lustratius:

1List the justificante captures stored in the active profile.
aeat app live justificante list
aeat app live justificante list
2Inspect one capture by an unambiguous prefix of its snapshot id.
aeat app live justificante view <snapshot-id>
aeat app live justificante view <snapshot-id>

La vista informa de l’id de l’expediente, el codi de verificació CSV, l’empremta del PDF, si la captura encara està activa o substituïda, i quan es va capturar.

Baixa el justificante de l’AEAT i concilia

Recupera el rebut de la presentació i concilia en una sola ordre. La baixada llegeix de l’AEAT, de manera que es mostra com a marc il·lustratiu:

1Pull the receipt and reconcile it against the local record in one step.
aeat app modelo reconcile pull --modelo 303 --year 2026 --period 1T
aeat app modelo reconcile pull --modelo 303 --year 2026 --period 1T

Reemplaça 303, 2026 i 1T amb el modelo, l’any i el període de la teva presentació real. També pots anomenar la unitat de treball directament com a argument posicional en lloc dels selectors --modelo --year --period.

La baixada és de només lectura a l’AEAT. El rebut recuperat es desa com a captura xifrada al teu perfil, de manera que l’evidència oficial continua disponible després que l’ordre acabi. Per llistar o inspeccionar les captures desades més endavant, consulta Baixa i desa el justificante més amunt.

O bé concilia contra un PDF local

Si ja has descarregat el justificante del portal, compara el teu registre de presentació local contra aquell fitxer. Aquesta comprovació és local i mai no contacta amb l’AEAT, però necessita el PDF real del rebut al disc, de manera que es mostra com a marc il·lustratiu:

1Reconcile the local filing record against a downloaded justificante PDF.
aeat app modelo reconcile import --modelo 303 --year 2026 --period 1T --file \
  ./justificante.pdf
aeat app modelo reconcile import --modelo 303 --year 2026 --period 1T --file `
  ./justificante.pdf

Aquesta comprovació és local. Llegeix el PDF que aportes i mai no contacta amb l’AEAT.

Llegeix el resultat

Tots dos transports informen d’un de tres veredictes:

  • matches - el justificante coincideix amb el registre de presentació local.

  • mismatches - un o més camps difereixen. L’informe anomena cada camp i mostra el valor local al costat del valor trobat al PDF.

  • evidence_invalid - no s’ha pogut llegir el PDF. Comprova que el fitxer és el justificante de l’AEAT i no un document diferent.

La conciliació compara només quatre camps de capçalera: el codi de modelo, l’any de presentació, el període i l’identificador del contribuent (NIF, CIF, DNI o NIE). No compara els valors de les casilles. Un veredicte mismatches sempre anomena un d’aquests quatre camps, mai una casilla.

Gestiona una discrepància

Un veredicte mismatches anomena el camp de capçalera que difereix i mostra el teu valor local al costat del valor del justificante.

  1. Confirma que el justificante és el correcte per a aquesta presentació, no d’un període o contribuent diferent. Un rebut equivocat és la causa més habitual.

  2. Si el modelo, l’any o el període difereixen, o bé has conciliat contra la presentació equivocada o bé has presentat el període equivocat al portal. Torna a executar la conciliació amb els selectors correctes, o comprova què has presentat.

  3. Si l’identificador del contribuent difereix, confirma que el perfil actiu coincideix amb el contribuent a qui es va emetre el justificante.

  4. Si el justificante mateix sembla incorrecte, contacta amb el teu asesor o amb l’AEAT directament.

Si un valor de casilla sembla incorrecte

La conciliació no compara els valors de les casilles, de manera que no et pot dir que un total calculat difereix del que has presentat. Per corregir un valor de casilla, fes servir el flux de treball d’esmena en lloc de la conciliació. Torna a comprovar les entrades i torna a calcular. Si el període ja s’havia presentat, presenta una complementaria. Consulta Revisa i aporta entrades de càlcul.

Què conservar com a evidència

El justificante és la teva prova del que l’AEAT ha rebut. Vet aquí què desa cada camí:

  • reconcile pull desa el justificante recuperat com a còpia xifrada al teu perfil.

  • reconcile import llegeix un PDF que aportes però no el desa. Si concilies amb un PDF descarregat, baixa també el rebut perquè se’n conservi una còpia xifrada al teu perfil. Consulta Baixa i desa el justificant.

  • L’historial de conciliacions és una relectura que pots regenerar a partir del justificante, de manera que no necessita cap còpia de seguretat a part.

Revisa conciliacions anteriors

Cada conciliació es registra a l’historial d’esdeveniments del perfil. Llista les conciliacions anteriors registrades per al perfil actiu:

1List the reconciliations recorded for the active profile.
aeat --format json app modelo reconcile list
aeat --format json app modelo reconcile list
{
  "active_profile": "docs-sequence-sandbox",
  "command": "modelo.reconcile.list",
  "notices": [],
  "result": {
    "bucket_id": "<bucket-id>",
    "operation": "modelo.reconcile.list",
    "reconciliation_count": 0,
    "reconciliations": [],
    "work_unit_id": null
  },
  "schema_version": "2",
  "status": "success"
}

Confirm the recorded reconciliations read back cleanly.

En un perfil nou la llista és buida; després de conciliar una presentació apareix una fila per cada execució.

Afegeix --work-unit-id <id> per limitar la llista a una sola unitat de treball. Cada fila mostra quan es va executar la conciliació, la unitat de treball, la font d’evidència, el veredicte i quants camps van diferir. La conciliació és repetible a demanda a partir del justificante, de manera que això és una relectura de conveniència més que no pas un registre desat a part.

Passos següents