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

# Reconciliation: Revolut Business

> Il collegamento diretto al conto Revolut Business: come lo attiva uno studente, cosa importa, quali limiti ha e cosa non è ancora stato provato in produzione.

Con Revolut Business il tool può **scaricare i movimenti direttamente dal conto**, senza export manuale. Il collegamento passa dalla Mattone Platform: è lei a custodire l'autorizzazione Revolut dello studente, il tool gliela chiede al momento del bisogno con una firma condivisa fra i due servizi.

## Come lo attiva uno studente

<Steps>
  <Step title="Collega Revolut sulla platform">Da `app.mattone.co` → **Connessioni** → **Revolut Business**. Parte l'autorizzazione sul sito Revolut: lo studente accede con il proprio account Business e approva. Il token resta sulla platform, mai nel tool.</Step>
  <Step title="Entra nel tool dalla platform">Serve entrare dal pulsante Reconciliation della platform: è così che il tool sa quale utente Mattone sei. Con il login classico il collegamento non funziona (errore «Mattone user not linked»).</Step>
  <Step title="Import Mensile → Importa da Revolut Business">Scegli il periodo. Il tool mostra un'anteprima, poi importa.</Step>
</Steps>

## Cosa importa e con quali regole

* Solo i movimenti **completati** (niente pending).
* **Tutti i conti** dell'account Revolut Business insieme: se lo studente ha un conto EUR e uno GBP, arrivano entrambi. Al momento dell'import questi movimenti **non vengono legati a nessun conto bancario** del tool: compaiono fra i movimenti del tenant senza conto di appartenenza, riconoscibili perché la loro origine dice che arrivano dalla sincronizzazione Revolut e non da un file.
* Restano però senza conto solo fino al **riavvio successivo** del tool: all'avvio, ogni movimento rimasto senza conto viene assegnato al **primo conto di tipo Revolut** dello spazio. È un'assegnazione automatica e non chiede conferma, quindi tocca anche i movimenti che **non** vengono da Revolut — per esempio quelli caricati da file su un conto poi cancellato, o su una banca diversa. Da settembre 2026 quando questo accade il tool lo **scrive nel registro**, con quante righe ha toccato e per quale spazio: se ti risulta un movimento finito sul conto sbagliato, è lì che si controlla.
* Periodo massimo **92 giorni** per volta, sempre con inizio e fine espliciti. Per un anno intero servono quattro sincronizzazioni.
* Se nel periodo scelto esistono **già** movimenti nel tenant, il tool si rifiuta di importare (protezione anti-doppioni). Scegli un periodo che non si sovrappone, oppure cancella prima l'import precedente.

## Stato reale

Il collegamento Revolut è **scritto ma mai eseguito con successo in produzione**: al 4 settembre 2026 il registro delle sincronizzazioni era vuoto e nessun movimento nel tenant Cosmica proviene dall'API. Cosmica usa l'export CSV mensile. Il primo studente (o Cosmica stessa) che lo attiva sta facendo il **collaudo**: fallo su un periodo corto, confronta il numero di movimenti con l'export della banca, e segnala al team cosa è successo. Vedi [Troubleshooting](/integrazioni/reconciliation/troubleshooting).

<Note>
  Doc ufficiale Revolut Business API: [https://developer.revolut.com/docs/api/business](https://developer.revolut.com/docs/api/business). Le chiavi dell'app Revolut e il segreto condiviso fra platform e tool vivono nelle variabili d'ambiente dei due servizi, mai qui.
</Note>


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