# Connessioni email (https://docs.getbeel.com/it/guide/invoice-management/gmail-integration)

Collega Gmail, Outlook, IMAP o l’inoltro email: Getbeel trova le fatture dei fornitori nella casella.

Getbeel legge le caselle che colleghi e importa le email con fatture. Puoi collegare più caselle per team, per esempio amministrazione@ e fatture@.

## Prima di iniziare [#prima-di-iniziare]

- **Un piano con crediti fattura.** Senza piano i pulsanti di collegamento sono disattivati.
- **Il limite del piano.** **Impostazioni → Email** mostra quante connessioni email usi sul totale.
- **Non serve** dare a Getbeel la password di Gmail o Outlook: l'accesso passa da Google o Microsoft, in sola lettura.
- **Costo.** Ogni fattura letta usa un credito; l'inoltro email è un servizio aggiuntivo a pagamento ([Prezzi](/it/api/pricing)).

## Collega una casella [#collega-una-casella]

<Steps>
<Step>

### Apri le impostazioni email [#apri-le-impostazioni-email]

Apri **Impostazioni → Email**. Le schede sono **Gmail**, **Outlook**, **Altra email** e **Inoltro e-mail**.

</Step>
<Step>

### Scegli il provider e autorizza [#scegli-il-provider-e-autorizza]

- **Gmail**: premi **Collega Gmail** e autorizza la lettura delle email nella schermata di Google.
- **Outlook**: premi **Collega Outlook** e accedi con l'account Microsoft (Outlook.com o Microsoft 365).
- **Altra email** (IMAP): premi **Collega IMAP**. Scegli il **Provider email**, poi inserisci indirizzo e una password per le app.

Per IMAP Getbeel usa SSL/TLS sulla porta 993. I server con solo altre porte o STARTTLS non sono supportati.

</Step>
<Step>

### Cerca le fatture passate [#cerca-le-fatture-passate]

Apri **Fatture ricevute** e premi **Scansiona ora**. Scegli un periodo, per esempio **Ultimi 3 mesi**, e premi **Avvia scansione**.

</Step>
</Steps>

## Cosa è successo [#cosa-è-successo]

- **La casella è collegata.** Dopo il primo accesso riuscito il suo stato è **Accesso email verificato**.
- **Getbeel la controlla una volta al giorno** e importa le nuove fatture da solo.
- **La scansione del periodo è partita.** **Fatture ricevute** mostra l'avanzamento e si aggiorna da sola.
- **L'AI legge ogni fattura trovata** e la mette in **Fatture ricevute**.

## Inoltra le fatture [#inoltra-le-fatture]

L'inoltro serve quando non vuoi collegare tutta la casella. È un servizio aggiuntivo a pagamento.

1. Apri **Impostazioni → Email → Inoltro e-mail** e premi **Configura inoltro**.
2. Copia l'**Indirizzo di inoltro**.
3. Inoltra le fatture a quell'indirizzo, a mano o con una regola del tuo programma di posta.

Getbeel elabora ogni email appena arriva.

## Gestisci le connessioni [#gestisci-le-connessioni]

Ogni casella mostra indirizzo e stato. Dal menu della riga:

- **Ricollega** (Gmail): rinnova l'autorizzazione se Google l'ha revocata.
- **Scollega**: Getbeel smette di leggere la casella. Le fatture già importate restano.

**Cronologia scansioni**, nella stessa pagina, elenca ogni scansione con tipo, stato, fatture trovate ed elaborate. Apri una riga per l'esito di ogni email:

| Esito                                | Cosa significa                                               |
| ------------------------------------ | ------------------------------------------------------------ |
| **Fattura creata**                   | La fattura è in **Fatture ricevute**                         |
| **Manca il documento della fattura** | L'email parla di una fattura ma non ha un allegato leggibile |
| **Duplicata**                        | La fattura c'è già                                           |
| **Non è una fattura**                | Per esempio una newsletter                                   |
| **Nessun contenuto di fattura**      | L'email o l'allegato non hanno testo leggibile               |
| **Crediti esauriti**                 | Saltata: i crediti fattura sono finiti                       |
| **Errore**                           | Un errore imprevisto; Getbeel riprova da solo                |

## Se qualcosa non va [#se-qualcosa-non-va]

| Messaggio                                                              | Causa                                | Cosa fare                                                         |
| ---------------------------------------------------------------------- | ------------------------------------ | ----------------------------------------------------------------- |
| **Da ricollegare**: "GetBeel non può leggere questa casella. …"        | Google ha revocato l'accesso         | Dal menu della casella scegli **Ricollega**                       |
| "Scegli lo stesso account Google della casella che stai ricollegando." | Hai scelto un altro account          | Ricollega con l'account giusto                                    |
| "L’amministratore Google Workspace ha bloccato l’accesso a Gmail. …"   | Il tuo dominio blocca le app esterne | Chiedi all'amministratore di autorizzare Getbeel, o carica i file |
| "Hai raggiunto il limite di collegamenti email."                       | Il piano consente meno caselle       | Scollega una casella o cambia piano                               |
| "L'inoltro email è un servizio aggiuntivo a pagamento. …"              | Manca il servizio di inoltro         | Premi **Vai a Utilizzo e fatturazione**                           |
| **Scansioni da controllare**                                           | Le importazioni non riescono         | Getbeel riprova da solo; se continua, ricollega la casella        |

Dopo un ricollegamento, premi **Scansiona ora** sul periodo mancante.

## Prossimi passi [#prossimi-passi]

<Cards>
  <Card
    title="Estrazione con l'AI"
    href="/it/guide/invoice-management/ai-extraction"
  >
    Cosa legge l'AI da ogni fattura.
  </Card>
  <Card title="Regole AI" href="/it/guide/invoice-management/categories-rules">
    Escludi mittenti o correggi i dati in automatico.
  </Card>
  <Card title="Codice destinatario" href="/it/guide/codice-destinatario">
    Ricevi le fatture elettroniche anche dallo SDI.
  </Card>
</Cards>
