Quando carichi un file CSV o Excel, Finbooks controlla il formato e il contenuto prima di importare qualsiasi cosa. Se il file non corrisponde a quanto la connessione si aspetta, viene contrassegnato come Rifiutato e nessuna transazione viene importata.
Questo articolo spiega come leggere il risultato, le cause più comuni di rifiuto e cosa fare dopo.
Come capire cosa è andato storto
Subito dopo aver cliccato su Carica CSV, Finbooks convalida ogni file e ti porta alla fase Verifica risultati importazione. Segui questi passaggi per leggere il risultato:
nella fase Verifica risultati importazione, trova il tuo file nell'elenco
leggi le colonne Conteggio righe, Stato file e lo stato dell'importazione (vedi la tabella qui sotto)
se il file è Rifiutato con un certo numero di righe con errori, clicca su Vedi errori per aprire il pannello con i dettagli degli errori, dove puoi vedere l'errore specifico di ogni riga
clicca su Esporta errori per scaricare l'elenco degli errori come file CSV
Se lo stato dell'importazione è Non valido, non è disponibile alcun report degli errori: l'intestazione del file è errata, quindi non ci sono errori di riga da mostrare. Controlla l'intestazione confrontandola con la guida della tua connessione.
Quando l'intestazione è errata, l'app mostra un pulsante Download template CSV. È la soluzione più rapida: scarica il modello e copia al suo interno le tue transazioni.
Risultato dell'importazione in base allo stato del file:
Stato file | Conteggio righe | Stato importazione | Cosa significa |
Caricato | Numero di transazioni importate | Importato o In corso | il formato è corretto e il file è stato accettato |
Rifiutato | 0 | Non valido | l'intestazione del file è errata, non è stato importato nulla e non è disponibile alcun report degli errori |
Rifiutato | 0 | Numero di righe con errori | il file contiene righe che non possono essere lette, quindi l'intero file viene rifiutato e non è stato importato nulla |
⚠️ Gli errori non vengono salvati
I dettagli degli errori sono disponibili solo finché ti trovi nella fase Verifica risultati importazione. Se lasci la pagina o avvii un nuovo caricamento, vengono persi. Scarica il report degli errori con Esporta errori prima di uscire, oppure ricarica il file per vedere di nuovo gli errori.
Cause comuni di rifiuto e come risolverle
Controlla le cause qui sotto nell'ordine. La maggior parte dei rifiuti dipende dalle prime quattro.
Il tipo di file non corrisponde alla connessione
Alcune connessioni accettano solo file CSV, altre accettano file Excel (.xlsx) nativi. Consulta la guida alla connessione della tua piattaforma per verificare quale formato supporta.
Se la guida chiede il file esattamente come lo esporta la piattaforma, caricalo senza convertirlo. Salvare di nuovo un file in un formato diverso può modificarne la struttura.
Il file è stato modificato o salvato di nuovo
Aprire un CSV in Excel e salvarlo di nuovo può aggiungere modifiche che non vedi, ad esempio virgolette in più nell'intestazione o nelle prime righe. Questo basta per far rifiutare il file.
Se devi controllare un file, aprilo con un editor di testo semplice (Blocco note su Windows, TextEdit su Mac). Per saperne di più, leggi Cos'è un file CSV e come modificarlo.
Il file non è quello richiesto dalla guida alla connessione
Ogni guida alla connessione indica quale report scaricare. Un report diverso della stessa piattaforma, o un file di un'altra piattaforma, non corrisponderà alla struttura attesa.
Verifica di caricare il file richiesto dalla guida, che copra tutto il tuo storico, e nella connessione creata per quella piattaforma.
La piattaforma non è supportata con un file nativo
Se Finbooks non supporta il file nativo della piattaforma, l'esportazione della piattaforma non può essere caricata così com'è. Devi inserire le tue transazioni nel CSV personalizzato di Finbooks e caricarlo in una connessione personalizzata.
crypto, segui Guida alla compilazione del CSV di Finbooks crypto
finanza tradizionale (azioni, obbligazioni, ETF, derivati e simili), segui Guida alla compilazione del CSV di Finbooks TradFi
Per conoscere tutte le tue opzioni, leggi La mia piattaforma non è supportata: quali sono le mie opzioni?.
Il CSV personalizzato non rispetta il formato Finbooks
Se hai compilato un CSV personalizzato, il file viene rifiutato quando l'intestazione o le colonne non corrispondono al modello:
la prima riga deve essere l'intestazione e deve corrispondere esattamente a un modello Finbooks: stessi nomi delle colonne, stesso ordine, nessuna colonna in più o mancante
tutte le 13 colonne devono essere presenti, anche se alcune sono vuote
ogni riga è una singola transazione
le colonne obbligatorie devono essere sempre compilate
Per il CSV personalizzato crypto, l'intestazione può essere in inglese, italiano, francese, spagnolo o portoghese, purché corrisponda esattamente a un modello Finbooks. Per il CSV personalizzato TradFi, l'intestazione deve essere in inglese.
Come separatore tra le colonne puoi usare sia la virgola sia il punto e virgola.
L'intestazione del CSV personalizzato crypto, in inglese, è:
` TYPE,CATEGORY,TRANSACTION DATE,OUT CURRENCY,OUT AMOUNT,OUT FIAT VALUE,IN CURRENCY,IN AMOUNT,IN FIAT VALUE,FEE CURRENCY,FEE AMOUNT,NOTES,ORIGINAL ID `
L'intestazione del CSV personalizzato TradFi (solo in inglese) è:
` ASSET CLASS,TYPE,EXCHANGE CODE,CATEGORY,TRANSACTION DATE,OUTGOING ASSET,OUTGOING AMOUNT,INCOMING ASSET,INCOMING AMOUNT,FEE CURRENCY,FEE AMOUNT,POSITION ID,NOTES `
Puoi partire dal modello crypto, che contiene già l'intestazione.
Se l'intestazione è errata, l'app mostra un pulsante Download template CSV: scarica il modello e copia al suo interno le tue transazioni. Per il CSV personalizzato TradFi non esiste un link al modello, quindi segui la guida TradFi.
ℹ️ Crypto e finanza tradizionale sono separate
Usa il CSV personalizzato crypto per le crypto e il CSV personalizzato TradFi per gli investimenti tradizionali. Se nel tuo account vedi solo la sezione di finanza tradizionale, leggi Come attivare la sezione crypto.
Le date non sono in un formato supportato
La colonna TRANSACTION DATE è obbligatoria e deve usare uno di questi formati:
yyyy-MM-dd HH:mm:ss
yyyy-MM-dd HH:mm
dd/MM/yyyy HH:mm:ss
dd/MM/yyyy HH:mm
Ad esempio, una transazione del 02 gennaio 2024 alle 21:45 può essere scritta come 2024-01-02 21:45 oppure 02/01/2024 21:45.
Data e ora devono inoltre corrispondere al tuo fuso orario locale. Finbooks non può rilevare il fuso orario usato dalla piattaforma, quindi converti gli orari nel tuo orario locale prima di caricare il file.
I numeri usano la virgola decimale
Se usi la virgola come separatore decimale, devi racchiudere il numero tra virgolette, altrimenti la virgola viene letta come separatore di colonna e la riga si rompe. Puoi anche usare il punto come separatore decimale.
Formato | Esempio | Risultato |
Virgola decimale senza virgolette | 2999,85 | errato |
Virgola decimale con virgolette | "2999,85" | corretto |
Punto decimale | 2999.85 | corretto |
Mancano valori obbligatori
Cosa devi compilare dipende dal tipo di transazione:
Incoming, l'asset e l'importo ricevuti
Outgoing, l'asset e l'importo inviati
Trade, sia l'asset e l'importo inviati sia quelli ricevuti
Ogni riga richiede anche tipo, categoria e data. Per l'elenco completo delle colonne, consulta la guida per le crypto o per la finanza tradizionale.
La piattaforma ha cambiato il formato di esportazione
Le piattaforme aggiornano i loro file di tanto in tanto. Questo può causare un formato non supportato, colonne mancanti, tipi di transazione non riconosciuti o intestazioni che non corrispondono più.
Se ritieni che il file dovrebbe essere supportato, contatta il Supporto Finbooks. I dettagli sono nella sezione qui sotto.
Messaggi di errore comuni
Messaggio | Cosa significa di solito |
Some errors were found in the header: one or more column headers do not match our required format, and we are unable to suggest a valid correction. | l'intestazione del file non corrisponde a quella attesa: controlla il tipo di file, controlla se il file è stato modificato e verifica che l'intestazione corrisponda esattamente alla guida alla connessione o al modello del CSV personalizzato |
Unrecognised columns: no Finbooks CSV template matches this file | l'intestazione non corrisponde a nessun modello Finbooks in nessuna lingua supportata: confronta l'intestazione con il modello e correggi nomi e ordine, oppure ricomincia dal modello con Download template CSV |
Unrecognized section | il file contiene una sezione che il software non riesce a riconoscere: carica esattamente il report richiesto dalla guida alla connessione, senza modificarlo |
Se vedi un messaggio di errore tecnico inatteso, contatta il Supporto Finbooks e allega il file.
Non esistono importazioni parziali
Finbooks importa un file tutto o niente. Se anche una sola riga contiene un errore, l'intero file viene rifiutato e nessuna transazione di quel file viene importata.
Quando lo stato dell'importazione mostra un numero di righe con errori, apri Vedi errori per capire perché ogni riga non è andata a buon fine, correggi quelle righe nel file di origine e carica di nuovo il file. Poiché dal file rifiutato non è stato importato nulla, non creerai duplicati caricando il file corretto.
Cosa fare dopo
Segui questi passaggi dopo un rifiuto:
se lo stato dell'importazione mostra righe con errori, apri Vedi errori e scarica l'elenco con Esporta errori. Se mostra Non valido, non c'è alcun report degli errori: controlla invece l'intestazione
confronta l'errore con le cause qui sopra e correggi il file. Se l'intestazione è errata, clicca su Download template CSV e copia le tue transazioni nel modello
carica di nuovo il file corretto:
in una connessione esistente, clicca su Connessioni nel menu a sinistra, clicca sui tre puntini all'estremità della riga della connessione, poi seleziona Importa nuovo file
dall'ultima fase della procedura di caricamento, clicca su Importa nuovo CSV
controlla il nuovo risultato in Verifica risultati importazione
Se non vuoi compilare il file da solo, puoi usare il Servizio Conversione File CSV a pagamento. Il risultato dipende dai dati che fornisci.
Come contattare il Supporto
Se il file viene ancora rifiutato, contatta il Supporto Finbooks via chat o all'indirizzo customer.support@finbooks.com e invia:
il nome del file e la piattaforma da cui proviene
il file originale, esattamente come l'hai scaricato
il report degli errori scaricato con Esporta errori
Il nostro team verificherà se il formato è supportato e ti aiuterà con il passo successivo.
Per la procedura di caricamento completa, leggi Come importare un file CSV.
Risposte rapide
Posso caricare un file Excel?
Dipende dalla connessione. Alcune connessioni accettano file Excel (.xlsx) nativi, altre solo CSV. Consulta la guida alla connessione della tua piattaforma.
Perché il mio file mostra Non valido?
Non valido significa che l'intestazione del file è errata, quindi l'intero file è stato rifiutato e nessuna transazione è stata importata. Verifica di caricare il file richiesto dalla guida, senza modifiche, oppure che l'intestazione del tuo CSV personalizzato corrisponda esattamente a un modello Finbooks. La soluzione più rapida è il pulsante Download template CSV: scarica il modello e copia al suo interno le tue transazioni.
Perché Verifica risultati importazione non funziona dopo che ho lasciato la pagina?
I dettagli degli errori non vengono salvati quando lasci la procedura di caricamento. Carica di nuovo il file e clicca su Vedi errori prima di lasciare la pagina.
Da un file rifiutato viene importata qualche transazione?
No. Un file viene importato tutto o niente: se una riga contiene un errore, l'intero file viene rifiutato. Per un file Rifiutato, Conteggio righe mostra 0 perché nessuna transazione è stata importata.
Posso scaricare un report degli errori per un file Non valido?
No. Non valido significa che l'intestazione del file è errata, quindi non è disponibile alcun report degli errori. Controlla l'intestazione confrontandola con la guida alla connessione.
