# Collega la banca (https://docs.getbeel.com/it/guide/collega-la-banca)

I movimenti del conto arrivano da soli in Getbeel, senza caricare estratti conto. Guida passo per passo.

Con la banca collegata, Getbeel scarica i movimenti dei tuoi conti ogni 6 ore e li abbina alle fatture. Non devi più caricare estratti conto.

Il collegamento passa da **Enable Banking**, un servizio europeo autorizzato a leggere i conti con il tuo consenso. Usi un'applicazione Enable Banking **intestata alla tua azienda**: Getbeel legge i movimenti con la tua chiave, e solo dei conti che autorizzi.

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

- **L'accesso all'home banking** dell'azienda.
- **Credito sul saldo prepagato.** Ogni conto collegato costa 2 € al mese e ogni movimento importato 0,02 € ([Prezzi](/it/api/pricing)). Enable Banking è gratuito. Se ti sei registrato prima del 13 novembre 2026, i conti collegati sono inclusi nel tuo piano a pagamento attivo: non serve il saldo.
- **Il ruolo Proprietario o Membro.** Il **Commercialista** vede le banche collegate ma non le gestisce.
- **Circa 10 minuti**, una volta sola, sullo **stesso browser** dall'inizio alla fine.
- **Non serve** caricare estratti conto: i movimenti arrivano da soli.

## Passi [#passi]

<Steps>
<Step>

### Crea un account Enable Banking [#crea-un-account-enable-banking]

