Esportare o scaricare le Sottoscrizioni come CSV

Questo documento spiega come esportare le Sottoscrizioni in un file CSV dettagliato per la conformità, l'analisi dei ricavi, il monitoraggio della retention e la gestione della fatturazione.

Panoramica

La funzione Subscriptions CSV Export ti permette di scaricare i record delle sottoscrizioni dalla Dashboard Pagamenti → Subscriptions.

Puoi esportare:

Tutte le sottoscrizioni dell'account, oppure
Solo le sottoscrizioni che corrispondono ai tuoi filtri/query di ricerca

L'export viene inviato via email come link di download sicuro che scade dopo 7 giorni.

Se il link scade → avvia semplicemente un nuovo export.

INDICE DEI CONTENUTI

Come esportare le Sottoscrizioni
Capire il formato dei dati
Garanzie di coerenza dei dati
Guida di riferimento alle colonne (con esempi)
Esempio di dati Sottoscrizione su più righe
FAQ

Come esportare le Sottoscrizioni

Vai su Pagamenti → Subscriptions
(Facoltativo) Applica ricerca o filtri:
- Stato (Active, Canceled, Past Due, ecc.)
- Tipo di prodotto
- Dati del cliente
- Provider, valuta o intervallo di date
Clicca su Download
Apri il link ricevuto via email → il CSV si scarica immediatamente

Capire il formato dei dati

Le sottoscrizioni spesso includono più:

Prodotti (voci)
Imposte

Pertanto, una sottoscrizione può generare più righe nel file — una riga per ogni voce e imposta (se applicabile).

Questo è necessario per una reportistica accurata a livello di prodotto e di imposta.

Suggerimento: quando vuoi sommare i totali in Sheets/Excel →

Raggruppa i valori per Subscription ID per evitare di contare due volte gli stessi importi.

Garanzie di coerenza dei dati (Exports Upgrade)

Gli export delle Sottoscrizioni sono formattati per analisi di fatturazione stabili e reportistica pronta per audit.

Valori 0 vs campi vuoti

0 appare solo quando il campo è applicabile e il valore è effettivamente zero.
Vuoto appare solo quando il campo non è applicabile (ad esempio, i campi del periodo di prova quando non esiste alcuna prova).

Struttura stabile per la reportistica

L'ordine delle colonne è coerente per supportare pivot, importazioni e pipeline BI.
L'output su più righe per le sottoscrizioni è intenzionale per l'accuratezza a livello di prodotto e di imposta; raggruppa per Subscription id per evitare il doppio conteggio.

Guida di riferimento alle colonne (con esempi)

