## id
doc_alta_client

## nom
Alta de client — guia detallada de la pantalla

## descripcio
Consulta aquest document quan calgui explicar amb precisió un camp o control concret de la
pantalla "Fitxers mestres → Clients" — el sistema de pagaments per activitat amb mandat SEPA, les
dades DIR3 per facturar a Administracions Públiques, la pestanya d'Albarans, o les regles
d'eliminació (incloent-hi els Albarans i Subscripcions pendents). No és l'explicació general de
per què cal donar d'alta un client, que cobreix `flux_alta_client`.

## contingut
### On és i com es crea

Fitxers mestres → Clients. Dues maneres de crear-ne un:

1. **Botó "Afegir"** — obre un formulari emergent (modal), compartit amb Proveïdors i altres
   fitxers mestres semblants.
2. **Des de la llista** — triant un client ja existent al lateral s'obre la seva fitxa completa
   per editar-lo.

### Camps del formulari

| Camp | Etiqueta a la UI | Notes |
|---|---|---|
| Descripció | Nom Comercial | |
| NomFiscal | Nom Fiscal | Raó social |
| IdTipusIdeFiscal | Tipus Identificació Fiscal | Determina quin botó de validació apareix (NIF espanyol o VIES), igual que a Proveïdors |
| CodiPais | País | 2 lletres (p. ex. ES) |
| Nif | NIF / CIF | |
| AdrecaFiscal | Adreça Fiscal | |
| CodiPostalFiscal | C.P. | |
| PoblacioFiscal | Població | |
| Mail | Email | Visible directament a la capçalera de la fitxa (a diferència de Proveïdors, on és a la fitxa comercial) |
| Actiu | (interruptor) | Un client nou sempre es crea actiu |

**IdMPF i Iban** (mitjà de pagament i IBAN directes) encara existeixen com a columnes a la base de
dades i es poden veure al codi font de la pantalla, però estan **amagats** a la fitxa de Client —
es mantenen només per compatibilitat amb dades antigues. La configuració real de com es cobra a un
client es fa des del diàleg de Pagaments (vegeu més avall), no aquí.

No hi ha camps de descompte, tarifa de preus ni límit de crèdit a la fitxa d'un client — no
existeixen a FiskAppCloud.

### Pagaments per activitat i mandat SEPA

El botó "Pagaments" (icona d'engranatge, a la capçalera de la fitxa) obre un diàleg amb una fila
per cada activitat de l'empresa, on es pot triar:

- el mitjà de pagament del client per a aquella activitat concreta;
- l'IBAN corresponent;
- la referència i la data del mandat SEPA, si es cobra per domiciliació.

Des del mateix diàleg es pot **enviar un mandat SEPA** al client (perquè el signi) i copiar
l'enllaç d'aquest enviament.

A diferència de Proveïdors, on el mitjà de pagament és un únic valor fix a la fitxa, un client pot
tenir una forma de cobrament diferent per a cada activitat.

### Facturació electrònica a Administracions Públiques (DIR3)

Si el client és un organisme públic, cal activar l'interruptor **"Es Administració Pública"**. En
activar-lo, es fan obligatoris:

- **Canal de Factura Electrònica** (FACe, eFACT, Euskadi, Galícia, o Manual)
- **Oficina Comptable** (codi DIR3)
- **Òrgan Gestor** (codi DIR3)
- **Unitat Tramitadora** (codi DIR3)

Si l'interruptor està desactivat, aquests camps es buiden en desar — no queden dades DIR3
"fantasma" en un client que ha deixat de ser Administració Pública.

Aquest bloc de camps només apareix a la fitxa de Client — no existeix a Proveïdors.

### Pestanya Albarans

La fitxa d'un client té una pestanya pròpia d'Albarans, que mostra els albarans generats per
aquest client i permet crear-ne un de nou directament des d'aquí. Aquesta pestanya no existeix a
la fitxa d'un proveïdor.

### Validació de NIF / VIES i comprovació de duplicats

Igual que a Proveïdors: el Tipus d'Identificació Fiscal determina si apareix "Validar NIF"
(validació local de format, sense sortir de l'aplicació) o "Validar VIES" (consulta real al servei
de la UE). Abans de desar un client nou, es comprova si ja n'hi ha un amb el mateix NIF: si està
actiu, bloqueja la creació; si està desactivat, ofereix reactivar-lo.

### Desactivar vs. eliminar

- **Interruptor "Actiu"**: marca el client com a inactiu sense esborrar cap dada ni històric.
  Reversible en qualsevol moment.
- **Eliminar** (icona de paperera): esborra el client de debò, però queda bloquejat si:
  - té qualsevol moviment comptable associat (una operació registrada, un apunt al diari, un
    registre fiscal, o una factura de venda vinculada);
  - té un **albarà encara no facturat** (correguit el 2026-08-30 — abans d'aquesta data, un
    client amb albarans pendents es podia eliminar sense avís);
  - té una **subscripció que encara no està de baixa** (activa, pausada, o amb baixa sol·licitada
    però no confirmada; també corregit el 2026-08-30);
  - està marcat com a "per defecte" de l'empresa (mai es pot eliminar, encara que no tingui cap
    moviment).

  Si qualsevol d'aquests bloqueja l'eliminació, l'aplicació indica quin document ho impedeix i la
  seva data — cal desactivar el client en lloc d'eliminar-lo.

## comprovacions
Si no es pot eliminar un client:
- comprova si té algun moviment comptable (operació, apunt, registre fiscal o factura de venda);
- comprova si té algun albarà encara no facturat;
- comprova si té alguna subscripció que no estigui de baixa;
- comprova si està marcat com a client "per defecte" de l'empresa.

Si els camps DIR3 no es guarden com s'esperava:
- comprova que l'interruptor "Es Administració Pública" estigui activat — si no ho està, els camps
  DIR3 es buiden en desar encara que s'hagin omplert abans.

Si l'usuari pregunta per l'IBAN o el mitjà de pagament d'un client i no el troba a la fitxa
principal:
- indica-li el botó "Pagaments" — la configuració real hi és, no al formulari principal.