For the complete documentation index, see llms.txt. This page is also available as Markdown.

Report

Genera, pianifica e scarica report personalizzati per la tua attività Amazon. Scegli tra più tipi di report, filtra per marketplace e intervallo di date, e imposta report ricorrenti automatici per il

Difficoltà: 🟢 Principiante · Tempo di lettura: ~15 min

rocket

La pagina Report è il tuo centro per generare, gestire e scaricare esportazioni di dati personalizzate da SellerMagnet. Che ti serva un report finanziario una tantum per il tuo commercialista, un riepilogo settimanale delle vendite per il tuo team o un'esportazione mensile delle prestazioni per gli stakeholder, il modulo Report gestisce tutto con tipi di report flessibili, pianificazione e opzioni di recapito.

I report estraggono dati da tutti gli altri moduli di SellerMagnet, ordini, prodotti, transazioni, spese e prestazioni delle inserzioni. Forniscono un'istantanea dei tuoi dati al momento della generazione, formattata per un facile consumo fuori da SellerMagnet.


🎥 Video guida

Video tutorial in arrivo. Una guida completa di questa funzione sarà disponibile qui a breve.


🗂️ Struttura della pagina

Sezione
Scopo

Panoramica statistiche

Quattro schede statistiche che mostrano i conteggi totale, completati, in sospeso e falliti dei report

Barra delle azioni rapide

Pulsanti per generare, pianificare e aggiornare i report

Schede filtro per stato

Filtra la tabella dei report per stato (All, Completed, Pending, Failed)

Barra di ricerca

Cerca i report per tipo o nome

Tabella dei report

Elenco completo di tutti i report generati con stato, download e azioni

Sezione report pianificati

Tabella delle pianificazioni di report ricorrenti con stato e info sulla prossima esecuzione


📋 Panoramica statistiche

Quattro schede statistiche in alto forniscono un rapido riepilogo dell'attività dei tuoi report:

Scheda statistica
Descrizione
Colore indicatore

Total Reports

Numero totale di report mai generati

Blu

Completed

Report terminati con successo e pronti per il download

Verde

Pending

Report attualmente in generazione o in coda

Giallo/Ambra

Failed

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.

I report in sospeso in genere si completano entro 1-5 minuti a seconda del volume di dati e dell'intervallo di date. Report molto grandi (12+ mesi su più marketplace) possono richiedere fino a 15 minuti.


Barra delle azioni rapide

La barra delle azioni fornisce i controlli principali:

Pulsante
Azione
Descrizione

Generate Report (blu, primario)

Apre la finestra di generazione del report

Crea un nuovo report una tantum

Schedule Report

Apre la finestra di pianificazione

Imposta un report ricorrente automatico

Refresh

Ri-estrae l'elenco dei report

Aggiorna la tabella con gli stati più recenti


🔍 Schede filtro per stato

Sotto i pulsanti di azione, le schede filtro ti permettono di restringere l'elenco dei report:

Scheda
Mostra
Badge

All

Ogni report indipendentemente dallo stato

Conteggio totale

Completed

Solo report generati con successo

Conteggio completati

Pending

Report attualmente in elaborazione

Conteggio in sospeso

Failed

Report che hanno riscontrato errori

Conteggio falliti


📤 Tabella dei report

SellerMagnet Report

La tabella principale mostra tutti i tuoi report generati.

Colonne della tabella

Colonna
Descrizione

Report Type

Tipo di report (es. Orders, Product COGS, General Fees, Listing Performance)

Connection

Account/connessione Amazon Seller da cui è stato generato il report

Marketplaces

Quale/i marketplace copre il report

Time Range

Intervallo di date coperto dal report

Requested At

Data e ora in cui il report è stato richiesto

Format

Formato del file (CSV, XLSX, JSON)

Records

Numero di righe di dati nel report

Status

Stato corrente: Initial, Pending, Processing, Completed, Failed

Action

Pulsanti di download o nuovo tentativo

Badge di stato

Stato
Aspetto
Significato

Initial

Giallo/ambra (conteggiato sotto Pending)

Il report è appena stato inviato ed è in attesa che il worker lo prenda in carico

Completed

Badge verde con segno di spunta

