En el desenvolupament de programari empresarial, la generació de factures en PDF a partir d’HTML és una necessitat recurrent. Tradicionalment, això implica integrar un navegador sense interfície gràfica com Chromium al backend, la qual cosa dispara la mida del contenidor, allarga els temps d’arrencada en fred i complica el desplegament en entorns serverless. A Q2BSTUDIO, com a empresa especialitzada en aplicacions a mida, hem vist com aquest enfocament pot convertir-se en un coll d’ampolla innecessari. Existeix una alternativa més neta: delegar la renderització a un servei extern que accepti una URL pública i retorni els bytes del PDF. D’aquesta manera, el navegador viu en una altra màquina i el teu backend només s’encarrega d’orquestrar la crida i emmagatzemar el resultat.
La idea és senzilla. Tens una plantilla HTML amb CSS que es veu perfectament al navegador del client. El comptable demana un PDF, però no vols carregar amb Chromium. Una API com SnapPDF exposa un únic endpoint GET al qual li passes la URL de la teva factura renderitzada i obtens el binari del PDF. Paràmetres com format, background o wait_for_selector permeten ajustar el resultat sense tocar el codi del backend. A Q2BSTUDIO recomanem aquest patró perquè s’alinea amb la nostra filosofia d’arquitectures lleugeres i escalables, ja sigui sobre cloud AWS/Azure o en infraestructura pròpia.
La implementació des de Node.js és directa amb fetch natiu. Construeixes la URL amb els paràmetres, fas la petició i llegeixes el cos com a ArrayBuffer. La resposta no és JSON, sinó application/pdf; un error retorna un JSON amb el camp error. És important validar que el contingut comenci amb %PDF-, perquè si la URL retorna una pàgina d’inici de sessió, obtindries l’HTML en lloc del PDF. També cal activar background=true per conservar colors de fons en CSS, cosa que Chromium desactiva per defecte en imprimir. Sense aquesta opció, les capçaleres de taula amb fons de color es tornarien il·legibles.
El flux de treball recomanat consisteix a generar una URL signada amb temps de vida curt (60 segons) quan la factura passa a estat finalitzat. Aquesta URL apunta a la vista HTML que ja mostres al client. Es passa al servei de PDF, i els bytes rebuts s’emmagatzemen en un bucket de S3 o contenidor d’Azure Blob, indexats per l’ID de factura. Així el PDF es converteix en un artefacte en memòria cau. Cada cop que algú el descarrega, no es torna a renderitzar, sinó que se serveix directament des de l’emmagatzematge. El teu equip de disseny segueix editant l’HTML com sempre, i el PDF es regenera automàticament quan sigui necessari.
Des de la perspectiva de negoci, aquest enfocament redueix costos operatius en eliminar la dependència d’un navegador a cada instància. Els desplegaments serverless deixen d’estar limitats per la mida del paquet, i els contenidors arrenquen en segons en lloc de minuts. A Q2BSTUDIO apliquem tècniques similars quan integrem IA per automatitzar processos de generació de documents, o quan afegim capes de ciberseguretat mitjançant URLs signades amb testimonis d’accés temporal. També és perfectament compatible amb solucions de BI/Power BI que necessiten incrustar PDFs generats dinàmicament en dashboards.
Hi ha detalls pràctics a tenir en compte. L’opció wait_for_selector és un intent de millor esforç: si el selector no apareix, obtindràs el PDF amb el que hagi carregat fins a aquell moment. Convé verificar visualment el resultat abans d’enviar-lo al client. El paràmetre scale està limitat entre 0.1 i 2.0 per Chromium; valors fora de rang s’ajusten silenciosament. Per a pàgines amb WebSockets o polling llarg, el servei espera que la xarxa s’estabilitzi abans d’imprimir, cosa que allarga la resposta. Les factures són estàtiques; els panells en temps real no ho són. Per això aquest patró funciona especialment bé per a documents transaccionals.
Un altre punt crític: la URL que envies ha de ser públicament accessible. El servei rebutja adreces loopback, privades o link-local. En desenvolupament local pots utilitzar un túnel com ngrok. En producció, una URL signada amb expiració de 60 segons ofereix la seguretat necessària. A Q2BSTUDIO solem combinar això amb automatització de processos mitjançant agents IA que orquestren tot el cicle: des de la confirmació de la comanda fins al lliurament del PDF per correu electrònic. Tot sense que el backend hagi d’executar un sol navegador.
En resum, generar factures PDF des d’HTML sense Chromium al teu backend és possible, eficient i escalable. Només necessites un servei extern, una URL accessible i una integració mínima. Aquesta arquitectura encaixa perfectament amb els principis de desenvolupament de Q2BSTUDIO, on prioritzem solucions modulars, segures i preparades per al núvol. El resultat: un sistema més lleuger, més ràpid i més fàcil de mantenir.
