Skip to content
18 changes: 9 additions & 9 deletions CLAUDE.md

Large diffs are not rendered by default.

6 changes: 3 additions & 3 deletions docs/casillas.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@

**Notas:**
- La divisa es un elemento patrimonial: la ganancia/pérdida es valor de transmisión − valor de adquisición (Art. **33.1** LIRPF), imputada en la conversión efectiva a euros (Art. 14.2.e). La divisa comparte el bloque «otros elementos patrimoniales» (casillas 1633/1637) con opciones, cripto y fondos no cotizados. La casilla 1626 es «Tipo de elemento patrimonial. Clave», y 1631 es la «Fecha de transmisión» — no son importes.
- Cada conversión EUR→FCY crea un lote en la cola FIFO de esa divisa (DGT V2324-10).
- Cada conversión EUR→FCY crea un lote en la cola FIFO de esa divisa, valorado por lo que realmente costó (Art. 35.1 LIRPF): el importe en euros que aplicó el bróker cuando el extracto lo da, y si no, el tipo BCE del día de la conversión. La transmisión se valora igual. La ley no fija en qué orden sale la divisa: aplicar FIFO es una inferencia por analogía con el Art. 37.2, que solo habla de valores.
- Cada conversión de la divisa (por ejemplo, USD→EUR) consume lotes por FIFO y realiza una ganancia o pérdida de divisa. Lo mismo ocurre con los intereses y comisiones que pagas en esa divisa.
- Comprar valores en divisa no realiza nada. La divisa gastada queda apartada con su coste de origen y vuelve a la cola cuando vendes los valores.
- Las conversiones automáticas del broker (AFx/FXCONV de IBKR) se procesan por defecto como cualquier otra conversión, porque IBKR no convierte a euros al vender y la divisa que tienes es real. Si tu broker sí la convierte en el acto, puedes excluirlas desmarcando «Procesar autoconversiones del bróker» en el perfil fiscal, o con `--skip-auto-convert` en la CLI.
Expand All @@ -47,7 +47,7 @@
**Notas:**
- Los dividendos incluyen tanto dividendos ordinarios como "Payment In Lieu of Dividends" (dividendos sustitutivos en operaciones de préstamo de valores).
- Las retenciones extranjeras NO se deducen aquí — se declaran en la casilla 0588.
- La conversión a EUR usa el tipo de cambio ECB oficial del día de pago (DGT V0583-16, PGC NRV 11a).
- El informe convierte a EUR con el tipo oficial del BCE (Ley 46/1998 art. 36) del día de pago que da el extracto. La regla de la DGT es el tipo vigente el día en que el cobro es exigible (V1024-11 para dividendos, V0463-21 para intereses). Normalmente coincide con el día de pago; si el bróker paga más tarde, los dos tipos pueden diferir.
- Los gastos genuinos de administración y depósito de valores negociables (cuando el bróker los detalla) sí son deducibles en la **Casilla 0037** (Art. 26.1.a LIRPF); la casilla 0027 recoge ingresos íntegros, nunca gastos.
- Las cuotas de suscripción del bróker (p. ej. planes de trading de tarifa plana) NO son «gastos de administración y depósito de valores negociables», por lo que no son deducibles.

Expand Down Expand Up @@ -121,7 +121,7 @@ El motor de anti-churning recorre todas las operaciones en orden cronológico y,

DeclaRenta usa exclusivamente los **tipos de cambio diarios del BCE** (European Central Bank), publicados a las 16:00 CET cada día TARGET. Para fines de semana y festivos, se utiliza el último tipo disponible (día hábil anterior).

**Base legal:** PGC NRV 11a (partidas monetarias en moneda extranjera) y consultas vinculantes de la DGT (V2324-10, V0583-16). No existe ningún artículo en la LGT que prescriba una fuente concreta de tipos de cambio; el BCE constituye un safe harbor por su carácter institucional.
**Base legal:** el art. 36 de la Ley 46/1998 fija como cambio oficial del euro frente a otras divisas el que publica el Banco Central Europeo. La DGT valora las rentas en divisa al tipo vigente en la fecha de la operación o del cobro (V1024-11, V0463-21, V2422-20).