Nome colonna	Descrizione	Esempio
Subscription id	ID interno del sistema per la sottoscrizione	`jfhbiabfoanfle13kj`
Location id	Identificativo del sub-account	`NyGCsdhgRZ8Ffa8Ssagfhd`
Customer id	Identificativo di sistema del cliente	`jbtyjkzMjvd8cLi9HUC`
Customer name	Nome visualizzato del cliente	`Maria Russell`
Customer email	Email registrata per il sottoscrittore	`maria@domain.com`
Customer phone	Telefono registrato per il sottoscrittore	`+1 480-555-7002`
Subscription start	Data di creazione della sottoscrizione	`Jan 05, 2026`
Subscription end	Data di fine se annullata o scaduta; Vuoto se la sottoscrizione non è terminata	`May 30, 2026`
Number of trial days	Durata del periodo di prova applicato; Vuoto se non c'è prova	`14`
Trial start	Primo giorno della prova; Vuoto se non c'è prova	`Jan 05, 2026`
Trial end	Data di fine prova; Vuoto se non c'è prova	`Jan 19, 2026`
Cancelled at	Timestamp di annullamento della sottoscrizione; Vuoto se non annullata	`Mar 15, 2026`
Payment method	Metodo usato per l'ultimo addebito riuscito	`Visa •1234`
Currency	Valuta della sottoscrizione	`USD`
Sub total	Totale prima di sconto e imposta esclusiva (non include le Setup Fee)	`200.00`
Discount	Sconto applicato (coupon ecc.)	`-20.00`
Total tax amount (excluded in prices)	Imposte applicate in aggiunta (non include nulla sulle Setup Fee)	`14.40`
Total tax amount (included in prices)	Imposte incluse nel prezzo (non include nulla sulle Setup Fee)	`0.00`
Total amount	Importo finale addebitato (dopo sconto e imposte; non include le spese di elaborazione)	`194.40`
Coupon code	Coupon applicato (se presente)	`WELCOME10`
Status	Stato del ciclo di vita della sottoscrizione	`Active`, `Past Due`, `Cancelled`
Live mode	Se la sottoscrizione è in modalità test o live	`Yes`, `No`
Source type	Origine del checkout come Funnel, Payment Link, Store	`Funnel`
Source sub type	Classificazione più specifica della fonte	`One-Step Checkout`
Source id	Identificativo interno del checkout	`fnl_0188`
Source name	Titolo visualizzato della fonte	`Health Coaching Funnel`
Payment provider	Stripe, NMI, Authorize.net, PayPal, Square	`Stripe`
Connected account	Account del provider usato per la fatturazione	`acct_5520XX`
Transaction date	Data dell'ultimo rinnovo con transazione riuscita	`Mar 05, 2026`
Transaction time	Orario dell'ultimo addebito	`2:10 PM`
Timezone	Fuso orario del sistema	`America/New_York`
Total products	Numero di prodotti legati alla sottoscrizione	`1`
Line item name	Titolo del prodotto	`Monthly Yoga Plan`
Line item quantity	Quantità del prodotto	`1`
Line item price	Prezzo per unità di prodotto	`200.00`
Line item discount	Sconto applicato al prodotto	`20.00`
Line item subtotal	Subtotale del prodotto (prima di imposte e commissioni)	`180.00`
Line item product id	ID di riferimento del prodotto	`prod_X7E12`
Tax name	Etichetta dell'imposta per la voce	`NY Sales Tax`
Tax amount	Quota di imposta allocata a questa voce	`14.40`
Last paused on date	Timestamp della pausa più recente	`April 01, 2026`
Resumed on date	Data di ripresa della sottoscrizione; è la data effettiva in cui una sottoscrizione in pausa riprende.	`April 10, 2026`
Pause end date	Data di fine prevista della pausa più recente; è la data in cui si prevede che una sottoscrizione in pausa termini la pausa.	`April 10, 2026`
Processing charge name	Nome di commissioni/costi aggiuntivi	`Platform Fee`
Processing charge amount	Valore della commissione	`2.50`

Esempio di dati Sottoscrizione su più righe

Esempio 1:

Una singola sottoscrizione con:

3 prodotti
2 imposte — entrambe esclusive

Il CSV potrebbe generare un totale di 6 righe:

2 righe per ogni prodotto
6 righe per le imposte, dove l'importo dell'imposta per ogni nome di imposta per ogni prodotto è una nuova riga

→ Tutte condividono lo stesso Subscription id

Esempio 2:

Una singola sottoscrizione con:

3 prodotti
2 imposte — entrambe esclusive sul prodotto 1, entrambe inclusive sul prodotto 2 e nessuna imposta sul prodotto 3.

Il CSV potrebbe generare un totale di 5 righe:

2 righe per 2 prodotti e 1 riga per il 3° prodotto
4 righe per le imposte: le prime 2 imposte sono nel formato <Tax Name 1> e <Tax Name 2>, le successive 2 nel formato <Tax Name 1 (Included in prices)> e <Tax Name 2 (Included in prices)>; la 5ª riga non ha valori nelle colonne delle imposte

→ Tutte condividono lo stesso Subscription id

FAQ

1. Perché vedo più righe per ogni sottoscrizione?

Perché ogni prodotto e/o imposta viene suddiviso singolarmente per una reportistica accurata.

2. Le sottoscrizioni annullate vengono incluse negli export?

Sì — a meno che tu non filtri per Status prima di esportare.

3. L'export mostra i valori e i dettagli aggiornati in base a un'azione di aggiornamento della sottoscrizione?

Sì, l'export mostra i dati più recenti della sottoscrizione indipendentemente dalla data di inizio, ovvero se prodotto, quantità, ecc. cambiano, nell'export verrà riportato il valore più recente.

4. Posso esportare lo storico di fatturazione delle sottoscrizioni?

Per lo storico completo di fatturazione → usa Transactions Export.

5. Chi può scaricare gli export delle sottoscrizioni?

Solo gli utenti con permesso di:

✔ Visualizzare le Sottoscrizioni

✔ Esportare le Sottoscrizioni

6. L'indirizzo del cliente è incluso?

Solo se raccolto tramite checkout — altrimenti le colonne rimangono vuote.

7. Perché Subscription End è vuoto?

Significa che la sottoscrizione è ancora attiva, non pagata, in prova, pianificata, ecc., ovvero che la sottoscrizione non è ancora terminata.

Questo articolo è stato utile?