curl -fsSL syncbank.app/install.sh | bash
incolla nel terminale
oppure
Installazione manuale richiede passaggi extra • Vedi il sorgente dello script
ONBOARDING
Inizia con SyncBank.
Se hai gia acquistato una chiave di licenza, grazie. Segui le istruzioni qui sotto per iniziare. Se incontri problemi, sentiti libero di contattarci.
Crea un account Enable Banking
Registra un'applicazione API (SyncBank)
Ottieni il file .pem e l'application ID
Attiva l'app collegando i tuoi conti bancari
Installa Sync Bank
Opzione piu veloce
Installazione manuale (.zip)
Attiva Sync Bank
Collega banche e destinazioni
Programma sincronizzazione e monitoraggio
~15 minuti
1
Crea un account Enable Banking
Vai su enablebanking.com e registrati.
SyncBank si collega alla tua banca tramite Enable Banking, un provider PSD2 autorizzato. Ti serve un account sviluppatore gratuito.
A
Registra un'applicazione API (SyncBank)
1. Nome applicazione:
Syncbank
2. URL di redirect consentiti:
https://syncbank.app/callback
3. Application description:
Sincronizza le tue transazioni nella tua app preferita
4. Email per questioni di protezione dati: il tuo indirizzo email
5. Privacy URL:
https://syncbank.app/privacy
6. URL termini:
https://syncbank.app/terms
7. Set your application environment to (production)
Devi essere in modalita production per recuperare le transazioni dentro Sync Bank, la modalita Sandbox serve solo per i test.
B
Ottieni il file .pem e l'application ID
1. Il tuo Application UUID - un identificatore univoco per la tua app
2. Un file private.pem key file — download and keep it safe
~ Tienili entrambi pronti - li inserirai nella procedura guidata.
C
Attiva l'app collegando i tuoi conti bancari
1. Open your application page.
2. Click Activate by linking accounts.
3. Choose country and bank, then complete the flow.
4. Approve read-only access.
Prima di aggiungere le tue banche dentro Sync Bank, devi prima collegare il conto su Enable Banking per attivarlo.
~3 minutes
2
Installa Sync Bank
Assicurati che
Docker Desktop sia installato. Sync Bank verra eseguito dentro un container leggero su qualunque computer, anche un NAS, un Raspberry o un piccolo server domestico.
A
Opzione piu veloce
Scegli la tua piattaforma, poi copia e incolla il comando di installazione nel Terminale o in PowerShell.
Una volta completato, puoi saltare l'opzione B 1-3 (installazione manuale .zip) qui sotto.
Una volta completato, puoi saltare l'opzione B 1-3 (installazione manuale .zip) qui sotto.
B
Installazione manuale (.zip)
2. Unzip it, and open terminal in that folder app.
3. Esegui il comando:
docker compose up -d
~3 minutes
3
Attiva Sync Bank
Sync Bank gira sulla porta 3030 per impostazione predefinita (es. http://127.0.0.1:3030)
1. Avvia l'app dal browser
https://localhost:3030/
2. Inserisci la chiave di licenza acquistata per attivare l'app (step 1-in-app)
3. Carica il tuo file .pem e aggiungi il tuo Application ID (step 2-in-app)
~5 minuti
4
Collega banche e destinazioni
SyncBank e progettato apposta per rendere la configurazione piu semplice. Dentro l'app troverai una guida in 5 passaggi per iniziare.
1. Connect your banks and authorize your read-only access
2. Abilita la tua destinazione preferita: Notion, Actual, Google Sheets, Airtable o CSV (step 3-in-app)
Ogni banca richiedera una nuova autorizzazione ogni 180 giorni. Tramite l'applicazione puoi monitorare i giorni rimanenti o inserire la tua email per ricevere notifiche.
~1 minuto
5
Programma sincronizzazione e monitoraggio
Puoi scegliere una data specifica per iniziare la prima sincronizzazione. Dopo quella sincronizzazione iniziale, il sistema recuperera automaticamente le nuove transazioni a partire dall'ultima data sincronizzata.
La prima sincronizzazione parte subito. Dopo, diventa automatica secondo la tua programmazione. Puoi vedere i log e monitorare le connessioni.
AIUTO
FAQ e supporto
Le transazioni non si sincronizzano
+
Per prima cosa verifica che l'autorizzazione bancaria sia ancora attiva. Puoi riautorizzarla al passaggio 2 se necessario. Controlla lo stato dell'ultima sincronizzazione al passaggio 5. Prova a sincronizzare di nuovo e aggiorna, oppure aspetta la prossima sincronizzazione programmata. Assicurati che le transazioni recenti non siano pendenti o gia incluse. Per ulteriore supporto, copia i log e inviali a [email protected].
Posso attivare la stessa licenza su piu computer?
+
Si. La stessa chiave di licenza SyncBank puo essere attivata su fino a 2 computer. Se in seguito vuoi spostarla su un'altra macchina, l'app supporta anche la disattivazione.
Cosa significa l'errore 429?
+
L'errore 429 significa che l'API ha limitato temporaneamente la richiesta perche sono state inviate troppe richieste in poco tempo. Nella maggior parte dei casi e temporaneo. Attendi qualche minuto e riprova.
Perche la mia licenza risulta inattiva o scaduta?
+
Questo significa che SyncBank non e riuscito a convalidare la tua licenza attuale come attiva. Le cause comuni sono una prova scaduta, una chiave non valida o una licenza non piu attiva. Reinserisci la chiave al passaggio 1, assicurati di essere online e riprova. Se risulta ancora inattiva, contatta il supporto con la tua chiave di licenza.
Perche SyncBank dice "No new transactions"?
+
Questo significa che SyncBank ha controllato correttamente la tua banca, ma non c'era nulla di nuovo da importare dall'ultima sincronizzazione. Nella maggior parte dei casi e normale. La banca potrebbe non aver ancora registrato nuove transazioni, oppure un pagamento recente potrebbe essere ancora pendente. Se ti aspettavi qualcosa, aspetta un po' ed esegui di nuovo la sincronizzazione.
Perche le mie transazioni non compaiono in Notion?
+
Di solito significa una di queste cose: la destinazione Notion non e abilitata, la chiave API o il database ID non sono stati validati, il database non e stato condiviso con l'integrazione Notion, mancano i mapping delle proprieta richieste oppure la licenza corrente non include il bundle Notion. Nota anche che le transazioni pendenti non vengono inviate a Notion finche non sono confermate dalla banca.
Perche le transazioni pendenti non vengono inviate alle mie destinazioni?
+
Questo e previsto. SyncBank invia prima le transazioni pendenti ad Actual, poi aspetta che la banca le confermi prima di scriverle su destinazioni come Notion, Google Sheets o CSV. Questo evita ID instabili e aiuta a prevenire duplicati. Quando la transazione viene confermata, SyncBank la abbina e scrive la versione confermata.
Perche vedo transazioni duplicate?
+
Le versioni attuali di SyncBank sono progettate per prevenire automaticamente i duplicati. Lo fanno tracciando separatamente le transazioni pendenti, aspettando che vengano confermate prima di scriverle su destinazioni come Notion, Google Sheets e CSV, e usando il riferimento stabile della banca come chiave di deduplicazione. SyncBank ricorda anche quali transazioni sono gia state importate o scritte, quindi non vengono inviate di nuovo nelle sincronizzazioni successive.
Se continui a vedere transazioni duplicate, di solito si tratta di vecchie voci legacy create prima che la transazione confermata sostituisse quella pendente. Nella maggior parte dei casi puoi mantenere la voce confermata e rimuovere il duplicato piu vecchio. Se i duplicati continuano a comparire, contatta il supporto e ti aiuteremo a indagare e ripulirli.
Se continui a vedere transazioni duplicate, di solito si tratta di vecchie voci legacy create prima che la transazione confermata sostituisse quella pendente. Nella maggior parte dei casi puoi mantenere la voce confermata e rimuovere il duplicato piu vecchio. Se i duplicati continuano a comparire, contatta il supporto e ti aiuteremo a indagare e ripulirli.
Non hai trovato quello che cercavi e ti serve ancora supporto?
+
Se non hai trovato la risposta che cercavi, contattaci a [email protected].