📝 Descrizione
Scopri il significato dello stato «In errore» per il tuo account API o per il tuo file su Waltio, oltre ai passaggi da seguire per risolvere il problema.
Questo stato indica che Waltio non riesce più a recuperare o a leggere correttamente i dati della piattaforma interessata. I dati già importati non verranno eliminati, ma le nuove transazioni non saranno più sincronizzate finché la situazione non verrà regolarizzata.
⚠️ Avvertenze
Non condividere mai la tua chiave segreta o la tua chiave API completa al di fuori dei nostri canali ufficiali: il team di Waltio potrà chiedertela unicamente tramite la chat del sito o via e-mail all'indirizzo
[email protected], attraverso un canale sicuro.Eliminare il tuo account API o il file in errore cancellerà tutte le tue transazioni e le modifiche apportate. Se hai apportato un numero consistente di modifiche alle tue transazioni, non eliminarlo: contatta invece il team di supporto per trovare un'altra soluzione.
📂 Risoluzione di un account API in errore
Una connessione API può andare in errore a causa di una chiave scaduta, eliminata o modificata, di un server remoto non disponibile o di un problema di sincronizzazione. Per risolvere un malfunzionamento legato a un'API:
Vai alla pagina Account in Waltio e consulta il messaggio di errore visualizzato sull'account interessato.
Se il messaggio indica che la chiave è scaduta o che le sue autorizzazioni sono cambiate, riconnettiti alla piattaforma interessata.
Elimina o disattiva la vecchia chiave API sulla piattaforma, se necessario, quindi crea una nuova chiave API. ⚠️ Attenzione: questo eliminerà tutte le transazioni e le modifiche che hai apportato su di esse (ad esempio l'aggiunta di etichette).
Clicca su Aggiungi un account e inserisci la nuova connessione API in Waltio.
Se Waltio ti chiede di Forzare la sincronizzazione, conferma l'azione.
Verifica che lo stato dell'account torni normale e che compaiano le ultime transazioni.
Se l'errore persiste, contatta il supporto specificando le seguenti informazioni:
Il nome della piattaforma.
Il messaggio di errore esatto.
Uno screenshot delle autorizzazioni della tua chiave API, se presente.
La conferma della modifica o della ricreazione della chiave API.
Ho chiuso un account e ora l'API mostra un errore. Cosa devo fare?
⚠️ Non eliminare l'API, altrimenti rischi di perdere l'intero cronologia delle transazioni senza possibilità di recupero.
Dalla pagina Account, clicca sul punto esclamativo accanto al messaggio di errore e poi sul pulsante Archivia.
Questo farà scomparire l'errore conservando la tua cronologia.
📂 Risoluzione di un file in errore
Un file viene rifiutato quando la sua struttura non corrisponde al formato previsto (esportazione errata, modifica del file, cambio di formato da parte della piattaforma o nuovo tipo di operazione). Per risolvere un malfunzionamento legato a un file:
Verifica di aver esportato l'intera cronologia delle transazioni.
Consulta il tutorial della piattaforma sul nostro Centro Assistenza per selezionare il tipo di esportazione idoneo.
Scarica nuovamente il file originale direttamente dalla piattaforma.
Vai in I miei account e importa il file originale senza aprirlo, né modificarne le colonne o il contenuto.
Se l'importazione fallisce di nuovo, prova a generare una nuova esportazione che copra lo stesso periodo.
Se il problema persiste, invia il tuo file originale al supporto tramite la chat.
💡 API o file: quale metodo preferire?
La scelta del metodo dipende dalla tua situazione:
Connessione API: consente di sincronizzare automaticamente le tue nuove transazioni.
File CSV / Excel: consigliato se la connessione API non è disponibile, se non copre l'intera cronologia o in caso di vincoli tecnici.
Per individuare il metodo ottimale, consulta il tutorial dedicato alla tua piattaforma nel Centro Assistenza.
💡 Quando contattare il supporto?
Contatta il team di supporto nei seguenti casi:
Il tuo account API rimane in errore dopo la creazione di una nuova chiave.
Hai apportato un gran numero di modifiche alle tue transazioni e non vuoi perderle.
Il tuo file conforme viene rifiutato ripetutamente.
Mancano delle operazioni dopo una ri-importazione o una ri-sincronizzazione.
Sei indeciso su quale file esportare o quali autorizzazioni concedere.
Per velocizzare la gestione della richiesta, comunica sempre il nome della piattaforma, il messaggio di errore esatto e la modalità di importazione utilizzata (API o File).
Non condividere mai la tua chiave segreta o la tua chiave API completa al di fuori dei nostri canali ufficiali: il team di Waltio potrà chiedertela unicamente tramite la chat del sito o via e-mail all'indirizzo [email protected], attraverso un canale sicuro.