> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mattone.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Servizi, saldo a favore, dati fiscali e fatture

> Come funziona la fatturazione degli studenti da ottobre 2026: un cliente Stripe e una carta per studente, una fattura per servizio, crediti inclusi per listing, add-on, saldo a favore, dati fiscali e fatture dei bonifici. Dove si fa ogni cosa.

Da ottobre 2026 la regola è semplice: **uno studente = un cliente Stripe di Mattone.co LLC = una carta**, e **ogni addebito ha la sua fattura**, una per servizio. Lo studente le trova tutte in **Amministrazione → Le tue fatture**; il team le vede dalla sua scheda in **Studenti**.

## Una carta, una fattura per servizio

| Servizio | Come si fattura |
| - | - |
| **Servizio AI Ospiti — canone** | Abbonamento mensile sui **listing realmente attivi** nel ciclo, anticipato dalla data di attivazione, senza pro-rata. Il numero di listing scritto nel contratto è solo un controllo |
| **Servizio AI Ospiti — crediti oltre gli inclusi** | Fattura a sé per ogni ciclo Conduit chiuso, con il calcolo scritto |
| **CRM** | Abbonamento dedicato, fattura a parte. In fattura si chiama «CRM Mattone» |
| **WhatsApp e altri add-on** | Abbonamento dedicato per ciascuno, fattura a parte |
| **Rate del programma pagate con bonifico** | Fattura già pagata, emessa in automatico (vedi sotto) |

Tutte le fatture escono da Stripe con l'intestazione di Mattone.co LLC e la numerazione delle fatture Mattone (prefisso INV, ripartita dal 48). Per i clienti italiani con P.IVA e per quelli UE la fattura porta la nota di inversione contabile.

> [!NOTE]
>
> **La fattura non si carica più.** Basta il contratto: ogni rata e ogni servizio pagato genera da solo la sua fattura Stripe. Il bottone **Carica fattura storica** resta solo per le vecchie fatture dei bonifici, emesse prima del passaggio.

## Crediti AI inclusi ed extra

* **40 crediti inclusi** ogni mese per ogni listing attivo, compresi nel canone.
* Oltre gli inclusi, **€0,07 a credito**, in una fattura separata per ciclo (il ciclo è quello di Conduit, non il mese solare).
* Chi ha firmato le condizioni precedenti (**v1**) paga i crediti extra **al costo del fornitore**, finché non accetta per iscritto le condizioni **v2**. In **Studenti → scheda → Servizi e abbonamento** si segna con **Segna condizioni v2 accettate…** (e si torna indietro con **Riporta a v1…**).
* WhatsApp, SMS e chiamate vocali **non** sono crediti: restano al costo del provider, con fattura separata.
* Esenzione e omaggio non pagano i crediti extra.

## Aggiungere un servizio o un add-on

Ci sono due strade, che portano allo stesso risultato.

**Da Incassi**

1. **Incassi** → clic sul nome dello studente → **+ Servizio**.
2. Scegli **WhatsApp**, **CRM** o **altro** (nome libero), il canone mensile e una nota (per esempio «accettato in call il 23/10»).
3. **Aggiungi (in attesa)**: il servizio nasce in piattaforma, **senza addebito**. La riga diventa **Servizio in attesa**.
4. Quando è il momento, **Aggancia** → anteprima del primo addebito → **Aggancia e addebita**.

**Dalla scheda dello studente**

1. **Studenti** → riga dello studente → **Servizi e abbonamento** → **CRM e add-on**.
2. **Add-on (importo libero)**: nome e importo → **+ Accendi voce**. Anche qui accendere **non addebita**.
3. **Aggancia a Stripe…** → anteprima → conferma. Per chiudere un servizio: **Chiudi…**.

Ogni servizio è un abbonamento separato **sulla stessa carta**, con le sue fatture. WhatsApp può essere attivo (o in attesa) **una sola volta** per studente. Il CRM si può avviare anche **con decorrenza futura** dalla sezione Saldo (**CRM con decorrenza**). I prezzi di CRM e WhatsApp sono scritti in fondo alla scheda Incassi, sotto «Come si calcola».

## Saldo a favore

Il **saldo a favore** è un importo in euro che lo studente ha «in cassa» con noi: le fatture lo consumano **prima** di toccare la carta. Vale per tutte le fatture (canone, crediti, CRM, add-on).

