Portale clienti e condivisione

Il portale clienti è il lato di Invotify rivolto ai suoi clienti — tutto ciò che il cliente vede e fa senza mai creare un account. Lei genera un link di condivisione sicuro, lo invia al cliente, e questi ottiene una pagina pulita e personalizzata con il suo marchio dove può leggere la fattura, scaricare il PDF e (su Pro) pagare online. Nel frattempo, lei riceve una registrazione discreta di quando e da dove l’ha aperta.

Che cosa fa il portale:

• Visualizzazione pubblica della fattura — Un link basato su token apre la fattura nel browser. Nessun login, nessuna password, nessun attrito per il cliente.
• Download del PDF — Il cliente scarica con un clic un PDF A4 della sua fattura, fedele al pixel.
• Pagamento online (Pro) — Un pulsante "Paga ora" (Pay Now) porta il cliente a un checkout Stripe sicuro per un pagamento totale o parziale.
• Tracciamento delle visualizzazioni — Ogni apertura viene registrata: quando, da dove, numero di visualizzazioni e data/ora della prima e dell’ultima.
• Preferenze e-mail — Annullamento dell’iscrizione con un clic e controllo granulare su quali e-mail il cliente riceve.

Due tipi di link:

• Link a fattura singola (/invoice/{token}) — Mostra una fattura specifica con tutti i suoi dettagli e un’azione di download/pagamento.
• Link al portale cliente (/portal/{token}) — Una vista unificata delle fatture recenti del cliente, del suo saldo totale residuo, di un eventuale indicatore di scaduto e del saldo delle note di credito, con un’azione di pagamento per ciascuna fattura.

Piani: Visualizzazione pubblica, download del PDF, tracciamento delle visualizzazioni e gestione delle preferenze e-mail sono disponibili su ogni piano. Il pagamento online dal portale richiede un piano Pro con Stripe collegato.

Ogni pagina del portale è personalizzata con il nome e il logo della sua attività, riporta una discreta dicitura "Powered by Invotify" a piè di pagina ed è contrassegnata noindex, così non compare mai nei motori di ricerca.

Condividere una fattura crea un token di condivisione unico e difficile da indovinare e lo trasforma in un link pubblico che il suo cliente può aprire senza effettuare l’accesso. Il token è un UUID casuale — non può essere indovinato incrementando un numero — e corrisponde a una sola fattura.

Come funziona il token di condivisione:

• La generazione di un link crea uno share_token per la fattura e restituisce un URL nella forma https://your-app/invoice/{token}.
• Se per quella fattura esiste già un token, Invotify restituisce lo stesso — condividere di nuovo non cambia il link né rompe un URL già inviato.
• Il link è l’unica credenziale. Chiunque lo possieda può visualizzare la fattura, quindi lo tratti come un link privato.
• Può revocare un link di condivisione in qualsiasi momento. La revoca cancella il token e il vecchio URL smette immediatamente di funzionare (restituisce "non trovato" (not found)). Generi un nuovo link per condividere di nuovo.

Autorizzazioni: Generare o revocare un link di condivisione richiede l’autorizzazione "Gestione fatture" (Manage invoices), così solo i membri del team autorizzati possono esporre una fattura.

Che cosa riceve il cliente: Quando invia una fattura via e-mail, il link (e su Pro, un link di pagamento) può accompagnarla. Può anche copiare l’URL di condivisione e inviarlo attraverso qualsiasi canale — chat, il suo client di posta, un’app di messaggistica.

Condividere il PDF su WhatsApp, Telegram, Slack e simili: La finestra di condivisione su fatture e preventivi consegna il PDF renderizzato direttamente al pannello di condivisione del suo dispositivo (su telefoni, tablet e browser desktop moderni). Tocchi WhatsApp, Telegram, Slack o Messenger e il PDF è già allegato — scelga il destinatario e invii. Sui browser senza supporto ai file nel pannello di condivisione, Invotify ripiega sul download del PDF e sull’apertura dell’app, così può allegarlo manualmente.

Quando un cliente apre un link di condivisione, arriva su una pagina pulita e adatta ai dispositivi mobili che non richiede alcun login. Esistono due esperienze, a seconda del link.

Pagina della fattura singola (`/invoice/{token}`): Il cliente vede la fattura completa — il nome e il logo della sua attività, il numero e lo stato della fattura, le date di emissione e di scadenza, i dati di fatturazione, ogni voce con quantità e totali, e le eventuali note da lei aggiunte. In fondo ci sono le azioni: - Scarica PDF (Download PDF) — Genera e scarica un PDF A4 professionale, identico a quello che lei invierebbe. Generato lato server su richiesta. - Paga ora (Pay Now) — Compare solo quando è disponibile un link di pagamento e la fattura non è già pagata o annullata (Pro — vedere "Pagamento online" più avanti).

Pagina del portale unificato (`/portal/{token}`): Una panoramica in stile dashboard per il cliente su tutte le sue fatture con lei: - Saldo residuo — Il totale ancora dovuto su tutte le fatture non pagate (non solo quella su cui ha fatto clic), con un indicatore di scaduto se qualcuna ha superato la scadenza. - Saldo delle note di credito — Qualsiasi credito emesso o applicato di cui dispone. - Elenco fatture — Le sue fatture recenti non in bozza, con paginazione, ciascuna con numero, date, stato, importo e un’azione di pagamento.

Privacy by design: Il portale restituisce sempre e solo un sottoinsieme sicuro di dati. Gli ID interni, il token di condivisione stesso e tutto ciò che non riguarda quel cliente vengono rimossi dalla risposta. Il portale unificato è rigorosamente limitato all’unico cliente a cui appartiene il token. Le risposte del portale vengono inviate con caching no-store, così nulla di sensibile viene memorizzato dagli intermediari.

