> For the complete documentation index, see [llms.txt](https://docs.sellermagnet.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sellermagnet.com/it-sellermagnet-guida/dashboard-e-analisi/dashboard-overview/reports.md).
# Report
{% hint style="info" %}
**Difficoltà:** 🟢 Principiante · **Tempo di lettura:** \~15 min
{% endhint %}
{% hint style="success" icon="rocket" %}
**Apri questa pagina nella tua dashboard:** [**Vai a Report →**](https://dashboard.sellermagnet.com/dashboard/reports)
{% endhint %}
La pagina **Report** è il vostro centro per generare, gestire e scaricare esportazioni dati personalizzate da SellerMagnet. Che abbiate bisogno di un report finanziario una tantum per il vostro commercialista, di un riepilogo settimanale delle vendite per il team o di un esportazione mensile delle performance per le parti interessate, il modulo Report gestisce tutto con tipi di report flessibili, programmazione e opzioni di consegna.
{% hint style="info" %}
I report estraggono dati da tutti gli altri moduli di SellerMagnet, ordini, prodotti, transazioni, spese e performance dei listing. Forniscono una istantanea dei vostri dati al momento della generazione, formattata per un facile utilizzo al di fuori di SellerMagnet.
{% endhint %}
***
## Video dimostrativo
{% hint style="info" %}
**Tutorial video in arrivo.** Una guida completa di questa funzionalità sarà disponibile qui a breve.
{% endhint %}
***
## 🗂️ Struttura della pagina
| Sezione | Scopo |
| ------------------------------ | ---------------------------------------------------------------------------------------- |
| **Panoramica statistiche** | Quattro schede statistiche che mostrano conteggi totali, completati, in attesa e falliti |
| **Barra azioni rapide** | Pulsanti per generare, programmare e aggiornare i report |
| **Schede filtro per stato** | Filtra la tabella report per stato (Tutti, Completati, In attesa, Falliti) |
| **Barra di ricerca** | Cerca report per tipo o nome |
| **Tabella report** | Elenco completo di tutti i report generati con stato, download e azioni |
| **Sezione report programmati** | Tabella delle programmazioni ricorrenti con stato e info prossima esecuzione |
***
## 📋 Panoramica statistiche
Quattro schede statistiche nella parte superiore forniscono un riepilogo rapido della vostra attività di reportistica:
| Scheda statistica | Descrizione | Indicatore colore |
| ----------------- | ------------------------------------------------------------- | ----------------- |
| **Report totali** | Numero totale di report mai generati | Blu |
| **Completati** | Report conclusi con successo e pronti per il download | Verde |
| **In attesa** | Report attualmente in fase di generazione o in coda | Giallo/Ambra |
| **Falliti** | Report che hanno riscontrato un errore durante la generazione | Rosso |
Ogni scheda è **cliccabile**, facendo clic su una scheda statistica si filtra la tabella per mostrare solo i report con quello stato.
{% hint style="info" %}
I report in attesa vengono generalmente completati entro 1-5 minuti a seconda del volume dei dati e dell'intervallo di date. Report molto grandi (12+ mesi su più marketplace) possono richiedere fino a 15 minuti.
{% endhint %}
***
## Barra azioni rapide
La barra delle azioni fornisce i controlli principali:
| Pulsante | Azione | Descrizione |
| ----------------------------------- | ---------------------------------- | ----------------------------------------- |
| **Genera Report** (blu, principale) | Apre la finestra di generazione | Crea un nuovo report una tantum |
| **Programma Report** | Apre la finestra di programmazione | Configura un report ricorrente automatico |
| **Aggiorna** | Ricarica la lista dei report | Aggiorna la tabella con gli ultimi stati |
***
## Schede filtro per stato
Sotto i pulsanti di azione, le schede filtro permettono di restringere la lista dei report:
| Scheda | Mostra | Badge |
| -------------- | -------------------------------------------- | -------------------- |
| **Tutti** | Tutti i report indipendentemente dallo stato | Conteggio totale |
| **Completati** | Solo i report generati con successo | Conteggio completati |
| **In attesa** | Report in fase di elaborazione | Conteggio in attesa |
| **Falliti** | Report che hanno riscontrato errori | Conteggio falliti |
***
## 📤 Tabella report
La tabella principale mostra tutti i report generati.
### Colonne della tabella
| Colonna | Descrizione |
| ------------------------ | ------------------------------------------------------------------------ |
| **Tipo di report** | Tipo di report (es. Ordini, Prodotti, Transazioni, Performance listing) |
| **Connessione** | Account/connessione Amazon Seller utilizzata per la generazione |
| **Marketplace** | Quale/i marketplace copre il report |
| **Intervallo temporale** | Intervallo di date coperto dal report |
| **Richiesto il** | Data e ora della richiesta del report |
| **Formato** | Formato del file (CSV, XLSX, JSON) |
| **Record** | Numero di righe dati nel report |
| **Stato** | Stato attuale: Iniziale, In attesa, In elaborazione, Completato, Fallito |
| **Azione** | Pulsanti di download o nuovo tentativo |
### Badge di stato
| Stato | Aspetto | Significato |
| ------------------- | ----------------------------------------- | --------------------------------------------------------------------------------- |
| **Iniziale** | Giallo/ambra (conteggiato come In attesa) | Il report è appena stato inviato ed è in attesa che il worker lo prenda in carico |
| **Completato** | Badge verde con segno di spunta | Il report è pronto per il download |
| **In attesa** | Badge giallo/ambra con orologio | Il report è in coda o in elaborazione |
| **In elaborazione** | Badge blu con indicatore di caricamento | Il report è in fase di generazione attiva |
| **Fallito** | Badge rosso con punto esclamativo | La generazione ha riscontrato un errore |
### Azioni
| Azione | Icona | Descrizione |
| ----------- | ---------------------- | -------------------------------------------- |
| **Scarica** | Icona download (verde) | Scarica il file del report completato |
| **Riprova** | Icona nuovo tentativo | Ritenta la generazione per un report fallito |
| **Elimina** | Icona cestino | Rimuovi il record del report |
***
## 📤 Passo dopo passo: Generare un report una tantum
1. Cliccate sul pulsante **"Genera Report"** nella Barra azioni rapide.
2. Si apre la finestra di generazione del report.
3. Compilate i parametri del report:
| Campo | Descrizione | Esempio |
| ------------------ | --------------------------------------- | ------------------------ |
| **Tipo di report** | Selezionate il tipo di dati desiderato | Report ordini |
| **Connessione** | Scegliete l'account Amazon sorgente | Il mio account Amazon EU |
| **Marketplace** | Selezionate uno o più marketplace | Amazon.de, Amazon.fr |
| **Data inizio** | Inizio del periodo del report | 2026-01-01 |
| **Data fine** | Fine del periodo del report | 2026-03-31 |
| **Formato** | Scegliete il formato del file di output | CSV |
4. Cliccate su **"Genera"** per inviare la richiesta del report.
5. La finestra si chiude e il report appare nella tabella con stato "In attesa".
6. Attendete che lo stato passi a "Completato" (generalmente 1-5 minuti).
7. Cliccate sul pulsante **Scarica** per salvare il file.
{% hint style="success" icon="rocket" %}
**Suggerimento:** Generate report trimestrali il primo giorno lavorativo di ogni nuovo trimestre. Questo crea un archivio coerente dei dati della vostra attività Amazon per l'analisi delle tendenze e la preparazione fiscale.
{% endhint %}
***
## 📤 Tipi di report disponibili
| Tipo report | Dati inclusi | Ideale per |
| ------------------------------ | --------------------------------------------------------------- | --------------------------------------------------------------- |
| **Report ordini** | Tutti i record ordine con prodotti, commissioni, COGS, profitto | Contabilità, preparazione fiscale, analisi redditività |
| **Report prodotti** | Catalogo prodotti con volumi di vendita, margini, ROI | Revisione performance prodotti, decisioni di approvvigionamento |
| **Report transazioni** | Tutte le commissioni e aggiustamenti Amazon | Analisi commissioni, ottimizzazione costi |
| **Report performance listing** | Sessioni, visualizzazioni pagina, conversione, Buy Box % | Analisi marketing, ottimizzazione listing |
| **Report spese** | Tutte le spese aziendali tracciate manualmente | Detrazioni fiscali, revisione budget |
| **Report inventario** | Livelli stock, previsioni, dati lotti | Pianificazione riordini, gestione magazzino |
| **Report Conto economico** | P\&L completo che combina tutte le fonti dati | Revisione aziendale mensile/trimestrale |
***
## ⚡ Report a esportazione diretta (istantanei)
Alcune voci nel menu a tendina del tipo di report sono contrassegnate con un **⚡ fulmine**. Queste sono fonti a **esportazione diretta** (sincrone): invece di essere messe in coda per un worker in background, si generano in modo **sincrono** e il file **viene scaricato immediatamente** nel vostro browser. Per queste non c'è alcuna riga "In attesa" da attendere.
{% hint style="info" %}
I report standard vengono messi in coda e appaiono nella tabella con uno stato che aggiornate fino a "Completato". I report a esportazione diretta ⚡ saltano la coda: cliccate Genera e il file inizia subito a scaricarsi.
{% endhint %}
Le fonti a esportazione diretta attualmente includono Ordini, Ordini rimborsati, Prodotti e COGS, Spese, Performance dei listing, Transazioni / Payout, Richieste di recensione, Campagne PPC, Parole chiave PPC, Cronologia ricerche Sourcer e un Riepilogo finanziario.
### Istantanee (nessun intervallo di date)
Alcune fonti a esportazione diretta sono **istantanee puntuali** dei vostri dati attuali, quindi non necessitano di un intervallo di date. Quando ne selezionate una, i campi Data inizio e Data fine scompaiono.
| Fonte istantanea | Cosa cattura |
| ------------------------------- | ---------------------------------- |
| **Prodotti e COGS** | Stato attuale di catalogo e costi |
| **Spese** | Registro completo delle spese |
| **Cronologia ricerche Sourcer** | Tutto ciò che avete cercato |
| **Campagne PPC** | Elenco attuale delle campagne |
| **Parole chiave PPC** | Elenco attuale delle parole chiave |
Le restanti fonti a esportazione diretta (Ordini, Ordini rimborsati, Transazioni, Performance dei listing, Richieste di recensione, Riepilogo finanziario) richiedono comunque una Data inizio e una Data fine.
### Anteprima prima di generare
Solo per le fonti a esportazione diretta ⚡, un pulsante **Anteprima** appare nella finestra di generazione. Cliccatelo per caricare un piccolo **campione di righe e colonne** così potete confermare di aver scelto la fonte, il marketplace e l'intervallo di date giusti prima di scaricare il file completo.
{% hint style="success" icon="rocket" %}
**Suggerimento:** Usate l'**Anteprima** per verificare prima le colonne e alcune righe. Se il campione risulta vuoto, il vostro marketplace o intervallo di date probabilmente non contiene dati, regolate i filtri prima di generare l'esportazione completa.
{% endhint %}
***
## 📤 Report programmati
La sezione Report programmati vi permette di automatizzare la generazione ricorrente di report.
### Colonne della tabella report programmati
| Colonna | Descrizione |
| ----------------------- | ------------------------------------------------------------------------------ |
| **Tipo di report** | Tipo di report generato |
| **Frequenza** | Con che frequenza il report viene generato (Giornaliero, Settimanale, Mensile) |
| **Consegna** | Come viene consegnato il report (Download, Email) |
| **Formato** | Formato del file (CSV, XLSX, JSON) |
| **Prossima esecuzione** | Data e ora della prossima generazione programmata |
| **Ultima esecuzione** | Data e ora della generazione più recente |
| **Stato** | Attivo o In pausa |
| **Azione** | Modifica, pausa/riprendi o elimina la programmazione |
### Passo dopo passo: Creare un report programmato
1. Cliccate sul pulsante **"Programma Report"** nella Barra azioni rapide.
2. Si apre la finestra di programmazione.
3. Configurate la programmazione:
| Campo | Descrizione | Esempio |
| ------------------------ | ------------------------------- | ------------------------- |
| **Tipo di report** | Tipo di report | Report ordini |
| **Connessione** | Account Amazon | Il mio account Amazon EU |
| **Marketplace** | Marketplace target | Tutti i marketplace EU |
| **Frequenza** | Con che frequenza generare | Settimanale (ogni lunedì) |
| **Intervallo temporale** | Quale periodo copre ogni report | Ultimi 7 giorni |
| **Formato** | Formato di output | CSV |
| **Metodo di consegna** | Come ricevere il report | Email + Download |
4. Cliccate su **"Salva programmazione"** per attivare.
5. La programmazione appare nella tabella dei report programmati con stato "Attivo".
{% hint style="warning" %}
I report programmati si generano automaticamente all'ora configurata. Assicuratevi che il vostro indirizzo email sia corretto nelle Impostazioni se avete selezionato la consegna via email. I report che non riescono a essere consegnati via email rimangono disponibili per il download manuale.
{% endhint %}
### Gestione dei report programmati
| Azione | Come fare |
| --------------------------------------- | --------------------------------------------------------------------------------- |
| **Mettere in pausa una programmazione** | Cliccate sul pulsante pausa nella riga della programmazione |
| **Riprendere una programmazione** | Cliccate sul pulsante riprendi su una programmazione in pausa |
| **Modificare una programmazione** | Cliccate sul pulsante modifica per cambiare frequenza, intervallo date o consegna |
| **Eliminare una programmazione** | Cliccate sul pulsante elimina per rimuovere definitivamente la programmazione |
***
## 📤 Scenario reale: Flusso di lavoro per report mensili
**Situazione:** Gestite un'attività Amazon e dovete fornire al vostro commercialista dati finanziari mensili.
| Report | Programmazione | Scopo |
| ---------------------- | ------------------------------------------------- | ---------------------------------------------------------------- |
| **Report ordini** | Mensile, 1 di ogni mese, dati del mese precedente | Record completi degli ordini per la riconciliazione dei ricavi |
| **Report transazioni** | Mensile, 1 di ogni mese, dati del mese precedente | Dettaglio commissioni Amazon per la categorizzazione delle spese |
| **Report spese** | Mensile, 1 di ogni mese, dati del mese precedente | Spese aziendali manuali per il tracking delle detrazioni |
| **Report P\&L** | Mensile, 1 di ogni mese, dati del mese precedente | Conto economico combinato |
Configurate queste quattro programmazioni una sola volta, e il vostro commercialista riceve dati puliti ogni mese senza alcuno sforzo manuale.
{% hint style="success" icon="rocket" %}
**Suggerimento:** Create un report programmato "Performance Q4" che si esegue settimanalmente da ottobre a dicembre. Durante la vostra stagione più intensa, dati settimanali vi aiutano a prendere decisioni più rapide su inventario, prezzi e pubblicità.
{% endhint %}
***
## 📊 Scenario reale: un report P\&L di marzo, dall'inizio alla fine
**Situazione:** È il 2026-04-01 e il vostro commercialista ha bisogno di un Conto economico per marzo. Vendete su Amazon.de tramite la vostra connessione "Il mio account Amazon EU".
**Passaggi:**
1. Cliccate su **Genera Report** e scegliete **Report Conto economico** come Tipo di report.
2. Impostate **Connessione** su *Il mio account Amazon EU* e **Marketplace** su *Amazon.de*.
3. Impostate **Data inizio** su `2026-03-01` e **Data fine** su `2026-03-31`.
4. Scegliete **XLSX** come formato (il vostro commercialista lo esamina a mano) e cliccate su **Genera**.
5. La riga appare come **In attesa**, passa a **In elaborazione** e arriva a **Completato** dopo circa due minuti. Cliccate su **Scarica**.
**Cosa contiene il file:** Il Report Conto economico combina i vostri dati di Ordini, Transazioni e Spese per il periodo in un unico prospetto. Per marzo si riassume in:
| Riga | Importo (EUR) |
| --------------------------------------- | ------------- |
| Ricavi lordi da prodotti | 48.250,00 |
| Rimborsi | -2.180,00 |
| **Ricavi netti** | **46.070,00** |
| Commissioni Amazon (segnalazione + FBA) | -11.540,00 |
| COGS (costo del venduto) | -18.900,00 |
| Spesa PPC / pubblicità | -3.420,00 |
| Spese aziendali tracciate | -1.150,00 |
| **Profitto netto** | **11.060,00** |
Il totale delle commissioni Amazon corrisponde a ciò che un **Report transazioni** autonomo per la stessa finestra di marzo sommerebbe, e la cifra COGS riflette i costi per unità che mantenete in Prodotti. L'IVA viene gestita separatamente dal vostro commercialista e non viene compensata in questa riga di profitto.
{% hint style="info" %}
La colonna **Record** conta il numero di righe dati scritte nel file, non un importo in valuta. Per un'esportazione per ordine è il numero di righe ordine; per un prospetto combinato come il P\&L è il numero di voci di riepilogo e di riga che il file contiene. Un report **Completato** che mostra **0** record significa che la query è andata a buon fine ma il vostro marketplace e intervallo di date non contenevano dati - ricontrollate i filtri anziché riprovare.
{% endhint %}
{% hint style="warning" %}
**Riprova vs. nuova esecuzione per un report programmato fallito:** Se un'istanza programmata termina in **Fallito**, la programmazione stessa non ne risente - scatta comunque al suo prossimo intervallo e genera ex novo per la nuova finestra relativa (per esempio, i successivi "ultimi 7 giorni"). Cliccare **Riprova** sulla riga fallita invece ritenta quella stessa istanza per il suo periodo originale. Usate **Riprova** per recuperare il report specifico che avete perso; attendete la prossima esecuzione se vi serve solo il periodo corrente.
{% endhint %}
***
## 📤 Formati dei file report
| Formato | Ideale per | Vantaggi | Limitazioni |
| -------- | -------------------------------------------------------- | ------------------------------------------------- | --------------------------------------------- |
| **CSV** | Importazione in software contabili, analisi dati | Compatibilità universale, dimensione file ridotta | Nessuna formattazione, nessun foglio multiplo |
| **XLSX** | Revisione manuale, condivisione con le parti interessate | Tabelle formattate, fogli multipli possibili | Dimensione file maggiore, richiede Excel |
***
## 🔧 Risoluzione problemi report falliti
Quando un report fallisce, controllate queste cause comuni:
| Causa | Sintomo | Soluzione |
| -------------------------------------- | ---------------------------------- | ------------------------------------------------------------------ |
| Intervallo date troppo ampio | Il report va in timeout | Riducete l'intervallo o dividetelo in periodi più piccoli |
| Limite frequenza API Amazon | Fallimenti intermittenti | Attendete 10 minuti e riprovate |
| Nessun dato per il periodo selezionato | Il report si completa con 0 record | Verificate che marketplace e intervallo date contengano dati reali |
| Connessione scaduta | Errore di autenticazione | Ri-autenticate la connessione Amazon nelle Impostazioni |
| Errore di elaborazione del server | Fallimento imprevisto | Cliccate Riprova; se persiste, contattate il supporto |
{% hint style="danger" %}
Se un report fallisce ripetutamente, non create decine di tentativi di ripetizione. Questo può mettere in coda lavori di elaborazione ridondanti. Provate una o due volte, poi contattate il supporto SellerMagnet con l'ID del report.
{% endhint %}
***
⚠️ Errori comuni da evitare
| Errore | Impatto | Approccio migliore |
| ---------------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------- |
| Generare report duplicati | Spreca risorse di elaborazione e ingombra la tabella | Controllate i report esistenti prima di generarne uno nuovo |
| Impostare intervalli di date troppo ampi | Generazione lenta, file enormi | Utilizzate intervalli mensili o trimestrali invece dell'anno intero |
| Non scaricare i report completati | I report potrebbero essere rimossi dopo un periodo di conservazione | Scaricate tempestivamente o configurate la consegna via email |
| Ignorare i report falliti | Dati mancanti per contabilità o analisi | Investigate i fallimenti e riprovate |
| Nessun report programmato | Dipendenza dalla generazione manuale ogni mese | Automatizzate i report ricorrenti con la funzione di programmazione |
| Selezione marketplace errata | I dati del report non corrispondono alle aspettative | Verificate la selezione marketplace prima di generare |
\## ✅ Migliori pratiche
1. **Automatizzate i report mensili:** Configurate programmazioni per i vostri quattro report principali (Ordini, Transazioni, Spese, P\&L) il 1 di ogni mese.
2. **Usate CSV per l'elaborazione dati:** Se pianificate di importare i dati in software contabili, scegliete sempre il formato CSV.
3. **Usate XLSX per la revisione umana:** Se il report verrà letto da una persona, XLSX offre una formattazione migliore.
4. **Mantenete intervalli di date gestibili:** I report mensili sono ideali. Trimestrali sono accettabili. I report annuali dovrebbero essere divisi per trimestre.
5. **Monitorate la coda In attesa:** Se vedete report bloccati in stato In attesa per più di 15 minuti, controllate lo stato della vostra connessione.
6. **Archiviate i report importanti:** Scaricate e conservate i report critici nel vostro cloud storage per la conservazione a lungo termine.
7. **Pulizia trimestrale:** Eliminate i vecchi report non più necessari per mantenere la pagina Report organizzata.
***
## 📤 Confronto: Report una tantum vs. programmati
| Funzionalità | Report una tantum | Report programmato |
| ------------------- | ----------------------------------- | --------------------------------------------------------- |
| **Generazione** | Attivazione manuale | Automatica secondo la programmazione |
| **Intervallo date** | Qualsiasi intervallo personalizzato | Relativo alla data di esecuzione (es. "ultimi 7 giorni") |
| **Consegna** | Solo download | Download + email opzionale |
| **Frequenza** | Una tantum | Giornaliero, settimanale o mensile |
| **Caso d'uso** | Analisi ad hoc, indagini specifiche | Report ricorrenti, aggiornamenti per le parti interessate |
| **Gestione** | Eliminare quando non più necessario | Pausa, riprendi o modifica la programmazione |
***
## ❓ FAQ
Per quanto tempo rimangono disponibili i report completati per il download?
I report completati vengono conservati per 90 giorni. Successivamente, il record del report potrebbe essere rimosso. Scaricate i report importanti tempestivamente o configurate la consegna via email per l'archiviazione automatica.
Posso generare report per più marketplace in un unico file?
Sì. Quando create un report, potete selezionare più marketplace. Il file generato conterrà dati da tutti i marketplace selezionati con una colonna identificativa del marketplace.
Su quale fuso orario si basano le date dei report?
I report utilizzano UTC come fuso orario base per i calcoli delle date. La colonna "Richiesto il" mostra l'ora nel vostro fuso orario locale. I filtri per intervallo date (Data inizio/Data fine) vengono interpretati nel fuso orario locale del marketplace.
Posso personalizzare le colonne che appaiono in un report?
I formati dei report sono standardizzati per includere tutte le colonne pertinenti al tipo di report selezionato. La personalizzazione delle colonne non è attualmente disponibile. Potete rimuovere le colonne indesiderate dopo aver scaricato il file.
C'è un limite al numero di report che posso generare?
Non c'è un limite rigido, ma generare molti report grandi simultaneamente può rallentare l'elaborazione. Vi consigliamo di generare un solo report grande alla volta e di attendere il completamento prima di avviare il successivo.
I report programmati possono essere inviati a più indirizzi email?
Attualmente, i report programmati vengono consegnati all'indirizzo email principale dell'account. Per la consegna a più destinatari, inoltrate l'email o utilizzate un cloud storage condiviso per i file scaricati.
Cosa succede se un report programmato fallisce?
La programmazione continua a essere eseguita al suo prossimo intervallo. L'istanza fallita appare nella tabella report con stato "Fallito". Riceverete una notifica riguardo al fallimento. La prossima esecuzione programmata tenterà la generazione dall'inizio.
***
## ➡️ Cosa fare dopo?
{% content-ref url="/pages/gj4yBqSaODXfK4E1RShU" %}
[Panoramica della Dashboard](/it-sellermagnet-guida/dashboard-e-analisi/dashboard-overview.md)
{% endcontent-ref %}
{% content-ref url="/pages/H3GRsPkp30FekCGPHAI5" %}
[Spese](/it-sellermagnet-guida/dashboard-e-analisi/dashboard-overview/expenses.md)
{% endcontent-ref %}