## Método FIFO (Art. 37.2 LIRPF)

Expand Down
2 changes: 1 addition & 1 deletion docs/modelos-fiscales.md
Original file line number Diff line number Diff line change
Expand Up @@ -181,7 +181,7 @@ DeclaRenta implementa las siguientes normas de la legislación fiscal española:
| Art. 46 LIRPF | Base del ahorro: ganancias y pérdidas patrimoniales derivadas de transmisión de elementos patrimoniales. |
| Art. 49 LIRPF | Compensación de pérdidas patrimoniales: arrastre 4 años, compensación cruzada con límite del 25%. |
| Art. 80 LIRPF | Deducción por doble imposición internacional: menor entre impuesto pagado en origen y cuota española. |
| PGC NRV 11a / DGT V0583-16 | Tipos de cambio: el BCE constituye la referencia oficial para la conversión de moneda extranjera (safe harbor). |
| Ley 46/1998 art. 36 | Tipos de cambio: el cambio oficial del euro frente a otras divisas es el que publica el Banco Central Europeo. |
| Ley 7/2024 | Introduce el tramo del 30% en la base del ahorro para rentas superiores a 300.000 EUR. |
| RD 1065/2007 | Reglamento general de gestión e inspección tributaria. Regula la obligación de informar sobre bienes en el extranjero (Modelo 720). |
| Orden EHA/3290/2008 | Regula la declaración de inversiones españolas en el exterior (Modelo D-6). |
Expand Down
2 changes: 1 addition & 1 deletion src/cli/index.ts
Original file line number Diff line number Diff line change
Expand Up @@ -201,7 +201,7 @@ program
.option("--prior-losses <file>", "JSON file with prior year losses for carryforward (Art. 49 LIRPF)")
.option(
"--monodivisa",
"Modo tradicional (como Autodeclaro/Taxdown/asesor): apaga el motor de divisa y valora el coste FCY al tipo del día de COMPRA (Art. 35.1), embebiendo el efecto divisa en la línea de la acción",
"Método tradicional: valora las acciones como Autodeclaro/Taxdown o un asesor (compra al tipo del día de COMPRA, venta al del día de venta; Art. 35.1), con el efecto divisa dentro de la línea de la acción. Apaga TODO el motor de divisa: no calcula ningún resultado de divisa, tampoco en conversiones USD→EUR propias ni en las automáticas del bróker. Si conviertes divisa, usa el modo por defecto",
)
.option(
"--skip-auto-convert",
Expand Down
6 changes: 4 additions & 2 deletions src/engine/ecb.ts
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,10 @@
* ECB exchange rate fetcher.
*
* Fetches official ECB daily reference rates via the SDMX REST API.
* DGT consultas vinculantes (V2324-10, V0583-16) require "tipo de cambio
* vigente" — ECB daily rates serve as the safe-harbor official source.
* The ECB rate is the official exchange rate by law (Ley 46/1998 art. 36: "tendrá
* la consideración de cambio oficial ... el que publique para el euro el Banco
* Central Europeo"). The DGT values foreign-currency income at the rate in force
* when it becomes payable (V1024-11, dividends; V0463-21, interest).
*/

import Decimal from "decimal.js";
Expand Down
7 changes: 4 additions & 3 deletions src/engine/fx-fifo.ts
Original file line number Diff line number Diff line change
Expand Up @@ -863,7 +863,8 @@ export class FxFifoEngine {
* rate — reproducing the pre-#230 full-proceeds behavior exactly. This is the
* load-bearing safety property: nothing changes for single-year/AFx files.
*
* SAME FILTERS AS THE BUY/CONSUMER SIDE (V2324-10 symmetry). STK/FUND/BOND only
* SAME FILTERS AS THE BUY/CONSUMER SIDE (so every parked principal has a
* matching re-add; an engine invariant, not a DGT rule). STK/FUND/BOND only
* (CRYPTO permutas' proceedsFcy is a coin, not fiat → crypto path; OPT/FOP/CASH
* excluded — CASH conversions are the FX engine's own events). `currency ≠ EUR`,
* ECB-resolvable, `proceedsFcy > 0`, and NOT a short close (`isShort`): a cover
Expand Down Expand Up @@ -945,7 +946,7 @@ export class FxFifoEngine {
* here equals the principal the SELL re-adds via `costBasisFcy` — the two sides
* reconcile.
*
* SAME FILTERS AS THE SELL SIDE (V2324-10 symmetry): `buySell === "BUY"`,
* SAME FILTERS AS THE SELL SIDE (engine invariant, not a DGT rule): `buySell === "BUY"`,
* STK/FUND/BOND only, `currency ≠ EUR`, ECB-resolvable, NOT an FXCONV/AFx trade.
* EXCLUDES short-cover buys (`openCloseIndicator === "C"`): a cover is the CLOSE
* of a short, not a fresh FCY outflow to acquire a long position — mirroring the
Expand Down Expand Up @@ -1063,7 +1064,7 @@ export class FxFifoEngine {
}

/** Detect FXCONV (automatic broker conversions for settlement) */
private static isFxconv(trade: Trade): boolean {
static isFxconv(trade: Trade): boolean {
const desc = (trade.description || "").toUpperCase();
const exch = (trade.exchange || "").toUpperCase();
const notes = (trade.notes || "").toUpperCase().split(";");
Expand Down
30 changes: 28 additions & 2 deletions src/generators/report.ts
Original file line number Diff line number Diff line change
Expand Up @@ -590,7 +590,10 @@ export function generateTaxReport(
// held divisa); the opt-out (trackAutoConvert === false) restores the
// per-trade isFxconv() skip. Manual CASH/income and tracked stock round-trips
// always accrue/move FCY lots.
// skipFx: monodivisa mode — treat all as EUR, no separate FX saldo (like Autodeclaro/Taxdown)
// skipFx: monodivisa mode — the WHOLE FX engine is off: no FX result at all, not
// even for the taxpayer's own FCY→EUR conversions or broker AFx/FXCONV ones. It
// matches tools like Autodeclaro/Taxdown only in how shares are valued (buy at
// the buy-date rate, sale at the sale-date rate; see traditionalCostBasis).
let fxDisposals: ReturnType<FxFifoEngine["processEvents"]> = [];
let fxTransmissionValue = new Decimal(0);
let fxAcquisitionValue = new Decimal(0);
Expand Down Expand Up @@ -746,7 +749,7 @@ export function generateTaxReport(
severity: "info",
message:
"Si otra herramienta muestra un importe distinto, puede deberse a que no calcula las ganancias por tipo de cambio (Art. 33.1 LIRPF).",
hint: "Puedes activar el modo monodivisa en tu perfil fiscal para comparar con herramientas como Autodeclaro o Taxdown.",
hint: "Puedes activar el modo monodivisa en tu perfil fiscal para comparar: valora las acciones igual que Autodeclaro o Taxdown (compra al tipo del día de compra, venta al del día de venta), pero no calcula ningún resultado de divisa, tampoco en las conversiones USD→EUR. Si conviertes divisa, el modo por defecto es el que lo calcula.",
});
// Method-consistency warning: the FX gain on a foreign currency is realized
// here only when the currency is converted to euros (defer / carry-basis,
Expand Down Expand Up @@ -781,6 +784,29 @@ export function generateTaxReport(
}
}

// Monodivisa drops every currency conversion silently (the FX engine is off), so
// say how many this year's file had. Mirrors extractFxEvents' filter: a non-EUR
// CASH trade, minus AFx/FXCONV rows when the user also opted out of those.
if (options?.skipFx) {
const trackAutoConvert = options.trackAutoConvert !== false;
const skippedConversions = statement.trades.filter(
(tr) =>
tr.assetCategory === "CASH" &&
tr.currency !== "EUR" &&
(trackAutoConvert || !FxFifoEngine.isFxconv(tr)) &&
normalizeDate(tr.settlementDate || tr.tradeDate).startsWith(yearStr),
).length;
if (skippedConversions > 0) {
allMessages.push({
id: "report.monodivisa_conversions_skipped",
severity: "info",
message: `El modo monodivisa ha dejado sin calcular ${skippedConversions} conversión(es) de divisa de este ejercicio (manuales o automáticas del bróker). Este modo no calcula ningún resultado de divisa (casillas 1633/1637).`,
hint: "El modo por defecto sí calcula las conversiones de divisa. Si has convertido divisa (por ejemplo, de USD a EUR), desactiva el modo monodivisa en tu perfil fiscal para incluir su resultado.",
context: { count: String(skippedConversions) },
});
}
}

// Final boundary guard (audit [HIGH/ERR]): scan every top-level monetary total
// destined for a casilla and coerce any non-finite (NaN/Infinity) value to 0,
// so a corrupt source amount can never render as a literal "NaN"/"Infinito" in
Expand Down
16 changes: 10 additions & 6 deletions src/i18n/locales/ca.ts
Original file line number Diff line number Diff line change
Expand Up @@ -241,11 +241,11 @@ const ca: TranslationKeys = {
"profile.ccaa_label": "Comunitat Autònoma:",
"profile.phone_label": "Telèfon:",
"profile.phone_placeholder": "600123456",
"profile.monodivisa_label": "Mode simplificat (monodivisa EUR)",
"profile.monodivisa_label": "Mètode tradicional (monodivisa, cost al tipus de compra)",
"profile.monodivisa_detail":
"No calcula guanys per tipus de canvi de forma separada (caselles 1633/1637): l'efecte divisa queda embegut en el cost de l'acció, valorat al tipus del dia de COMPRA (Art. 35.1). Compatible amb Autodeclaro, Taxdown i altres serveis (i amb el mètode tradicional que fan servir alguns assessors) que tracten totes les operacions com a moneda única EUR. Nota: en una actualització recent aquest mode valora el cost al tipus de la data de compra; el guany de valors en moneda estrangera pot diferir de xifres desades en versions anteriors — revisa-la si ja vas presentar amb una versió prèvia.",
"Valora cada acció en moneda estrangera com el mètode tradicional i eines com Autodeclaro o Taxdown: la compra al tipus de canvi del dia de compra i la venda al del dia de venda (Art. 35.1). L'efecte divisa queda dins del guany de l'acció. A més, apaga tot el càlcul de divisa: no calcula cap resultat de divisa (caselles 1633/1637), tampoc en les conversions USD→EUR que facis tu ni en les automàtiques del bróker. Si converteixes divisa, fes servir el mode per defecte, que sí que les calcula. Nota: en una actualització recent aquest mode valora el cost al tipus de la data de compra; el guany de valors en moneda estrangera pot diferir de xifres desades en versions anteriors — revisa-la si ja vas presentar amb una versió prèvia.",
"profile.monodivisa_warning":
"⚠ Aquest mode pot distorsionar els guanys patrimonials declarats (infraestimar o sobreestimar). El mode complet (per defecte) és més rigorós segons l'Art. 33.1 LIRPF (DGT V2324-10).",
"⚠ Aquest mode pot distorsionar els guanys patrimonials declarats (infraestimar o sobreestimar). El mode complet (per defecte) és més rigorós segons l'Art. 33.1 LIRPF (DGT V2422-20).",
"profile.track_autoconvert_label": "Processar les autoconversions del bróker (AFx/FXCONV)",
"profile.track_autoconvert_detail":
"Activat per defecte. Interactive Brokers no reconverteix a euros en vendre una acció, així que el saldo en divisa és real i convertir-lo després genera un guany o pèrdua patrimonial (art. 33.1 LIRPF). Desactiva-ho només si el teu bróker fa un round-trip complet EUR↔divisa i vols ignorar l'efecte de la divisa.",
Expand Down Expand Up @@ -629,7 +629,7 @@ const ca: TranslationKeys = {
"guide_rw.capital_gains_note":
"Si tens moltes operacions, pots consolidar-les en una sola línia per tipus d'actiu usant les dates genèriques 01/01 i 31/12. Renta Web accepta imports agregats.",
"guide_rw.fx_note":
"Els guanys per tipus de canvi es declaren apart dels guanys de valors. Només apareixen si has operat amb divises manualment (ex. conversions EUR→USD a IBKR). Si uses mode monodivisa, aquesta secció no aplica.",
"Els guanys per tipus de canvi es declaren a part dels guanys de valors. Apareixen quan converteixes divisa a euros o a una altra divisa (p. ex. USD→GBP) —incloses les conversions automàtiques del teu bróker (p. ex. AFx/FXCONV a IBKR)—, no només en les conversions manuals. Mentre mantens la divisa (p. ex. compres i vens accions en USD sense passar a euros), la diferència de canvi queda diferida fins que la converteixes efectivament, a euros o a una altra divisa (Art. 14.2.e LIRPF). Si uses mode monodivisa, aquesta secció no aplica.",
"guide_rw.dividends_note":
"Els dividends de brokers estrangers no porten retenció espanyola. La retenció estrangera (withholding tax) NO es posa aquí: es dedueix apart a la casella 0588 (doble imposició).",
"guide_rw.interest_note":
Expand All @@ -640,7 +640,7 @@ const ca: TranslationKeys = {
"guide_rw.blocked_losses_hint":
"Si DeclaRenta mostra pèrdues bloquejades, marca la casella <strong>«Pèrdues patrimonials no imputables»</strong> a Renta Web. Aquestes pèrdues es difereixen a l'exercici següent perquè es va recomprar el mateix valor en els 2 mesos posteriors (cotitzats) o 1 any (no cotitzats). L'import se suma a l'adquisició de la nova posició.",
"guide_rw.closing_tip":
"Després d'introduir totes les dades, usa el botó «Verificar declaració» de Renta Web per comprovar errors. Si una altra eina (Autodeclaro, Taxdown) mostra un import diferent en guanys patrimonials, pot ser perquè no calcula els guanys per tipus de canvi per separat — activa el mode monodivisa al teu perfil per comparar.",
"Després d'introduir totes les dades, usa el botó «Verificar declaració» de Renta Web per comprovar errors. Si una altra eina (Autodeclaro, Taxdown) mostra un import diferent en guanys patrimonials, pot ser perquè valora d'una altra manera les accions en divisa — activa el mode monodivisa al teu perfil per comparar. Aquest mode valora les accions com aquestes eines, però no calcula cap resultat de divisa, tampoc en les conversions USD→EUR; si converteixes divisa, el mode per defecte és el que el calcula.",

// PDF report
"pdf.subtitle": "Informe fiscal — Exercici",
Expand Down Expand Up @@ -809,7 +809,11 @@ const ca: TranslationKeys = {
"report.competitor_reconciliation":
"Si una altra eina mostra un import diferent, pot ser perquè no calcula els guanys per tipus de canvi (Art. 33.1 LIRPF).",
"report.competitor_reconciliation.hint":
"Pots activar el mode monodivisa al teu perfil fiscal per comparar amb eines com Autodeclaro o Taxdown.",
"Pots activar el mode monodivisa al teu perfil fiscal per comparar: valora les accions igual que Autodeclaro o Taxdown (compra al tipus del dia de compra, venda al del dia de venda), però no calcula cap resultat de divisa, tampoc en les conversions USD→EUR. Si converteixes divisa, el mode per defecte és el que el calcula.",
"report.monodivisa_conversions_skipped":
"El mode monodivisa ha deixat sense calcular {{count}} conversió(ns) de divisa d'aquest exercici (manuals o automàtiques del bróker). Aquest mode no calcula cap resultat de divisa (caselles 1633/1637).",
"report.monodivisa_conversions_skipped.hint":
"El mode per defecte sí que calcula les conversions de divisa. Si has convertit divisa (per exemple, d'USD a EUR), desactiva el mode monodivisa al teu perfil fiscal per incloure'n el resultat.",
"report.non_finite_total":
"S'ha detectat un valor no finit (NaN/Infinit) en un total calculat; revisa els fitxers importats.",
"report.non_finite_total.hint":
Expand Down
Loading
Loading