## id
flux_tpv_virtual_cobrament

## nom
Cobrament amb TPV Virtual

## descripcio_activacio
Fes servir quan l'usuari vulgui cobrar una factura amb targeta a través del TPV Virtual, pregunti
per què el cobrament no apareix immediatament després de pagar, o per què no pot eliminar un
cobrament fet per TPV.

## relacionats
- flux_registrar_cobrament_factura
- flux_conciliacio
- flux_alta_tpv
- doc_tpv_virtual_cobrament

## explicacio
El cobrament amb TPV virtual es pot iniciar des del Portal de Clients, des d'un enllaç enviat amb
la factura o manualment des de la fitxa de la factura (MOTO). Segons la configuració, la passarel·la
pot ser Redsys o Global Payments; Bizum està implementat amb Redsys.

**Perquè aquest botó funcioni, cal haver-hi configurat prèviament un TPV.** El "TPV Virtual" no és
un catàleg a part — és una configuració que es penja sobre una fitxa de Fitxers mestres → TPV ja
existent, assignada a l'activitat de la factura. Vegeu `flux_alta_tpv` per donar-lo d'alta i
configurar-hi les credencials del proveïdor.

**El cobrament no es crea a l'instant.** Generar l'enllaç de pagament només reserva l'operació —
encara no hi ha cap cobrament registrat a la factura. El cobrament real es crea uns instants
després, quan el proveïdor confirma el pagament de manera asíncrona (una notificació pròpia de servidor
a servidor, no dependent del que vegi l'usuari a la pantalla). Per això, si es tanca la finestra de
pagament massa de pressa o es refresca la factura immediatament després de pagar, el cobrament pot
trigar uns segons a aparèixer.

Per a subscripcions, un enllaç recurrent permet pagar la primera factura i desar una referència
segura de la targeta. Les factures següents es cobren automàticament en validar-se si el client té
targeta com a mitjà habitual, recurrència activada per a client + activitat + mitjà i un token vigent.
Si cal renovar la targeta o l'autorització no és vàlida, es pot tornar a enviar un enllaç recurrent
encara que ja n'hi hagi un de vigent — la nova referència substitueix l'anterior en completar-se.

El pagament manual (MOTO), fet per un usuari de FiskAppCloud des de la fitxa de la factura, queda
identificat com a "MOTO" a les observacions del cobrament (diferenciat de "TPV"/"POS" per a un
pagament normal del client) — útil per distingir-lo després al detall del cobrament.

Un cop confirmat, el cobrament queda marcat com a vingut d'una via de pagament externa: **mai es
pot eliminar**. Si cal desfer-lo (per una devolució), l'única opció és "Retornar" — que sí
funciona, i genera un cobrament negatiu independent sense modificar mai l'original.

Per al detall tècnic del procés (com es genera l'enllaç, com es confirma el pagament, i com
funciona exactament "Retornar"), vegeu `doc_tpv_virtual_cobrament`.

## accions_futures
- iniciar_pagament_tpv
- retornar_cobrament_tpv