## id
doc_quadre_amortitzacio_actius_fixes

## nom
Quadre d'amortització d'actius fixes — guia detallada de la pantalla

## descripcio
Consulta aquest document quan calgui explicar amb precisió un camp o control concret de la pantalla
"Comptabilitat → Quadres d'Amortització d'Actius Fixes" (mètode constant vs. variable, imputació
d'activitat, què és editable, diferència entre Guardar i Validar, etc.) — no per a l'explicació
general de com funciona l'amortització, que ja cobreix `flux_amortitzacio_actius_fixes`.

## contingut
### On és i com es crea un quadre

Comptabilitat → Quadres d'Amortització d'Actius Fixes. La pantalla llista els quadres ja creats
per a l'exercici actual. Per crear-ne un de nou (botó "Afegir"), es mostra un selector amb els
actius fixes de l'empresa que **encara no tenen quadre en aquest exercici** — només se'n pot tenir
un per actiu i exercici; si ja n'hi ha un, l'aplicació ho bloqueja.

El selector ja mostra, de cada actiu, la data de servei, els anys, la periodicitat i el mètode —
aquests quatre camps **no es configuren aquí**, sinó a la fitxa d'alta de l'actiu fix (Fitxers
mestres). Aquesta pantalla només els llegeix i hi calcula el quadre.

### Mètode: Constant vs. Variable

És el camp que determina com es reparteix la quota any (o període) rere any. Es defineix a l'alta
de l'actiu, no aquí — aquí només es mostra i s'aplica.

- **Constant** (mètode 1, lineal): la quota és **sempre la mateixa** a cada període:
  `(altes − baixes) ÷ anys ÷ períodes per any`. És el mètode per defecte i el que s'aplica quan no
  hi ha motiu per accelerar la deducció.
- **Variable** (mètode 2, per períodes restants): la quota es **recalcula cada període**, dividint
  el pendent actual entre els períodes que queden fins a la fi de la vida útil
  (`pendent ÷ períodes_restants`). Això fa que **les primeres quotes siguin més grans** i vagin
  disminuint — útil quan es vol deduir més ràpid als primers anys, però normalment cal poder
  justificar-ho fiscalment (vegeu `flux_amortitzacio_actius_fixes` per al criteri general).

En tots dos casos, la quota mai supera el pendent real de l'actiu.

### Imputació d'activitat

Card "Quadre" del formulari. Si l'empresa té més d'una activitat econòmica, la quota
d'amortització es pot repartir entre diverses activitats amb un percentatge cadascuna — útil quan
un mateix actiu (per exemple, un vehicle o un local) serveix a més d'un negoci de la mateixa
empresa.

- Per defecte, si no hi ha cap repartiment previ, s'imputa el **100% a l'activitat principal**.
- Es poden afegir més línies (botó "+"), triant activitat i percentatge a cadascuna.
- **La suma ha de ser exactament 100%** — l'aplicació no deixa desar si no hi quadra, i marca en
  vermell els camps que fallen (activitat repetida, percentatge a 0, o el total).
- Cada línia d'imputació genera el seu propi apunt comptable de despesa; l'apunt d'amortització
  acumulada es fa sempre per l'import total del període (no es reparteix).

### La taula de períodes: què és cada fila

| Fila | Vol dir | Editable? |
|---|---|---|
| Pendent inicial | Import que queda per amortitzar en començar el període | No |
| Altes/Baixes del període | Moviments de l'actiu (alta o baixa parcial) dins d'aquest període concret | No |
| Quota teòrica | La quota que "tocaria" segons el mètode (constant o variable) | No |
| Quota real validada | Quota d'aquest període que ja consta en algun document **validat** anteriorment | No |
| Quota guardada a l'assentament | Quota que hi havia desada en aquest mateix document abans de l'edició actual | No |
| **Quota a comptabilitzar** | La quota que realment es registrarà en desar | **Sí — l'únic camp editable** |
| Diferència | Teòrica − real − a comptabilitzar | No (es recalcula sola) |
| Pendent final previst | Pendent inicial − quota a comptabilitzar | No |
| Estat | OK / Pendent / Excés (vegeu més avall) | No |

**La quota a comptabilitzar no pot ser negativa ni superar el pendent inicial d'aquell període** —
si s'hi intenta posar un import fora d'aquest rang, el camp es marca en vermell i no es pot desar.
Modificar-la recalcula en cascada tots els períodes posteriors del mateix quadre.

### Estats

- 🟢 **OK** — la diferència és pràcticament zero: el que s'ha comptabilitzat quadra amb el teòric.
- 🟡 **Pendent** — falta amortitzar (diferència positiva): la quota a comptabilitzar és inferior a
  la teòrica.
- 🔴 **Excés** — s'ha comptabilitzat més del que tocava teòricament (diferència negativa).

### Guardar, Validar, Recalcular, Eliminar

- **Guardar**: desa el document com a esborrany (no el marca com a definitiu). Es pot tornar a
  obrir i editar mentre l'exercici estigui obert.
- **Validar**: desa i, a més, marca el document com a definitiu — el botó "Validar" desapareix un
  cop fet. Comparteix tota la lògica de guardat amb "Guardar"; l'única diferència és aquest marcatge.
- **Cada cop que es desa (Guardar o Validar), s'esborren tots els assentaments comptables anteriors
  d'aquest document i es tornen a crear de zero** a partir dels valors actuals de la taula — no és
  un ajust incremental.
- **Recalcular**: descarta els canvis no desats i torna a demanar els valors calculats des del
  servidor (demana confirmació abans, perquè es perd l'edició en curs).
- **Eliminar**: esborra el document i tots els seus assentaments comptables. Només disponible si
  l'exercici encara està obert.

### Apunts comptables generats

Cada període amb quota a comptabilitzar diferent de zero genera un assentament de partida doble,
sobre dos comptes que **no són fixos**: es configuren per empresa al llibre d'amortització
(intern: Llibre 22) i s'han de consultar en viu — no assumir-los mai (ni "típicament 68x/28x": els
comentaris del propi codi sobre aquests camps són genèrics i no fiables per a aquest llibre).

**⚠️ Dada de tipus "consulta"** — necessita llegir-se de la base de dades de l'empresa concreta,
no és contingut estàtic d'aquest document:
- Nom real del llibre (`NomLlibre`, no "Llibre 22" — això no li diu res a l'usuari).
- Compte de despesa d'amortització: codi + descripció.
- Compte d'amortització acumulada: codi + descripció.

Un cop obtinguts, l'estructura de l'assentament és:

- **Deure — compte de despesa d'amortització**: **un apunt per cada línia d'imputació
  d'activitat**, amb l'import proporcional al seu percentatge. L'última línia s'ajusta perquè la
  suma quadri exactament amb la quota (evita descaixos per arrodoniment).
- **Haver — compte d'amortització acumulada**: **un sol apunt** amb l'import total del període —
  sempre imputat a l'activitat principal, encara que el deure s'hagi repartit entre diverses
  activitats.

Exemple amb noms de compte genèrics (a substituir pels reals de l'empresa consultada), quota de
1.000 € repartida 70/30 entre dues activitats:

| Compte (a consultar) | Deure | Haver | Activitat |
|---|---|---|---|
| [codi] — [descripció compte despesa] | 700 € | | Activitat A (70%) |
| [codi] — [descripció compte despesa] | 300 € | | Activitat B (30%) |
| [codi] — [descripció compte amortització acumulada] | | 1.000 € | Activitat principal |

Períodes amb quota 0 no generen cap apunt.

**Aquesta pantalla només genera apunts de tipus Amortització.** Els apunts d'Alta i Baixa de
l'actiu (que aquí es llegeixen per calcular el pendent, però no es creen) vénen d'un altre flux —
l'alta/baixa de l'actiu fix — encara pendent de documentar.

### Cas especial: l'actiu entra en servei a mig període

Si la data de posada en servei de l'actiu cau enmig d'un període, el comportament depèn de la
periodicitat configurada:

- **Mensual**: aquell mes es descarta sencer — l'amortització comença el mes següent (no es
  prorrategen dies).
- **Trimestral o anual**: al contrari, **s'amortitza el període sencer** encara que l'alta hagi
  caigut a mig període (no s'espera al període següent).

### Requisits perquè es pugui calcular el quadre

Si falta qualsevol d'aquests, la pantalla bloqueja el càlcul i mostra els errors concrets:
- L'exercici ha de tenir dates d'inici i fi.
- L'actiu ha de tenir compte comptable, data de servei, anys d'amortització vàlids (> 0),
  periodicitat vàlida i mètode vàlid.
- El Llibre 22 ha de tenir configurats el compte de despesa i el compte d'amortització acumulada.

### Documents adjunts i exportació

Un cop desat (té número de document), es poden adjuntar fitxers al quadre. Es pot exportar a Excel
o PDF amb les metadades (empresa, exercici, document, actiu, compte, mètode) i la taula completa
amb els estats acolorits.

## font_tecnica
- Vista: `Views/Comptabilitat/QuadresAmortitzacioActiusFixes.cshtml`
- JS: `wwwroot/js/documents/comptabilitat/quadres-amortitzacio-actius.js`
- Controller: `Controllers/ComptabilitatController.cs` — `QuadresAmortitzacioActiusFixes`,
  `DetallQuadreAmortitzacio`, `CalcularQuadreAmortitzacio`, `GuardarQuadreAmortitzacio`,
  `EliminarQuadreAmortitzacio`, `HistoricMovimentsActiuFixe`, `ConstruirQuadreAmortitzacioActiu`,
  `CalcularQuotaTeorica`, `PeriodePosteriorAlta`