How-to guides

Pick the question closest to what you are trying to do. For exact command options, use the command-line reference.

How do I start this?

Get Started

Map the whole journey from bank records to a filed modelo, stage by stage.

Get started: from bank records to a filed modelo
Quickstart

Shortest path from profile and ledger to an exported modelo file.

Quickstart: produce a modelo file
Set Up a Profile

Create, inspect, switch, export, import, rename, or delete taxpayer profiles.

Set up your taxpayer profile
Authenticate with AEAT

Configure read-only AEAT authentication for live-read workflows.

Authenticate with AEAT

What do I have to do?

Link Modelo 036 Censo

Pull, compare, and apply AEAT census facts for the active profile.

Link Modelo 036 census information
Which Modelos Apply to You

Ask which modelos apply to you and why, from your saved profile facts.

Find out which modelos apply to you
Filing Calendar

See what may be due and when filing windows open and close.

Plan your filing calendar
Filing Periods

Understand quarters, annual period codes, dates, and year-end.

Understand filing periods
AEAT Notifications

Capture, list, and view official AEAT notifications from your electronic inbox.

Check AEAT notifications and live observations
Read Live AEAT Data

Pull read-only data from AEAT: censo, notifications, filed returns, and receipts.

Read live AEAT data
Work with Transactions

Import, add, edit, remove, and review ledger rows.

Work with Transactions
Classify Transactions

Classify rows manually, in bulk, with allocation, or with LLM assistance.

Classify transactions
Manage Business Invoices

Record issued and received invoices and feed intra-community operations to Modelo 349.

Manage business invoices
Attach Invoices and Receipts

Store invoices and receipts and link them to the transactions they support.

Attach invoices and receipts to ledger transactions
Correct Ledger Mistakes

Update, remove, split, merge, stash, or archive transactions safely.

Correct mistakes in your ledger
Review Queue

Work through everything that still wants attention before a filing.

Work through the review queue
Record Modelo 036

Record an alta, modificacion, or baja you filed at AEAT’s sede.

Record a Modelo 036 declaration you filed at AEAT
Calculation Inputs

Review which form boxes were filled, supply missing values, and handle offsets.

Review and supply calculation inputs
Google Sheets Review

Export, edit, and pull back model calculations using a Google Sheets spreadsheet.

Review calculations with Google Sheets
Verify a Filing

Run verification, read the report findings, and fix what blocks export.

Verify a draft filing and act on the findings
Filing Readiness

Check readiness, dependencies, lifecycle history, and year-over-year deltas.

Check that a filing is ready
File at AEAT

Export the file, upload it at the AEAT portal yourself, record, and reconcile.

Upload your exported modelo at the AEAT portal
Reconcile a Filing

Compare local filing data with the AEAT justificante.

Reconcile a filed modelo against its justificante
Filing Receipts

Pull, store, and inspect the AEAT justificante for each filed period.

Pull and keep your filing receipts

How does this work?

Filing Workflow

Understand drafts, verification, export, filing markers, and history.

The filing workflow: work units and calculation revisions
Modelo 303

Prepare, verify, and export a quarterly IVA return.

Prepare a Modelo 303 IVA filing
Modelo 390

Prepare the annual IVA summary.

Prepare the annual Modelo 390 IVA summary
IVA Prorrata Deductions

Deduct input IVA under general or especial prorrata and declare differentiated sectors.

Apply IVA prorrata deductions
LLM Classification

Preview, apply, reject, or override local LLM suggestions.

Classify transactions with an LLM
Classify from an Invoice

Read an attached invoice on-host to classify, with the consent and privacy rules.

Classify a transaction from its invoice with a model
LLM Provider Setup

Install and authenticate a provider CLI so LLM suggestions work.

Set up LLM classification providers
Connect an Agent

Expose the toolset to Claude or any MCP client, with the safety boundary intact.

Connect an agent (MCP)
Protect Data Access

Set up a recovery key, change or recover your passphrase, lock, or reset.

Protect access to your data
Troubleshooting

Fix active-profile, storage, registry, and authentication problems.

Diagnose and repair your local setup
Recovery Runbooks

Step-by-step recovery procedures for common refusals and failures.

Recovery runbooks

aeat does not submit to AEAT. Exported files are local files. You upload them yourself through official AEAT channels and keep the justificante for your records.