Vai al contenuto principale

Per iniziare - Funzionamento e gestione della sincronizzazione

In questo articolo ti spieghiamo come funziona la sincronizzazione su Waltio.

📝 Descrizione

Come funziona la sincronizzazione con i tuoi wallet e le tue API? Una volta creata la connessione, verranno lette tutte le tue transazioni a partire dalla creazione del tuo account sulla piattaforma. In seguito, periodicamente, la sincronizzazione permette di recuperare automaticamente le tue nuove transazioni.


📂 Sincronizzazione automatica

Un'API o un wallet vengono sincronizzati automaticamente da Waltio. Le nuove transazioni vengono recuperate senza bisogno di riavviare l'importazione ogni volta.

Tutte le transazioni vengono aggiornate automaticamente ogni 7 giorni se effettui l'accesso a Waltio, e ogni 3 mesi se non effettui l'accesso.

⚠️ Le transazioni avvenute il giorno stesso della sincronizzazione non hanno ancora un valore espresso in moneta fiat. Il valore verrà aggiornato automaticamente nel prossimo report fiscale.

➕ Sincronizzazione manuale

Per i clienti con piano Smart ed Unlimited, è possibile avviare una sincronizzazione manuale quando desideri verificare rapidamente se una transazione recente è stata recuperata. La sincronizzazione manuale recupera principalmente le transazioni aggiunte dall'ultima sincronizzazione.

Dalla pagina Account:

  1. Apri l'account API o il wallet interessato.

  2. Clicca su Sincronizza.

  3. Attendi il completamento dell'operazione.

  4. Verifica la data dell'ultima sincronizzazione e le nuove transazioni importate.

💡 Limiti per piano:

  • Piano Smart: 1 sincronizzazione al mese per API (il contatore si azzera ogni 30 giorni)

  • Piano Unlimited: 3 sincronizzazioni al giorno per API (il contatore si azzera ogni 24 ore)

⚠️ Attenzione: I piani Free, Lite e Starter non hanno accesso alla sincronizzazione manuale.

📤 Mettere in pausa una sincronizzazione

La sospensione ti consente di interrompere temporaneamente il recupero di nuove transazioni da un'API. Utilizza questa opzione se desideri:

  • sospendere temporaneamente la sincronizzazione;

  • impedire a Waltio di interrogare una piattaforma;

  • mantenere la connessione e lo storico già importato senza eliminare l'account.

La messa in pausa non cancella le transazioni già presenti su Waltio. Potrai riattivare la sincronizzazione quando lo desideri.

👉 Contatta il supporto clienti tramite chat o all'indirizzo [email protected] per richiedere l'operazione.

📂 Archiviare un'API

La funzione Archivia è adatta quando non utilizzi più un account exchange o quando l'account è stato chiuso. L'archiviazione consente di:

  • interrompere i tentativi di sincronizzazione;

  • conservare lo storico delle transazioni già importate;

  • evitare che un account chiuso o inutilizzato rimanga in stato di errore nel tuo spazio.

Ad esempio, se hai chiuso il tuo account su una piattaforma, archivia l'API corrispondente invece di eliminarla.

Dalla pagina Account:

  1. Apri l'account exchange interessato.

  2. Clicca sui tre puntini e poi su Archivia.

  3. Non ci saranno più tentativi di sincronizzazione per questo account.

⚠️ La funzione Archivia è irreversibile, quindi utilizzala con cautela.

⚠️ Attenzione prima di eliminare un'API

Non eliminare un'API solo perché presenta un errore, è inattiva o perché non desideri più sincronizzarla.

L'eliminazione comporta la perdita dello storico associato a questa connessione e di tutte le modifiche apportate alle transazioni, con possibili ripercussioni sui calcoli e sui report fiscali. In alcuni casi, il recupero dello storico associato potrebbe rivelarsi impossibile (ad esempio, in caso di account chiuso). Ti consigliamo piuttosto di:

  • mettere l'API in pausa se l'interruzione è temporanea;

  • archiviarla se l'account è chiuso o definitivamente inutilizzato;

  • consultare la guida alla risoluzione dei problemi se l'API mostra un errore.

👉 Per risolvere un errore di sincronizzazione, consulta la nostra guida: Come risolvere un errore di API o di file.


💡 Buono a sapersi

Waltio si collega alle tue piattaforme di exchange tramite chiavi API in sola lettura: possiamo esclusivamente leggere i tuoi dati, senza mai effettuare trasferimenti o prelievi. Le chiavi pubbliche e segrete sono crittografate tramite un sistema KMS (Key Management Services) per proteggere i tuoi dati.

Hai ricevuto la risposta alla tua domanda?