# Crediti

> La moneta di prenotazione della community. Da dove arrivano i crediti (piano ogni mese, prodotto singolo e assegnazione del team), lotti e validità, il cambio di mese, accumulo, annullamento tardivo e assenza, la scheda Crediti nel profilo, I miei crediti, le regole della community e chi può fare cosa.

I **crediti** sono la moneta interna che il membro spende per **prenotare** sale, scrivanie e orari di persone ([Prenotazioni](/espacos/reservas) e [Appuntamenti](/espacos/agendamento)). Il credito **non è denaro**: non si preleva, non si trasferisce e non passa dal checkout. La community decide quanto costa ogni sala in crediti, e il membro riceve crediti dal piano, da un prodotto o dal team.

## A cosa serve

| Community | Come usa i crediti |
|---|---|
| Coworking | Il piano **Residente** dà 40 crediti al mese; la sala riunioni costa 3 crediti ogni 30 minuti |
| Spazio studio | Un pacchetto singolo di 20 crediti, valido 90 giorni, per chi non vuole abbonarsi |
| Mentoring | Il team assegna crediti omaggio a chi ha fatto il primo acquisto |
| Associazione | Ogni socio riceve crediti ogni mese per usare l'auditorium |

## Come funziona

### Da dove arrivano i crediti

| Origine | Come arriva | Compare nell'estratto come |
|---|---|---|
| **Piano** | Ogni mese, per ogni abbonamento attivo al piano che ha **Crediti al mese** | Piano |
| **Prodotto singolo** | Una volta, al completamento dell'acquisto | Prodotto |
| **Assegnazione manuale** | Il team assegna crediti a un membro, con un motivo | Team |

**Piano.** Ogni abbonamento **attivo** (o in periodo di prova) a un piano con crediti al mese riceve il mese che manca, e il piano annuale riceve **mese per mese** allo stesso modo. I crediti del piano valgono **fino al cambio di mese**, a mezzanotte nel fuso orario della community. Chi passa a un piano con più crediti riceve **solo la differenza**; chi passa a un piano con meno non perde ciò che ha già. Annullare subito o rimborsare l'abbonamento toglie ciò che non è ancora stato usato.

**Prodotto singolo.** Un prodotto **digitale a pagamento unico** può assegnare crediti all'acquisto, con una validità in giorni (vuota, non scadono). Un prodotto già **incluso in un piano** non assegna crediti. Il rimborso o la contestazione dell'acquisto toglie i crediti che ha assegnato (ciò che non è ancora stato usato).

