## id
doc_factures_via_subscripcions

## nom
Facturació amb Subscripcions — comportaments i casos concrets

## descripcio
Consulta aquest document quan calgui explicar amb precisió els camps d'una subscripció, com
funciona per dins la generació de factures, per què un període ja facturat no es torna a duplicar,
o resoldre el cas concret d'una factura fallida que no es regenera. No és l'explicació general, que
cobreix `flux_factures_via_subscripcions`.

## contingut
### Camps d'una subscripció

| Camp | Notes |
|---|---|
| Client | Obligatori |
| Descripció / Concepte de factura | El concepte que sortirà a la factura hi afegeix sempre el període facturat entre parèntesis (p. ex. "Quota mensual (01/09/2026 - 30/09/2026)") |
| Periodicitat | Mensual, trimestral... — configurable, no és una llista tancada al codi |
| Dia de facturació | Dia del mes (1-31) en què toca facturar |
| Tipus de període | "Període natural" (del dia 1 al final del mes/mesos que toquin) o "Període entre dates" (des del propi dia de facturació) |
| Data d'inici / Data de fi | La data de fi buida vol dir indefinida |
| Propera data de facturació | Calculada sola, avança automàticament cada vegada que es genera una factura |
| Activitat / Compte comptable / Tipus de Factura | **Obligatoris i bloquejats un cop creada la subscripció** — no editables després |
| ISP / Immoble (si aplica) | Igual que en qualsevol altra factura del mateix Tipus |
| Línies | Una o més, com en una factura normal (concepte, quantitat, preu, IVA...); cada línia es pot desactivar sense eliminar-la |

Si la subscripció no té cap línia activa, no es pot generar cap factura.

### Generar factures: manual, no automàtic

Ni el botó de lot ("Generar Factures", que revisa totes les subscripcions actives i genera les que
toquin) ni el botó individual ("Generar factura ara" dins d'una subscripció concreta) es disparen
sols per cap programació. La pantalla de "Configuració" d'aquest mòdul té camps que semblen una
programació (activar el procés automàtic, interval, hora preferida) però **avui no tenen cap
efecte real** — són a la pantalla però no fan res. La única manera que es generi una factura és que
algú premi un d'aquests dos botons.

### Protecció de duplicats

Abans de generar-se, sempre es comprova que no existeixi ja una factura per aquella mateixa
combinació de subscripció + període facturat — així que prémer "Generar Factures" diverses vegades
seguides no duplica res per als períodes que ja s'han facturat correctament.

### Cas concret: una factura fallida que no es regenerava sola (arreglat 2026-08-27)

Si la generació d'una factura concreta falla (per exemple, per un problema puntual en aquell
moment), l'aplicació ho marca com a error i **no ho torna a intentar per si sola**.

Fins fa poc, tampoc s'arreglava tornant a prémer "Generar Factures": encara que la pantalla de
previsualització mostrés aquella subscripció com a disponible de nou, en la pràctica el sistema
continuava considerant que aquell període ja estava "en cua" (encara que hagués fallat) i mai en
creava una de nova. **Ara ja no passa** — tornar a prémer "Generar Factures" torna a intentar-ho
també per als períodes que havien fallat.

A més, quan es genera un lot i queden errors, cada línia d'error del resum té ara dos botons
directes: **Reintentar** (torna a posar l'entrada a la cua de seguida, sense esperar al pròxim cop
que es premi "Generar Factures") i **Esborrar** (elimina definitivament el registre fallat — útil,
per exemple, si la subscripció ja no té sentit facturar-la per a aquell període).

### Pausar o donar de baixa

Pausar o donar de baixa una subscripció només afecta les factures futures — mai toca les que ja
s'havien generat abans, siguin esborranys o ja validades. Donar de baixa una subscripció sense data
de fi indicada li posa automàticament la data d'avui com a data de fi.