Come lo attiva uno studente
1
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.2
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»).
3
Import Mensile → Importa da Revolut Business
Scegli il periodo. Il tool mostra un’anteprima, poi importa.
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.Doc ufficiale Revolut Business API: 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.