**Assegnazione manuale.** Il team apre un nuovo lotto per il membro, con **motivo obbligatorio** e validità facoltativa (vedi [Chi può fare cosa](#chi-puo-fare-cosa)).

### Lotti e validità

Ogni assegnazione apre un **lotto**, con la sua validità. Il **saldo** è la somma dei lotti **non ancora scaduti**. Quando il membro prenota, il costo esce **prima dal lotto che scade prima**, e un rimborso torna allo stesso lotto (se è già scaduto, torna in un nuovo lotto, valido 30 giorni). L'estratto non viene mai cancellato né modificato: un errore si corregge con un nuovo movimento.

L'estratto mostra ogni movimento con il tipo:

| Tipo | Cos'è |
|---|---|
| **Assegnazione** | Un nuovo lotto (piano, prodotto o team) |
| **Uso in una prenotazione** | Il costo di una prenotazione |
| **Rimborso** | Crediti restituiti per annullamento, spostamento o blocco |
| **Rettifica** | Correzione fatta dal team, con il motivo |
| **Scadenza** | Ciò che è scaduto senza essere usato |
| **Revoca** | Crediti ripresi (per un rimborso, per esempio) |

### Il cambio di mese

I crediti del piano scadono alle **00:00 del giorno 1**, nel **fuso orario della community** (non in quello di chi guarda). Per impostazione predefinita **non c'è accumulo**: ciò che avanza del piano scade al cambio di mese e il mese successivo inizia con la nuova quota.

Con l'**accumulo** attivo, ciò che avanza passa al mese successivo, rispettando:

- il **tetto** di ciò che può passare da un mese all'altro (vuoto, nessun tetto);
- i **mesi di vita dell'accumulato**, da 1 a 12.

La modifica vale **dal prossimo cambio di mese in poi** e non modifica mai un lotto già esistente.

### Annullamento tardivo e assenza

Ogni prenotazione ha una **finestra di annullamento**, di **24 ore** per impostazione predefinita (da 0 a 720; la sala può avere la sua). Chi annulla o sposta **entro la finestra** (con 24 h o più di anticipo) riceve tutto indietro.

| Situazione | Per impostazione predefinita |
|---|---|
| Annullamento **dopo** la finestra (tardivo) | Il membro **perde** i crediti |
| **Assenza (no-show)**, segnata dal team o dall'host | Il membro **perde** i crediti |
| Annullamento da parte del **team** o dell'host | Rimborsa sempre per intero |
| Sala eliminata o orario bloccato con prenotazioni | Rimborsa sempre per intero |

Ogni regola di perdita è un interruttore nelle [regole della community](#le-regole-della-community): disattivata, il credito torna anche con l'annullamento tardivo o l'assenza.

### Abbonamento in pausa o insolvente

Un abbonamento **in pausa** o **insolvente** **non riceve il nuovo mese** di crediti. Quanto al saldo che la persona ha già, **per impostazione predefinita continua a usarlo**, anche per prenotare. È una regola della piattaforma, non un'opzione della community: non compare nelle impostazioni. Quando l'abbonamento torna attivo, la persona riceve i crediti del mese in corso.

## Dove vederli

### La scheda Crediti nel profilo

Nel profilo di un membro, la scheda **Crediti** mostra:

- il **saldo** e ciò che **scade a breve**;
- i **lotti**, con l'origine, quanto resta di ciascuno e la validità (o "non scade");
- l'**estratto conto**, dal più recente al più vecchio, con chi ha fatto ogni movimento e il motivo.

Il membro vede **solo la propria scheda**; il team (proprietario, amministratore, moderatore e finanza) vede quella di **qualsiasi membro**. Il moderatore vede soltanto: i pulsanti **Assegna crediti** e **Rettifica saldo** compaiono per il proprietario, l'amministratore e la finanza.

### I miei crediti

Il membro apre **Il mio account › Crediti** (**I miei crediti**) e vede lo stesso pannello: saldo, lotti ed estratto. Senza crediti, la schermata spiega da dove arrivano (piano, prodotti o assegnazione del team).

### Le regole della community

**Impostazioni › Crediti** raccoglie le regole (le modificano solo il proprietario e l'amministratore):

| Campo | Cosa fa | Predefinito |
|---|---|---|
| **Riporta i crediti del piano al mese successivo** | Attiva l'accumulo | Disattivato |
| **Tetto di ciò che passa da un mese all'altro** | Il massimo accumulabile | Nessun tetto |
| **Mesi di vita dell'accumulato** | Per quanti mesi l'accumulato resta valido (da 1 a 12) | 1 |
| **Nel primo mese, assegna la quota proporzionale ai giorni rimasti** | Chi si abbona a metà mese riceve solo i giorni restanti | Disattivato |
| **Finestra per annullare o modificare (ore)** | Anticipo per annullare senza perdere (da 0 a 720) | 24 |
| **L'annullamento tardivo perde il credito** | Annullare dentro la finestra non restituisce | Attivo |
| **L'assenza (no-show) perde il credito** | Chi non si presenta non riavrà i crediti | Attivo |

## Passo per passo

### Dare crediti mensili a un piano

1. Apri **Monetizzazione › Piani** e crea o modifica il piano.
2. Nel campo **Crediti al mese**, inserisci la quantità. **0** significa che il piano non assegna crediti.
3. Salva. Ogni abbonamento attivo inizia a ricevere la quota ogni mese, fino al cambio di mese nel fuso orario della community.

### Dare crediti con l'acquisto di un prodotto

1. Apri il prodotto (digitale, a pagamento unico).
2. In **Crediti assegnati all'acquisto**, inserisci la quantità (0 = non assegna).
3. In **Validità dei crediti (giorni)**, inserisci i giorni, contati dall'acquisto. Vuoto, i crediti **non scadono**.

> [!NOTE]
> I crediti funzionano solo in una community che ha uno spazio di **Prenotazioni** o di **Appuntamenti**. Senza, l'app avvisa sotto il campo: *"I crediti funzionano solo in una community con uno space di Prenotazioni o di Appuntamenti. Creane uno prima, poi definisci i crediti."* Crea lo spazio e torna al piano o al prodotto.

### Assegnare o rettificare i crediti di un membro

1. Apri il profilo del membro e la scheda **Crediti**.
2. **Assegna crediti** apre un nuovo lotto: inserisci la **quantità**, il **motivo** (obbligatorio, compare nell'estratto) e, se vuoi, la **validità** (l'ultimo giorno vale fino alle 23:59 nel fuso orario della community).
3. **Rettifica saldo** corregge il saldo: scegli **Aggiungi** o **Rimuovi**, la quantità e il motivo. Rimuovere chiede una seconda conferma, consuma prima i lotti che scadono prima e **non può superare il saldo utilizzabile**.

## Chi può fare cosa

| Azione | Proprietario | Amministratore | Finanza | Moderatore | Membro |
|---|---|---|---|---|---|
| Vedere il proprio saldo ed estratto | ✔ | ✔ | ✔ | ✔ | ✔ |
| Vedere il saldo e l'estratto di qualsiasi membro | ✔ | ✔ | ✔ | ✔ | — |
| Assegnare crediti e rettificare il saldo | ✔ | ✔ | ✔ | — | — |
| Vedere le regole della community | ✔ | ✔ | ✔ | ✔ | — |
| Modificare le regole della community | ✔ | ✔ | — | — | — |
| Prenotare con **cortesia** (senza addebito) | ✔ | ✔ | — | — | — |

La **cortesia** è una prenotazione che non addebita nulla, sempre con un motivo; la usano solo il proprietario e l'amministratore (vedi [Prenotazioni](/espacos/reservas#prenotare-a-nome-di-qualcuno)).

## Errori comuni e come risolverli

| Situazione | Cosa fare |
|---|---|
| Il campo crediti del piano o del prodotto mostra l'avviso sullo spazio | Crea prima uno spazio di Prenotazioni o di Appuntamenti |
| *"Ti mancano N crediti per questa prenotazione"* | Il membro ha bisogno di più crediti: il team li assegna, oppure sceglie un orario più economico |
| Non riesco a rimuovere crediti | Il saldo utilizzabile è minore della richiesta; rimuovi al massimo il saldo |
| Ho cambiato l'accumulo e nel lotto attuale non è cambiato nulla | La regola vale dal prossimo cambio di mese e non modifica i lotti già esistenti |
| Il prodotto non assegna crediti | Solo un prodotto **digitale a pagamento unico** assegna crediti, e non se è incluso in un piano |

## Domande frequenti

**Il credito è denaro?** No. Paga solo prenotazioni dentro la community; non si preleva né si trasferisce.

**Il membro vede quando scadono i crediti?** Sì: il saldo mostra ciò che scade a breve e ogni lotto mostra la data.

**Cosa succede ai crediti se l'abbonamento viene annullato?** L'annullamento immediato e il rimborso tolgono ciò che non è stato usato.

**Posso cambiare il costo di una sala dopo?** Sì. Le prenotazioni già fatte mantengono il costo che avevano.

## Nell'API e nell'MCP

Le rotte sono in `/api/credits` (saldo, estratto, assegnazioni, rettifiche e regole), documentate nel [riferimento dell'API](/api/referencia). L'assistente fa tutto questo nella conversazione: vedi [Strumenti · Crediti](/mcp/ferramentas-creditos).

## Correlati

- [Prenotazioni](/espacos/reservas)
- [Appuntamenti](/espacos/agendamento)
- [Piani](/monetizacao/planos)
- [Prodotti](/monetizacao/produtos)
- [Ruoli e permessi](/conceitos/papeis-e-permissoes)