## id doc_personalitzar_plantilla_factura ## nom Personalitzar la plantilla del PDF — comportaments i casos concrets ## descripcio Consulta aquest document quan calgui explicar amb precisió el catàleg de camps disponibles a la plantilla, com s'assigna una plantilla a una empresa/activitat, per què alguns controls antics de la pantalla no fan res, o per què un idioma diferent no es tradueix sol al PDF. No és l'explicació general, que cobreix `flux_personalitzar_plantilla_factura`. ## contingut ### Catàleg de camps disponibles La mateixa pantalla mostra la llista completa (desplegable "Camps disponibles"), amb les marques de posició agrupades per bloc: dades generals de la factura (número, data, nom de l'activitat...), dades de l'empresa (nom, adreça, NIF, codi de verificació de l'AEAT), dades del client, un bloc repetible per a les línies de la factura, un altre repetible per als impostos, i un altre per als cobraments ja registrats. També hi ha el logo i el codi QR de VeriFactu, tots dos com a imatges ja preparades — només cal col·locar la marca corresponent perquè surtin. Hi ha també dues marques especials, només vàlides a la Capçalera o el Peu (no al Cos), pensades per mostrar el número de pàgina i el total de pàgines — no formen part del catàleg normal de dades, són una convenció pròpia del motor que genera el PDF. ### Assignació d'una plantilla Cada plantilla es desa per a una empresa i una activitat concretes, i opcionalment restringida a un sol Tipus de Factura dins d'aquella activitat. Si dues plantilles de la mateixa empresa/activitat coincidissin, guanya la que estigui marcada Tipus de Factura concret per davant de la genèrica, i la marcada per defecte per davant de qualsevol altra. Hi ha també una plantilla de nivell d'aplicació (només editable per l'equip de FiskAppCloud) que actua com a últim recurs si una empresa no n'ha creat cap de pròpia. En crear una plantilla nova, sempre es parteix del contingut d'una altra plantilla ja existent com a punt de partida (mai una pàgina en blanc) — es pot triar quina. ### Controls antics que ja no fan res A la pantalla encara hi apareixen (o hi han aparegut en algun moment) referències a color principal, color secundari, i interruptors per mostrar/amagar logo, IBAN o QR. **Avui aquests controls no existeixen realment al formulari** — són vestigis d'una versió anterior de la pantalla. El comportament real i vigent és molt més senzill: **logo, QR i IBAN surten al PDF si i només si la seva marca de posició hi és present dins l'HTML de la plantilla** — no depenen de cap interruptor. Si un usuari busca un botó per "amagar el QR" i no el troba, la solució és treure la marca de posició corresponent de l'HTML directament. ### Multiidioma: no és automàtic per al text que s'escriu a mà Els noms de columna i etiquetes que ja venen incloses al catàleg de camps (per exemple "Total", "Concepte", "Quantitat") es tradueixen soles segons l'idioma de qui rep la factura, sempre que s'utilitzi la marca de posició corresponent en lloc d'escriure el text directament. **Qualsevol text que s'escrigui directament a l'HTML de la plantilla (no com a marca de posició) surt sempre en l'idioma en què s'ha escrit, per a totes les factures i tots els clients** — no hi ha manera de tenir una plantilla diferent per idioma; és una sola plantilla que serveix per a tots. Si una empresa factura clients en diversos idiomes i vol un peu de pàgina traduït, ha d'evitar escriure'l directament i fer servir només marques de posició per a qualsevol text que hagi de canviar d'idioma. ### Previsualitzar amb una activitat sense factures encara La previsualització sempre agafa la factura real més recent de l'activitat seleccionada — si aquella activitat encara no té cap factura (per exemple, és nova), no hi ha res per previsualitzar i l'aplicació ho indica així. No hi ha manera de previsualitzar amb dades d'exemple. ### Errors a la plantilla: efecte diferent segons on s'utilitzi Si la plantilla desada té un error a la sintaxi de les marques de posició: - **Descàrrega manual del PDF des de la factura**: falla directament, l'usuari no pot obtenir el PDF fins que es corregeixi la plantilla. - **Enviament automàtic per email en validar una factura**: l'enviament del PDF falla en silenci — no es mostra cap error a la pantalla de validació (que depèn només de la resposta de l'AEAT, no d'això), i l'única traça queda als registres interns de l'aplicació. Si un client es queixa que no li ha arribat el PDF per correu, val la pena revisar si la plantilla activa d'aquella activitat s'ha tocat recentment. En cap dels dos casos hi ha un mecanisme automàtic que torni a un disseny anterior o a la plantilla genèrica si la triada falla — només passa a la plantilla genèrica quan **no hi ha absolutament cap plantilla assignada** (ni pròpia ni de nivell d'aplicació), un cas que no hauria de donar-se mai en condicions normals.