## id
doc_conciliacio

## nom
Conciliació — mecanisme detallat i diferències entre pantalles

## descripcio
Consulta aquest document quan calgui explicar amb precisió com funciona la conciliació a cada
pantalla concreta (Cobraments, Caixa, Targetes, Bancs, TPV, Llibre Major), per què dues pantalles
semblen comportar-se diferent, com es desfà una conciliació, o com s'agrupen més de dos apunts
entre si. No és l'explicació general del concepte, que cobreix `flux_conciliacio`.

## contingut
### El concepte, en detall

Conciliar és aparellar entre si els apunts d'un mateix compte que es compensen (per exemple, la
factura d'un client i el seu cobrament), per distingir el que ja està liquidat del que encara
resta pendent. El "saldo" d'un compte és sempre una xifra (deure menys haver acumulat); el "saldo
viu" és, en canvi, la part d'aquest saldo que correspon a apunts encara no aparellats — és a dir,
allò que realment queda pendent de cobrar o pagar, partida a partida.

Només es poden conciliar els comptes marcats com a "saldos vius" al Pla Comptable — normalment
els de clients, proveïdors i bancs. Aquesta marca és una classificació de les dades mestres del
Pla Comptable, no un ajust que es faci des de l'operativa diària: canviar-la requereix la
intervenció de l'administrador del sistema, no és un interruptor accessible a l'usuari.

### 1. Conciliació en registrar un cobrament

**No és automàtica en desar.** Un cobrament nou es marca com a "pendent de conciliar" (o no) segons
dues condicions independents: que l'empresa tingui contractat el mòdul de Comptabilitat i que
tingui activa la "Conciliació de Tresoreria" (vegeu la secció següent). L'aparellament real amb un
moviment de tresoreria es fa després, a demanda: l'aplicació proposa candidats — moviments al
compte pont del mitjà de pagament triat, dins d'una finestra de ±1 dia i amb el mateix import
(marge de mig cèntim) — i l'usuari en tria un manualment. Mai s'aparella sol sense cap confirmació.

Es pot desfer aquest aparellament ("Marcar com a pendent de conciliar") en qualsevol moment,
excepte si el cobrament ja ve d'una via externa confirmada (TPV, recurrent) — en aquests casos
l'única opció és "Retornar" (encara no implementat a totes les vies).

Vegeu `flux_registrar_cobrament_factura` per al flux complet de com es registra un cobrament.

### 2. Conciliació en comptabilitzar operacions de tresoreria

Els quatre orígens de moviments de tresoreria **no funcionen igual**:

- **Llibre de Caixa**: la conciliació només s'intenta línia a línia, quan l'usuari surt del camp
  d'import o de tercer (en editar, no en desar). Mai s'intenta en bloc per a tot el llibre. També
  té una implementació de desar independent de la resta — no comparteix el mateix camí de codi.
- **Extractes de Targetes, Extractes de Bancs, Tancaments de TPV**: comparteixen la mateixa
  implementació. A més de l'aparellament línia a línia en editar, **intenten conciliar tot
  l'extracte automàticament just en carregar-lo** — abans que l'usuari hagi tocat res.
- **Tancaments de TPV** té, a més, un botó específic "Conciliar automàtic" que aparella per data i
  import exactes contra els cobraments pendents.

En cap dels quatre casos "Desar" torna a intentar la conciliació: el botó Desar només guarda
l'estat de conciliació que ja s'havia calculat mentre l'usuari treballava a la pantalla.

Quan un moviment no es pot aparellar de manera inequívoca, l'aplicació no l'aparella sola: obre un
diàleg (per triar la factura corresponent) o el deixa marcat com a pendent amb una icona vermella
clicable.

### 3. Conciliació manual des del Llibre Major

El Llibre Major fa servir un mecanisme propi, separat del de Cobraments/Tresoreria. Té dues
accions:

- **"Conciliar"**: exigeix que la suma de les línies seleccionades doni exactament zero.
- **"Conciliar Parcial"**: no exigeix suma zero — permet deixar constància d'una conciliació
  incompleta.

És l'única pantalla que permet crear directament una agrupació real N:1 o 1:N (per exemple, una
factura contra dos cobraments parcials diferents) en una sola acció, en lloc d'anar acumulant
membres d'un en un.

Hi ha també una **"Conciliació massiva"**: l'aplicació proposa aparellaments (1 a 1, i també grups
per import agregat) per a un rang de dates triat, sobre tots els exercicis, i l'usuari revisa i
confirma quins accepta abans que es desin.

### Com s'agrupen més de dos apunts

Cada grup conciliat comparteix un mateix identificador intern. Quan s'hi afegeix un nou membre
(per exemple, un segon cobrament parcial de la mateixa factura), el motor compartit (usat per
Cobraments i Tresoreria) recalcula l'estat de **tots** els membres del grup — si abans un apunt
quedava marcat com a "parcial" i el nou pagament ja completa l'import, tots els membres del grup
passen a "total" automàticament, encara que s'haguessin conciliat en sessions diferents.

