Fatturazione
Piani e limiti, consumi e soglie, upgrade e downgrade, metodi di pagamento, dati fiscali italiani con SDI e PEC, scadenze, sospensione e disdetta.
L'area Fatturazione raccoglie piano, consumi, metodi di pagamento e documenti fiscali del tenant. I pagamenti sono gestiti tramite Stripe; le fatture sono emesse secondo la normativa italiana e trasmesse al Sistema di Interscambio.
Prima di iniziare
- Permesso billing:subscription:read per consultare piano e consumi
- Permesso billing:subscription:write per cambiare piano
- Dati di fatturazione completi e validati
Piani e limiti
| Elemento | Starter | Business | Enterprise |
|---|---|---|---|
| Conversazioni incluse / mese | 1.000 | 10.000 | Secondo contratto |
| Utenti inclusi | 3 | 15 | Personalizzato |
| Progetti | 1 | 10 | Illimitati |
| Storage knowledge base | 2 GB | 50 GB | Personalizzato |
| Classificazione documenti | Non inclusa | 5.000 documenti / mese | Personalizzato |
| Canali | Widget | Widget, WhatsApp, email, API | Tutti |
| SSO | No | No | Sì |
| Ruoli personalizzati | No | Fino a 10 | Illimitati |
| Conservazione dati | 6 mesi | 24 mesi | Personalizzata |
| Assistenza | Email e telefono, orario ufficio | Dedicata, con SLA contrattuali |
Superamento delle soglie
Le conversazioni oltre il pacchetto incluso sono fatturate a consumo secondo il listino del piano. Il servizio non si interrompe al superamento: ricevi un avviso e l'eccedenza compare nella fattura del mese.
Consumi
| Voce | Unità di misura | Come si conteggia |
|---|---|---|
| Conversazioni | Sessioni avviate | Una sessione conta una volta, indipendentemente dai messaggi |
| Token AI | Migliaia di token | Somma di input e output di tutti i modelli usati |
| Storage | GB medi mensili | Documenti, allegati e indici della knowledge base |
| Documenti classificati | Documenti elaborati | Le riclassificazioni non sono riconteggiate |
| Utenti | Posti occupati | Utenti attivi più inviti pendenti, rilevati a fine periodo |
| Messaggi WhatsApp | Conversazioni WhatsApp | Tariffate secondo il listino Meta, riaddebitate al costo |
Il periodo di fatturazione è mensile e coincide con il giorno di attivazione del tenant. I contatori si azzerano all'inizio di ogni periodo.
Soglie e avvisi
Imposta le soglie
Definisci una o più soglie percentuali sul pacchetto incluso, ad esempio 70%, 90% e 100%. Puoi impostare soglie diverse per conversazioni, token, storage e documenti.
Scegli i destinatari
Indica gli indirizzi email che riceveranno l'avviso. Consigliato includere sia il referente tecnico sia quello amministrativo.
Attiva il tetto di spesa
Con Limite di spesa mensile definisci un importo massimo per l'eccedenza. Al raggiungimento puoi scegliere se ricevere solo un avviso oppure sospendere le nuove conversazioni fino al periodo successivo.
Il tetto di spesa blocca il servizio
Se scegli la sospensione automatica, al raggiungimento del limite l'assistente smette di rispondere ai nuovi visitatori. Valuta questa opzione solo se il controllo di budget è prioritario rispetto alla continuità del servizio.
Cambiare piano
L'attivazione è immediata. La differenza di prezzo è calcolata in proporzione ai giorni residui del periodo in corso e addebitata subito sul metodo di pagamento predefinito. Limiti e funzionalità del nuovo piano sono disponibili senza attese.
Metodi di pagamento
| Metodo | Disponibilità | Note |
|---|---|---|
| Carta di credito o debito | Tutti i piani | Circuiti Visa, Mastercard, American Express |
| Addebito SEPA | Business, Enterprise | Mandato SDD, addebito entro 5 giorni lavorativi |
| Bonifico bancario | Enterprise | Pagamento a 30 giorni data fattura, su accordo contrattuale |
I dati della carta non transitano mai dai sistemi Blu Pantheon: sono raccolti direttamente da Stripe tramite un modulo sicuro conforme allo standard PCI DSS. Le operazioni con carte europee richiedono l'autenticazione forte del cliente (SCA).
Metodo di riserva
Aggiungi un secondo metodo di pagamento e impostalo come riserva. In caso di carta scaduta o rifiutata, l'addebito viene tentato automaticamente sul metodo alternativo, evitando la sospensione del servizio.
Dati di fatturazione
Profilo di fatturazione
| Parametro | Tipo | Obblig. | Default | Descrizione |
|---|---|---|---|---|
ragioneSociale | string | Sì | — | Denominazione esatta come da visura camerale. Per i liberi professionisti, nome e cognome. |
partitaIva | string | Sì | — | P.IVA italiana a 11 cifre, con prefisso IT per le operazioni intracomunitarie. Verificata con algoritmo di controllo. |
codiceFiscale | string | Sì | — | Codice fiscale dell’azienda (11 cifre) o del titolare (16 caratteri). Obbligatorio per la fatturazione elettronica. |
indirizzoSedeLegale | oggetto | Sì | — | Via, numero civico, CAP a 5 cifre, comune, sigla provincia, nazione ISO 3166-1 alpha-2. |
codiceDestinatarioSdi | string | No | — | Codice a 7 caratteri alfanumerici del canale di ricezione SDI. Alternativo alla PEC. |
pec | string | No | — | Indirizzo PEC per la ricezione delle fatture elettroniche. Alternativo al Codice Destinatario. |
codiceUnivocoUfficio | string | No | — | Codice IPA a 6 caratteri, obbligatorio per le pubbliche amministrazioni. |
splitPayment | booleano | No | false | Scissione dei pagamenti ex art. 17-ter DPR 633/72, applicabile alle pubbliche amministrazioni. |
cig | string | No | — | Codice Identificativo Gara, da riportare in fattura per gli appalti pubblici. |
cup | string | No | — | Codice Unico di Progetto, richiesto per gli interventi di investimento pubblico. |
riferimentoAmministrazione | string | No | — | Riferimento interno del cliente da riportare in fattura, ad esempio un numero di ordine. |
emailAmministrativa | string | Sì | — | Indirizzo a cui inviare copia di cortesia delle fatture e gli avvisi di pagamento. |
Esempio di Codice Destinatario SDI
ABC1234Sette caratteri alfanumerici forniti dal tuo intermediario o dal software gestionale.
Codice Destinatario SDI o PEC: uno è obbligatorio
Per emettere la fattura elettronica devi indicare almeno uno tra Codice Destinatario SDI (7
caratteri) e PEC. Se non fornisci nessuno dei due, il Codice Destinatario viene valorizzato
con 0000000 e la fattura sarà recapitata esclusivamente nel tuo cassetto fiscale
sull'Agenzia delle Entrate: dovrai scaricarla manualmente. Verifica il codice con il tuo
commercialista prima di salvarlo: un codice errato causa lo scarto della fattura da parte del SDI.
Pubbliche amministrazioni
Se sei un ente pubblico, compila Codice Univoco Ufficio (IPA, 6 caratteri), attiva Split payment e indica CIG e, se previsto, CUP. In regime di scissione dei pagamenti l'IVA non viene addebitata: la fattura riporta la dicitura "scissione dei pagamenti" e l'importo dovuto è il solo imponibile.
Fatture e ricevute
| Documento | Quando viene emesso | Formato |
|---|---|---|
| Fattura elettronica | Alla chiusura del periodo di fatturazione | XML trasmesso al SDI |
| Copia di cortesia | Contestualmente alla trasmissione | PDF scaricabile e inviato via email |
| Ricevuta di pagamento | All'incasso | PDF scaricabile |
| Nota di credito | In caso di storno o rimborso | XML al SDI più copia PDF |
Ogni documento riporta lo stato di trasmissione al SDI: In attesa, Consegnata, Mancata consegna (recapito nel cassetto fiscale), Scartata (con codice di errore).
/billing/v1/invoicesBearer JWTElenca le fatture del tenant con importo, stato di pagamento e stato SDI. Richiede
billing:invoices:read.
Scadenze e sospensione
| Giorno dalla scadenza | Evento |
|---|---|
| 0 | Primo tentativo di addebito |
| +3 | Secondo tentativo, avviso email al referente amministrativo |
| +7 | Terzo tentativo, avviso in-app a tutti gli amministratori |
| +14 | Sospensione del servizio: la Console resta accessibile in sola lettura, gli assistenti smettono di rispondere |
| +30 | Blocco completo, esportazione dati ancora disponibile su richiesta |
| +90 | Cancellazione definitiva dei dati del tenant |
Evitare la sospensione
Il servizio si riattiva entro pochi minuti dal saldo dell'insoluto. Per evitare la sospensione
mantieni un metodo di pagamento di riserva valido e verifica che l'indirizzo amministrativo
non filtri i messaggi provenienti da no-reply@blupantheon.com.
Disdetta
Verifica il ruolo
Solo il Proprietario del tenant può disdire. Vedi Utenti e inviti per il trasferimento della proprietà.
Esporta i dati
Prima di confermare, esporta conversazioni, clienti, documenti e statistiche. Dopo il periodo di conservazione i dati non sono più recuperabili.
Conferma la disdetta
L'abbonamento resta attivo fino alla fine del periodo già pagato. Non sono previsti rimborsi per la frazione non utilizzata, salvo diverso accordo contrattuale.
Periodo di ripensamento
Nei 30 giorni successivi alla scadenza puoi riattivare l'abbonamento con dati e configurazioni intatti. Oltre i 90 giorni la cancellazione è definitiva.
Passi successivi
Autenticazione e sicurezza
Politica delle password, blocco account, MFA obbligatoria, durata delle sessioni, SSO e gestione completa delle chiavi API con rotazione.
Audit log
Registro immutabile delle azioni nel tenant — eventi tracciati, struttura di un record, filtri, esportazione per ispezioni e conservazione.