Il report è pronto per il download

Pending

Badge giallo/ambra con orologio

Il report è in coda o in elaborazione

Processing

Badge blu con spinner

Il report è attivamente in generazione

Failed

Badge rosso con punto esclamativo

La generazione del report ha riscontrato un errore

Azioni

Azione
Icona
Descrizione

Download

Icona di download (verde)

Scarica il file del report completato

Retry

Icona di nuovo tentativo

Ritenta la generazione per un report fallito

Delete

Icona cestino

Rimuove il record del report


📤 Passo dopo passo: generare un report una tantum

  1. Fai clic sul pulsante "Generate Report" nella barra delle azioni rapide.

  2. Si apre la finestra di generazione del report.

  3. Scegli una modalità di Delivery con il controllo segmentato nella parte superiore della finestra. Questo decide come viene prodotto il report e quale elenco di tipi di report mostra il menu a discesa:

Modalità di recapito
Cosa fa
Opzioni di formato

Instant export

Scarica immediatamente dai dati che SellerMagnet già possiede. Nessuna coda, nessuna attesa.

CSV, Excel

Amazon report

Richiesto ad Amazon e costruito da un worker in background. Compare nell'elenco dei report sotto e lo scarichi una volta che è Completed.

CSV, Excel, JSON

  1. Compila i parametri del report:

Campo
Descrizione
Esempio

Report Type

