Importar y gestionar transacciones¶
Esta página cubre el flujo de transacciones del ledger: importar tu extracto bancario, añadir a mano las transacciones que falten, revisarlas y corregirlas, y comprobar la preparación antes de un cálculo. Una línea de un extracto bancario es solo una fecha y un importe: el significado fiscal se añade después, en la clasificación.
Tus registros bancarios no se añaden automáticamente. aeat importa solo cuando ejecutas una orden de importación. Los cálculos fiscales usan las transacciones que has guardado bajo el perfil activo.
Antes de empezar¶
Necesitas:
una orden
aeatque funcioneun perfil de contribuyente activo; consulta Configurar tu perfil de contribuyente
una frase de contraseña de clave maestra. La herramienta te la pide la primera vez que abre tu almacenamiento cifrado en una sesión
un archivo o directorio de extracto bancario, salvo que estés añadiendo transacciones a mano
para los porcentajes de oficina en casa derivados del censo de la AEAT, datos del censo revisados; consulta Vincular la información censal del Modelo 036
Confirma el perfil activo antes de escribir datos de transacciones:
1Confirm the active profile.
aeat --format json config profile statusaeat --format json config profile status{ "active_profile": "docs-sequence-sandbox", "command": "config.profile.status", "notices": [], "result": { "active_profile": "docs-sequence-sandbox", "activity_present": true, "configured": true, "iva_regime": "GENERAL", "precondition_action": null, "profile_id": "<profile-id>", "profile_record_error": null, "profile_record_present": null, "registered_profile": null, "tax_id_present": true, "tax_residence_ccaa": "" }, "schema_version": "2", "status": "success" }
Confirm a profile is active before you write transaction data.
Formato del archivo de extracto¶
Un CSV bancario usa un separador de punto y coma (;) y decimales con coma. La primera línea es la cabecera de columnas; cada línea posterior es un movimiento:
Fecha operación;Fecha valor;Concepto;Importe;Saldo;Moneda
2026-02-10;2026-02-10;Venta cliente;1.210,00;1.210,00;EUR
2026-02-11;2026-02-11;Compra material;-605,00;605,00;EUR
El signo de Importe indica la dirección: un importe positivo es un ingreso, un importe negativo es un gasto.
Previsualiza una importación¶
Haz primero una prueba en seco. Una prueba en seco muestra lo que aeat importaría y no guarda ninguna fila. Luego repite la orden sin --dry-run para guardar las filas. La secuencia previsualiza el extracto del trimestre estándar, lo importa y confirma una fila importada:
1Preview the import - a dry run saves no rows.
aeat app ledger import --file fixtures/movimientos-2026-1t.csv --provider csv --dry-runaeat app ledger import --file fixtures/movimientos-2026-1t.csv --provider csv --dry-runRows 2 Entries imported 2 Skipped 0 DRY RUN MODE Yes Notice Dry run: no rows were saved. The counts above are a preview of what a real import would add and skip. notice ledger.import.dry_run_preview Dry run: no rows were saved. The counts above are a preview of what a real import would add and skip.
2Save the rows by repeating the command without --dry-run.
aeat app ledger import --file fixtures/movimientos-2026-1t.csv --provider csvaeat app ledger import --file fixtures/movimientos-2026-1t.csv --provider csvRows 2 Entries imported 2 Skipped 0
3Confirm an imported row is now in the ledger.
aeat --format json app ledger view 71a5db2baeat --format json app ledger view 71a5db2b{ "active_profile": "docs-sequence-sandbox", "command": "ledger.view", "notices": [], "result": { "bucket_id": "<bucket-id>", "review_status": "pending", "transaction": { "amount": "1210", "attachment_ids": [], "booked_date": "2026-02-10", "business_classification": "NOT_YET_PROCESSED", "business_pct": null, "category_id": null, "classification_confidence": null, "classification_reason": "", "classified_at": null, "classified_by": "auto", "counterparty": "", "counterparty_country": null, "counterparty_identification_state": null, "created_at": "2026-04-01T09:00:00+00:00", "currency": "EUR", "date": "2026-02-10", "description": "Cobro factura F-2026-001 servicios de consultoria", "direction": "INCOMING", "fx_rate": null, "invoice_id": null, "irpf_category": null, "iva_amount": null, "iva_category": null, "iva_rate": null, "lifecycle_state": "ACTIVE", "m210_income_classification": null, "modified_at": "2026-04-01T09:00:00+00:00", "notes": "", "prorrata_reference": null, "purchase_invoice_evidence_id": null, "source_jurisdiction": null, "taxable_base": null, "transaction_id": "71a5db2bb891df295bee72544c40497d24d5c8cfc7edab745ce7339dcf8d6518", "usage_ratio_id": null, "value_date": "2026-02-10", "value_in_eur": null }, "transaction_id": "71a5db2bb891df295bee72544c40497d24d5c8cfc7edab745ce7339dcf8d6518" }, "schema_version": "2", "status": "success" }
Confirm the statement's rows were imported into the ledger.
--provider csv nombra el formato del extracto. --provider auto le pide a aeat que lo detecte. Los proveedores reconocidos son auto, csv, ofx, qfx, xlsx, excel, n26, pdf y pdf-n26. Si la detección elige el formato equivocado, sustituye auto por el proveedor exacto; ejecuta aeat app ledger import --help o consulta la referencia de la CLI para la lista actual de proveedores.
Si la ruta no existe, la orden se niega limpiamente y nombra el archivo que falta (El archivo de origen no existe: ...); corrige la ruta y ejecútala de nuevo.
Guarda las filas importadas con diagnósticos¶
Añade --verify cuando quieras diagnósticos de importación junto con el guardado:
1Import the statement with diagnostics.
aeat app ledger import --file fixtures/movimientos-2026-1t.csv --provider csv --verifyaeat app ledger import --file fixtures/movimientos-2026-1t.csv --provider csv --verifyRows 2 Entries imported 2 Skipped 0 Valid Yes Detected format delimiter=';',quotechar='"' Source -
2Confirm the imported row is present.
aeat --format json app ledger view 71a5db2baeat --format json app ledger view 71a5db2b{ "active_profile": "docs-sequence-sandbox", "command": "ledger.view", "notices": [], "result": { "bucket_id": "<bucket-id>", "review_status": "pending", "transaction": { "amount": "1210", "attachment_ids": [], "booked_date": "2026-02-10", "business_classification": "NOT_YET_PROCESSED", "business_pct": null, "category_id": null, "classification_confidence": null, "classification_reason": "", "classified_at": null, "classified_by": "auto", "counterparty": "", "counterparty_country": null, "counterparty_identification_state": null, "created_at": "2026-04-01T09:00:00+00:00", "currency": "EUR", "date": "2026-02-10", "description": "Cobro factura F-2026-001 servicios de consultoria", "direction": "INCOMING", "fx_rate": null, "invoice_id": null, "irpf_category": null, "iva_amount": null, "iva_category": null, "iva_rate": null, "lifecycle_state": "ACTIVE", "m210_income_classification": null, "modified_at": "2026-04-01T09:00:00+00:00", "notes": "", "prorrata_reference": null, "purchase_invoice_evidence_id": null, "source_jurisdiction": null, "taxable_base": null, "transaction_id": "71a5db2bb891df295bee72544c40497d24d5c8cfc7edab745ce7339dcf8d6518", "usage_ratio_id": null, "value_date": "2026-02-10", "value_in_eur": null }, "transaction_id": "71a5db2bb891df295bee72544c40497d24d5c8cfc7edab745ce7339dcf8d6518" }, "schema_version": "2", "status": "success" }
Confirm the verified import saved the statement's rows.
Si la fuente de diagnóstico debe apuntar a un archivo original distinto, pásalo con --file <original>. Usa --period solo cuando quieras a propósito etiquetar la importación con un periodo fiscal; omítelo y aeat asigna el periodo automáticamente a partir de la fecha de cada transacción.
Añade una transacción a mano¶
Usa ledger add cuando falte una transacción en los extractos importados. Los campos obligatorios son fecha, importe, dirección y descripción. Escribe el importe como una cifra positiva: la dirección indica si el dinero entró o salió, y la orden rechaza un importe negativo. OUTGOING es para los gastos; INCOMING es para los ingresos:
1Record an expense you paid out.
aeat --format json app ledger add --date 2026-03-15 --amount 49.99 --direction OUTGOING \
--description Software subscription --idempotency-key import-add-softwareaeat --format json app ledger add --date 2026-03-15 --amount 49.99 --direction OUTGOING `
--description Software subscription --idempotency-key import-add-software{ "active_profile": "docs-sequence-sandbox", "command": "ledger.add", "notices": [], "result": { "bucket_event_ids": [ "dfc77364ad10b11146bbcb8a7f77093f32da233a72a1a1346ea3bed72574a969" ], "bucket_id": "<bucket-id>", "review_status": "pending", "transaction": { "amount": "49.99", "attachment_ids": [], "booked_date": "2026-03-15", "business_classification": "NOT_YET_PROCESSED", "business_pct": null, "category_id": null, "classification_confidence": null, "classification_reason": "", "classified_at": null, "classified_by": "auto", "counterparty": "", "counterparty_country": null, "counterparty_identification_state": null, "created_at": "2026-04-01T09:00:00+00:00", "currency": "EUR", "date": "2026-03-15", "description": "Software subscription", "direction": "OUTGOING", "fx_rate": null, "invoice_id": null, "irpf_category": null, "iva_amount": null, "iva_category": null, "iva_rate": null, "lifecycle_state": "ACTIVE", "m210_income_classification": null, "modified_at": "2026-04-01T09:00:00+00:00", "notes": "", "prorrata_reference": null, "purchase_invoice_evidence_id": null, "source_jurisdiction": "ES", "taxable_base": null, "transaction_id": "bbdc3ab706b04e3f0afcc53616b99d697a76b4c8678f1e2817dcbe675913a1d5", "usage_ratio_id": null, "value_date": null, "value_in_eur": null }, "transaction_id": "bbdc3ab706b04e3f0afcc53616b99d697a76b4c8678f1e2817dcbe675913a1d5" }, "schema_version": "2", "status": "success" }
2Record a payment you received.
aeat --format json app ledger add --date 2026-03-20 --amount 121.00 --direction INCOMING \
--description Client payment --idempotency-key import-add-clientaeat --format json app ledger add --date 2026-03-20 --amount 121.00 --direction INCOMING `
--description Client payment --idempotency-key import-add-client{ "active_profile": "docs-sequence-sandbox", "command": "ledger.add", "notices": [], "result": { "bucket_event_ids": [ "d64492dc5b6c14fb7732d7831f25ae499f8df403d5e57aafd8e563a7e4c59329" ], "bucket_id": "<bucket-id>", "review_status": "pending", "transaction": { "amount": "121", "attachment_ids": [], "booked_date": "2026-03-20", "business_classification": "NOT_YET_PROCESSED", "business_pct": null, "category_id": null, "classification_confidence": null, "classification_reason": "", "classified_at": null, "classified_by": "auto", "counterparty": "", "counterparty_country": null, "counterparty_identification_state": null, "created_at": "2026-04-01T09:00:00+00:00", "currency": "EUR", "date": "2026-03-20", "description": "Client payment", "direction": "INCOMING", "fx_rate": null, "invoice_id": null, "irpf_category": null, "iva_amount": null, "iva_category": null, "iva_rate": null, "lifecycle_state": "ACTIVE", "m210_income_classification": null, "modified_at": "2026-04-01T09:00:00+00:00", "notes": "", "prorrata_reference": null, "purchase_invoice_evidence_id": null, "source_jurisdiction": "ES", "taxable_base": null, "transaction_id": "2314a0fb896fe26934f274d57ced8417a0881f7e3f286b34f8c300efd1a6e6d8", "usage_ratio_id": null, "value_date": null, "value_in_eur": null }, "transaction_id": "2314a0fb896fe26934f274d57ced8417a0881f7e3f286b34f8c300efd1a6e6d8" }, "schema_version": "2", "status": "success" }
3Record a supplier expense.
aeat --format json app ledger add --date 2026-03-21 --amount 60.50 --direction OUTGOING \
--description Office supplies --idempotency-key import-add-suppliesaeat --format json app ledger add --date 2026-03-21 --amount 60.50 --direction OUTGOING `
--description Office supplies --idempotency-key import-add-supplies{ "active_profile": "docs-sequence-sandbox", "command": "ledger.add", "notices": [], "result": { "bucket_event_ids": [ "e1f4ade8214c0c3b747d99a79d73aa5735f6375e39115c473dc64093bbf30585" ], "bucket_id": "<bucket-id>", "review_status": "pending", "transaction": { "amount": "60.5", "attachment_ids": [], "booked_date": "2026-03-21", "business_classification": "NOT_YET_PROCESSED", "business_pct": null, "category_id": null, "classification_confidence": null, "classification_reason": "", "classified_at": null, "classified_by": "auto", "counterparty": "", "counterparty_country": null, "counterparty_identification_state": null, "created_at": "2026-04-01T09:00:00+00:00", "currency": "EUR", "date": "2026-03-21", "description": "Office supplies", "direction": "OUTGOING", "fx_rate": null, "invoice_id": null, "irpf_category": null, "iva_amount": null, "iva_category": null, "iva_rate": null, "lifecycle_state": "ACTIVE", "m210_income_classification": null, "modified_at": "2026-04-01T09:00:00+00:00", "notes": "", "prorrata_reference": null, "purchase_invoice_evidence_id": null, "source_jurisdiction": "ES", "taxable_base": null, "transaction_id": "8e9e36e8f65629149767b0a95c06a08c79cd61e03c3586aa66273419ec9ca43d", "usage_ratio_id": null, "value_date": null, "value_in_eur": null }, "transaction_id": "8e9e36e8f65629149767b0a95c06a08c79cd61e03c3586aa66273419ec9ca43d" }, "schema_version": "2", "status": "success" }
4Confirm the first transaction was stored as an outgoing expense.
aeat --format json app ledger view {transaction_id}aeat --format json app ledger view {transaction_id}{ "active_profile": "docs-sequence-sandbox", "command": "ledger.view", "notices": [], "result": { "bucket_id": "<bucket-id>", "review_status": "pending", "transaction": { "amount": "49.99", "attachment_ids": [], "booked_date": "2026-03-15", "business_classification": "NOT_YET_PROCESSED", "business_pct": null, "category_id": null, "classification_confidence": null, "classification_reason": "", "classified_at": null, "classified_by": "auto", "counterparty": "", "counterparty_country": null, "counterparty_identification_state": null, "created_at": "2026-04-01T09:00:00+00:00", "currency": "EUR", "date": "2026-03-15", "description": "Software subscription", "direction": "OUTGOING", "fx_rate": null, "invoice_id": null, "irpf_category": null, "iva_amount": null, "iva_category": null, "iva_rate": null, "lifecycle_state": "ACTIVE", "m210_income_classification": null, "modified_at": "2026-04-01T09:00:00+00:00", "notes": "", "prorrata_reference": null, "purchase_invoice_evidence_id": null, "source_jurisdiction": "ES", "taxable_base": null, "transaction_id": "bbdc3ab706b04e3f0afcc53616b99d697a76b4c8678f1e2817dcbe675913a1d5", "usage_ratio_id": null, "value_date": null, "value_in_eur": null }, "transaction_id": "bbdc3ab706b04e3f0afcc53616b99d697a76b4c8678f1e2817dcbe675913a1d5" }, "schema_version": "2", "status": "success" }
Confirm a manually added transaction is stored with its direction.
La tercera dirección, INTERNAL_TRANSFER, registra el dinero movido entre tus propias cuentas.
Registra los detalles fiscales en una transacción manual¶
ledger add acepta los mismos campos fiscales que estableces durante la clasificación, así que registras una transacción completa en un solo paso. --amount es el total bruto (base imponible más IVA), y la herramienta rechaza la fila si la base más el IVA no coincide con el bruto hasta el céntimo:
1Record a purchase with its full IVA breakdown in one step.
aeat --format json app ledger add --date 2026-03-21 --amount 121.00 --direction OUTGOING \
--description Office supplies --counterparty Papeleria SL --category-id \
material_oficina --taxable-base 100.00 --iva-rate 0.21 --iva-amount 21.00 --notes \
Receipt filed --idempotency-key import-tax-detailsaeat --format json app ledger add --date 2026-03-21 --amount 121.00 --direction OUTGOING `
--description Office supplies --counterparty Papeleria SL --category-id `
material_oficina --taxable-base 100.00 --iva-rate 0.21 --iva-amount 21.00 --notes `
Receipt filed --idempotency-key import-tax-details{ "active_profile": "docs-sequence-sandbox", "command": "ledger.add", "notices": [], "result": { "bucket_event_ids": [ "2db62f858773cb6a333db409b8321094557fa580bd514110e48d1214f0f437b5" ], "bucket_id": "<bucket-id>", "review_status": "pending", "transaction": { "amount": "121", "attachment_ids": [], "booked_date": "2026-03-21", "business_classification": "NOT_YET_PROCESSED", "business_pct": null, "category_id": "material_oficina", "classification_confidence": null, "classification_reason": "", "classified_at": null, "classified_by": "auto", "counterparty": "Papeleria SL", "counterparty_country": null, "counterparty_identification_state": null, "created_at": "2026-04-01T09:00:00+00:00", "currency": "EUR", "date": "2026-03-21", "description": "Office supplies", "direction": "OUTGOING", "fx_rate": null, "invoice_id": null, "irpf_category": null, "iva_amount": "21", "iva_category": null, "iva_rate": "0.21", "lifecycle_state": "ACTIVE", "m210_income_classification": null, "modified_at": "2026-04-01T09:00:00+00:00", "notes": "Receipt filed", "prorrata_reference": null, "purchase_invoice_evidence_id": null, "source_jurisdiction": "ES", "taxable_base": "100", "transaction_id": "aebcbdf126dab613bfff9204b98d9bdce07dd43b900d9b0e1c00e24c709a2618", "usage_ratio_id": null, "value_date": null, "value_in_eur": null }, "transaction_id": "aebcbdf126dab613bfff9204b98d9bdce07dd43b900d9b0e1c00e24c709a2618" }, "schema_version": "2", "status": "success" }
2Confirm the taxable base and IVA were stored.
aeat --format json app ledger view {transaction_id}aeat --format json app ledger view {transaction_id}{ "active_profile": "docs-sequence-sandbox", "command": "ledger.view", "notices": [], "result": { "bucket_id": "<bucket-id>", "review_status": "pending", "transaction": { "amount": "121", "attachment_ids": [], "booked_date": "2026-03-21", "business_classification": "NOT_YET_PROCESSED", "business_pct": null, "category_id": "material_oficina", "classification_confidence": null, "classification_reason": "", "classified_at": null, "classified_by": "auto", "counterparty": "Papeleria SL", "counterparty_country": null, "counterparty_identification_state": null, "created_at": "2026-04-01T09:00:00+00:00", "currency": "EUR", "date": "2026-03-21", "description": "Office supplies", "direction": "OUTGOING", "fx_rate": null, "invoice_id": null, "irpf_category": null, "iva_amount": "21", "iva_category": null, "iva_rate": "0.21", "lifecycle_state": "ACTIVE", "m210_income_classification": null, "modified_at": "2026-04-01T09:00:00+00:00", "notes": "Receipt filed", "prorrata_reference": null, "purchase_invoice_evidence_id": null, "source_jurisdiction": "ES", "taxable_base": "100", "transaction_id": "aebcbdf126dab613bfff9204b98d9bdce07dd43b900d9b0e1c00e24c709a2618", "usage_ratio_id": null, "value_date": null, "value_in_eur": null }, "transaction_id": "aebcbdf126dab613bfff9204b98d9bdce07dd43b900d9b0e1c00e24c709a2618" }, "schema_version": "2", "status": "success" }
Confirm the tax fields were recorded on the manual transaction.
Campos opcionales útiles:
--currencyregistra un importe en una moneda distinta del euro; su valor predeterminado esEUR.--counterpartyregistra a quién pagaste o quién te pagó.--category-idasigna la categoría de ingreso o gasto. Ejecutaaeat app ledger categoriespara enumerar los ids.--taxable-base,--iva-ratee--iva-amountregistran el desglose del IVA.--irpf-categoryregistra la categoría de IRPF (impuesto sobre la renta de las personas físicas).--source-jurisdictionregistra el país al que pertenece un movimiento, como un código ISO de dos letras, que importa para los ámbitos de no residentes.--notesañade una nota breve del operador.
Para un movimiento en parte de la actividad y en parte personal, establece --classification MIXED y el porcentaje de la actividad con --business-pct, un valor de 0 a 1. Para la semántica de la categoría de IVA, el Estado miembro de la UE y el porcentaje de uso que hay detrás de estos campos, consulta Clasificar transacciones.
Usa las órdenes de factura cuando además necesites hacer seguimiento de si existe una factura por separado del movimiento bancario. Las facturas recibidas son facturas de proveedor que debes; las facturas emitidas son facturas a clientes que te deben:
1Record a supplier's received invoice.
aeat --format json app ledger invoice add --kind received --counterparty-nif B12345674 \
--counterparty-name Proveedor SL --country-code ES --invoice-number 2026-0142 \
--invoice-date 2026-03-21 --taxable-base 100.00 --iva-rate 21aeat --format json app ledger invoice add --kind received --counterparty-nif B12345674 `
--counterparty-name Proveedor SL --country-code ES --invoice-number 2026-0142 `
--invoice-date 2026-03-21 --taxable-base 100.00 --iva-rate 21{ "active_profile": "docs-sequence-sandbox", "command": "ledger.invoice.add", "notices": [], "result": { "base_total": "100.00", "base_total_eur": "100.00", "bucket_id": "<bucket-id>", "counterparty_country": "ES", "counterparty_name": "Proveedor SL", "counterparty_tax_id": "sha256:133cad41", "currency": "EUR", "fx_rate": null, "fx_rate_date": null, "fx_rate_source": null, "grand_total": "121.00", "grand_total_eur": "121.00", "invoice_id": "58b9b176555a62584c1afd469cb548df417ab2531cacdbfb4673af2c98a0d6dd", "invoice_number": "2026-0142", "issued_at": "2026-03-21", "iva_total": "21.00", "iva_total_eur": "21.00", "kind": "received", "linked_transaction_ids": [], "notes": "", "operation_type": null, "payment_status": "PENDING", "recargo_amount": null, "retention_amount": null, "retention_rate": null }, "schema_version": "2", "status": "success" }
2List issued invoices.
aeat app ledger invoice list --kind issuedaeat app ledger invoice list --kind issuedbucket <profile-id> count 0
3Confirm the received invoice is a payable invoice.
aeat --format json app ledger invoice view {invoice_id}aeat --format json app ledger invoice view {invoice_id}{ "active_profile": "docs-sequence-sandbox", "command": "ledger.invoice.view", "notices": [], "result": { "base_total": "100.00", "base_total_eur": "100.00", "bucket_id": "<bucket-id>", "counterparty_country": "ES", "counterparty_name": "Proveedor SL", "counterparty_tax_id": "sha256:133cad41", "currency": "EUR", "fx_rate": null, "fx_rate_date": null, "fx_rate_source": null, "grand_total": "121.00", "grand_total_eur": "121.00", "invoice_id": "58b9b176555a62584c1afd469cb548df417ab2531cacdbfb4673af2c98a0d6dd", "invoice_number": "2026-0142", "issued_at": "2026-03-21", "iva_total": "21.00", "iva_total_eur": "21.00", "kind": "received", "linked_transaction_ids": [], "notes": "", "operation_type": null, "payment_status": "PENDING", "recargo_amount": null, "retention_amount": null, "retention_rate": null }, "schema_version": "2", "status": "success" }
Confirm the recorded invoice resolved to a payable invoice.
Para el flujo completo de registros de factura, consulta Adjuntar facturas y recibos.
Revisa las filas¶
Enumera las filas, acota la lista con filtros, examina una fila y lee su historial de eventos. La secuencia importa el trimestre y recorre las órdenes de lectura:
1List every row.
aeat app ledger listaeat app ledger listACCOUNTING LEDGER TRANSACTIONS id full_id date amount description IVA category review_status 71a5db2b 71a5db2bb891df295bee72544c40497d24d5c8cfc7edab745ce7339dcf8d6518 2026-02-10 1210 Cobro factura F-2026-001 servicios de consultoria pending e3eeac5e e3eeac5e306efe4e82a72896e92e7c236245ec85348834b2c10b120c67fe087d 2026-02-11 605 Compra de material de oficina proveedor local pending
2Narrow the list with filters.
aeat app ledger list --filter period=1T --filter year=2026aeat app ledger list --filter period=1T --filter year=2026ACCOUNTING LEDGER TRANSACTIONS id full_id date amount description IVA category review_status 71a5db2b 71a5db2bb891df295bee72544c40497d24d5c8cfc7edab745ce7339dcf8d6518 2026-02-10 1210 Cobro factura F-2026-001 servicios de consultoria pending e3eeac5e e3eeac5e306efe4e82a72896e92e7c236245ec85348834b2c10b120c67fe087d 2026-02-11 605 Compra de material de oficina proveedor local pending
3List only the rows still needing a decision.
aeat app ledger list --filter classification=NOT_YET_PROCESSEDaeat app ledger list --filter classification=NOT_YET_PROCESSEDACCOUNTING LEDGER TRANSACTIONS id full_id date amount description IVA category review_status 71a5db2b 71a5db2bb891df295bee72544c40497d24d5c8cfc7edab745ce7339dcf8d6518 2026-02-10 1210 Cobro factura F-2026-001 servicios de consultoria pending e3eeac5e e3eeac5e306efe4e82a72896e92e7c236245ec85348834b2c10b120c67fe087d 2026-02-11 605 Compra de material de oficina proveedor local pending
4Inspect one row before changing it.
aeat app ledger view 71a5db2baeat app ledger view 71a5db2bID 71a5db2bb891df295bee72544c40497d24d5c8cfc7edab745ce7339dcf8d6518 Date 2026-02-10 Value date 2026-02-10 Amount 1210 Currency EUR Direction INCOMING Description Cobro factura F-2026-001 servicios de consultoria Counterparty - Classification NOT_YET_PROCESSED Business % - Category - Usage ratio id - Taxable base - IVA rate - IVA amount - IVA category - Established in - VAT identified in - IRPF category - Notes - Purchase invoice evidence - Attachments - Lifecycle state ACTIVE Classified by auto Classified at - Classification confidence - Classification reason - Review status pending
5Read the event history for the row.
aeat app ledger history 71a5db2baeat app ledger history 71a5db2bBucket <profile-id> ID 71a5db2bb891df295bee72544c40497d24d5c8cfc7edab745ce7339dcf8d6518 Event count 1 2026-04-01T09:00:00+00:00 ledger.transaction.imported 1a59b4ec789420d5ec241c40cf90be91ca7a1d4ca191ceb478a141a48bfa14c3
6Track the same row.
aeat app ledger track 71a5db2baeat app ledger track 71a5db2bID 71a5db2bb891df295bee72544c40497d24d5c8cfc7edab745ce7339dcf8d6518 Lifecycle state ACTIVE Created bucket event - import_provider CSV provider import_source movimientos-2026-1t.csv import_ingested_at 2026-04-01T09:00:00+00:00 import_fingerprint 924aad06902b61c5d2c34863ac5d8c8768039a38540cd0235e0308d6be767898
7Confirm the row is the imported income movement.
aeat --format json app ledger view 71a5db2baeat --format json app ledger view 71a5db2b{ "active_profile": "docs-sequence-sandbox", "command": "ledger.view", "notices": [], "result": { "bucket_id": "<bucket-id>", "review_status": "pending", "transaction": { "amount": "1210", "attachment_ids": [], "booked_date": "2026-02-10", "business_classification": "NOT_YET_PROCESSED", "business_pct": null, "category_id": null, "classification_confidence": null, "classification_reason": "", "classified_at": null, "classified_by": "auto", "counterparty": "", "counterparty_country": null, "counterparty_identification_state": null, "created_at": "2026-04-01T09:00:00+00:00", "currency": "EUR", "date": "2026-02-10", "description": "Cobro factura F-2026-001 servicios de consultoria", "direction": "INCOMING", "fx_rate": null, "invoice_id": null, "irpf_category": null, "iva_amount": null, "iva_category": null, "iva_rate": null, "lifecycle_state": "ACTIVE", "m210_income_classification": null, "modified_at": "2026-04-01T09:00:00+00:00", "notes": "", "prorrata_reference": null, "purchase_invoice_evidence_id": null, "source_jurisdiction": null, "taxable_base": null, "transaction_id": "71a5db2bb891df295bee72544c40497d24d5c8cfc7edab745ce7339dcf8d6518", "usage_ratio_id": null, "value_date": "2026-02-10", "value_in_eur": null }, "transaction_id": "71a5db2bb891df295bee72544c40497d24d5c8cfc7edab745ce7339dcf8d6518" }, "schema_version": "2", "status": "success" }
Confirm the inspected row reads the imported income movement.
Para una cola de revisión más amplia, usa ledger review para examinar filas seleccionadas y ledger check para informar de anomalías agregadas del ledger entre periodos. Ambas son solo locales:
1Inspect selected ledger rows for a period.
aeat app ledger review --filter period=1T --filter year=2026aeat app ledger review --filter period=1T --filter year=2026ACCOUNTING LEDGER REVIEW SESSION 71a5db2b 71a5db2bb891df295bee72544c40497d24d5c8cfc7edab745ce7339dcf8d6518 2026-02-10 1210 Cobro factura F-2026-001 servicios de consultoria pending e3eeac5e e3eeac5e306efe4e82a72896e92e7c236245ec85348834b2c10b120c67fe087d 2026-02-11 605 Compra de material de oficina proveedor local pending
2Report aggregate ledger anomalies across periods.
aeat --format json app ledger checkaeat --format json app ledger check{ "active_profile": "docs-sequence-sandbox", "command": "ledger.check", "notices": [], "result": { "bucket_id": "<bucket-id>", "checked_transaction_count": 2, "issues": [ { "detail": "business classification 'NOT_YET_PROCESSED' is not ready for modelo calculation", "reason": "missing_business_classification", "transaction_id": "71a5db2bb891df295bee72544c40497d24d5c8cfc7edab745ce7339dcf8d6518" }, { "detail": "business classification 'NOT_YET_PROCESSED' is not ready for modelo calculation", "reason": "missing_business_classification", "transaction_id": "e3eeac5e306efe4e82a72896e92e7c236245ec85348834b2c10b120c67fe087d" } ], "link_inconsistencies": [], "periods": [ "2026" ], "ready": false }, "schema_version": "2", "status": "success" }
Confirm the aggregate ledger check runs cleanly.
Exporta filas para revisar¶
Exporta el ledger activo a un archivo. El filtro --year y --period mantiene la exportación alineada con las fechas de las transacciones. Las exportaciones son instantáneas de revisión, no una vía de editar y reimportar:
1Export the first quarter to a CSV snapshot.
aeat --format json app ledger export --output ./ledger-2026-q1.csv --year 2026 --period \
1Taeat --format json app ledger export --output ./ledger-2026-q1.csv --year 2026 --period `
1T{ "active_profile": "docs-sequence-sandbox", "command": "ledger.export", "notices": [], "result": { "bucket_event_ids": [ "ec10496135191214d662a70eacf77db3f739a457585f0bb2e8ce45e6bb5805b5" ], "bucket_id": "<bucket-id>", "byte_size": 950, "export_format": "csv", "export_id": "5f0ddcff2e977990b1b5fd3fc6e107cf9b3cb3b5f7ac82e87d072c77fed11cf4", "fieldnames": [ "bucket_id", "transaction_id", "lifecycle_state", "booked_date", "value_date", "effective_date", "amount", "currency", "direction", "counterparty", "description", "source_jurisdiction", "business_classification", "business_pct", "category_id", "taxable_base", "iva_rate", "iva_amount", "iva_category", "counterparty_country", "counterparty_identification_state", "irpf_category", "usage_ratio_id", "prorrata_reference", "purchase_invoice_evidence_id", "attachment_ids", "notes", "created_by", "created_source_command", "value_in_eur", "fx_rate" ], "filename_extension": "csv", "media_type": "text/csv", "output_path": "ledger-2026-q1.csv", "row_count": 2, "rows": [ { "amount": "1210.00", "attachment_ids": "", "booked_date": "2026-02-10", "bucket_id": "<bucket-id>", "business_classification": "NOT_YET_PROCESSED", "business_pct": "", "category_id": "", "counterparty": "", "counterparty_country": "", "counterparty_identification_state": "", "created_by": "", "created_source_command": "", "currency": "EUR", "description": "Cobro factura F-2026-001 servicios de consultoria", "direction": "INCOMING", "effective_date": "2026-02-10", "fx_rate": "", "irpf_category": "", "iva_amount": "", "iva_category": "", "iva_rate": "", "lifecycle_state": "ACTIVE", "notes": "", "prorrata_reference": "", "purchase_invoice_evidence_id": "", "source_jurisdiction": "", "taxable_base": "", "transaction_id": "71a5db2bb891df295bee72544c40497d24d5c8cfc7edab745ce7339dcf8d6518", "usage_ratio_id": "", "value_date": "2026-02-10", "value_in_eur": "" }, { "amount": "605.00", "attachment_ids": "", "booked_date": "2026-02-11", "bucket_id": "<bucket-id>", "business_classification": "NOT_YET_PROCESSED", "business_pct": "", "category_id": "", "counterparty": "", "counterparty_country": "", "counterparty_identification_state": "", "created_by": "", "created_source_command": "", "currency": "EUR", "description": "Compra de material de oficina proveedor local", "direction": "OUTGOING", "effective_date": "2026-02-11", "fx_rate": "", "irpf_category": "", "iva_amount": "", "iva_category": "", "iva_rate": "", "lifecycle_state": "ACTIVE", "notes": "", "prorrata_reference": "", "purchase_invoice_evidence_id": "", "source_jurisdiction": "", "taxable_base": "", "transaction_id": "e3eeac5e306efe4e82a72896e92e7c236245ec85348834b2c10b120c67fe087d", "usage_ratio_id": "", "value_date": "2026-02-11", "value_in_eur": "" } ], "sha256": "0becceaa2ef5f6edba6a89f5fee123b09f1a044d477005dd381cecb52f66213d" }, "schema_version": "2", "status": "success" }
Confirm the ledger exports for the requested period.
2Write an XLSX snapshot of the whole year instead. XLSX embeds a per-run id, so it is shown as a display frame.
aeat app ledger export --output ./ledger-2026.xlsx --export-format xlsx --year 2026 \
--period 0Aaeat app ledger export --output ./ledger-2026.xlsx --export-format xlsx --year 2026 `
--period 0AAñade --export-format xlsx para escribir en su lugar una instantánea XLSX, y usa el token anual 0A cuando el alcance de la revisión sea un año completo.
Para cambiar filas guardadas, usa ledger update, ledger classify, ledger allocate, ledger split o ledger merge.
Actualiza una fila¶
Usa ledger update para los campos editables de la transacción: fecha, fecha de valor, importe, dirección, moneda, contraparte, descripción, base imponible, tipo de IVA, cuota de IVA, categoría de IRPF, notas o etiqueta de grupo:
1Correct the description, capturing the new id the update rotates to.
aeat --format json app ledger update {transaction_id} --description \
Corrected descriptionaeat --format json app ledger update {transaction_id} --description `
Corrected description{ "active_profile": "docs-sequence-sandbox", "command": "ledger.update", "notices": [], "result": { "bucket_event_ids": [ "51bb581f6eb1806a49fcd5105e639fc5aa44520bae30174e14209ac995f7d355" ], "bucket_id": "<bucket-id>", "review_status": "pending", "transaction": { "amount": "121", "attachment_ids": [], "booked_date": "2026-03-21", "business_classification": "NOT_YET_PROCESSED", "business_pct": null, "category_id": null, "classification_confidence": null, "classification_reason": "", "classified_at": null, "classified_by": "auto", "counterparty": "", "counterparty_country": null, "counterparty_identification_state": null, "created_at": "2026-04-01T09:00:00+00:00", "currency": "EUR", "date": "2026-03-21", "description": "Corrected description", "direction": "OUTGOING", "fx_rate": null, "invoice_id": null, "irpf_category": null, "iva_amount": null, "iva_category": null, "iva_rate": null, "lifecycle_state": "ACTIVE", "m210_income_classification": null, "modified_at": "2026-04-01T09:00:00+00:00", "notes": "", "prorrata_reference": null, "purchase_invoice_evidence_id": null, "source_jurisdiction": "ES", "taxable_base": null, "transaction_id": "86f4d44865f693e51c368c3e8f25a5b9bf7e1acf6089298e885854d661254629", "usage_ratio_id": null, "value_date": null, "value_in_eur": null }, "transaction_id": "86f4d44865f693e51c368c3e8f25a5b9bf7e1acf6089298e885854d661254629" }, "schema_version": "2", "status": "success" }
2Record the IVA breakdown against the current id.
aeat --format json app ledger update {after_description} --taxable-base 100.00 \
--iva-rate 0.21 --iva-amount 21.00aeat --format json app ledger update {after_description} --taxable-base 100.00 `
--iva-rate 0.21 --iva-amount 21.00{ "active_profile": "docs-sequence-sandbox", "command": "ledger.update", "notices": [], "result": { "bucket_event_ids": [ "6082dd1e06c1a8299d25b7bfa3ac07495b32841016b4dc538a50ccfc9a81744d" ], "bucket_id": "<bucket-id>", "review_status": "pending", "transaction": { "amount": "121", "attachment_ids": [], "booked_date": "2026-03-21", "business_classification": "NOT_YET_PROCESSED", "business_pct": null, "category_id": null, "classification_confidence": null, "classification_reason": "", "classified_at": null, "classified_by": "auto", "counterparty": "", "counterparty_country": null, "counterparty_identification_state": null, "created_at": "2026-04-01T09:00:00+00:00", "currency": "EUR", "date": "2026-03-21", "description": "Corrected description", "direction": "OUTGOING", "fx_rate": null, "invoice_id": null, "irpf_category": null, "iva_amount": "21", "iva_category": null, "iva_rate": "0.21", "lifecycle_state": "ACTIVE", "m210_income_classification": null, "modified_at": "2026-04-01T09:00:00+00:00", "notes": "", "prorrata_reference": null, "purchase_invoice_evidence_id": null, "source_jurisdiction": "ES", "taxable_base": "100", "transaction_id": "86f4d44865f693e51c368c3e8f25a5b9bf7e1acf6089298e885854d661254629", "usage_ratio_id": null, "value_date": null, "value_in_eur": null }, "transaction_id": "86f4d44865f693e51c368c3e8f25a5b9bf7e1acf6089298e885854d661254629" }, "schema_version": "2", "status": "success" }
3Add an operator note against the current id.
aeat app ledger update {after_iva} --notes Receipt checked against supplier PDFaeat app ledger update {after_iva} --notes Receipt checked against supplier PDFID 86f4d44865f693e51c368c3e8f25a5b9bf7e1acf6089298e885854d661254629 Date 2026-03-21 Amount 121 Description Corrected description Review status pending
4The original id still resolves for reads; confirm the correction landed.
aeat --format json app ledger view {transaction_id}aeat --format json app ledger view {transaction_id}{ "active_profile": "docs-sequence-sandbox", "command": "ledger.view", "notices": [], "result": { "bucket_id": "<bucket-id>", "review_status": "pending", "transaction": { "amount": "121", "attachment_ids": [], "booked_date": "2026-03-21", "business_classification": "NOT_YET_PROCESSED", "business_pct": null, "category_id": null, "classification_confidence": null, "classification_reason": "", "classified_at": null, "classified_by": "auto", "counterparty": "", "counterparty_country": null, "counterparty_identification_state": null, "created_at": "2026-04-01T09:00:00+00:00", "currency": "EUR", "date": "2026-03-21", "description": "Corrected description", "direction": "OUTGOING", "fx_rate": null, "invoice_id": null, "irpf_category": null, "iva_amount": "21", "iva_category": null, "iva_rate": "0.21", "lifecycle_state": "ACTIVE", "m210_income_classification": null, "modified_at": "2026-04-01T09:00:00+00:00", "notes": "Receipt checked against supplier PDF", "prorrata_reference": null, "purchase_invoice_evidence_id": null, "source_jurisdiction": "ES", "taxable_base": "100", "transaction_id": "86f4d44865f693e51c368c3e8f25a5b9bf7e1acf6089298e885854d661254629", "usage_ratio_id": null, "value_date": null, "value_in_eur": null }, "transaction_id": "86f4d44865f693e51c368c3e8f25a5b9bf7e1acf6089298e885854d661254629" }, "schema_version": "2", "status": "success" }
Confirm the row's description and IVA fields were updated.
Una actualización da a la transacción un id nuevo; un id que anotaste antes sigue resolviéndose en view, history y track. Para el flujo de corrección completo -dividir, fusionar, archivar, apartar, eliminar y restablecer filas- consulta Corregir errores en tu ledger.
Adjunta evidencia a una transacción¶
Adjunta evidencia de compra segura a una transacción. El id de la evidencia viene de aeat app ledger evidence add. La secuencia registra una evidencia y un gasto, y luego adjunta uno al otro:
1Attach the purchase evidence to the transaction.
aeat app ledger attach {transaction_id} --purchase-invoice-evidence-id {evidence_id}aeat app ledger attach {transaction_id} --purchase-invoice-evidence-id {evidence_id}ID 9ad5e90279a049021db72b53806469870d4739a6d557a47006099b5ce5c9573b Date 2026-03-21 Amount 121 Description Office supplies Review status pending
2Confirm the transaction resolves after the attachment.
aeat --format json app ledger view {transaction_id}aeat --format json app ledger view {transaction_id}{ "active_profile": "docs-sequence-sandbox", "command": "ledger.view", "notices": [], "result": { "bucket_id": "<bucket-id>", "review_status": "pending", "transaction": { "amount": "121", "attachment_ids": [], "booked_date": "2026-03-21", "business_classification": "NOT_YET_PROCESSED", "business_pct": null, "category_id": "material_oficina", "classification_confidence": null, "classification_reason": "", "classified_at": null, "classified_by": "auto", "counterparty": "", "counterparty_country": null, "counterparty_identification_state": null, "created_at": "2026-04-01T09:00:00+00:00", "currency": "EUR", "date": "2026-03-21", "description": "Office supplies", "direction": "OUTGOING", "fx_rate": null, "invoice_id": null, "irpf_category": null, "iva_amount": "21", "iva_category": null, "iva_rate": "0.21", "lifecycle_state": "ACTIVE", "m210_income_classification": null, "modified_at": "2026-04-01T09:00:00+00:00", "notes": "", "prorrata_reference": null, "purchase_invoice_evidence_id": "6509f06abb0c5756", "source_jurisdiction": "ES", "taxable_base": "100", "transaction_id": "9ad5e90279a049021db72b53806469870d4739a6d557a47006099b5ce5c9573b", "usage_ratio_id": null, "value_date": null, "value_in_eur": null }, "transaction_id": "9ad5e90279a049021db72b53806469870d4739a6d557a47006099b5ce5c9573b" }, "schema_version": "2", "status": "success" }
Confirm the purchase-invoice evidence attached to the transaction.
attach es la única puerta para la evidencia de compra. La orden link vincula una transacción únicamente a una factura del catálogo de conciliación.
La opción link --invoice-id espera un id del catálogo de facturas de conciliación (que rellenan los flujos de importación y conciliación), no un id de aeat app ledger invoice add. Consulta Adjuntar facturas y recibos para el flujo completo de evidencia y registros de factura, incluida la opción --attachment-id y su limitación actual.
Descarga un documento directamente desde Google Drive al almacenamiento de evidencia cifrado con evidence pull. Este comando accede a Google Drive, así que se ejecuta contra tu propia cuenta autorizada y no en el sandbox de la documentación:
1Pull a document from Google Drive into encrypted evidence.
aeat app ledger evidence pull <transaction-id> --source GOOGLE_DRIVE --reference \
<drive-file-id> --note Supplier invoiceaeat app ledger evidence pull <transaction-id> --source GOOGLE_DRIVE --reference `
<drive-file-id> --note Supplier invoiceLa orden descarga el archivo de Drive, guarda sus bytes cifrados junto con la transacción y conserva el enlace original como procedencia. Los enlaces de Gmail, las URL arbitrarias y los archivos de Drive fuera del ámbito concedido se rechazan: la evidencia siempre lleva el documento en sí, nunca un enlace a secas. Para una fuente rechazada, descarga el documento tú mismo y adjúntalo con aeat app ledger attach --attachment-id.
Corrige una fila incorrecta¶
Dividir un movimiento mixto en partes, volver a fusionar una división errónea, y archivar, apartar, eliminar o restablecer filas son todas correcciones. Corregir errores en tu ledger reúne ese flujo, con un ejemplo para cada orden y orientación sobre cómo elegir la corrección menos destructiva.
Clasifica las filas¶
Clasifica las filas antes de calcular. Como mínimo, las filas de actividad importadas necesitan una decisión de actividad/personal/mixta, y las filas de gasto necesitan una categoría:
1List the recognized expense categories.
aeat app ledger categoriesaeat app ledger categoriesRECOGNISED LEDGER SPENDING CATEGORIES category-id (pass this exact value) family cuotas_colegiales social_security cuotas_autonomos_ss social_security mutualidad_alternativa social_security arrendamiento_local premises ibi_local_afecto premises suministros_local_afecto premises suministros_home_office_luz home_office_suministros suministros_home_office_agua home_office_suministros suministros_home_office_gas home_office_suministros suministros_home_office_internet home_office_suministros telefonia_fija home_office_suministros amortizacion_vivienda_afecto home_office_ownership ibi_vivienda_afecto home_office_ownership comunidad_vivienda_afecto home_office_ownership arrendamiento_vivienda_afecto home_office_ownership telefonia_movil telecoms material_oficina office software_suscripcion office hardware_amortizable office mobiliario_amortizable office reparaciones_conservacion office publicidad_marketing office formacion_profesional office vehiculo_combustible vehicle vehiculo_mantenimiento vehicle vehiculo_seguro vehicle vehiculo_peaje vehicle vehiculo_parking vehicle manutencion_dietas_nacional meals manutencion_dietas_extranjero meals asesoria_fiscal professional_services asesoria_juridica professional_services asesoria_contable professional_services viajes_transporte travel viajes_alojamiento travel seguros_responsabilidad_civil insurance seguros_salud_autonomo insurance gastos_bancarios financial gastos_financieros financial suministros_cliente_directos direct_costs subcontratacion direct_costs tributos_fiscalmente_deducibles taxes Pass the bare id, e.g. --category-id cuotas_colegiales (not a family-prefixed or compound key). Deductible expenses only. Income (INCOMING) transactions are classified by direction and need no --category-id; `ledger check` and `ledger preflight` do not flag income as missing_category. IRPF CATEGORIES FOR --irpf-category irpf-category (pass this exact value) use actividad_economica professional activity withholding (received or paid net) arrendamiento_local net-paid rent expense withholding arrendamiento_vivienda_afecto net-paid rent expense withholding trabajo employment income (not for net-paid invoices) Net-paid rent example: --category-id arrendamiento_local --irpf-category arrendamiento_local. Net-paid professional service: --category-id asesoria_fiscal --irpf-category actividad_economica.
2Classify the imported expense as a business cost with a category.
aeat app ledger classify e3eeac5e --classification BUSINESS --category-id \
material_oficinaaeat app ledger classify e3eeac5e --classification BUSINESS --category-id `
material_oficinaID e3eeac5e306efe4e82a72896e92e7c236245ec85348834b2c10b120c67fe087d Date 2026-02-11 Amount 605 Description Compra de material de oficina proveedor local Review status reviewed
3Confirm the row now reads business with its category.
aeat --format json app ledger view e3eeac5eaeat --format json app ledger view e3eeac5e{ "active_profile": "docs-sequence-sandbox", "command": "ledger.view", "notices": [], "result": { "bucket_id": "<bucket-id>", "review_status": "reviewed", "transaction": { "amount": "605", "attachment_ids": [], "booked_date": "2026-02-11", "business_classification": "BUSINESS", "business_pct": null, "category_id": "material_oficina", "classification_confidence": "1", "classification_reason": "aeat app ledger classify", "classified_at": "2026-04-01T09:00:00+00:00", "classified_by": "manual", "counterparty": "", "counterparty_country": null, "counterparty_identification_state": null, "created_at": "2026-04-01T09:00:00+00:00", "currency": "EUR", "date": "2026-02-11", "description": "Compra de material de oficina proveedor local", "direction": "OUTGOING", "fx_rate": null, "invoice_id": null, "irpf_category": null, "iva_amount": null, "iva_category": null, "iva_rate": null, "lifecycle_state": "ACTIVE", "m210_income_classification": null, "modified_at": "2026-04-01T09:00:00+00:00", "notes": "", "prorrata_reference": null, "purchase_invoice_evidence_id": null, "source_jurisdiction": null, "taxable_base": null, "transaction_id": "e3eeac5e306efe4e82a72896e92e7c236245ec85348834b2c10b120c67fe087d", "usage_ratio_id": null, "value_date": "2026-02-11", "value_in_eur": null }, "transaction_id": "e3eeac5e306efe4e82a72896e92e7c236245ec85348834b2c10b120c67fe087d" }, "schema_version": "2", "status": "success" }
Confirm the imported expense is classified as business.
Clasificar transacciones reúne el flujo completo: clasificación en bloque por CSV, asignación de uso mixto, campos fiscales, reglas guardadas y sugerencias asistidas por LLM.
Comprueba la preparación para un periodo de presentación¶
Ejecuta la comprobación previa antes de calcular un modelo, y luego comprueba el estado general del ledger. La comprobación previa examina cada registro dentro del periodo y señala todo lo que aún falta antes de fiarse de cualquier suma: una clasificación, categoría, base, cuota de IVA, tipo de IVA o referencia de división que falte, o una moneda no convertible:
1Check the period is ready to calculate.
aeat app ledger preflight --year 2026 --period 1Taeat app ledger preflight --year 2026 --period 1Tbucket <profile-id> period 2026 1T checked 2 issues 0 ready true
2Read the overall ledger state for the period.
aeat --format json app ledger status --year 2026 --period 1Taeat --format json app ledger status --year 2026 --period 1T{ "active_profile": "docs-sequence-sandbox", "command": "ledger.status", "notices": [], "result": { "active_count": 2, "archived_count": 0, "bucket_id": "<bucket-id>", "business_expense_total": "605", "business_income_total": "1210", "business_net_total": "605", "checked_transaction_count": 2, "pending_review_count": 0, "period": { "code": "1T", "filing_year": 2026 }, "readiness_issue_count": 0, "readiness_issues": [], "ready": true, "reviewed_count": 2, "skipped_count": 0, "split_count": 0, "stale_filings": [], "stashed_count": 0, "total_count": 2, "unconverted_currency_count": 0 }, "schema_version": "2", "status": "success" }
Confirm the period's readiness is reported for the classified quarter.
La comprobación no cambia nada; nombra las filas que no están listas para que corrijas la materia prima antes de fiarte de cualquier total. Continúa al cálculo solo cuando el perfil activo y el periodo objetivo estén suficientemente listos para el modelo que estás preparando.
Para la revisión de cálculos en Google Sheets, consulta Revisar cálculos con Google Sheets. Ese flujo exporta una superficie de cálculo de un modelo a Sheets; es independiente de la exportación del ledger a CSV/XLSX.
Si una orden se detiene con un error¶
Si una orden informa de que no hay ningún perfil activo, de que el periodo no es válido o de que el ledger no está listo, usa Diagnosticar y reparar tu instalación local.
Próximos pasos¶
Importación, exportación y evidencia: entiende qué significan las filas importadas y en qué se diferencian de los datos fiscales y la evidencia de presentación.