Vai su [enablebanking.com](https://enablebanking.com/sign-in/) e registrati con l'email aziendale.

</Step>
<Step>

### Crea un'applicazione [#crea-unapplicazione]

Nel [pannello di controllo](https://enablebanking.com/cp/applications) apri **Applications → Register new application**:

- Ambiente: **Production**.
- Nome: per esempio "Getbeel - Rossi S.r.l.".
- Chiave: scegli **Generate in the browser** ed esporta la chiave privata. Salva il file `.pem`: ti serve al passo 5.
- Se chiede gli indirizzi di privacy e termini, usa quelli del sito della tua azienda.

Annota l'**Application ID** che compare sotto il nome.

</Step>
<Step>

### Aggiungi l'indirizzo di ritorno di Getbeel [#aggiungi-lindirizzo-di-ritorno-di-getbeel]

Nella stessa applicazione, in **Allowed redirect URLs**, incolla esattamente:

```text
https://getbeel.com/api/open-banking/callback
```

In Getbeel lo trovi anche nella pagina della banca, con il pulsante **Copia**.

</Step>
<Step>

### Attiva l'applicazione collegando i tuoi conti [#attiva-lapplicazione-collegando-i-tuoi-conti]

Scegli **Activate by linking accounts** e accedi alla tua banca. L'applicazione si attiva in **modalità limitata**: leggerà solo i conti che colleghi qui. Collega tutti i conti che vuoi vedere in Getbeel.

</Step>
<Step>

### Carica ID e chiave in Getbeel [#carica-id-e-chiave-in-getbeel]

In Getbeel apri **Riconciliazione**, poi **Altre azioni** (⋯) → **Collega la banca**. Inserisci:

- l'**ID dell'applicazione**;
- la **Chiave privata (.pem)**, con **Scegli il file .pem**;
- il **Tipo di conto**: **Conto aziendale** (S.r.l. e partite IVA con home banking business) o **Conto personale**;
- il **Paese della banca**.

Scegli **Verifica e continua**.

</Step>
<Step>

### Scegli la banca e accedi [#scegli-la-banca-e-accedi]

Cerca la tua banca in **Cerca la tua banca** e scegli **Vai alla banca**. Accedi come fai di solito e autorizza la lettura dei conti. Hai 30 minuti, nello stesso browser.

</Step>
</Steps>

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

- **Hai un account Enable Banking** a nome dell'azienda.
- **L'applicazione è tua**, con la tua chiave privata.
- **Getbeel può ricevere il ritorno** dalla banca all'indirizzo autorizzato.
- **L'applicazione è attiva** e vede solo i conti che hai collegato.
- **Getbeel ha verificato la chiave** con Enable Banking e l'ha salvata cifrata (AES-256): non è più visibile a nessuno, nemmeno a te.
- **La banca è collegata.** I movimenti degli ultimi 90 giorni arrivano in **Riconciliazione** in pochi minuti, un estratto per conto e per mese, già abbinati alle fatture.

## Dopo il collegamento [#dopo-il-collegamento]

- **Aggiornamenti**: ogni 6 ore. Con **Sincronizza ora** aggiorni subito.
- **Consenso**: la banca lo concede per un massimo di 180 giorni (alcune banche meno). Sette giorni prima della scadenza, e di nuovo se scade, Getbeel manda un'email ai proprietari del team e mostra un avviso in Riconciliazione. Scegli **Ricollega** e rifai l'accesso alla banca. I movimenti già scaricati restano.
- **Movimenti in attesa**: quelli che la banca non ha ancora contabilizzato compaiono sotto il conto come **In attesa di contabilizzazione**. Non vengono abbinati; quando la banca li contabilizza diventano movimenti normali.
- **Fornitori esteri**: come per gli estratti caricati, l'AI riconosce i pagamenti a fornitori esteri e li propone in **Autofatture**.
- **Più banche**: con **Collega un'altra banca** ne colleghi fino a 10.
- **Scollega**: chiude il consenso presso la banca e cancella la chiave. Estratti e abbinamenti restano.

<Callout title="Sola lettura">
  Getbeel usa la chiave solo per leggere i movimenti dei conti autorizzati. Non
  può disporre pagamenti.
</Callout>

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

| Messaggio                                                                            | Causa                                                          | Cosa fare                                                                                                            |
| ------------------------------------------------------------------------------------ | -------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| "Questo non è il file della chiave privata"                                          | Hai caricato un file diverso dalla chiave                      | Carica il file `.pem` esportato al passo 2 (inizia con `-----BEGIN PRIVATE KEY-----`), non il certificato            |
| "Enable Banking non riconosce l'ID dell'applicazione o la chiave"                    | ID e chiave di applicazioni diverse, o applicazione non attiva | Controlla che siano della stessa applicazione e rifai il passo 4                                                     |
| "La tua applicazione Enable Banking non consente l'indirizzo di ritorno di Getbeel"  | Manca l'indirizzo tra gli Allowed redirect URLs                | Rifai il passo 3: l'indirizzo deve essere identico                                                                   |
| "La banca non ha condiviso nessun conto"                                             | L'applicazione è in modalità limitata senza conti              | Collega i conti in Enable Banking (passo 4), poi **Ricollega**                                                       |
| "Completa l'accesso alla banca nello stesso browser in cui l'hai avviato su Getbeel" | Hai finito l'accesso su un altro browser o dispositivo         | Ricomincia da Getbeel con **Ricollega** e completa l'accesso alla banca in quel browser, non su un altro dispositivo |
| "Il collegamento è scaduto (hai 30 minuti per completare l'accesso alla banca)"      | Sono passati più di 30 minuti                                  | Riprova dal passo 6                                                                                                  |
| "L'accesso è stato annullato o rifiutato dalla banca"                                | Hai annullato, o la banca ha rifiutato                         | Riprova quando vuoi                                                                                                  |
| "Hai già collegato 10 banche"                                                        | Hai raggiunto il limite                                        | Scollega una banca per aggiungerne un'altra                                                                          |
| "Il consenso della banca è scaduto: ricollega la banca."                             | Sono passati i giorni del consenso, o l'hai revocato           | Scegli **Ricollega**                                                                                                 |

## Prossimi passi [#prossimi-passi]

<Cards>
  <Card
    title="Flusso di revisione"
    href="/it/guide/bank-reconciliation/review-workflow"
  >
    Conferma gli abbinamenti dei movimenti appena arrivati.
  </Card>
  <Card title="Autofatture" href="/it/guide/autofatture">
    I pagamenti a fornitori esteri, pronti come autofatture.
  </Card>
  <Card title="Collegamenti bancari via API" href="/it/api/bank-connections">
    Collega la banca da codice o dall'assistente AI.
  </Card>
</Cards>
