> ## 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.

# Incassi: le situazioni standard e cosa fare

> La scheda Incassi dell'Admin Panel: una riga per studente, una situazione presa da un catalogo chiuso, un bottone. Per ogni situazione: cosa vuol dire, cosa si preme, chi lo fa.

**Incassi** è la prima scheda dell'Admin Panel. Ogni riga è uno studente con: nome, **situazione**, importo, prossima data e **un solo bottone**. La situazione non è una frase scritta a mano: viene da un **catalogo chiuso**, si calcola dai dati veri (Stripe e registri della piattaforma) e **sparisce da sola** quando il problema è risolto.

## I cinque stati (filtri e card in alto)

| Stato | Cosa vuol dire |
| - | - |
| **In regola** | Abbonamento attivo, niente da incassare adesso |
| **Da incassare** | C'è un importo certo da prendere: arretrato, abbonamento da avviare, carta da chiedere |
| **Da verificare** | Manca un dato per poter incassare: l'importo è **presunto** finché non si sistema |
| **Non pagato** | Una fattura emessa non è stata pagata (carta rifiutata o conferma della banca) |
| **Omaggio / esente** | Servizio in omaggio o in esenzione: niente da incassare |

Sopra la tabella ci sono anche **Incassato questo mese** (fatture Stripe pagate, emesse nel mese) e **Abbonamenti attivi**. Il bottone **↻ Aggiorna** rilegge Stripe; dopo ogni azione la vista si rilegge da sola.

## Le situazioni, una per una

| Situazione | Stato | Bottone | Chi agisce |
| - | - | - | - |
| **3D Secure** | Non pagato | **Invia link** | Lo studente, dal link |
| **Carta rifiutata** | Non pagato | **Invia link** | Lo studente, dal link |
| **Arretrato** | Da incassare | **Addebita** | Amministrazione |
| **Da avviare** | Da incassare | **Avvia** | Amministrazione |
| **Carta mancante** / **Carta scaduta** | Da incassare | **Chiedi carta** | Lo studente, dalla mail |
| **Da verificare** | Da verificare | **Risolvi** | Amministrazione |
| **Doppio abbonamento** | Da verificare | **Unifica** | Amministrazione |
| **Conduit scollegato** | Da verificare | **Ricollega** | Delivery |
| **Servizio in attesa** | Da verificare | **Aggancia** | Amministrazione |
| **In regola** | In regola | nessuno | — |
| **Omaggio** | Omaggio / esente | nessuno | — |

Ogni riga mostra **una sola situazione**, la più urgente. L'ordine è: fattura non pagata → doppio abbonamento → arretrato incassabile → dati da sistemare → Conduit scollegato → carta → abbonamento da avviare → in regola.

## Le procedure

> **3D Secure / Carta rifiutata → Invia link**
>
> Una fattura è stata emessa e non è stata pagata. **3D Secure** vuol dire che la banca dello studente chiede di confermare il pagamento; **Carta rifiutata** che la carta non è passata.
>
> 1. Premi **Invia link**: si apre l'anteprima della mail di pagamento.
> 2. Conferma: parte allo studente la mail Mattone con il link per pagare (e confermare con la banca).
> 3. Non serve fare altro: quando lo studente paga, la riga torna da sola **In regola**. Il dettaglio della riga dice quando è partito l'ultimo link.
>
> Non si riaddebita a mano una fattura già aperta: un nuovo addebito resta bloccato finché quella fattura non è pagata.

> **Arretrato → Addebita**
>
> Ci sono cicli già maturati, con importo certo, da prendere sulla carta salvata.
>
> 1. Premi **Addebita**: l'anteprima mostra cicli, importo e totale.
> 2. Conferma **Addebita … ora**: parte l'addebito, con la sua fattura.
> 3. Se la banca chiede di confermare, l'esito lo dice in italiano («la banca chiede di confermare: gli mandiamo il link?») e propone **Invia link di pagamento**.
>
> Il canone è **anticipato**: un ciclo al mese dal giorno di attivazione, **senza pro-rata**, sui **listing realmente attivi** nel ciclo. Il saldo a favore dello studente, se c'è, si usa prima della carta.

> **Da avviare → Avvia**
>
> Lo studente ha carta, contratto e listing misurati, ma l'abbonamento mensile non è ancora partito.
>
> 1. Premi **Avvia**: l'anteprima mostra listing, importo mensile e prima scadenza.
> 2. Conferma **Avvia abbonamento**.
>
> Se nel mese non ci sono listing misurati, **Avvia** resta spento: prima va capito perché Conduit non vede appartamenti.

