# 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 e **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: Completato, In attesa, In elaborazione, Fallito |
| **Azione** | Pulsanti di download o nuovo tentativo |
### Badge di stato
| Stato | Aspetto | Significato |
| ------------------- | --------------------------------------- | ----------------------------------------- |
| **Completato** | Badge verde con segno di spunta | Il report e 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 è 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" %}
**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 è 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 | Contabilita, 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 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 lunedi) |
| **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, è il vostro commercialista riceve dati puliti ogni mese senza alcuno sforzo manuale.
{% hint style="success" %}
**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 %}
***
## 📤 Formati dei file report
| Formato | Ideale per | Vantaggi | Limitazioni |
| -------- | -------------------------------------------------------- | ------------------------------------------------- | --------------------------------------------- |
| **CSV** | Importazione in software contabili, analisi dati | Compatibilita 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 contabilita 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?
Si. Quando create un report, potete selezionare più marketplace. Il file generato conterra 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'e un limite al numero di report che posso generare?
Non c'e 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 tentera 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 %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.sellermagnet.com/it-sellermagnet-guida/dashboard-e-analisi/dashboard-overview/reports.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.