In questa guida ti spiego passo passo come connettere il tuo account Swag a CryptoBooks.
I passaggi principali, che ti spiegherò nel dettaglio subito sotto, sono i seguenti:
Bisogna scaricare i file CSV della piattaforma Swaggy.
Caricare il file su CryptoBooks.
Bisogna scaricare anche il file CSV dalla piattaforma Swag Mining.
Modificare eventualmente il file CSV di Swag Mining inserendo le righe mancanti che CryptoBooks indica
Caricare il file CSV di Swag Mining modificato opportunamente nella connessione denominata “Swag Mining” su CryptoBooks
A causa di alcune limitazioni tecniche, il file CSV delle transazioni di mining avvenute su Swag necessita di una piccola modifica da parte dell'utente per poter essere importato regolarmente su CryptoBooks e mostrare i dati corretti.
Nel file originale scaricato dalla piattaforma vengono indicate solo le righe di Mining Production, mentre è necessario aggiungere manualmente le righe di Mining Payment.
In questa guida ti illustro come connettere tutte le tue piattaforme SWAG e come modificare, se necessario, il file CSV di Swag Mining correttamente.
ISTRUZIONI DETTAGLIATE
1. Scaricare i file dalla piattaforma Swaggy
Accedi alla piattaforma Swaggy con le tue credenziali.
Dal pannello sinistro, premi su “Transazioni”, cliccando sull’icona della bilancia, come nell’immagine qui sotto.
Potrai scegliere tra diversi “wallet”. Seleziona il primo wallet della lista da cui risultano transazioni.
Clicca, quindi, su “Filtra dati”.
Ti si aprirà un pannello che ti permette di indicare il periodo per cui elaborare il report. Dovrai indicare come data di partenza il 1° di gennaio dell’anno in cui hai cominciato ad operare in SWAG. Come data finale, lascia pure la data corrente in cui stai scaricando il file CSV.
A questo punto premi su “Esporta in CSV”: il file verrà direttamente scaricato sul tuo computer!
Una volta terminato con quel wallet, dovrai ripetere l’operazione per tutti i wallet che hanno almeno 1 transazione. Ad es., se adesso hai scaricato il file CSV con le transazioni del “Wallet Swaggy BTC”, e hai anche delle transazioni sul “Wallet Swaggy USDT”, dovrai filtrare i dati per il periodo corretto ed esportare il file CSV anche per quest’ultimo wallet.
Anche per questi wallet, dovrai premere su “Filtra Dati” e selezionare le medesime date, come illustrato poco sopra.
Puoi cambiare wallet scegliendo quello che desideri dal menu a tendina “Seleziona Conto”:
Suggerimento: rinomina i file scaricati in modo che siano facilmente identificabili. Ad es “Swaggy1”, “Swaggy2” e così via.
2. Caricare il file CSV “Swaggy”
Una volta che hai scaricato il file o i file di Swaggy, dovrai caricarli su CryptoBooks. Per fare questo, accedi al tuo account CryptoBooks e vai sulla sezione Connessioni:
Premendo sul tasto verde “Aggiungi Connessione +”, in alto a destra, ti si aprirà una schermata come quella sotto, dove dovrai cercare “Swaggy” (senza le virgolette) nella barra di ricerca e ti comparirà il risultato corretto, su cui dovrai cliccare per selezionarlo e procedere:
Una volta cliccato su Swaggy, potrai dare un nome alla connessione (per es., “Swaggy”).
Non cambiare la “categoria di default” e lascia quella preimpostata (Trading): semplicemente, premi su “Prossimo Step”:
Ti troverai davanti una schermata come questa qua sotto:
Cliccando su “Scegli il file +” ti si aprirà una finestra da cui dovrai scegliere il file che hai scaricato da Swaggy, come qui sotto: selezionalo e premi su “Apri” (oppure fai doppio click sul file):
Clicca su “Importa transazioni”, ed il gioco è fatto per quanto riguarda il file di Swaggy!
La connessione a Swaggy è stata correttamente aggiunta. Puoi procedere adesso con lo step 3 e scaricare il file delle transazioni di Swag Mining.
Se hai più file Swaggy: dalla pagina “Connessioni” troverai la tua connessione di Swaggy appena creata e il tasto “Aggiungi nuova import”: cliccando su questo tasto potrai caricare gli altri file di Swaggy eventualmente salvati.
3. Scaricare i file dalla piattaforma Swag Mining
Oltre al file o ai file CSV che hai scaricato da Swaggy, dovrai scaricare anche un altro file CSV, dalla piattaforma SWAG Shopping. Per scaricare questo file, dovrai innanzitutto andare su SWAG Shopping ed effettuare il login.
Poi, dovrai cliccare sul tasto “My Swag” in alto a destra e, con il menù a tendina aperto, selezionare “My Balance” e fare clic.
A questo punto, si aprirà una schermata nuova, con una lista delle transazioni. Rimanendo su “My Balance”, bisogna cliccare sul tasto “Estratto conto”:
Dovrai inserire le date del report. Metti il 1° gennaio (01/01) dell’anno in cui sei entrato in SWAG come data di partenza e come data di fine metti pure la data del giorno attuale. Dopo qualche secondo, comparirà un messaggio di conferma che il tuo report ti sta arrivando via email.
Aprendo la tua casella di posta elettronica, entro qualche minuto dovrebbe arrivarti l’email da parte di Swag contenente il report che hai appena richiesto.
Non allarmarti se vedi l’icona del PDF sul file da scaricare: si tratta comunque di un file CSV, il file è quello giusto! Come qua sotto:
Scarica il file dall’email sul tuo computer, eventualmente cambiagli pure il nome (senza aprire il file ma direttamente dalla cartella!) in qualcosa come “Swag Mining”.
4. Caricare il file CSV “Swag Mining”
Arriviamo ad una parte in cui devi prestare la massima attenzione per non commettere errori. Vedrai che seguendo queste indicazioni si tratta alla fine di un gioco da ragazzi!
Innanzitutto, apri il tuo account CryptoBooks, vai sulla scheda “Connessioni”; clicca sul pulsante “Aggiungi connessione”, in alto a destra: ti si aprirà un pannello come quello nell’immagine qui sotto. Cerca “swag” nella barra di ricerca e dovresti avere due soli risultati, vale a dire “Swaggy” e “Swag Mining”:
Bisogna scegliere “Swag Mining” e cliccarci sopra. Mi raccomando di accertarsi di aver scelto Swag Mining e non Swaggy.
Ora potrai dare un nome alla connessione in modo da poterla poi identificare facilmente; lascia pure come categoria principale “Trading”. Una volta assegnato il nome, premi su “Prossimo step”.
Clicca sul tasto “Scegli il file” e, dal menu che ti si apre, seleziona il file che - se hai seguito passo passo le indicazioni che ti ho appena fornito - hai scaricato per ultimo e che ti è arrivato per email.
Bisogna:
Non aprire il file con un software come “Spreadsheet” o “Excel”, perché ne modificherebbe il tipo e CryptoBooks non sarebbe più in grado di leggerlo. Una volta scaricato, fino a questo momento non andrà toccato il file! Lascialo così com’è.
Assicurarsi che il tipo di file sia proprio “CSV”.
Se non riesci a trovarlo, prova a guardare nella tua cartella “Download”, eventualmente ordinando i file per data di creazione dalla più recente alla meno recente: dovrebbe essere l’ultimo file che hai scaricato.
Una volta individuato il file delle transazioni di Swag Mining, clicca su “Carica file e importa transazioni”, che sarà diventato verde.
SE NON COMPAIONO ERRORI:
L’operazione di import delle transazioni potrebbe richiedere qualche minuto. La connessione a Swag Mining sarà visualizzabile sulla lista delle connessioni, mentre la lista delle transazioni si aggiornerà man mano che l’import procederà. Potrai ignorare il punto 5 di questa guida e la tua procedura di connessione alle tue piattaforme Swag sarà correttamente completata!
SE IL FILE NON VIENE CARICATO E COMPARE UN ERRORE:
Il file non verrà correttamente caricato su CryptoBooks nel caso in cui manchino - come spesso accade - le transazioni di acquisto del servizio di noleggio di alcune o tutte le macchine di tipo “variabile” ed “evolution”. Se nel caricamento del file dovesse comparire un errore come quello sottostante all’interno di un box rosso, non preoccuparti. Segui le indicazioni che sto per fornirti e risolverai tutto in pochi minuti! Per proseguire con la connessione, segui il passo 4 di questa guida, appena qui sotto.
Se invece compare un altro errore, come ad es. un errore riguardante il formato del file, scarica e ricarica su CryptoBooks nuovamente il file di Swag Mining premurandoti di non aprirlo, non toccarlo e non cambiarne neanche il nome.
5. Modificare il file CSV di Swag Mining
Se nell'upload del file per Swag Mining incappi in un errore come quello nell’immagine appena qui sopra, segui i passi qui sotto e risolverai l’errore in men che non si dica.
Lascia aperta la tua pagina di CryptoBooks; apri la cartella del tuo computer in cui hai salvato il file CSV di Swag Mining (in teoria, l’ultimo scaricato dall’email, quello che poi hai provato a caricare su CryptoBooks ma che dava errore) e aprilo con il blocco note o programma simile.
Importantissimo: bisogna utilizzare un software tra i seguenti:
Blocco note (Windows)
TextEdit (Mac)
Atom
E non altri come Word, WordPad, Google Docs, Visual Studio Code etc.Infatti, questi ultimi potrebbero modificare il file rendendolo illeggibile per CryptoBooks.
Nell’esempio qui sotto apriamo il file CSV tramite il software TextEdit del Mac:
Una volta aperto, dovremo scorrere il file fino alla fine:
e aggiungere una nuova riga, proprio in fondo a tutte quelle righe; in questa riga dovremo inserire la prima delle transazioni mancanti.
Dovremo poi ripetere l’operazione per ogni transazione mancante.
Per il momento, copia e incolla in una riga nuova il seguente testo, che poi ti spiego come modificare opportunamente:
<yyyy-MM-dd HH:mm:ss.000>,<currency>,<amount>,,,,0,,Miner: <id>; Days: <days>,,MINING_PAYMENT
Ora, dovremo trovare tutti i dati da inserire al posto delle lettere / cifre indicate qui sopra.
Presta attenzione a quanto segue:
Bisogna cancellare i simboli < e >
Le virgole vanno mantenute esattamente come sono, e così anche i “due punti” ed i trattini.
Gli spazi vanno mantenuti esattamente come sono; se non ci sono spazi, non vanno aggiunti, se ci sono non vanno tolti.
Ecco un esempio di come sarà formattata una riga creata correttamente:
2023-08-15 00:31:58.000,BTC,0.0000000900,,,,0,,Miner: 56ZN-29KO-08EH-1PLQ; Days: 365,,MINING_PAYMENT
Ora ti spiego come riempire ogni “campo” (intendendo i parametri contenuti tra i simboli < e >).
Innanzitutto, dovrai tornare sul tuo account “Swag Mining” e cliccare nuovamente su “My Balance”:
Ti comparirà una schermata che hai già visto poco fa.
In questo caso dovremo però premere su “Macchine” e ti si aprirà la lista delle tue macchine, divise per categorie.
Dobbiamo trovare le macchine che hanno i codici che ci mancano e che CryptoBooks ha rilevato nel box rosso poco sopra. Quindi, torna sulla scheda di CryptoBooks, visualizza i codici che sono indicati come mancanti da CryptoBooks e cercali aprendo le varie schede di ogni macchina nella schermata di Swag Mining e guardando il relativo codice, per capire se è quello che cerchiamo.
Quando hai trovato la macchina con il codice corrispondente (come per es. nell’immagine qui sotto), presta attenzione:
Il codice di 16 cifre deve corrispondere a quello che CryptoBooks richiede. Ora, da questa schermata hai tutti i dati che ti servono:
Il codice macchina (indicato come “ID Ordine”) è quello che deve corrispondere a quello richiesto da CryptoBooks.
Ora, torna sul file CSV che stai modificando e dove hai inserito la riga con il template e sostituisci i dati della riga contenuti tra i simboli <> in modo che contengano quelli che hai appena trovato. I dati da inserire sono i seguenti:
<yyyy-MM-dd HH:mm:ss.000>: si tratta della data che, nell’immagine qui sopra, vedi nel riquadro blu, la prima delle due. In altre parole è il giorno in cui hai effettuato l’acquisto di quella macchina. Nella data bisogna mettere la cifra con il formato americano, non italiano. Quindi, presta attenzione che bisogna inserire prima l’anno, poi la cifra che corrisponde al mese, e solo alla fine la cifra che corrisponde al giorno, nel formato “yyyy-MMM-dd”.
Inoltre, se le ore, minuti e secondi non sono indicati nella pagina della macchina variabile, inserisci 00:00:00 .<currency>: l’acronimo indicato della valuta, in questo caso BTC.
<amount>: l’ammontare pagato per il noleggio della macchina. Ci sono due cifre di Bitcoin: attenzione a copiare e incollare la cifra che è indicata come “valore”, e non quella che sta nella medesima schermata e che viene indicata come “estr. Totale”.
Inoltre, nel copiare e incollare la cifra prestare massima attenzione a cambiare la virgola in punto decimale! Se non si fa così, il file non verrà letto da CryptoBooks, che darà errore.
Per intenderci, nell’esempio sopra bisogna cambiare da
0,26603574
a:
0.26603574<id>: dovrai copiare ed incollare l’ID dell’ordine della macchina (per intenderci, proprio quello che CryptoBooks ti ha segnalato come mancante e di cui stiamo prendendo i dati!).
<days>: è il parametro che va sostituito con il numero di giorni intercorso tra la data iniziale e la data finale di noleggio, indicata appena sotto (è la seconda delle due date indicate). Se, ad es., la data di inizio noleggio è 01/01/2022 e la fine è 31/12/2022, dovrai inserire 365. Per calcolare il numero di giorni tra due date, puoi utilizzare questo calcolatore automatico.
Tutti gli altri dati, cifre, simboli e caratteri vanno lasciati così come sono!
Se dovessimo inserire i dati indicati nell’immagine qui sopra, la riga template seguente:
<yyyy-MM-dd HH:mm:ss.000>,<currency>,<amount>,,,,0,,Miner: <id>; Days: <days>,,MINING_PAYMENT
diventerebbe →
2021-10-15 00:00:00,BTC,0,26603574,,,,0,,Miner: XPIY-U982-10LH-SWFE; Days: 1141,,MINING_PAYMENT
→ Devi ripetere questa operazione per ogni macchina che ti viene segnalata come mancante!
Per es., nello screenshot qui sotto abbiamo un totale di 11 ID di macchine mancanti: dovremo cercarle tutte quante e inserire per ciascuna di esse una riga nuova con i dati inseriti come ti ho appena mostrato, ricavandoli dalla scheda specifica di quella macchina nella sezione “Macchine” del Balance di Swag.
Ecco come dovrebbe apparire il file CSV modificato opportunamente, con una riga nuova per ogni macchina (nel riquadro verde ti mostro le righe inserite manualmente):
Macchine Evolution
Non solo le macchine “Variabili” possono mancare dal file CSV, ma anche le macchine “Evolution”. Si trovano un po’ più sotto rispetto alle macchine variabili, sempre nella sezione Swag Shop → Balance → Macchine e per ciascuna macchina trovi una scheda simile a quella che trovi per le macchine variabili. Esattamente come per le macchine variabili, dovrai inserire i dati nella riga template che ti ho fornito, e aggiungere una riga al file CSV.
→ Per istruzioni su come inserire i dati delle macchine Evolution sul file CSV, riferirsi alla guida per le macchine variabili appena sopra!s
In alcuni casi, tuttavia, potrebbero mancare dei dati e la scheda apparire diversa da quella delle macchine variabili. Nell’es. sottostante manca la cifra in Bitcoin pagata per il noleggio di quella macchina:
Innanzitutto, completiamo la riga da inserire nel file CSV (il template è sempre lo stesso, lo trovi sopra) con i dati a disposizione in questa scheda, che sono tutti eccetto il parametro <amount> e <CURRENCY>.
Potremo quindi già riempire i parametri <yyyy-MM-dd HH:mm:ss.000>, <id> e <days>.
Per trovare <amount> e <currency>, segniamoci la data di inizio (nello screenshot sopra è il 07/03/2024).
Andiamo su Ordini, dal pannello sinistro, come nello screenshot seguente:
Cerchiamo un ordine che possa essere stato effettuato nel giorno che ci siamo segnati, oppure il giorno precedente (nello screenshot qui sotto abbiamo trovato l’ordine che è stato eseguito il 6 marzo, mentre ci eravamo segnati la data del 7 marzo come inizio noleggio).
Come vedrai, c’è indicato l’ammontare pagato: ecco il nostro “amount”! Insieme, c’è anche la <currency> (= valuta), vale a dire BTC.
A quel punto avremo completato la riga da inserire nel file CSV con gli ultimi due parametri mancanti: vai sul CSV; inserisci la riga mancante con tutte queste informazioni e il gioco è fatto!
Ricordati che devi ripetere l’operazione per tutti gli id delle macchine Evolution mancanti, che CryptoBooks ti segnala!
6. Caricare il file CSV “Swag Mining” opportunamente modificato
Per caricare il file che hai modificato inserendo le righe per ogni macchina mancante segnalata da CryptoBooks, dovrai semplicemente ripetere gli step segnati al punto 4 di questa guida.
Se dovessi incappare ancora in qualche errore:
Assicurati che il file sia ancora in formato CSV.
Se sono indicati degli ID di macchine mancanti, integra il file CSV ulteriormente, salvalo e ricaricalo su CryptoBooks
Se compare un errore strano che non è quello che ti ho mostrato un po’ sopra, probabilmente il file è stato corrotto: dovrai riscaricarlo e modificarlo nuovamente. Attenzione che in questi casi, di regola, il problema è che lo hai modificato o salvato con un editor che non va bene! Assicurati di aver modificato il file con uno degli editor suggeriti sopra.
Se tutto è andato a buon fine, dopo qualche minuto l’import dei file sarà terminato e il tuo saldo (nella sezione “Dashboard” nonché nella sezione Portfolio” sarà pari a quello effettivamente detenuto sui tuoi account di Swag.
Se non hai altre connessioni, potrai scaricare direttamente i report che ti servono dalla sezione Report!