# Download

> Lo spazio che condivide file (fogli di calcolo, e-book, PDF, modelli) in un archivio o in un solo file, gratis, venduti o inclusi nel piano. Chi carica, l'approvazione, il timbro sui PDF, I miei download e i contatori del team.

Il modulo **Download** è il luogo in cui distribuire file alla community: un foglio di calcolo, un e-book, un PDF, un modello, un pacchetto ZIP. Lo spazio può essere un **archivio** (più elementi, ciascuno con uno o più file) oppure **un solo file**. Ogni elemento è gratis per chi vede lo spazio, venduto tramite un [prodotto](/monetizacao/produtos) o incluso in un [piano](/monetizacao/planos).

I file sono conservati in un'area **privata**. Nessuno riceve un indirizzo permanente: ogni download genera, sul momento, un link valido **5 minuti**.

## A cosa serve

| Community | Download |
|---|---|
| Scuola online | L'e-book del corso, venduto a parte, e il foglio degli esercizi, gratis per gli studenti |
| Associazione | Verbali, statuti e modelli di documento, solo per i soci |
| Consulenza | Un kit di modelli in ZIP, incluso nel piano premium |
| Coworking | Il manuale della casa, in PDF, in uno spazio con un solo file |

## Come funziona

### Archivio o un solo file

Alla creazione dello spazio, il passo **Come funziona lo spazio** chiede la modalità:

| Modalità | Cosa mostra lo spazio |
|---|---|
| **Archivio** (predefinita) | Più elementi, ciascuno con uno o più file, filtrabili per categoria. Non c'è limite di elementi né di file per elemento |
| **Un solo file** | Lo spazio mostra direttamente un unico file. Per cambiarlo, **sostituisci** il file: un secondo elemento o un secondo file viene rifiutato |

In **Archivio**, le **categorie** sono facoltative (la schermata suggerisce *Fogli di calcolo*, *E-book* e *Modelli*). Ogni elemento ha al massimo una categoria, e una categoria con elementi si può rimuovere solo dopo aver spostato o eliminato quegli elementi.

### L'elemento

