## id
doc_alta_tpv

## nom
Alta de TPV — guia detallada i relació amb TPV Virtual

## descripcio
Consulta aquest document quan calgui explicar amb precisió un camp de la fitxa d'un TPV, com es
vincula un tancament diari amb el terminal correcte, o els detalls de com es configura el TPV
Virtual des d'aquesta mateixa pantalla. No és l'explicació general, que cobreix `flux_alta_tpv`.

## contingut
### Camps bàsics del formulari

| Camp intern | Etiqueta a la UI | Notes |
|---|---|---|
| Descripció | Nom | |
| Lliure01 | Número TPV | Text lliure — número/codi de comerç del terminal |
| Lliure03 | Compte bancari associat | Referència a Fitxers mestres → Comptes Bancaris |
| Iban | IBAN | Còpia de l'IBAN del banc triat, no editable |
| Actiu | (interruptor) | |

### Fitxer de TPV i TPV Virtual: una sola fitxa, dos usos

Aquest és el punt que més sol confondre. **No hi ha dues fitxes ni dos catàlegs**: la mateixa fila
que s'acaba de crear amb les dades bàsiques és la que, des d'un botó "Configurar TPV virtual" a la
seva pròpia pantalla de detall, es pot ampliar amb credencials de Redsys (entorn, codi de comerç,
terminal, clau de signatura) i amb l'assignació d'activitats que hi podran cobrar. Tècnicament, la
configuració de TPV Virtual es desa en una taula separada, però sempre referenciant aquesta mateixa
fitxa — no es pot crear una configuració de TPV Virtual sense que ja existeixi la fitxa bàsica del
TPV a la qual penjar-se.

En altres paraules: **tot TPV Virtual és un TPV d'aquesta pantalla amb una configuració addicional
opcional; no tot TPV d'aquesta pantalla té TPV Virtual configurat**. Un terminal físic normal,
sense cap intenció de cobrar online, no necessita mai obrir aquest modal.

La configuració admet Redsys i Global Payments. Camps segons proveïdor:

| Camp | Redsys | Global Payments |
|---|---|---|
| Codi de comerç | FUC | Merchant ID |
| Terminal | Número de terminal | Account |
| Clau de signatura | Clau secreta | Shared Secret |
| Clau de devolució | (mateixa clau de signatura) | Rebate Password — camp separat obligatori, encara que l'entitat hagi assignat el mateix valor que el Shared Secret |

Les claus es desen com a secrets — en tornar a obrir la configuració no se'n mostra el valor; deixar
el camp en blanc en desar no el sobreescriu. També s'activen les capacitats contractades (puntual,
recurrent, MOTO i, amb Redsys, Bizum) i s'assigna cada activitat al TPV per mitjà de pagament.

**Marcar una capacitat aquí no l'habilita al banc.** Si el proveïdor no té provisionat el servei
corresponent (per exemple, pagament recurrent o Bizum), la passarel·la rebutjarà l'operació encara
que estigui activada a FiskAppCloud.

**Restricció d'assignació**: una activitat només pot tenir un TPV assignat per a cada mitjà de
pagament (targeta o Bizum) — assignar-ne un de nou a la mateixa combinació activitat+mitjà
desactiva automàticament l'assignació anterior (no es duplica). Un mateix TPV sí que pot atendre
diverses activitats i, si el proveïdor ho permet, més d'un mitjà alhora.

**Provar la configuració**: un cop desada, el botó "Provar TPV" obre la passarel·la real del
proveïdor amb una operació de prova — confirma la connexió i la signatura, però no substitueix
acabar una operació de veritat i comprovar que el cobrament arriba a FiskAppCloud. Hi ha un botó
equivalent per provar específicament el pagament manual (MOTO). El test del mode recurrent
(tokenització) només està disponible amb Redsys — amb Global Payments queda desactivat a la UI.

### Vinculació amb els Tancaments de TPV

La pantalla operativa de Tancaments de TPV (Comptabilitat/Tresoreria) fa triar, per a cada
tancament, a quin TPV d'aquesta llista pertany. Quan els tancaments s'importen automàticament des
d'un fitxer del banc, l'aplicació identifica sola a quin TPV correspon cada bloc comparant el codi
de comerç del fitxer amb el "Número TPV" de la fitxa (els últims dígits, ja que els formats no
coincideixen exactament) — si no troba una coincidència única, no assumeix res i ho senyala.

### Eliminació

S'aplica la mateixa regla genèrica que a la resta de fitxers mestres (bloqueig per moviments
comptables directes). **No s'ha trobat cap comprovació que impedeixi eliminar un TPV que encara té
una configuració de TPV Virtual activa o un historial de cobraments fets a través seu** — si es
dona aquest cas, cal revisar-ho manualment abans d'eliminar-lo.

## comprovacions
Si un usuari pregunta on és el "catàleg de TPVs virtuals": no n'hi ha cap de separat — és la
mateixa pantalla de Fitxers mestres → TPV, amb el botó de configuració.

Si un tancament de TPV importat automàticament no s'ha assignat a cap terminal: comprova que el
"Número TPV" de la fitxa coincideixi (als últims dígits) amb el codi de comerç del fitxer del banc.

Si un usuari vol eliminar un TPV que sap que té el TPV Virtual configurat: avisa que aquest cas no
queda protegit automàticament — cal comprovar-ho manualment abans.

Si la passarel·la rebutja una operació de prova o real: comprova que el proveïdor, l'entorn, les
credencials i la capacitat concreta (puntual/recurrent/MOTO/Bizum) estiguin realment contractats i
provisionats per l'entitat — activar-ho a FiskAppCloud no ho activa al banc.

Si un usuari assigna un TPV a una activitat+mitjà que ja en tenia un altre: no dona error, l'anterior
queda desactivat automàticament i el nou el substitueix.