Seleziona il tipo di dati che vuoi (l'elenco dipende dalla modalità di Delivery)

Orders

Report Options

Per alcuni tipi di Amazon report, spunta le caselle facoltative per includere dati extra

(varia per tipo)

Connection

Scegli da quale account Amazon estrarre

My Amazon EU Account

Marketplace(s)

Seleziona uno o più marketplace, o lascia su "All Marketplaces"

Amazon.de, Amazon.fr

Start Date

Inizio del periodo del report

2026-01-01

End Date

Fine del periodo del report

2026-03-31

Format

Scegli il formato del file di output

CSV

Preset rapidi di date: invece di scegliere le date a mano, usa i pulsanti sopra i campi delle date, Last 7 Days, Last 30 Days, Last 90 Days, This Month e This Year, per compilare Start Date ed End Date con un clic.

  1. Fai clic su "Generate Report" per inviare.

  2. Per un Instant export, il file si scarica immediatamente nel tuo browser e la finestra si chiude. Per un Amazon report, il report compare nella tabella con stato "Pending".

  3. Per gli Amazon report, attendi che lo stato cambi in "Completed" (in genere 1-5 minuti), poi fai clic sul pulsante Download per salvare il file.

rocket

⚡ Delivery: Instant export vs. Amazon report

Il menu a discesa dei tipi di report non mescola ogni tipo in un unico lungo elenco. Un controllo segmentato Delivery nella parte superiore della finestra Generate scambia il menu a discesa tra due tipi di report:

Modalità di recapito
Icona
Comportamento

Instant export

Fulmine

Generato in modo sincrono dai dati che SellerMagnet già memorizza. Il file si scarica immediatamente, non c'è una riga "Pending" da attendere. Solo CSV o Excel.

Amazon report

Logo Amazon

Richiesto ad Amazon e costruito da un worker in background. È in coda e finisce nell'elenco dei report con uno stato che aggiorni finché non è "Completed". CSV, Excel o JSON.

Prima c'era un unico menu a discesa dove gli instant export erano contrassegnati solo con un'emoji a fulmine. Non c'è più, il controllo Delivery ora rende la scelta esplicita e mantiene ogni elenco breve.

Fonti degli instant export

Selezionando Instant export il menu a discesa passa a queste fonti basate su registro (CSV/XLSX):

Orders, Refunded Orders, Products & COGS, Expenses, Listing Performance, Transactions / Payouts, Review Requests Sent, Financial Summary, Sourcer Lookup History, PPC Campaigns e PPC Keywords.

Snapshot (nessun intervallo di date)

Alcune fonti di instant export sono istantanee puntuali dei tuoi dati correnti, quindi non necessitano di un intervallo di date. Quando ne selezioni una, i campi Start Date ed End Date scompaiono.

Fonte snapshot
Cosa cattura

Products & COGS

Stato corrente del catalogo e dei costi

Expenses

Registro completo delle spese

Sourcer Lookup History

Tutto ciò che hai cercato

PPC Campaigns

Elenco corrente delle campagne

PPC Keywords

Elenco corrente delle parole chiave

Le restanti fonti di instant export (Orders, Refunded Orders, Transactions / Payouts, Listing Performance, Review Requests Sent, Financial Summary) richiedono comunque una data di inizio e fine.

Anteprima prima di generare

Solo per le fonti Instant export, un pulsante Preview compare nella finestra di generazione. Fai clic su di esso per caricare un piccolo campione di righe e colonne così puoi confermare di aver scelto la fonte, il marketplace e l'intervallo di date giusti prima di scaricare il file completo.

rocket

📤 Tipi di report disponibili (Amazon Reports)

L'elenco Amazon report è guidato dai tuoi dati e può cambiare nel tempo, quindi tratta quanto segue come indicativo invece che come un menu fisso. I tipi tipici includono:

Tipo di report
Dati inclusi
Ideale per

Orders

Record di ordini con prodotti e dati finanziari

Contabilità, riconciliazione del fatturato

Sales Summary

Cifre di vendita aggregate per il periodo

Istantanee rapide delle prestazioni

Inventory / Inventory Snapshot / Inventory Report / Inventory Forecast

Livelli di scorte, istantanee dello stato corrente e stime prospettiche della domanda

Pianificazione dei riordini, gestione del magazzino

FBA Returns

Resi per ordini FBA (Fulfilled by Amazon)

Analisi del tasso di reso e della qualità

FBM Returns

Resi per ordini FBM (Fulfilled by Merchant)

Analisi del tasso di reso e della qualità

Expenses

Spese aziendali tracciate manualmente

Detrazioni fiscali, revisione del budget

Product COGS

Catalogo prodotti con costo del venduto per unità

Revisione di margine e redditività

General Fees

Commissioni e aggiustamenti Amazon

Analisi delle commissioni, ottimizzazione dei costi

Listing Performance

Sessioni, visualizzazioni di pagina, conversione, % Buy Box

Analisi di marketing, ottimizzazione delle inserzioni

Repricing Log

Cronologia delle variazioni di prezzo automatizzate

Verifica del Repricer

Review Request Log

Richieste di recensione inviate

Tracciamento dell'outreach delle recensioni

Reimbursement Claims

Record dei reclami di rimborso Lost & Found

Tracciamento del recupero

Alerts History

Eventi di avviso passati

Revisione operativa

Seller Performance

Metriche di integrità e prestazioni dell'account

Monitoraggio della conformità

Alcuni tipi di Amazon report, come Inventory Snapshot, Inventory Forecast e Seller Performance, sono istantanee dello stato corrente e nascondono l'intervallo di date quando selezionati. Altri espongono caselle Report Options extra sotto il menu a discesa del tipo, spuntale per includere dati aggiuntivi nel file.


📤 Report pianificati

La sezione Report pianificati ti permette di automatizzare la generazione ricorrente dei report.

La pianificazione copre i tipi Amazon report (in coda). Gli instant export vengono eseguiti su richiesta, quindi non vengono pianificati.

Colonne della tabella dei report pianificati

Colonna
Descrizione

Report Type

Tipo di report in generazione

Frequency

Con quale frequenza il report viene eseguito (Daily, Weekly, Every 2 Weeks, Monthly), con il giorno scelto mostrato tra parentesi

Delivery

Come il report viene recapitato (Email, Webhook o Email + Webhook)

Format

Formato del file (CSV, XLSX, JSON)

Next Run

Data e ora della prossima generazione pianificata

Last Run

Data e ora della generazione più recente

Status

Active o Paused

Action

Interruttore pausa/ripresa, o eliminazione della pianificazione

Passo dopo passo: creare un report pianificato

  1. Fai clic sul pulsante "Schedule Report" nella barra delle azioni rapide.

  2. Si apre la finestra di pianificazione.

  3. Configura la pianificazione:

Campo
Descrizione
Esempio

Connection

Account Amazon

My Amazon EU Account

Report Type

Tipo di report

Orders

Marketplace(s)

Marketplace target, o "All Marketplaces"

All Marketplaces

Frequency

Con quale frequenza generare: Daily, Weekly, Every 2 Weeks o Monthly

Weekly

Day of Week

Mostrato per Weekly ed Every 2 Weeks, in quale giorno il report viene eseguito

Monday

Day of Month

Mostrato per Monthly, un giorno da 1 a 28

1

Send via

Metodo di recapito: Email, Webhook o Email + Webhook

Email + Webhook

Webhook URL

Mostrato quando è selezionato Webhook o Email + Webhook, l'URL che riceve il report finito

https://your-server.com/webhook

Format

Formato di output: CSV, Excel o JSON

CSV

  1. Fai clic su "Create Schedule" per attivare.

  2. La pianificazione compare nella tabella dei report pianificati con stato "Active".

Il selettore Day of Month si ferma a 28 di proposito, così una pianificazione mensile ha sempre un giorno valido in ogni mese, febbraio incluso.

Gestire i report pianificati

Azione
Come

Mettere in pausa una pianificazione

Spegni l'interruttore sulla riga della pianificazione

Riprendere una pianificazione

Riaccendi l'interruttore

Eliminare una pianificazione

Fai clic sull'icona del cestino per rimuovere permanentemente la pianificazione


📤 Scenario reale: flusso di reportistica mensile

Situazione: gestisci un'attività Amazon e devi fornire al tuo commercialista dati finanziari mensili.

Report
Pianificazione
Scopo

Orders

Mensile, il 1° di ogni mese, dati del mese precedente

Record completi degli ordini per la riconciliazione del fatturato

General Fees

Mensile, il 1° di ogni mese, dati del mese precedente

Ripartizione delle commissioni Amazon per la categorizzazione delle spese

Expenses

Mensile, il 1° di ogni mese, dati del mese precedente

Spese aziendali manuali per il tracciamento delle detrazioni

Imposta queste tre pianificazioni una volta, e il tuo commercialista riceve dati puliti ogni mese senza alcuno sforzo manuale.

rocket

📊 Leggere i tuoi risultati

La colonna Records conta il numero di righe di dati scritte nel file, non un importo in valuta. Per un'esportazione per ordine è il numero di righe d'ordine. Un report Completed che mostra 0 record significa che la query è stata eseguita correttamente ma il tuo marketplace e intervallo di date non contenevano dati - ricontrolla i filtri invece di riprovare.


📤 Formati di file dei report

Formato
Ideale per
Vantaggi
Limitazioni

CSV

Importazione in software di contabilità, analisi dei dati

Compatibilità universale, dimensione file ridotta

Nessuna formattazione, nessun foglio multiplo

XLSX

Revisione manuale, condivisione con gli stakeholder

Tabelle formattate, fogli multipli possibili

Dimensione file maggiore, richiede Excel

JSON

Alimentazione di dati in script o integrazioni

Leggibile dalla macchina, preserva la struttura annidata

Non pensato per fogli di calcolo; solo Amazon report

Il JSON è disponibile solo per i tipi di Amazon (in coda) report. Gli instant export producono CSV o Excel, se scegli JSON per un instant export, SellerMagnet mostra un errore che ti dice che il tipo supporta solo CSV ed Excel.


🔧 Risoluzione dei problemi dei report falliti

Quando un report fallisce, controlla queste cause comuni:

Causa
Sintomo
Soluzione

Intervallo di date troppo grande

Il report va in timeout

Riduci l'intervallo di date o suddividilo in periodi più piccoli

Limite di frequenza dell'API Amazon

Fallimenti intermittenti

Attendi 10 minuti e riprova

Nessun dato per il periodo selezionato

Il report si completa con 0 record

Verifica che il marketplace e l'intervallo di date abbiano dati effettivi

Connessione scaduta

Errore di autenticazione

Ri-autentica la tua connessione Amazon nelle Impostazioni

Errore di elaborazione del server

Fallimento inatteso

Fai clic su Retry; se persiste, contatta il supporto


⚠️ Errori comuni da evitare
Errore
Impatto
Approccio migliore

Generare report duplicati

Spreca risorse di elaborazione e ingombra la tabella

Controlla i report esistenti prima di generarne uno nuovo

Impostare intervalli di date troppo ampi

Generazione lenta, file enormi

Usa intervalli mensili o trimestrali invece dell'intero anno

Non scaricare i report completati

I report potrebbero essere ripuliti dopo un periodo di conservazione

Scarica prontamente o imposta il recapito via email

Ignorare i report falliti

Dati mancanti per contabilità o analisi

Indaga sui fallimenti e riprova

Nessun report pianificato

Affidarsi alla generazione manuale ogni mese

Automatizza i report ricorrenti con la funzione di pianificazione

Selezione errata del marketplace

I dati del report non corrispondono alle aspettative

Ricontrolla la selezione del marketplace prima di generare

## ✅ Buone pratiche

  1. Automatizza i report mensili: imposta pianificazioni per i tuoi report principali (Orders, General Fees, Expenses) il 1° di ogni mese.

  2. Usa CSV per l'elaborazione dei dati: se pensi di importare i dati in un software di contabilità, scegli sempre il formato CSV.

  3. Usa XLSX per la revisione umana: se il report verrà letto da una persona, XLSX fornisce una formattazione migliore.

  4. Mantieni gestibili gli intervalli di date: i report mensili sono ideali. Il trimestrale è accettabile. I report annuali dovrebbero essere suddivisi per trimestre.

  5. Monitora la coda Pending: se vedi report bloccati in Pending per più di 15 minuti, controlla lo stato della tua connessione.

  6. Archivia i report importanti: scarica e conserva i report critici nel tuo cloud storage per la conservazione a lungo termine.

  7. Pulizia trimestrale: elimina i report vecchi e non più necessari per mantenere organizzata la tua pagina Report.


📤 Confronto: report una tantum vs. pianificati

Funzione
Report una tantum
Report pianificato

Generazione

Attivazione manuale

Automatica secondo pianificazione

Intervallo di date

Qualsiasi intervallo personalizzato

Relativo alla data di esecuzione (es. "7 giorni precedenti")

Recapito

Gli instant export si scaricano immediatamente; gli Amazon report compaiono nell'elenco per il download

Email, Webhook o Email + Webhook

Frequenza

Una tantum

Giornaliera, settimanale, ogni 2 settimane o mensile

Caso d'uso

Analisi ad hoc, indagini specifiche

Reportistica ricorrente, aggiornamenti agli stakeholder

Gestione

Elimina quando non più necessario

Metti in pausa, riprendi o elimina la pianificazione


❓ FAQ

Per quanto tempo i report completati restano disponibili per il download?

I report completati vengono conservati per 90 giorni. Dopodiché, il record del report può essere ripulito. Scarica prontamente i report importanti o imposta il recapito via email per l'archiviazione automatica.

Posso generare report per più marketplace in un unico file?

Sì. Quando crei un report, puoi selezionare più marketplace. Il file generato conterrà dati da tutti i marketplace selezionati con una colonna identificatore del marketplace.

Su quale fuso orario si basano le date dei report?

I report usano UTC come fuso orario di base per i calcoli delle date. La colonna "Requested At" mostra l'ora nel tuo fuso orario locale. I filtri di intervallo di date (Start Date/End Date) sono interpretati nel fuso orario locale del marketplace.

Posso personalizzare quali colonne compaiono in un report?

I formati dei report sono standardizzati per includere tutte le colonne rilevanti per il tipo di report selezionato. La personalizzazione delle colonne non è attualmente disponibile. Puoi 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. Consigliamo di generare un report grande alla volta e attendere che si completi prima di iniziare il successivo.

I report pianificati possono inviare a più indirizzi email?

Attualmente, i report pianificati vengono recapitati all'email principale dell'account. Per il recapito a più destinatari, inoltra l'email o usa un cloud storage condiviso per i file scaricati.

Cosa succede se un report pianificato fallisce?

La pianificazione continua a essere eseguita al suo intervallo successivo. L'istanza fallita compare nella tabella dei report con stato "Failed". Riceverai una notifica sul fallimento. La prossima esecuzione pianificata tenterà una generazione fresca.


➡️ Cosa c'è dopo?

Panoramica della DashboardSpese

Ultimo aggiornamento