## id
doc_llibre_accionistes

## nom
Llibre d'Accionistes — guia detallada i casos concrets

## descripcio
Consulta aquest document quan calgui explicar amb precisió com es diferencien les dues operacions
del Llibre d'Accionistes, com es calcula el resum de participacions, o els límits reals de
l'eliminació d'un moviment. No és l'explicació general, que cobreix `flux_llibre_accionistes`.

## contingut
### Canvi Accionariat vs. Pagament de Dividends

Encara que comparteixin pantalla, són dues operacions independents:

- **Canvi Accionariat** (`IdLlibre = 31`): registra un moviment d'accions (Núm. Accions, Valor
  Nominal, Prima, Data, Concepte) contra un accionista. Es guarda sempre com a validat. No toca cap
  compte comptable — és exclusivament un llibre de titularitat.
- **Pagament de Dividends** (`IdLlibre = 32`): reparteix un import total entre els accionistes
  segons el seu percentatge actual de participació. Per cada accionista genera tres línies
  comptables: el dividend brut, la retenció d'IRPF (si l'accionista té l'interruptor de retenció
  actiu a la seva fitxa — vegeu `doc_alta_accionista`) amb el registre fiscal corresponent, i
  l'import net efectivament pagat.

### Moviments d'accions: un historial, no una foto fixa

Cada moviment de Canvi Accionariat queda desat com una fila independent (`RegAccionista`), amb la
seva pròpia data i exercici. Una transmissió es registra amb un número d'accions **negatiu** (hi
ha un botó explícit per invertir el signe). La participació actual d'un accionista és sempre la
suma de totes les seves files — no hi ha cap "foto fixa" que es pugui editar directament.

### Com es calcula el resum

El resum (capital social, fons propis, valor real per acció, i el detall per accionista) es
calcula en el moment de consultar-lo, no es desa enlloc:

- El total d'accions només compta els accionistes amb un saldo net positiu.
- El capital social i els fons propis surten dels saldos reals dels comptes comptables del grup
  10 (i 11/12 per als fons propis), no d'una xifra introduïda a mà.
- El valor real per acció és fons propis ÷ total d'accions.
- El percentatge de cada accionista és sempre el seu saldo ÷ el total — per això sempre suma 100%
  entre tots els accionistes, per construcció, sense necessitat de cap validació explícita.

### Eliminar un moviment: sense els mateixos frens que altres pantalles

Eliminar un moviment del Llibre d'Accionistes esborra tota l'operació (i, si és un Pagament de
Dividends, també els seus apunts comptables i el registre fiscal associat). **No hi ha cap
comprovació al servidor** que impedeixi eliminar un moviment ja validat, ni que l'exercici estigui
tancat — l'única protecció que existeix és un avís al navegador quan l'exercici sembla tancat, no
una regla imposada pel servidor. Si un usuari pregunta si es pot "desfer" un pagament de dividends
ja validat, la resposta és sí, tècnicament es pot eliminar igualment.

## comprovacions
Si el percentatge de participació d'un accionista sembla incorrecte:
- recorda que es calcula sobre el saldo net de tots els seus moviments de Canvi Accionariat, no
  sobre cap valor introduït directament.

Si es vol saber si es pot desfer un pagament de dividends ja validat:
- sí, l'eliminació no comprova l'estat de validació al servidor — només hi ha un avís al
  navegador si l'exercici sembla tancat.