> **Carta mancante / Carta scaduta → Chiedi carta**
>
> Serve una carta valida e non c'è (o è scaduta). Premi **Chiedi carta**: parte la mail Mattone che chiede allo studente di salvarla in **Amministrazione → Metodo di pagamento Mattone**. Quando la salva, la riga si aggiorna da sola, senza che nessuno debba premere altro.
>
> La carta serve anche allo studente per il suo percorso: dal 23/10/2026 il passo **«Carta di pagamento salvata»** è l'ultimo del percorso che sblocca la call 1:1. Salvarla non addebita nulla.

> **Da verificare → Risolvi**
>
> Manca qualcosa per poter incassare. **Risolvi** apre l'elenco di cosa manca, con il modo per sistemarlo:
>
> | Manca | Come si sistema |
> | - | - |
> | **Data attivazione** | La si inserisce nella finestra, con la fonte (contratto, mail…), e **Salva** |
> | **Dati Conduit** / **Listing da confermare** | Dal dettaglio della riga (clic sul nome): importo e motivo per ogni ciclo, oppure conferma della proposta |
> | **Carta** | **Manda la mail per la carta** |
> | **Contratto**, **Chi fattura**, **Fattura vecchia**, **Abbonamento** | Dalla scheda dello studente (**Apri la scheda**) |
> | **Stripe non letto** | **↻ Aggiorna**: se resta, è Stripe che non risponde |
>
> Finché resta qualcosa da verificare, l'importo è **presunto**. Diventa **Da incassare** quando non manca più niente.

> **Doppio abbonamento → Unifica**
>
> Sullo stesso studente ci sono due abbonamenti del canone vivi: rischio di addebito doppio. Il bottone apre il dettaglio della riga; da **Dettagli tecnici → Cliente su Stripe** si tiene **un solo** abbonamento del canone e si chiude l'altro. Nel dubbio su quale tenere, non si chiude niente e si chiede a chi decide sull'amministrazione.

> **Conduit scollegato → Ricollega (delivery)**
>
> Lo studente ha una data di attivazione ma questo mese non arriva nessun dato da Conduit: il giro automatico non vede il suo workspace. È un lavoro di **delivery**: verificare che il workspace Conduit dello studente sia collegato e visibile. Finché non lo è, non si fattura sul niente.

> **Servizio in attesa → Aggancia**
>
> Un servizio (CRM, WhatsApp, un add-on) è stato acceso in piattaforma ma non è ancora agganciato a Stripe.
>
> 1. Premi **Aggancia**: l'anteprima mostra il primo addebito («subito, poi ogni mese nello stesso giorno»).
> 2. Conferma **Aggancia e addebita**: nasce l'abbonamento di quel servizio, sulla stessa carta, con fatture separate.

> **In regola / Omaggio**
>
> Niente da fare. In **Omaggio** rientrano anche i servizi in esenzione. Un omaggio si può trasformare in **saldo a favore** dalla scheda dello studente: vedi [Servizi, saldo e fatture](https://docs.mattone.co/amministrazione/servizi-saldo-fatture.md).

## Il dettaglio di una riga

Cliccando il nome si apre il dettaglio: **al massimo cinque righe** in italiano piano (da pagare o arretrato, quanto paga ogni mese, listing fatturati con il mese, carta, saldo a favore o ultima fattura), il bottone **+ Servizio**, **Apri la scheda** dello studente e, chiusi, i **Dettagli tecnici**.

## Cosa si aggiorna da solo

Quando lo studente salva o toglie una carta, cambia la carta predefinita, o nasce un abbonamento, Stripe lo comunica alla piattaforma e la situazione si aggiorna da sola. Questi aggiornamenti **non mandano mail allo studente**: le mail partono solo dalle azioni che premi tu e dai solleciti automatici delle fatture scadute (vedi [Mancato pagamento](https://docs.mattone.co/delivery/mancato-pagamento.md)).

> [!WARNING]
>
> Da Incassi si toccano soldi veri: ogni azione ha **anteprima e conferma**. Se l'anteprima non torna con quello che ti aspetti, non confermare: apri il dettaglio, o la scheda dello studente, e capisci prima.

> **[Admin Panel: la mappa](https://docs.mattone.co/amministrazione/admin-panel.md)**
>
> Dove si trova cosa

> **[Servizi, saldo e fatture](https://docs.mattone.co/amministrazione/servizi-saldo-fatture.md)**
>
> Add-on, saldo a favore, dati fiscali, crediti


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