## id
doc_validar_enviar_factura

## nom
Validar i enviar una factura — comportaments i casos concrets

## descripcio
Consulta aquest document quan calgui explicar amb precisió què comprova FiskAppCloud abans de
deixar validar una factura, què veu exactament l'usuari quan l'AEAT accepta/rebutja, com funciona
realment l'enviament per lots, o resoldre un "per què no ha passat res"/"per què no es mou la
barra de progrés". No és l'explicació general del procés, que cobreix `flux_validar_enviar_factura`.

## contingut
### Comprovacions abans de deixar validar

Sempre es comprova que hi hagi client seleccionat. A més, segons el tipus d'identificació fiscal
que porti la factura:

- Si la factura porta identificació fiscal (és a dir, no és una factura "sense identificació de
  client" / tiquet), també calen País, Nom Fiscal i NIF.
- Si la factura és de lloguer de local de negoci, també cal tenir seleccionat l'Immoble.

Si falta algun d'aquests camps, el camp corresponent es marca en vermell i la validació s'atura
aquí mateix — sense cap missatge emergent, només el marcat del camp.

Superat això, encara es fan comprovacions addicionals de coherència entre el tipus d'identificació
fiscal i el país (per exemple: NIF nacional amb país diferent d'Espanya, o VIES amb país Espanya,
queden bloquejats amb un avís concret), i si escau es torna a validar el NIF o el VIES en viu
contra l'AEAT abans de continuar. Només si tot això és correcte apareix la confirmació final
("Aquesta acció validarà i enviarà la factura a l'AEAT. Vol continuar?") i, en confirmar, la
pantalla mostra "Enviant Factura... Esperant resposta AEAT" fins que arriba la resposta.

### Què veu l'usuari segons la resposta de l'AEAT

- **Acceptada**: distintiu verd, "Enviament acceptat per l'AEAT".
- **Acceptada parcialment**: distintiu groc, "Enviament acceptat parcialment per l'AEAT. Revisa
  els errors."
- **Rebutjada**: distintiu vermell, "Enviament rebutjat per l'AEAT. Revisa els errors."
- En els tres casos, si l'AEAT ha tornat algun motiu d'error concret per línia, es llista tal qual
  (codi + descripció literal de l'AEAT) — no és un missatge genèric de FiskAppCloud.
- El codi de verificació (CSV) que dona l'AEAT es mostra sempre que n'hi ha.
- Cas especial: si l'empresa té desactivat l'enviament VeriFactu, la factura es dona directament
  per "Validada" sense arribar a contactar l'AEAT — no és un error, és el comportament esperat en
  aquesta configuració.

### Tornar-ho a intentar

Si una factura queda rebutjada (totalment o parcial) i **s'ha creat directament a FiskAppCloud**,
n'hi ha prou amb tornar a obrir-la i prémer "Validar" un altre cop, un cop corregit el motiu del
rebuig. **No es reserva un número oficial nou** — reutilitza el que ja tenia (només es reserva
número la primera vegada, quan la factura encara és un esborrany sense enviar). Sí que s'actualitza
la data de la factura a la data actual en cada reintent d'un esborrany o d'una rebutjada total
(no en una acceptada parcialment).

Si la factura **prové d'una integració externa** (per exemple Clock) i queda rebutjada, no hi ha
botó de "Validar" — en el seu lloc apareix "Netejar factura rebutjada". **Això no és un
reintent**: esborra tota la comptabilitat i els cobraments generats per aquella factura i la deixa
només com a registre històric del rebuig. S'ha d'utilitzar només quan es vulgui descartar
definitivament l'intent, no per corregir-la i tornar-la a enviar.

### Generació del PDF i enviament per email

El PDF només es genera automàticament quan la factura queda acceptada (total o parcialment) o quan
es dona per validada sense enviar-se (empresa amb VeriFactu desactivat) — **mai** si l'AEAT la
rebutja del tot. Si la generació o la pujada del PDF falla per qualsevol motiu, la factura es queda
igualment validada — no es desfà res — i només apareix un avís separat dient que no s'ha pogut
descarregar el PDF; es pot tornar a generar més tard des de la mateixa fitxa.

El PDF, tant si es genera automàticament com si es torna a generar més tard, sempre mostra les
dades tal com estaven **en el moment d'emetre la factura** — mai les dades actuals del client o de
l'empresa si aquestes han canviat després. Això és intencionat: una factura de fa anys ha de
continuar sortint igual que quan es va emetre.

L'enviament automàtic per email al client (si l'Activitat el té configurat i té el correu SMTP
enllestit) fa servir sempre el SMTP propi d'aquella activitat — mai un remitent genèric de
FiskAppCloud — exactament el mateix mecanisme que el botó manual "Enviar per correu". És totalment
silenciós de cara a l'usuari: si falla, no es mostra cap avís a la pantalla — el resultat que veu
l'usuari en validar depèn únicament de la resposta de l'AEAT, mai de si l'email ha sortit o no.
Perquè es pugui activar aquest enviament automàtic a la configuració de l'Activitat, cal tenir
omplerts els quatre camps SMTP obligatoris — es comprova tant a la pantalla com al servidor.

### Enviament per lots — què és diferent de fer-ho un per un

Es fa des de la llista de factures amb "Enviar Selecció" (només ofereix les factures encara
pendents de validar que ja hi ha carregades a la pantalla). Un cop confirmat l'enviament del lot,
**la pantalla no espera la resposta ni mostra el resultat de cada factura**: només confirma que
s'han afegit a la cua i recarrega la pàgina. Cada factura del lot es processa una darrere l'altra
(no totes alhora), i el seu estat es va actualitzant a la llista — però **cal refrescar la pàgina
manualment per veure-ho**, no s'actualitza sola. Si es vol conèixer el resultat concret (acceptada,
rebutjada, amb quin error) de cada factura del lot, cal obrir-la individualment un cop processada,
igual que amb qualsevol altra factura.

**Nota important sobre el ritme d'enviament**: tot i que l'objectiu del disseny és no saturar
l'AEAT, avui dia les factures d'un lot s'envien una darrere l'altra tan de pressa com l'AEAT va
responent, sense cap pausa forçada entre elles. Si un usuari pregunta per què un lot gran "es
dispara de cop" en lloc de anar espaiat, aquesta n'és la raó — és un comportament real i no un
malfuncionament.

### On trobar les factures rebutjades

No hi ha una pantalla separada de "rebutjades". La llista general de factures ja les posa sempre
primer de tot (per davant fins i tot dels esborranys), amb una capçalera pròpia "Rebutjades
pendents (N)" quan n'hi ha, i també es poden aïllar amb el filtre d'estat de la mateixa llista.