## id
flux_enllac_pagament_factura

## nom
Enllaç de pagament d'una factura

## descripcio_activacio
Fes servir quan l'usuari vulgui generar o copiar un enllaç perquè el seu client pagui una factura
sense necessitat d'entrar al Portal de Clients, vulgui incloure aquest enllaç en enviar la factura
per correu, o pregunti per què l'opció de pagament apareix desactivada per a un client o factura
concrets tot i que l'empresa i l'activitat ja estan ben configurades.

## relacionats
- flux_portal_clients
- flux_tpv_virtual_cobrament
- flux_alta_client
- flux_alta_tpv
- doc_enllac_pagament_factura

## explicacio
Des de la fitxa d'una factura (modal d'enviament per correu), hi ha dos punts relacionats però
diferents:

- **Botó "Copiar Enllaç de Pagament"**: genera l'enllaç a l'instant i el deixa preparat per copiar
  i enganxar on calgui — no envia cap correu.
- **Opció de pagament dins l'enviament per correu**: en enviar la factura per email (manualment o
  automàticament, quan l'activitat ho té configurat), es pot incloure el mateix enllaç dins el
  cos del missatge.

En tots dos casos l'enllaç porta el client cap al Portal de Clients (vegeu `flux_portal_clients`)
sense que hagi d'identificar-se — el mateix testimoni de l'enllaç fa de credencial.

### Quan es pot generar l'enllaç

Cal que es compleixin **totes** aquestes condicions, en aquest ordre — si en falla una de les
primeres, les següents ni es comproven:

1. El client (`IdAuxiliar` de la factura) té un **mitjà de pagament habitual actiu configurat per
   a aquesta activitat concreta** — vegeu `flux_alta_client` (botó "Pagaments" a la fitxa del
   client). Sense això, l'opció queda desactivada encara que la resta estigui perfecte.
2. Aquest mitjà habitual **no pot ser "Domiciliació Bancària"** — les domiciliacions es cobren
   sempre per Remeses (`flux_remeses`), mai per enllaç.
3. El mitjà habitual del client ha d'estar marcat com actiu, visible al Portal i que permeti
   pagament puntual — a nivell d'**empresa o d'activitat**, segons si l'activitat "hereta" la
   configuració de l'empresa o en té una de pròpia (interruptor a la configuració de l'activitat).
4. Si el mitjà habitual és "Targeta", cal a més un **TPV Virtual assignat i actiu** per a aquella
   activitat (vegeu `flux_alta_tpv`).
5. La factura ha d'estar en un estat vàlid per generar-hi un enllaç (esborrany, validada, o
   equivalent) i **no pot estar anul·lada**.
6. La factura ha de tenir **import pendent de cobrar** — si ja està totalment cobrada, no es genera
   cap enllaç.
7. El Portal de Clients ha d'estar **activat per a l'empresa**, amb la seva URL pública
   configurada.

### Enllaç puntual vs. recurrent

Hi ha dos tipus d'enllaç, no un de sol:

- **Puntual**: vàlid per a qualsevol factura amb un mitjà habitual que ho permeti (punt 2-3
  amunt). En obrir-lo, el client pot triar qualsevol mitjà de pagament puntual disponible — el
  mitjà habitual només decideix si es pot **oferir** l'opció, no limita què triarà el client dins
  el Portal.
- **Recurrent**: només per a factures de **subscripcions** (`flux_factures_via_subscripcions`),
  amb mitjà habitual "Targeta" i un TPV Virtual amb recurrència disponible — pensat perquè el
  client deixi la targeta guardada per als cobraments futurs de la subscripció.

### Cobrament automàtic (MIT), sense cap enllaç

Si una factura de subscripció **ja té un testimoni de targeta vigent** (guardat en un pagament
recurrent anterior) i la factura ja està **validada**, FiskAppCloud **ni tan sols ofereix cap
enllaç** — cobra directament amb el testimoni guardat (pagament "Merchant-Initiated Transaction").
L'opció recurrent només apareix quan encara **no** hi ha cap testimoni vigent — és a dir, la
primera vegada, per obtenir-lo.

Per al detall tècnic exacte de cada condició i la prioritat entre puntual/recurrent/automàtic,
vegeu `doc_enllac_pagament_factura`.

## accions_futures
- generar_enllac_pagament
- consultar_opcions_pagament_factura