**1. Apri la sezione Saldo**

**Studenti** → scheda → **Servizi e abbonamento** → **Saldo**.

**2. Scegli il movimento**

**+ Aggiungi al saldo** o **− Togli dal saldo**, con la causale: Omaggio, Pagamento in più, Doppio addebito, Rimborso (errore nostro), Prepagato, Correzione.

**3. Scrivi il motivo**

È **obbligatorio** e **lo vede anche lo studente**: scrivilo come lo leggerebbe lui.

**4. Anteprima e conferma**

**Anteprima** → **Conferma e scrivi su Stripe**. Il movimento resta tracciato (causale, motivo, chi, quando).

* Serve una **carta salvata** per ogni movimento: se manca, dalla stessa sezione si manda la mail **«salva la carta»** (con **Prova a me** per vederla prima).
* Lo studente vede **«Saldo a tuo favore»** e i movimenti in **I tuoi servizi attivi**; ogni fattura pagata con il saldo lo dice in nota.
* Arrivano avvisi automatici quando il saldo scende sotto 100 €, quando finisce e quando manca la carta.
* Un vecchio omaggio a tetto si trasforma con **Converti omaggio in saldo…**: il già consumato viene scalato, il resto diventa saldo.

## Dati fiscali

**Studenti** → scheda → **Fatturazione**: ragione sociale, P.IVA o codice fiscale, indirizzo, provincia, email per le fatture. Li può correggere il team: sono gli stessi che lo studente vede e salva da **Amministrazione → Dati di fatturazione**, e vanno sul suo cliente Stripe, quindi sulle fatture successive (non su quelle già emesse). La P.IVA viene verificata da Stripe: se la rifiuta, gli altri dati restano salvati e la risposta lo dice.

Il filtro **dati fiscali da completare** della scheda Studenti dice chi va sistemato.

### Clienti Stripe dello studente

Uno studente può avere **più clienti Stripe** (per esempio uno storico, o quello del CRM). In **Studenti** → scheda → **Fatturazione** → **Clienti Stripe**:

* l'elenco dei clienti collegati, con il badge **Principale (si fattura qui)** o **Secondario**, l'origine e gli abbonamenti di ciascuno; un avviso rosso se ci sono **due abbonamenti dello stesso servizio**;
* **Clienti Stripe che potrebbero essere suoi** (stessa email o stessa location del CRM), con **Collega come principale** o **Collega come secondario**; con **Altra email dello studente** + **Cerca** si allarga la ricerca;
* un campo per l'id cliente + **Collega a studente**, per un cliente che non ha la sua email (chiede conferma);
* su un secondario, **Unifica: rendi principale** (chiede conferma: cambia il cliente su cui si fattura) e **Scollega**.

Su Stripe non si scrive niente: si cambia solo il collegamento in piattaforma. Lo studente, in **Le tue fatture**, vede le fatture di **tutti** i suoi clienti Stripe.

## Bonifici: fatture automatiche da Mattone HQ

Le rate del programma pagate con bonifico si abbinano in **Mattone HQ**. Quando un incasso è abbinato a una rata, HQ chiede alla piattaforma di emettere, sul cliente Stripe dello studente, una **fattura già segnata come pagata**: nessun addebito, nessuna mail. Lo studente la trova insieme alle altre in **Le tue fatture**.

* I contratti **già fatturati sul bonifico** sono esclusi: niente seconda fattura.
* Un acconto parziale non genera fattura; una rata pagata in più bonifici si fattura quando è completa.
* Lo studente HQ va collegato a mano al suo profilo della piattaforma, la prima volta.

## Solleciti

Le fatture scadute hanno solleciti automatici al **giorno 0, 3 e 6**; dal giorno 7 il sistema **propone** la sospensione, non la applica da solo. La scala completa è in [Mancato pagamento](https://docs.mattone.co/delivery/mancato-pagamento.md). Termini e Privacy della piattaforma descrivono pagamenti, abbonamenti e fatturazione.

> **[Incassi: le situazioni standard](https://docs.mattone.co/amministrazione/incassi.md)**
>
> Una situazione, un bottone, chi lo fa

> **[Billing Conduit](https://docs.mattone.co/integrazioni/conduit/billing-e-fatturazione.md)**
>
> Stripe dello studente vs canone del Servizio AI Ospiti


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.