Cadrumo documentation

Paper tax forms, an envelope, a keyboard, and a calculator arranged on a desk

This is the documentation for Cadrumo and its aeat command-line interface (CLI). Cadrumo turns your records into checked modelo figures and an export file. You upload that file to the Agencia Estatal de Administración Tributaria (AEAT) yourself. For what Cadrumo is and who it is for, see the product page; the source is on GitHub. Cadrumo is in beta - interfaces may still change between releases.

Important

Cadrumo is not tax advice, is not affiliated with AEAT, and does not replace AEAT’s official tools or advice from a qualified professional. It builds, checks, and exports files locally. You file through official AEAT channels yourself and remain responsible for every declaration you submit. Read the full disclaimer before you rely on Cadrumo.

Where to start

These guides cover the whole preparation cycle: setting up a taxpayer profile, importing and classifying bank records, checking what is due, and preparing, verifying, and exporting each modelo. The two worked years - one for income tax, one for IVA - walk the full cycle with real commands.

Start from scratch

Take the shortest path from an empty profile to an exported modelo file.

Quickstart: prepare a modelo filing
Run through the income-tax year

Follow a worked year of Modelo 130 quarters closing into the annual Modelo 100 Renta declaration, command by command.

The income-tax year: four instalments and the annual Renta
Run through the IVA year

Follow a worked year of Modelo 303 quarters, the Modelo 349 branch, and the annual Modelo 390 summary, command by command.

The IVA year: quarterly returns and the annual summary
Set up your taxpayer profile

Create the taxpayer profile and record the facts that decide which modelos apply.

Set up your taxpayer profile
Import and manage transactions

Import bank statements, review the rows, and attach the evidence behind them.

Import and manage transactions
Classify transactions

Decide business, personal, or mixed use and set the category and tax fields on each row.

Classify transactions
Plan your filing calendar

See which modelos are due and which period to prepare next.

Plan your filing calendar
Prepare your filings

Prepare, verify, export, file at AEAT, and reconcile - with a recipe per modelo: 036, 100 (Renta), 130, 303, 349, and 390.

The filing workflow

Search everything

Press Ctrl+K (Cmd+K on macOS) on any page to search tax concepts, casillas, commands, and guides; exact term matches appear first. Use the command-line reference for commands and options, and how it works for how records become modelo figures and what checks run. Use Import, export, and evidence to distinguish source data, review outputs, AEAT upload files, official filing proof, and audit packages.