El Llibre Major, en canvi, no fa aquest recàlcul retroactiu: cada vegada que es confirma una
conciliació hi sobreescriu l'estat de tot el conjunt de línies seleccionades (les existents del
grup més les noves), sense necessitat de recalcular res perquè ja rep totes les línies alhora.

### Desfer una conciliació ("desconciliar")

Es pot fer des de tres llocs (la factura, la pantalla de tresoreria, i el Llibre Major), i mai
esborra els apunts comptables — només en desfà la vinculació. El comportament amb grups de més de
dos membres és asimètric i intencionat:

- Si el grup té **2 membres o menys**, treure'n un desfà la conciliació sencera — tots dos apunts
  queden lliures.
- Si el grup té **més de 2 membres**, treure'n un només rebaixa la resta d'un estat "total" a
  "parcial" — el grup no es dissol mai del tot, i si ja estava en "parcial" no canvia res.

### Com es mostra l'estat

Cada apunt guarda el seu propi estat de conciliació (pendent / parcial / total) i, si forma part
d'un grup, un identificador compartit amb la resta de membres. Això és independent del **saldo
acumulat** que es mostra al Llibre Major (la xifra de deure menys haver acumulada fila a fila) —
no s'han de confondre: el saldo acumulat és simplement el total corrent del compte, mentre que
l'estat de conciliació indica quins apunts concrets ja estan aparellats.

Les columnes relacionades amb conciliació (estat, vincle al grup) només es mostren quan el compte
és realment un compte de saldos vius — en els altres, no hi apareixen.

### Dos interruptors independents: "Conciliació de Tresoreria" i mòdul Financer

Hi ha dos ajustos diferents que afecten la conciliació, i **no bloquegen les mateixes coses**:

- **"Conciliació de Tresoreria"** (Configuració → Empresa): és un ajust per empresa, no per
  subscripció. Amb aquest interruptor desactivat, **totes** les pantalles de conciliació queden
  bloquejades del tot — Bancs, Caixa, Targetes, TPV i les quatre accions del Llibre Major deixen
  de funcionar, per a qualsevol compte (client, proveïdor o genèric). És una decisió deliberada:
  hi ha empreses (per exemple, molts autònoms) que no porten un control actiu de tresoreria — si
  la conciliació estigués sempre activa, totes les seves factures quedarien perpètuament
  "pendents de cobrar" sense que ningú les gestionés mai. Per evitar-ho, un cobrament creat amb
  aquest interruptor desactivat neix directament com a **no pendent de conciliar** — el sistema el
  tracta com si ja estigués liquidat, en lloc d'acumular-se com un pendent que ningú resoldrà.
  Aquest comportament és intencionat, no un error.
- **Mòdul Financer** de la subscripció: amb aquest desactivat (però la Conciliació de Tresoreria
  activa), la conciliació de comptes **no es bloqueja** — continua funcionant igual per a
  proveïdors i comptes genèrics. L'únic que desapareix és el tractament específic d'un compte de
  client com a "cobrament" (la icona i el flux d'assignar-lo a una factura concreta): sense
  Financer, un moviment contra un compte de client es concilia igual que un de proveïdor, per la
  via genèrica, sense passar mai pel mecanisme de cobraments.

En resum: "Conciliació de Tresoreria" és l'interruptor mestre (tot o res); el mòdul Financer només
afina si els comptes de client es tracten de manera especial (com a cobrament) o no.

## comprovacions
Si un usuari pregunta per què un cobrament no s'ha conciliat sol: recorda que mai és automàtic —
sempre cal triar un candidat manualment.

Si un usuari pregunta per què l'extracte de Caixa no s'ha conciliat en bloc com el de Bancs:
explica que Caixa només concilia línia a línia en editar, mai en bloc — és un comportament diferent
per disseny, no un error.

Si un usuari pregunta per què desfer una conciliació d'un grup gran no ha alliberat tots els
apunts: explica la regla asimètrica de grups de més de dos membres.

Si un usuari pregunta com marcar un compte com a "saldos vius" i no ho troba a l'aplicació:
explica que aquesta marca és de les dades mestres del Pla Comptable i requereix intervenció de
l'administrador del sistema — no és una opció d'ús diari.

Si un usuari pregunta per què un cobrament antic no es pot eliminar tot i no haver-lo conciliat
mai amb cap moviment real: comprova si es va crear amb la "Conciliació de Tresoreria"
desactivada — en aquest cas neix com a "no pendent" i el sistema el tracta com ja liquidat; cal
forçar-lo a "pendent de conciliar" des de la pròpia factura abans de poder-lo eliminar.

Si un usuari pregunta per què desactivar el mòdul Financer no bloqueja la conciliació de Bancs:
aclareix que només afecta el tractament especial dels comptes de client com a "cobrament" — la
conciliació genèrica segueix activa; qui bloqueja tota la conciliació és l'interruptor
"Conciliació de Tresoreria" de Configuració → Empresa, no el mòdul Financer.
