Getting started¶
This page routes you to the right guide. The guides are grouped the way a filing year actually runs: set up who the taxpayer is, see what is due and when, keep the ledger of what happened, and prepare each filing. Cadrumo is the product; the Agencia Estatal de Administración Tributaria (AEAT) is the external tax authority, and Cadrumo never submits a return or acts as AEAT - read how records become filing-ready figures for that boundary.
Start with the installation guide if the aeat
command does not run. For a map of the whole journey from bank records to a
filed modelo, read the filing journey. For terminology, use
the glossary; for exact options and refusals,
the command-line reference.
For an ordinary failure, follow Diagnose and repair and open a public issue with redacted output if the problem remains. Never publish taxpayer data, credentials, or a vulnerability in an issue.
Run through a filing year¶
Two modelo-based run-throughs carry one example taxpayer through a complete filing year, command by command. Start here to see the whole workflow before running your own.
Four quarterly Modelo 130 instalments, each building on the ones before it, closing with the annual Modelo 100 Renta declaration.
Four quarterly Modelo 303 returns with the IVA credit carrying between them, a Modelo 349 branch, and the annual Modelo 390 summary.
Shortest path from profile and ledger to an exported modelo file: one modelo, one period, copy-paste commands.
First-time walk-through of one Modelo 130 quarter: import a statement, classify the rows, prepare the draft, and confirm it verifies.
Your profile¶
Who the taxpayer is, and the facts that decide what you owe.
Create, inspect, export, import, rename, or delete taxpayer profiles, and log in to the one you want active.
Configure read-only AEAT authentication for live-read workflows.
Keep AEAT census facts correct in the active profile.
Ask which modelos apply to you and why, from your saved profile facts.
Store your passphrase safely, log out, or reset local state.
Your calendar¶
What is due, and when.
See what may be due, when filing windows open and close, and which period tokens address them.
Capture official notifications and read live AEAT data, view-only.
Check readiness, what a filing depends on, its full history, and year-over-year changes.
Your ledger¶
The record of what happened: bring transactions in, classify them, and keep the evidence.
Import, add, edit, remove, and review ledger rows.
Classify rows manually, in bulk, with allocation, or through the review queue.
Set up a provider, preview and apply suggestions, and classify from an attached invoice.
Store invoices and receipts and link them to the transactions they support.
Record issued and received invoices and feed intra-community operations to Modelo 349.
Update, remove, split, merge, stash, or archive transactions safely.
Deduct input IVA under general or especial prorrata and declare differentiated sectors.
Your filings¶
The per-modelo work: prepare, review, verify, export, file, and reconcile.
Understand drafts, verification, export, filing markers, and history.
Record an alta, modificacion, or baja you filed at AEAT’s sede.
Prepare the annual Renta declaration that gathers the whole year.
Prepare the quarterly IRPF instalment, cumulative across the year.
Prepare, verify, and export a quarterly IVA return.
Declare intra-community operations from your invoice records.
Prepare the annual IVA summary.
Review which form boxes were filled, supply missing values, and handle offsets.
Export, edit, and pull back modelo calculations using a Google Sheets spreadsheet.
Run verification, read the report findings, and fix what blocks export.
Export the file, upload it at the AEAT portal yourself, record, and reconcile.
Pull and store the AEAT justificante, then compare it with your local filing record.
Tools and help¶
Expose the toolset to Claude or any MCP client, with the safety boundary intact.
Fix active-profile, storage, registry, and authentication problems.
Publish and verify a signed registry authority as a release operator.