## id
doc_alta_proveidor

## nom
Alta de proveïdor — guia detallada de la pantalla

## descripcio
Consulta aquest document quan calgui explicar amb precisió un camp o control concret de la
pantalla "Fitxers mestres → Proveïdors" (formulari d'alta ràpida vs. fitxa completa, validació de
NIF/VIES, reactivació d'un proveïdor inactiu, diferència entre desactivar i eliminar, etc.) — no
per a l'explicació general de per què cal donar d'alta un proveïdor, que cobreix
`flux_alta_proveidor`.

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

Fitxers mestres → Proveïdors. Dues maneres de crear-ne un:

1. **Botó "Afegir"** — obre un formulari emergent (modal), separat de la fitxa de detall.
2. **Des de la llista** — triant un proveïdor 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 (vegeu més avall) |
| CodiPais | País | 2 lletres (p. ex. ES) |
| Nif | NIF / CIF | |
| AdrecaFiscal | Adreça Fiscal | |
| CodiPostalFiscal | C.P. | |
| PoblacioFiscal | Població | |
| IdMPF | Medi de Pagament | |
| Iban | IBAN | Es formata automàticament en escriure |
| Mail (Lliure01) | Email | **Només a la fitxa de detall** — no existeix al formulari ràpid d'alta |
| Actiu | (interruptor) | **Només a la fitxa de detall** — un proveïdor nou sempre es crea actiu |

Tots els camps són obligatoris tant al formulari ràpid d'alta com a l'edició posterior (Email n'és
l'única excepció).

### Validació de NIF / VIES

El **Tipus d'Identificació Fiscal** determina quin botó de validació apareix al costat del NIF:

- **Tipus 1**: mostra **"Validar NIF"** — comprova, sense sortir de l'aplicació ni consultar cap
  servei extern, que el DNI/NIE/CIF introduït té un format i una lletra de control vàlids
  (algorisme de validació espanyol estàndard).
- **Tipus 2**: mostra **"Validar VIES"** — fa una consulta real al servei VIES de la Unió Europea;
  si el número intracomunitari és vàlid, retorna el nom i l'adreça oficialment registrats.

### Comprovació de duplicats en crear-ne un

Abans de desar un proveïdor nou, l'aplicació comprova si ja existeix algun proveïdor amb el mateix
NIF a la mateixa empresa:

- Si n'hi ha un i **està actiu**: bloqueja la creació ("Ja existeix un element amb aquest NIF").
- Si n'hi ha un però **està desactivat**: ofereix reactivar-lo enlloc de crear-ne un de nou.

Un cop creat (o reactivat), l'aplicació obre automàticament la seva fitxa de detall.

### Desactivar vs. eliminar

- **Interruptor "Actiu"**: marca el proveïdor com a inactiu sense esborrar cap dada ni històric.
  Reversible en qualsevol moment.
- **Eliminar** (icona de paperera): esborra el proveïdor de debò. **Només es pot fer si no té cap
  moviment comptable associat** — ni cap operació registrada, ni un apunt al diari, ni cap registre
  fiscal, ni cap factura de venda vinculada. Si ja n'hi ha, l'eliminació es bloqueja i l'aplicació indica quin
  document ho impedeix i la seva data — cal desactivar-lo en lloc d'eliminar-lo.
- Un proveïdor marcat com **"per defecte"** de l'empresa mai es pot eliminar, encara que no tingui
  cap moviment.

## font_tecnica
- Vista: `Views/Fitxers/Proveidors.cshtml`
- Modal d'alta: `Views/Shared/Modals/AltaProveïdor.cshtml`
- JS: `wwwroot/js/documents/mestres/proveidors.js`, `wwwroot/js/shared/modals/alta-auxiliar.js`
- Validació NIF/VIES: `wwwroot/js/documents/factures/factura-modal.js` (`validarNIF`,
  `validarVIES`), endpoint `POST /Validacio/ValidarNIF` a `Controllers/BancsController.cs` (crida VIES)
- Controller: `Controllers/FitxersController.cs` — `CrearAuxiliar` (línia 1658), `GuardarAuxiliar`
  (línia 1365), `EliminarAuxiliar` (línia 1781), `ComprovarNif` (línia 1919), `ActivarAuxiliar`
  (línia 1943)