Veendo genera PDF professionali di ordini e preventivi on-demand. I PDF si creano in background, vengono salvati su AWS S3 e notificati al cliente via email e notifiche in-app.
Generazione PDF on-demand
Quando richiedi il PDF di un ordine o di un preventivo, il sistema pubblica un task SNS verso veendo-task, che legge il documento da MongoDB, genera l'HTML dal template Handlebars, lo converte a PDF tramite DocuEngine (bridge HTTPS), e salva il file su S3 nel bucket attachment del tenant.
Il percorso S3 è `{tenantCode}/docs/{documentId}.pdf`. Il documento viene aggiornato con i riferimenti al PDF (chiave S3, bucket, data di generazione, dimensione) e il cliente riceve una notifica in-app quando il PDF è pronto.
- Generazione asincrona via SNS e background task
- Salvataggio su AWS S3 nel bucket del tenant
- Template Handlebars per layout personalizzato
- Notifica in-app e email al cliente quando PDF pronto
Download e accesso ai PDF
I PDF di ordini e preventivi sono scaricabili in due modalità: da cliente loggato (accesso autenticato) o via link pubblico univoco. Ogni documento ha un `publicToken` che permette il download senza login. I link pubblici hanno preautorizzazione S3 temporanea (pre-signed URL) con scadenza.
Dal pannello admin puoi scaricare qualunque PDF; il cliente vede il pulsante download solo se il PDF è stato generato.
- Download autenticato: cliente loggato accede istantaneamente
- Download pubblico: link univoco con token, nessun login richiesto
- Pre-signed URLs di AWS S3 con scadenza temporale
- Pulsante download disponibile solo se PDF generato
Branding e personalizzazione PDF
Il template PDF (Handlebars) estrae i dati dal documento (ordine/preventivo) e dal setup del tenant: nome azienda, logo, indirizzo, messaggi custom, colori tema. Il setup include anche informazioni di fatturazione opzionali (numero registrazione, partita IVA, dati IBAN) che compaiono nel PDF.
Ogni tenant ha il proprio template locale in veendo-task, permettendo customizzazioni deep. Per personalizzazioni specifiche, contatta il team Veendo per override del template.
- Template Handlebars con dati dinamici da ordine e setup
- Logo, colori e nome azienda dal branding setup
- Informazioni fiscali e IBAN opzionali nel PDF
- Custom template per tenant su richiesta
Sicurezza e storage
I PDF sono salvati su S3 in un bucket privato del tenant, con isolamento dati per sicurezza. L'accesso è gestito tramite pre-signed URLs con scadenza (default 7 giorni) o autenticazione diretta tramite API. Non ci sono costi aggiuntivi di storage S3: il bucket è incluso nell'infrastruttura Veendo.
I PDF sono tracciati nei log di accesso per audit: chi ha scaricato cosa e quando. I file non vengono mai eliminati automaticamente, permettendo ricerca storica e ricomposizione di documenti.
I PDF rimangono disponibili indefinitamente su S3 per ricerche storiche e audit.