Cadrumo

Cadrumo is a helper for preparing your Spanish tax forms. It ships as the aeat command-line application.

This is the landing page for Cadrumo’s documentation. It shows how to turn local records into checked modelo figures and export files. You upload those files yourself to the Agencia Estatal de Administración Tributaria (AEAT). The project source is on GitHub.

Cadrumo is for autónomos, small businesses, and the people who help them prepare Spanish filing records. You prepare one taxpayer’s records at a time. The project is in beta, so expect changes between versions.

The guides on this page are ordered by the usual filing path. Start at the first thing you have not done yet. The path runs from installing the CLI and setting up the taxpayer, through preparing records and deciding what is due, to producing an export and following the full filing loop.

Important

aeat is not tax advice, is not affiliated with AEAT, and does not replace AEAT’s official tools or professional advice. 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 aeat.

Where to start

Start From Scratch

Use this when you are new to aeat and want the shortest path through profile, transactions, calculation, verification, and local export.

Quickstart: produce a modelo file
Set Up Your Taxpayer Profile

Use this when aeat does not yet know which taxpayer, activity, or local profile to use.

Set up your taxpayer profile
Work with Transactions

Use this when records are not yet in the ledger, or when they still need review, classification, export, split, merge, or evidence links.

Work with Transactions
Classify Transactions

Use this when imported rows need business, personal, mixed-use, category, or tax-field decisions.

Classify transactions
Plan Your Filing Calendar

Use this when you need to see which modelos are due and which period to prepare.

Plan your filing calendar
Follow the Filing Workflow

Use this when you want the full repeatable loop: prepare, verify, export, file through AEAT, and keep local history.

The filing workflow: work units and calculation revisions
Build Your First Modelo 130 Filing

A guided walkthrough from setup through the final local export.

Build your first Modelo 130 filing

Go straight to usage and reference

Already know the workflow? Go straight to the reference you need: