Verify a draft filing and act on the findings

Verification checks your saved calculation locally against the official form rules and saves a report of what it found. Nothing is sent to AEAT; everything happens on your computer. The order is always the same: calculate, then verify, then export or record the filing.

Before you start

You need:

  • A master-key passphrase. aeat prompts for it, or you set AEAT_SECRET_PASSPHRASE for a non-interactive run.

  • An active profile with a name and surnames. The --quiet form skips the wizard:

    aeat config profile create me --quiet --tax-id 12345678Z --name "Ana" \
  --surnames "Garcia Lopez" --activity "consultoria" --activity-start-date 2026-01-01

    The --activity-start-date matters for a first filing: it scopes out the dependency on a prior period you never filed, so verification can pass. See Set up your profile.

  • A calculated draft for the filing you want to check. For a first-period Modelo 303, record some business activity in the ledger, create the work unit, then calculate:

    aeat app ledger add --date 2026-02-10 --amount 1210 --direction INCOMING \
  --description "venta" --classification BUSINESS --taxable-base 1000 --iva-rate 0.21 --iva-amount 210
aeat app modelo work create --modelo 303 --year 2026 --period 1T
aeat app modelo work calculate --modelo 303 --year 2026 --period 1T

If you want to understand how filings and saved calculations fit together, read the filing spine first.

Run verification

Run verification against the filing you want to check. Name the modelo, the year, and the period:

aeat app modelo work verify --modelo 303 --year 2026 --period 1T

Period tokens are 0A for annual, 1T to 4T for quarters, and 01 to 12 for months.

With the profile and draft above, this first-period Modelo 303 passes. When the draft passes, the result shows granted_verificado_completo true and a completeness_status of complete - the saved calculation is now verified and ready to export.

When the draft does not pass, the result shows granted_verificado_completo false and a completeness_status of incomplete or blocked. The saved calculation stays a draft.

The command saves the verification report in both cases, so you can return to the findings later.

By default the command checks the current saved calculation, and it checks only drafts. To pick a different draft, use --select latest-draft or pass that calculation’s revision ID directly. Use --by to record who ran the check.

List your verification reports

Every verification run leaves a report. List them:

aeat app modelo verification-report list

To narrow the list to the reports for one saved calculation, add --calculation-revision-id with that calculation’s ID.

View a report and read the findings

Open one report by its ID:

aeat app modelo verification-report view <verification-report-id>

The report shows:

  • The completeness status: complete, incomplete, or blocked.

  • Whether the draft became verified (granted_verificado_completo).

  • When the run happened and who ran it.

  • How many casillas the calculation resolved.

  • Which required casillas are still missing.

  • The list of findings.

Each finding carries:

  • A severity: blocking or warning.

  • The affected casilla, where one applies.

  • A message describing what the rule checked.

  • A suggested next action.

  • The legal references behind the rule, where the rule has them.

For the legal references in machine-readable form, render the report as JSON. --format json is a global flag, so it goes before the command:

aeat --format json app modelo verification-report view <verification-report-id>

Each finding in the JSON output carries legal_refs and source_refs. Most findings name a legal reference - a cross-period dependency, for example, cites the law behind the prior-filing carry. A few purely structural checks, such as an unresolved registry snapshot, have none, so those fields are empty for them.

Blocking findings prevent the draft from becoming verified, and export needs a verified calculation. Warnings do not block; read them, decide whether they apply to you, and move on.

After any fix: re-run verification

After you change anything, run verification again:

aeat app modelo work verify --modelo 303 --year 2026 --period 1T

Confirm the finding you addressed is gone from the new report. Repeat until the result shows granted_verificado_completo true. Each symptom section in this guide finishes with this re-run step.

The report says incomplete

Incomplete means required casillas have no value yet. The report lists which ones under missing required casillas.

For a casilla you enter by hand, supply its value and recalculate:

aeat app modelo work calculate --modelo 303 --year 2026 --period 1T --casilla <ID>=<VALUE>

--casilla works only on boxes whose input kind is manual. A box filled from your ledger or another source is bound, and --casilla refuses it with cannot override bucket-derived source-bound casillas. Fix the source for those — see Review your calculation values. Check which kind a box is with aeat app modelo casillas 303 --period 1T.

Then re-run verification. For the full input workflow, including where values come from and how to check them, see Review your calculation values.

The report says blocked

Blocked means at least one blocking finding stands between your draft and a verified calculation. You cannot export the draft until you resolve every blocking finding.

Read each finding’s suggested next action first; it tells you what the tool expects you to do. The common kinds of blocking finding:

  • A cross-field rule failed. Two or more casillas disagree in a way the form rules do not allow. Check the values named in the finding against your records.

  • A value could not be derived. The tool needed to compute a casilla but your data did not provide enough input. Supply the missing input or enter the value directly.

  • A prior-period record is missing. This filing depends on a filing from an earlier period that is missing or unconfirmed. Record or confirm that earlier filing first. If you had no obligation in that earlier period because you had not started your activity yet, set your activity-start date on the profile so the dependency is scoped out:

    aeat config profile edit me --quiet --activity-start-date 2026-01-01

    Replace me with your profile name.

After each fix, re-run verification.

Export refuses because no verified calculation exists

Export needs a verified (or locally-filed) saved calculation. It refuses a plain draft with a message such as “current revision is still draft; verify it before exporting” or “no exportable verified or filed revision exists”. Check where your filing stands:

aeat app modelo work status --modelo 303 --year 2026 --period 1T

If the saved calculation is still a draft, verify it:

aeat app modelo work verify --modelo 303 --year 2026 --period 1T

Once verification grants verified-complete, retry the export:

aeat app modelo export --modelo 303 --year 2026 --period 1T --output ./modelo-303.boe

More than one filing matches

When more than one filing or saved calculation matches the modelo, year, and period you named, the tool refuses to guess and prints the candidates instead.

List your filings with their work-unit IDs:

aeat app modelo work list

Then target the one you mean by passing its work-unit ID directly:

aeat app modelo work verify --work-unit-id <work-unit-id>

To confirm which filing a command touched, check its state and the actions taken on it:

aeat app modelo work status --modelo 303 --year 2026 --period 1T
aeat app modelo work history --modelo 303 --year 2026 --period 1T

The filing deadline has passed

Verification does not check filing deadlines. It still runs for a past period and can pass; the deadline gate applies later, when you record the filing with work file.

If the deadline has passed, file late through AEAT’s own channels; consult AEAT or an advisor about any surcharges that may apply.

Where to get help

Command labels and messages display in Spanish to match the official AEAT forms, while this guide is in English. The field names this guide names - granted_verificado_completo, completeness_status, finding_legal_refs - match the output exactly, so you can map a Spanish line back to the step that describes it.

If a report or an error message does not match what this guide describes, see Diagnose and repair. Unfamiliar terms are defined in the glossary. Before you share command output to ask for help, remove personal tax identifiers such as your NIF, CIF, DNI, NIE, or NII.

Next steps