## id
doc_crear_factura_manual

## nom
Crear una factura manualment — guia detallada de la pantalla

## descripcio
Consulta aquest document quan calgui explicar amb precisió un camp, una restricció o un
comportament concret del formulari de crear factura (Facturació → Factures) — capçalera, línies de
concepte, i quines regles depenen del Tipus de Factura triat. No és l'explicació general de per
què/quan crear una factura, que cobreix `flux_crear_factura_manual`.

## contingut
### Capçalera

| Camp | Etiqueta a la UI | Obligatori en crear | Obligatori en validar | Notes |
|---|---|---|---|---|
| Tipus de Factura | Tipus de Factura | No | No | Determina en cascada la resta de camps fiscals (vegeu més avall) |
| Client | (sense etiqueta pròpia; botó "+" al costat = "Afegir Client") | No | **Sí**, llevat que sigui una factura sense identificació de client (tiquet) | Es pot desar la factura sense client — l'aplicació no ho impedeix, però no la deixarà validar |
| Dades Fiscals (tipus d'identificació) | Dades Fiscals | No | — | Es força automàticament segons el Tipus de Factura (vegeu més avall) |
| País | País | No | **Sí**, llevat de tiquet | Si s'omple, ha de ser un codi de país vàlid; en blanc ho accepta el servidor |
| ID Codi (NIF) | ID Codi | No | **Sí**, llevat de tiquet | |
| Nom Fiscal | Nom Fiscal | No | **Sí**, llevat de tiquet | |
| Adreça | Adreça | No | No | |
| C.P. | C.P. | No | No | |
| Població | Població | No | No | |
| Número Factura / Número Document / Data Factura | Numero Factura / Numero Document / Data Factura | — | — | Bloquejats: el número oficial l'assigna el sistema en validar, no abans |
| Data Comptable | Data Comptable | No | No | Si la data cau fora de l'exercici obert, l'aplicació l'ajusta sola i avisa |
| Descripció | Descripció | No | No | |
| Notes de la factura | Notes de la factura | No | No | Només visible un cop la factura ja existeix, no durant la primera creació |
| Comanda / Expedient / Contracte | Comanda / Expedient / Contracte | No | No | Només apareixen si el client és Administració Pública (vegeu apartat propi) |
| Activitat | Activitat: | **Sí** | — | |
| Tipus d'Ingrés (compte) | Tipus d'Ingrés: | **Sí** | — | |
| Sub-Tipus d'Ingrés (subcompte) | Sub-Tipus d'Ingrés: | **Sí, només si apareix** | — | Només es mostra si el compte triat té subcomptes |
| Inversió del Subjecte Passiu | Inversió del Subjecte Passiu | No | No | Editable només quan el Tipus de Factura la fa rellevant (vegeu més avall); en cas contrari queda amagada |
| Retenció | Retenció (etiqueta sense traduir a altres idiomes — error pendent) | — | — | Apareix i es calcula sola només si el Tipus de Factura en porta |
| Immoble | Immoble: | No | **Sí, si el Tipus de Factura és de lloguer de local de negoci** | |

**Important**: en crear la factura, l'aplicació **no obliga a omplir client, NIF ni nom fiscal** —
es pot desar una capçalera incompleta en aquest sentit. Aquestes dades **sí que es tornen
obligatòries en el moment de validar-la** (enviar-la a l'AEAT). Si un usuari pregunta per què no el
deixa validar tot i haver pogut crear la factura, aquesta és la raó.

### Com el Tipus de Factura determina la resta (en triar-lo)

- **Identificació fiscal forçada**: "Vendes de Béns i Serveis Minorista" (tiquet) força "sense
  identificació" (el NIF queda deshabilitat i s'oculten els botons de validar-lo). "Vendes de Béns
  i Serveis Nacionals", "Vendes Serveis Professionals", els dos de lloguer, i "Vendes a Canàries"
  forcen NIF nacional. Els dos de venda intracomunitària (UE) forcen VIES. La resta força "Altres".
- **Immoble**: només es mostra per als Tipus de lloguer de local de negoci.
- **Inversió del Subjecte Passiu**: només es mostra i és editable per a "Vendes de Béns i Serveis
  Nacionals" i "Vendes Serveis Professionals" — es reinicialitza sempre sense marcar. Per a la
  resta de Tipus queda amagada del tot.
- **Retenció**: es proposa sola si el Tipus en porta una (vegeu `doc_concepte_tipus_factura`).
- Tots els camps de classificació fiscal interna (els que apareixen com a "Clau Operació",
  "Qualificació", "Exenció" a la pantalla) **es proposen automàticament des del Tipus de Factura
  triat — mai cal tocar-los a mà**.
- En canviar el Tipus de Factura, **es buida el client i totes les dades fiscals** — cal
  tornar-les a introduir.

**Marcar/desmarcar Inversió del Subjecte Passiu, quan és editable, també canvia sola la
Qualificació d'Operació associada** (S1↔S2 — sense inversió / amb inversió, vegeu
`doc_concepte_tipus_factura`) — és automàtic, no cal ajustar-ho per separat.

### Client d'Administració Pública

Si el client seleccionat té marcat el senyal d'Administració Pública (es marca en donar-lo d'alta,
vegeu més avall), apareixen tres camps addicionals — Comanda, Expedient, Contracte — que en cas
contrari resten amagats i es netegen. Cap d'aquests tres camps és obligatori per si mateix a
aquesta pantalla.

