## id
flux_personalitzar_plantilla_factura

## nom
Personalitzar la plantilla del PDF de factura

## descripcio_activacio
Fes servir quan l'usuari vulgui canviar el disseny del PDF de les seves factures, pregunti com
afegir el logo o el QR a la factura, per què el PDF li surt amb un disseny diferent del que esperava
segons l'activitat, o li falli la descàrrega/enviament del PDF just després de tocar la plantilla.

## relacionats
- flux_crear_factura_manual
- flux_validar_enviar_factura

## explicacio
Configuració → Documents (només visible per a usuaris amb rol d'administrador de l'empresa).

**No és un editor visual (WYSIWYG)**: és un editor de codi HTML en brut, amb tres blocs separats —
Capçalera (es repeteix a cada pàgina), Cos (el contingut principal, no es repeteix) i Peu (es
repeteix a cada pàgina). Dins d'aquest HTML es col·loquen unes marques de posició amb una sintaxi
pròpia (per exemple `{{ empresa.nom }}`, `{{ client.nom }}`, o un bucle per a les línies de la
factura) — la mateixa pantalla mostra la llista completa de camps disponibles per copiar-los.

**Cap element és obligatori per si sol**: el logo, el codi QR de VeriFactu i l'IBAN només surten al
PDF si la marca de posició corresponent hi és present a l'HTML — si algú l'esborra sense voler,
desapareix del PDF sense cap avís.

Un cop desada, la plantilla s'assigna a una combinació d'empresa + activitat (i, opcionalment, un
Tipus de Factura concret dins d'aquella activitat). Es poden tenir diverses plantilles amb noms
diferents per a la mateixa activitat; una d'elles queda marcada com la que s'utilitza per defecte.
Si mai s'esborra la que estava marcada per defecte, se'n marca automàticament una altra sola.

**Previsualitzar** genera el PDF real amb l'última factura de veritat d'aquella activitat — **si
l'activitat encara no té cap factura, no es pot previsualitzar res**.

Un cop desada i marcada com a plantilla activa, s'utilitza exactament igual tant si es descarrega
la factura manualment com si s'envia automàticament per correu en validar-se — és el mateix
mecanisme de generació en tots dos casos, no n'hi ha un de diferent per a la previsualització.

**Avís important**: si es desa una plantilla amb un error a la sintaxi de les marques de posició,
l'efecte és diferent segons com s'utilitzi després: la descàrrega manual del PDF deixa de funcionar
del tot per a aquella factura (error), mentre que l'enviament automàtic per correu en validar
simplement no arriba a enviar el PDF, sense cap avís visible enlloc — només queda registrat
internament. Si un usuari es queixa que "no li arriba el PDF per correu" just després d'haver
tocat la plantilla, revisar-la és el primer pas.

Per al detall del catàleg de camps disponibles, i de casos concrets com el multiidioma o els
controls antics que ja no fan res a la pantalla, vegeu `doc_personalitzar_plantilla_factura`.
