Documentazione KSIDol > Moduli KSIDol > PropalQR

Guida del modulo: PropalQR

Guida d'uso non tecnica: a cosa serve il modulo, come utilizzarlo e come si integra con Dolibarr.

Firma del clienteIn 1 scansione

Posizioni del QRScheda, PDF, e-mail

Colori d'accento6 tonalità

Pagine del PDF interessate1ª, tutte o ultima

1. Panoramica del modulo

PropalQR ("Firma del preventivo tramite QR code") aggiunge un QR code accanto al link di firma online dei tuoi preventivi (proposte commerciali) Dolibarr. In pratica, il cliente non deve più ricopiare un indirizzo né cercare un link in un'e-mail: inquadra il QR code con la fotocamera del telefono e arriva direttamente alla pagina di firma online del preventivo. È una scorciatoia che accelera l'accettazione di un preventivo, in particolare durante un appuntamento o alla consegna di un documento cartaceo. Il modulo non crea alcun nuovo dato e non sostituisce nulla: si basa interamente sugli oggetti nativi di Dolibarr. Il QR code si limita a codificare l'URL di firma online che Dolibarr fornisce già per la proposta. Funziona quindi là dove il tuo preventivo vive già: sulla scheda della proposta, nel PDF generato e nelle e-mail inviate da Dolibarr.

Trasforma il link di firma online di un preventivo in un QR code che il cliente inquadra per firmare
Compare automaticamente sulla scheda della proposta, accanto al link esistente
Può essere aggiunto al PDF del preventivo e inserito nei modelli di e-mail
Si basa solo sulla firma online nativa di Dolibarr: non viene esposto nulla di più del link già trasmesso al cliente
Nessuna configurazione obbligatoria: il modulo sceglie impostazioni adeguate per impostazione predefinita

2. QR code sulla scheda della proposta

Sulla schermata di un preventivo, il modulo aggiunge un riquadro "QR code di firma online" sotto le informazioni della proposta, accanto al link di firma già presente.

Mostra un blocco contenente il titolo, il link pubblico di firma (cliccabile) e l'immagine del QR code
Il QR code codifica l'indirizzo della pagina di firma online del preventivo
Il riquadro compare solo nella visualizzazione normale del preventivo (non durante la preparazione di un'e-mail), per non rallentare le schermate
Il collaboratore può far inquadrare il codice direttamente sullo schermo dal cliente presente

3. QR code sul PDF della proposta

Quando Dolibarr genera il PDF di un preventivo, il modulo vi aggiunge un blocco con il QR code di firma, pratico per un preventivo stampato o inviato come allegato.

Aggiunge il QR code al PDF del preventivo prodotto da Dolibarr (il link per esteso non viene ripetuto sul PDF)
La posizione del blocco (coordinate X e Y, in millimetri) è regolabile nella configurazione
Il colore del QR code e del suo titolo segue la tonalità d'accento scelta
Scegli su quali pagine compare: solo la prima, tutte, o solo l'ultima
Il cliente inquadra il QR code del documento cartaceo o PDF per aprire la firma online sul proprio telefono

4. QR code e link nelle e-mail

Il modulo mette a disposizione due "campi di unione" (sostituzioni) che puoi inserire nei tuoi modelli di e-mail Dolibarr per integrare il QR code o il link di firma.

__PROPAL_SIGNATURE_QRCODE__: inserisce l'immagine del QR code nel corpo dell'e-mail
__PROPAL_SIGNATURE_QRCODE_URL__: inserisce il link pubblico di firma (utile se il cliente blocca la visualizzazione delle immagini)
L'immagine del QR code viene prodotta su richiesta, per non rallentare l'apertura del modulo "Invia un'e-mail"
Questi campi si inseriscono nei modelli di e-mail, come le altre variabili di Dolibarr

5. Configurazione del modulo

Il modulo aggiunge una voce "Propal QR" nel menu e una pagina di impostazioni. Nessuna impostazione è obbligatoria: i valori predefiniti vanno bene nella maggior parte dei casi.

Posizione del QR sul PDF: coordinate X (dal bordo sinistro) e Y (dall'alto), in millimetri; lasciando vuoto si mantiene il posizionamento automatico
Anteprima visiva: un mock-up di pagina (esemplare del modello Cyan) mostra in tempo reale dove cadrà il QR code mentre regoli X e Y
Colore d'accento: 6 tonalità proposte (Nero inchiostro, Blu oceano, Verde smeraldo, Viola, Arancione ambra, Rosso carminio)
Visualizzazione del QR sul PDF: solo prima pagina, tutte le pagine, o solo ultima pagina
Pulsanti "Salva" e "Ripristina la posizione predefinita" per tornare alle impostazioni originali

6. Condizioni di visualizzazione del QR code

Il QR code compare solo quando la firma ha senso, per evitare di proporre un link inattivo.

La firma online delle proposte deve essere attivata in Dolibarr
La proposta non deve più essere in stato bozza (il preventivo deve essere convalidato)
Se queste condizioni non sono soddisfatte, nessun blocco QR viene mostrato né aggiunto al PDF
Il modulo gestisce gli ambienti multi-società (multi-entità) per calcolare il corretto indirizzo pubblico

7. Collegamenti con Dolibarr

Il modulo non funziona in modo isolato: si integra con i blocchi nativi di Dolibarr.

Proposte commerciali (preventivi) : Il modulo dipende dal modulo nativo Proposte commerciali: il blocco QR viene aggiunto sulla scheda del preventivo e sul suo PDF, senza modificare la struttura delle proposte.
Firma online di Dolibarr : Il QR code codifica l'URL di firma online fornito da Dolibarr. È quindi necessario che la firma online delle proposte sia attivata. Il modulo non espone nulla di più di questo link pubblico già trasmesso al cliente.
Generazione dei PDF : Il modulo si inserisce nella generazione PDF nativa (modelli di proposte) per collocarvi il blocco QR, nella posizione e sulle pagine che scegli.
Modelli di e-mail (sostituzioni) : Fornisce due variabili di unione (__PROPAL_SIGNATURE_QRCODE__ e __PROPAL_SIGNATURE_QRCODE_URL__) riutilizzabili nei modelli di e-mail Dolibarr, come gli altri campi standard.
Clienti / terzi destinatari : È il cliente destinatario del preventivo che inquadra il QR code per firmare online; il modulo facilita questo percorso senza creare alcuna scheda o dato aggiuntivo.
Stato del documento : Il comportamento segue lo stato nativo della proposta: il QR viene proposto solo per un preventivo convalidato (mai per una bozza).