### Donar d'alta un client des d'aquí mateix

El botó "+" al costat del selector de client obre un formulari ràpid d'alta (el mateix que ja
documenta `flux_alta_proveidor`, aplicat a client en lloc de proveïdor) — cal tenir triat abans el
Tipus de Factura, perquè determina si es crea com a client o com a proveïdor. És en aquest
formulari ràpid on es marca si el client és Administració Pública.

### Línies de concepte

| Camp | Etiqueta a la UI | Notes |
|---|---|---|
| Data | Data | |
| Codi | Codi (Opcional) | Llista desplegable amb els conceptes actius de Fitxers mestres → Conceptes Factura — **explícitament opcional**: es pot afegir una línia sense triar cap concepte, només amb descripció lliure. La llista es carrega un sol cop en obrir la pantalla de factures: si s'edita un concepte a Fitxers mestres mentre ja es té la pantalla de factures oberta, cal recarregar la pàgina perquè el desplegable reflecteixi el canvi |
| Concepte | Concepte | Camp de text (fins a 200 caràcters). Si es tria un Codi, s'autoemplena — però **es pot editar igualment després** |
| Quantitat | Qtat. | Amb botó de canvi de signe — accepta valors negatius |
| Preu Unitari | Preu Unitari € | S'autoemplena en triar un Codi — editable després; es pot desar en blanc/zero sense avís |
| Tipus IVA | Tipus IVA % | Es valida en sortir del camp contra els tipus d'IVA vigents; si no és vàlid, es neteja i avisa. **Queda deshabilitat quan la línia és exempta** (vegeu apartat d'Exempció) |
| Import Net | Import Net € | És l'únic import que cal omplir per poder desar la línia |
| Import Total | Import Total € | |
| Exempció | "Indicar si la operació es exempta" | Per defecte "No Exempta" — vegeu l'apartat propi més avall, és el camp amb més lògica automàtica de tots |

Un cop desada la línia, els valors que s'hi han quedat són definitius: **encara que després es
canviï el preu, l'IVA o l'exempció del concepte a Fitxers mestres, la línia ja creada no es toca
mai més** — a diferència del que passa als albarans (vegeu `doc_alta_concepte_factura`).

### Com es decideix l'Exempció d'una línia (i quan l'IVA queda bloquejat)

En triar un Codi (concepte) a una línia, l'aplicació decideix l'Exempció seguint aquest ordre:

1. **Si el Tipus de Factura de la capçalera és d'un règim que sempre és sense IVA** (exportacions,
   vendes a Canàries/Ceuta/Melilla, vendes intracomunitàries de béns o serveis, OSS) — l'Exempció
   es força segons aquest règim, el camp d'Exempció queda fix, i el Tipus d'IVA es buida i queda
   **deshabilitat**. Això passa sigui quin sigui el concepte triat.
2. **Si no, però el concepte triat ja porta una exempció pròpia configurada** (a la seva fitxa de
   Fitxers mestres) — l'Exempció de la línia es posa a la del concepte, el Tipus d'IVA es buida i
   queda **deshabilitat** igualment.
   - **Restricció addicional en aquest cas**: si l'exempció del concepte és d'un dels dos tipus que
     només tenen sentit en vendes fora d'Espanya (per exemple, exempció per exportació) i la
     factura és d'una operació nacional, **l'aplicació rebutja la selecció** amb un avís i neteja
     el que s'havia triat — no deixa combinar un concepte "d'exempció d'exportació" amb una factura
     nacional.
3. **Si cap dels dos casos anteriors aplica**, l'Exempció es queda a "No Exempta", i el Tipus d'IVA
   es proposa a partir del percentatge configurat al concepte, **editable amb normalitat**.

**Sobre l'avís ja conegut del camp d'IVA que es queda gris**: passa exactament en els casos 1 i 2
d'aquí sobre — és el comportament esperat quan la línia és exempta, no un error. L'única situació
realment problemàtica (bug conegut) és si, dins la mateixa línia sense desar encara, es canvia el
concepte triat per un altre que ja no hauria de ser exempt: el camp d'IVA es pot quedar bloquejat
igualment per un detall intern, encara que ja no li tocaria estar-ho. Si un usuari es troba que "el
camp d'IVA surt gris i no el puc tocar" després de canviar de concepte dins la mateixa línia sense
haver-la desat, cal eliminar la línia i tornar-la a afegir de nou en comptes d'insistir a canviar el
concepte in situ.