Con un piano Pro e Stripe collegato, il portale trasforma una visualizzazione in un pagamento. Il cliente fa clic su "Paga ora" (Pay Now) e arriva sul checkout sicuro ospitato da Stripe — Invotify non tocca mai i dati della sua carta.

Come si svolge un pagamento dal portale: 1. Il cliente apre la sua fattura o il portale unificato e fa clic su Paga (Pay). 2. Invotify crea una sessione Stripe Checkout per quella fattura e vi reindirizza il cliente. 3. Il cliente paga sulla pagina ospitata di Stripe. La sua e-mail è precompilata per un checkout più rapido. 4. In caso di successo viene riportato a una pagina di conferma; se annulla, rientra senza intoppi. 5. Stripe conferma il pagamento e lo stato della fattura passa automaticamente a Pagata (Paid).

Pagamenti totali o parziali: - Per impostazione predefinita il cliente paga l’intero saldo residuo (l’importo dovuto, non solo il totale originale — quindi gli eventuali pagamenti parziali precedenti vengono considerati). - Se ha attivato i pagamenti parziali sulla fattura, il cliente può pagare un importo inferiore. Invotify applica l’eventuale importo minimo di pagamento da lei impostato e non consente mai al cliente di pagare più di quanto ancora dovuto.

Tutele integrate: - Le fatture già pagate o annullate non possono essere pagate di nuovo — il pulsante di pagamento viene nascosto e la richiesta è rifiutata lato server. - L’endpoint di pagamento del portale è soggetto a limitazione della frequenza per prevenire abusi. - L’importo del pagamento viene convalidato rispetto al saldo residuo in tempo reale e all’addebito minimo di Stripe prima della creazione di una sessione.

Importante: Il pagamento online richiede un piano Pro e un account Stripe collegato. Senza Stripe collegato, il portale funziona comunque per visualizzare e scaricare — semplicemente non c’è il pulsante di pagamento.

Smetta di chiedersi se il suo cliente ha davvero aperto la fattura. Ogni volta che una fattura condivisa viene visualizzata, Invotify lo registra — così sa esattamente quando l’ha vista, quante volte e da dove.

Che cosa viene registrato a ogni visualizzazione: - Data e ora — Quando è avvenuta la visualizzazione. - Origine — Da dove proviene la visualizzazione: link (un link condiviso a fattura singola), email, portal o api. Il valore predefinito è link. - IP del visitatore — L’indirizzo IP del cliente (estratto dall’header di inoltro), così può distinguere le aperture ripetute dallo stesso luogo da quelle nuove. - User-agent — La stringa del browser/dispositivo, troncata a una lunghezza sicura.

Statistiche aggregate che Invotify mantiene per fattura: - Numero di visualizzazioni — Il totale progressivo delle aperture. - Prima visualizzazione — Esattamente quando la fattura è stata aperta per la prima volta (registrata una sola volta, mai sovrascritta). - Ultima visualizzazione — L’apertura più recente. - IP unici — Quanti indirizzi IP distinti l’hanno visualizzata.

Dove le vede: Le statistiche di visualizzazione della fattura compaiono nella pagina di dettaglio della fattura — un badge compatto mostra il numero di visualizzazioni, con le date/ore di prima e ultima visualizzazione al passaggio del mouse, e un indicatore in tempo reale quando la fattura è stata aperta di recente. Il registro completo delle visualizzazioni (ogni singola apertura con origine, IP e user-agent) è disponibile tramite i dati di visualizzazione della fattura, limitati alla sua azienda.

Protezione dagli abusi: L’endpoint di tracciamento è soggetto a limitazione della frequenza per IP e per token, così un singolo cliente che ricarica ripetutamente la pagina non può gonfiare il suo conteggio di visualizzazioni, e l’endpoint non può essere bombardato per alterare i numeri.

Ogni e-mail che Invotify invia a un cliente contiene un link per l’annullamento dell’iscrizione / le preferenze, così i clienti mantengono sempre il controllo su ciò che arriva nella loro casella. Il link funziona senza alcun login — il token di annullamento stesso dimostra la titolarità dell’indirizzo e-mail.

Che cosa possono controllare i clienti: - E-mail di documenti — Fatture, preventivi e altri documenti a loro inviati. - E-mail di promemoria — Solleciti per pagamenti scaduti e in scadenza. - E-mail di marketing — Eventuali messaggi promozionali o annunci.

Ogni categoria è un interruttore indipendente. Un cliente che desidera solo le fatture ma non i promemoria può avere esattamente questo — non è tutto-o-niente.

Annullamento dell’iscrizione con un clic: La pagina delle preferenze è la stessa raggiungibile dal link di annullamento in qualsiasi e-mail. I clienti possono disattivare una singola categoria, o rinunciare a tutto, in un unico posto. Le modifiche vengono salvate immediatamente e si applicano agli invii futuri.

Come rimane sicuro: - L’endpoint delle preferenze richiede un token valido (rifiutato se troppo corto o mancante), e quel token da solo autorizza la lettura e l’aggiornamento delle preferenze — nessun account necessario. - Vengono accettate solo le chiavi di preferenza note e consentite, e solo valori booleani, così l’endpoint non può essere forzato a modificare altro. - Letture e scritture sono soggette a limitazione della frequenza per IP.

Rispettare queste preferenze mantiene sana la sua reputazione di mittente e la tiene dalla parte giusta delle regole anti-spam — i clienti che hanno scelto di rinunciare smettono semplicemente di ricevere quella categoria.