| Campo | A cosa serve |
|---|---|
| **Titolo** | Obbligatorio |
| **Descrizione** | Testo formattato |
| **Copertina** | Facoltativa. JPG, PNG, WEBP o GIF, fino a 20 MB |
| **Categoria** | Una delle categorie dello spazio (solo nell'archivio) |
| **File** | I file dell'elemento, caricati nella sua pagina |
| **Timbra i PDF** | Vedi [Timbrare i PDF](#timbrare-i-pdf) |

Un elemento nuovo nasce come **Bozza** (lo vedono solo il team e l'autore). **Pubblica** richiede almeno **un file**. Ritirarlo dalla pubblicazione lo riporta a bozza.

### File accettati

| Tipo | Formati |
|---|---|
| Immagini | PNG, JPG, WEBP, GIF |
| Fogli di calcolo | XLS, XLSX, ODS, CSV |
| PDF | PDF |
| Documenti | DOC, DOCX, ODT, TXT, MD, PPT, PPTX |
| Compressi | ZIP |

- **Fino a 200 MB per file.** Non c'è limite al numero di file.
- **Nessun eseguibile** e nessun altro tipo di file. Memberfy controlla il **contenuto** del file, non solo l'estensione: un eseguibile rinominato in `.pdf` viene rifiutato ed eliminato.
- Il caricamento va direttamente dal tuo browser all'archiviazione, con barra di avanzamento, e si possono caricare più file insieme, trascinandoli.
- I file rientrano nel conteggio dello spazio di archiviazione della community, che **avvisa soltanto** quando si supera il limite: l'archiviazione non blocca mai un caricamento.
- Ogni persona può fare fino a **60 caricamenti di contenuti multimediali all'ora** (file dei Download e altri contenuti multimediali ospitati); oltre, la schermata chiede di riprovare più tardi.
- **Sostituisci** mette un altro file al suo posto; **Rimuovi file** chiede conferma (*"Chi lo ha già scaricato ne conserva la copia."*). Chi scarica dopo riceve il file nuovo. Rimuovere l'ultimo file di un elemento pubblicato lo riporta a bozza.
- L'ordine dei file cambia con **Sposta su** e **Sposta giù**.

### Chi carica e chi configura

| Azione | Chi |
|---|---|
| Configurare lo spazio (modalità, categorie, approvazione) | Proprietario e amministratore |
| Creare un elemento e caricare file | Chi è consentito da **Chi può pubblicare** dello spazio. Per impostazione predefinita, solo il team (proprietario, amministratore, moderatore e finanza) |
| Modificare, sostituire file, pubblicare ed eliminare un elemento | L'autore dell'elemento e il team |
| Scaricare | Chi ha accesso all'elemento, come descritto in [Chi scarica](#chi-scarica) |
| Vedere i contatori | Il team |

Il proprietario e l'amministratore possono aprire il caricamento ai **membri** in **Chi può pubblicare**. Questo si somma alla regola di accesso dello spazio: chi non vede lo spazio non carica né scarica.

### Approvazione degli elementi dei membri

Con **Rivedi gli elementi dei membri** attivo nella configurazione dello spazio, l'elemento creato da un membro resta **In revisione**, invisibile agli altri, finché il team non decide dalla coda di [moderazione](/membros/moderacao). La scheda **In revisione** dello spazio mostra la coda.

- **Approva** pubblica l'elemento **subito**, se ha già un file (l'autore non deve pubblicarlo di nuovo).
- **Rifiuta** chiede il motivo, e l'autore viene avvisato.
- **Modificare** un elemento pubblicato di un membro lo **rimanda in revisione**.
- Gli elementi del team non passano per la coda.

### Prezzo e vendita

Ogni elemento nasce con un **prodotto** collegato, in bozza e **gratuito**. Nella pagina dell'elemento, il team vede la fascia **Prezzo e vendita**, che apre il prodotto per impostare prezzo, giacenza, piani e pubblicare. Questo prodotto è di tipo **Download** e non si elimina a parte: eliminare l'elemento archivia il prodotto. Vedi [Tipi di prodotto](/monetizacao/produtos#tipi-di-prodotto).

### Chi scarica

| Situazione dell'elemento | Chi scarica |
|---|---|
| Senza prezzo (prodotto in bozza, inattivo o a prezzo zero) | Chiunque veda lo spazio |
| Con prezzo e prodotto pubblicato | Chi l'ha **acquistato** (acquisto confermato e attivo) e chi ha un **piano che include il prodotto** |
| Sempre | Il team e l'autore dell'elemento |

- **Chi non ha accesso** vede l'elemento con un lucchetto: titolo, copertina, prezzo e il pulsante **Acquista**, senza i nomi dei file e senza link.
- **Rimborso, contestazione (chargeback), fine della scadenza dell'accesso e uscita dal piano** chiudono l'accesso a nuovi download. Chi ha già scaricato conserva la copia che ha, ma **averlo scaricato prima non garantisce l'accesso**: vale solo la regola attuale.
- **Elemento che era gratis e diventa a pagamento:** chi non l'ha acquistato e non ha un piano che lo include deve acquistarlo, anche se l'ha già scaricato prima.
- **Giacenza (facoltativa):** se il prodotto ha una giacenza e finisce, l'elemento compare come esaurito e subentra la [lista d'attesa](/monetizacao/produtos#posti-e-lista-d-attesa). Con una giacenza definita, anche un elemento a prezzo zero passa per una conferma di "ottieni gratis" per prendere l'unità.
- L'e-mail di conferma dell'acquisto di un download porta a **I miei download** (richiede l'accesso), mai a un link del file.

### I miei download

Ogni membro vede ciò che può scaricare in **Fatturazione › I miei acquisti › I miei download**: gli elementi acquistati, inclusi nel piano o gratuiti, con l'origine dell'accesso (**Acquistato**, **Nel tuo piano**, **Gratis**), la data di acquisto, l'ultimo download e, quando c'è una scadenza, *"Accesso fino al"*. L'elenco mostra solo ciò che la persona può davvero scaricare, con le date nel fuso orario della community.

### Timbrare i PDF

In **Modifica** dell'elemento, chi gestisce un elemento con almeno un PDF vede l'interruttore **Timbra i PDF** (spento per impostazione predefinita). Acceso, **chi scarica un PDF** riceve una **copia** con una piccola riga, in grigio, in fondo all'**ultima pagina**: *"Scaricato da {e-mail} il {data e ora}"*, nel fuso orario della community.

- **Il team e l'autore scaricano senza timbro**, per controllare il file. L'originale non viene mai modificato.
- **Un PDF oltre i 25 MB**, protetto da password o danneggiato esce **senza timbro**, e il download funziona normalmente.
- Gli altri tipi di file non ricevono il timbro.
- Il timbro **aiuta a rintracciare una fuga di file, ma non la impedisce**: chi ha il file può condividerlo.

### Contatori per il team

Nella pagina dell'elemento, il team vede quanti download ci sono stati, in totale e per persone diverse, per elemento e per file, e la data dell'ultimo. I download del team stesso non vengono conteggiati. Il membro non vede i contatori. I numeri mostrano quanti, non chi.

## Passo dopo passo

### Creare lo spazio

*Ruolo: proprietario o amministratore.*

1. In **Aggiungi Spazio**, scegli il modulo **Download**.
2. Nel passo **Come funziona lo spazio**, scegli **Archivio** o **Un solo file**.
3. Nell'archivio, aggiungi le **Categorie** (facoltativo) e, se i membri caricheranno file, attiva **Rivedi gli elementi dei membri**.
4. Imposta la visibilità e **Chi può pubblicare**, e crea lo spazio.

Per cambiare la modalità, le categorie o l'approvazione in seguito, usa **Configura lo spazio** nella barra **Gestione dello spazio**. Passare a **Un solo file** con un elemento di due o più file viene rifiutato.

### Creare un elemento e caricare i file

*Ruolo: chi lo spazio lascia creare.*

1. Nello spazio, clicca su **Nuovo download** (nella modalità a un solo file, **Aggiungi il file**).
2. Compila **Titolo**, **Descrizione**, **Categoria** e la **Copertina**, e clicca su **Crea e aggiungi file**.
3. Nella pagina dell'elemento, in **File**, trascina i file o usa **Scegli i file**.
4. Quando tutti hanno finito, clicca su **Pubblica**.

### Vendere l'elemento

*Ruolo: proprietario o amministratore.*

1. Nella pagina dell'elemento, clicca su **Prezzo e vendita**.
2. Imposta il **Prezzo** e, se vuoi, la giacenza, i piani in cui l'elemento è incluso, e pubblica il prodotto. Vedi [Prodotti](/monetizacao/produtos). Pubblicare un prodotto a pagamento richiede le [Informazioni Aziendali](/pagamentos/informacao-comercial) approvate; un prodotto gratuito no.
3. Chi non ha accesso vede ora il prezzo e **Acquista**.

### Scaricare

1. Apri l'elemento e clicca su **Scarica** accanto al file (*"Il link di download viene creato quando fai clic e vale 5 minuti."*).
2. Per rivedere ciò che hai, apri **I miei download**.

## Esempi

**E-book del corso.** Spazio **Materiali** (Archivio, visibilità **Privata**). L'elemento *E-book Excel da Zero* è pubblicato con un prezzo di US$ 29. Gli studenti vedono il lucchetto e **Acquista · US$ 29,00**; chi l'ha acquistato scarica. L'elemento *Foglio degli esercizi*, senza prezzo, è di tutti gli studenti.

**Manuale della casa.** Spazio **Manuale** in modalità **Un solo file**: carica solo il team, e ogni membro scarica il PDF. Per pubblicare una nuova versione, il team usa **Sostituisci** sul file.

**Modelli dei soci.** Archivio con la categoria *Modelli*. L'amministratore apre il caricamento ai membri e attiva la revisione: il modello inviato da un socio compare solo dopo che il team lo approva.

## Errori comuni e come risolverli

| Messaggio | Cosa fare |
|---|---|
| *Questo tipo di file non è accettato. Usa PDF, fogli di calcolo, documenti, immagini o ZIP.* | Convertilo in uno dei formati accettati |
| *Il file supera …* | Il limite è 200 MB per file; riducilo o dividilo |
| *Il file è vuoto.* | Scegli un altro file |
| *Non hai ancora accesso a questo file.* | L'elemento è a pagamento: acquistalo, o usa il piano che lo include |
| *Questo elemento è esaurito.* | Entra nella lista d'attesa |
| *Troppi download in poco tempo. Riprova tra qualche minuto.* | Aspetta qualche minuto |
| Il pulsante **Pubblica** non funziona | Carica prima almeno un file |
| Il membro non vede **Nuovo download** | **Chi può pubblicare** dello spazio è solo per il team |

## Domande frequenti

**Il link del file si può condividere?**
Vale 5 minuti ed è generato per chi ha cliccato. Chi vuole rintracciare l'origine di una fuga di un PDF può attivare il [timbro](#timbrare-i-pdf).

**Posso vendere un file senza creare un prodotto?**
No: ogni elemento ha il suo prodotto, in bozza e gratuito, e il prezzo si imposta lì.

**Chi ha acquistato l'elemento perde l'accesso se sostituisco il file?**
No. Il file nuovo vale per i download successivi; l'accesso continua.

**Si possono scaricare tutti i file di un elemento in una volta?**
Non ancora: ogni file ha il suo pulsante.

**C'è un antivirus?**
No. Memberfy blocca gli eseguibili e controlla il tipo dal contenuto, ma non analizza i file alla ricerca di virus.

## Con l'assistente

L'assistente configura lo spazio, crea gli elementi, carica i file (tramite link o file), pubblica, mostra i contatori e, per chi scarica, elenca i download e fornisce il link di 5 minuti. Vedi [Strumenti · Download](/mcp/ferramentas-downloads).

## Nell'API

`GET` e `PUT /api/downloads/spaces/{spaceId}` (modalità, categorie, approvazione); `GET` e `POST /api/downloads/items`, `GET`, `PUT` e `DELETE /api/downloads/items/{id}`; i file in `/api/downloads/items/{id}/files` (`upload-url`, `confirm`, `reorder`, `{fileId}/replace` e `DELETE {fileId}`); `POST /api/downloads/files/{fileId}/download` (restituisce il link di 5 minuti e `stamped`); `GET /api/me/downloads`; `GET /api/downloads/items/{id}/stats`; e la coda `GET /api/moderation/downloads/pending`. La community arriva dall'intestazione `X-CommunityId`. Il prodotto 1:1 arriva nel campo `product` dell'elemento.

## Correlati

- [Prodotti](/monetizacao/produtos)
- [Piani](/monetizacao/planos)
- [Moderazione](/membros/moderacao)
- [Moduli](/conceitos/modulos)
- [Fatturazione del membro](/pagamentos/faturamento-do-membro)