Esporta o scarica le transazioni in CSV
Questo documento spiega come esportare i record delle transazioni, come viene consegnato il file di esportazione e come interpretare il formato CSV — incluse più voci per transazione.
Panoramica
L'esportazione CSV delle transazioni ti permette di scaricare i record di pagamento dettagliati per reportistica, riconciliazione, contabilità e conformità.
L'esportazione include:
- Tutte le transazioni oppure
- Solo le transazioni in base ai filtri o alla ricerca applicati
I file vengono consegnati tramite link di download via email e possono essere aperti in qualsiasi strumento per fogli di calcolo.
INDICE
- Panoramica
- Come esportare le transazioni
- Modalità di consegna via email
- Struttura del CSV e regole di formattazione
- Garanzie di coerenza dei dati (aggiornamento esportazioni)
- Guida di riferimento alle colonne (con esempi)
- Note speciali sulla formattazione
- FAQ
Come esportare le transazioni
- Vai su Pagamenti → Transactions
- Applica filtri o una ricerca se necessario (es. intervallo di date, stato del pagamento, tipo di sorgente)
- Clicca sull'icona Download
- Un link di download sicuro verrà inviato via email all'utente che ha effettuato l'accesso
Nota di sicurezza: Il link nell'email è valido per 7 giorni ed è unico per l'utente che ha richiesto l'esportazione.
Modalità di consegna via email
- Il link di esportazione arriva in pochi minuti
- Il file viene scaricato tramite il link ricevuto via email, non direttamente nell'app
- Se il link scade → genera semplicemente una nuova esportazione
Struttura del CSV e regole di formattazione
Ogni riga non corrisponde necessariamente a una sola transazione.
Una singola transazione può includere più:
- Prodotti → genera più righe
- Tasse → genera una riga per ogni nome di imposta univoco per prodotto
- Addebiti vari (spese di elaborazione, more, mance)
Questo garantisce che ogni componente finanziaria sia identificabile separatamente. Per garantire chiarezza, se la stessa transazione ha più righe, non tutte le colonne sono popolate in ogni riga: principalmente i dati univoci di prodotto o imposta vengono popolati in ogni riga, mentre i dati completi sono disponibili solo in 1 riga per transazione.
Garanzie di coerenza dei dati (aggiornamento esportazioni)
Queste esportazioni sono progettate per flussi di lavoro di riconciliazione, contabilità e BI con formattazione stabile e valori prevedibili.
Valori 0 e valori vuoti
- 0 appare solo quando il campo è applicabile e il valore è effettivamente zero.
- Vuoto appare solo quando il campo non è applicabile a quella riga/record.
Struttura stabile per la reportistica
- L'ordine delle colonne è coerente per supportare pivot, importazioni e pipeline BI.
- La formattazione su più righe è intenzionale per l'allocazione a livello di prodotto e di imposta (non assumere "una riga = una transazione").
Guida di riferimento alle colonne (con esempi)
| Nome colonna | Descrizione | Esempio |
|---|---|---|
| Internal transaction id | Identificatore univoco della transazione in HITLEAD | 69369a9968f735180bfeb6ed |
| Location id | Identificatore del sub-account | NyGCsdhgRZ8Ffa8Ssagfhd |
| Customer id | Identificatore cliente in HITLEAD | jbtyjkzMjvd8cLi9HUC |
| Customer name | Nome visualizzato dalla transazione | Alex Ray |
| Customer email | Email utilizzata per la consegna della ricevuta | alex@example.com |
| Customer phone | Numero di telefono utilizzato al checkout | +1 555-012-2345 |
| Payment method | Metodo utilizzato per il pagamento | Credit Card, Cash, Instant Transfer |
| Currency | Valuta della transazione | USD |
| Sub total | Totale prodotti prima di sconti e imposte esclusive | 100.00 |
| Discount | Totale sconti applicati al subtotale | -15.00 |
| Total tax amount (excluded in prices) | Imposta aggiunta al subtotale dopo la sottrazione degli sconti | 8.40 |
| Total tax amount (included in prices) | Imposta inclusa nei prezzi dei prodotti, già parte del subtotale | 0.00 |
| Tip amount | Mancia aggiunta volontariamente dal cliente; non inclusa nell'importo dovuto | 5.00 |
| Late fees | Mora aggiunta oltre il prezzo del prodotto | 10.00 |
| Total amount due | Totale originale dell'ordine/fattura (include subtotale, sconto, imposte, more); non considera i pagamenti parziali e mostra sempre l'importo iniziale dovuto per l'ordine o la fattura | 103.40 |
| Total amount paid | Importo effettivamente pagato in questa transazione (include l'importo dovuto più eventuali mance e spese di elaborazione) | 110.40 |
| Coupon code | Coupon applicato, se presente | WELCOME15 |
| Status | Stato della transazione | Success, Refunded |
| Live mode | Se si è verificata in modalità Live o Test (No) | Yes |
| Source type | Checkout in cui è avvenuto l'acquisto | Invoice, Funnel Page, Form |
| Source id | ID interno dell'entità sorgente, ovvero il checkout | inv_8281 |
| Source name | Nome visualizzato della sorgente come definito dall'azienda | Q4 Billing Invoice |
| Internal order id | Riferimento ordine in HITLEAD (se applicabile) | jfnkwbgfwbegiu234 |
| Payment provider | Il gateway utilizzato per eseguire la transazione | Stripe, NMI, Authorize.net |
| Subscription id | Riferimento abbonamento in HITLEAD, se applicabile | sub_7A91F |
| Charge id | Identificatore addebito del provider | ch_1NHXYZ |
| Connected account | ID account merchant/cliente del provider di pagamento collegato | acct_1sagewg732Hko |
| Transaction date | Data dell'addebito | Dec 8, 2025 |
| Transaction time | Ora dell'addebito | 03:00 PM |
| Timezone | Fuso orario del record | America/New_York |
| Is refunded | Riferimento allo stato del rimborso; NA se non rimborsato | Yes/No |
| Amount refunded | Importo totale rimborsato (somma tutti i rimborsi in caso di rimborsi multipli) | 25.00 |
| Refund date | Data in cui è avvenuto il rimborso (ultima data di rimborso in caso di rimborsi multipli) | Dec 9, 2025 |
| Line item name | Nome del prodotto | Annual Pro Plan |
| Line item quantity | Quantità acquistata del prodotto indicato nella colonna 'Product name' | 1 |
| Line item price | Prezzo per voce del prodotto indicato nella colonna 'Product name' | 100.00 |
| Line item coupon discount | Quota coupon per il prodotto indicato nella colonna 'Product name' | 15.00 |
| Line item subtotal | Subtotale specifico per il prodotto indicato nella colonna 'Product name' | 85.00 |
| Line item product id | Identificatore prodotto HITLEAD della colonna 'Product name' | prod_5449 |
| Tax name | Etichetta imposta univoca indipendentemente dai dati della voce — più prodotti o voci possono avere lo stesso nome imposta, ma viene mostrato una sola volta per transazione | Sales Tax |
| Tax amount | Valore dell'imposta per questa riga, indipendentemente dai dati della voce — le imposte per tutti i prodotti con questo nome verranno sommate e mostrate qui | 8.40 |
| Processing charge name | Nome della tariffa varia — massimo 1 per transazione; vuoto se nessuna tariffa | Platform Fee |
| Processing charge amount | Importo delle tariffe varie; vuoto se nessuna tariffa | 2.00 |
| Gift card order number | Se è stata usata una gift card; vuoto se la gift card non è stata utilizzata per la transazione | GC-ORD-19202 |
| Gift card amount used | Importo riscattato nella transazione tramite gift card; vuoto se la gift card non è stata utilizzata | 20.00 |
Note speciali sulla formattazione
- Più prodotti → genera più righe con lo stesso ID transazione
- Più imposte → ogni imposta appare su una riga separata e appartiene alle voci prodotto, ovvero ogni imposta avrà una riga univoca associata a un prodotto
Quindi se 2 prodotti hanno le stesse aliquote fiscali (2), le voci totali per la transazione saranno 4: la voce 1 con imposta 1 e imposta 2 genera 2 righe, e la voce 2 con imposta 1 e imposta 2 genera altre 2 righe.
- Pagamenti combinati (es. carta + gift card) → mostrati separatamente nelle colonne dei valori
Se filtri per totali, aggrega sempre con attenzione nei fogli di calcolo.
- Precisione dell'aliquota fiscale
I valori dell'aliquota fiscale (percentuale) vengono esportati con 4 decimali (ad esempio, 7.1250%) per supportare aliquote fiscali frazionarie e una reportistica coerente. I valori degli importi fiscali rimangono arrotondati a 2 decimali in base agli standard valutari.
FAQ
1. Perché una singola transazione mostra più righe nel CSV?
Perché i prodotti vengono tracciati per voce e i dettagli fiscali vengono tracciati per nome imposta univoco. Questo è lo standard per la reportistica di livello contabile.
2. Perché il Total Amount Due differisce dal Total Amount Paid?
- Spese di elaborazione
- Mance
- Pagamenti parziali
… influenzano il pagamento finale, non l'importo originale dovuto.
3. Perché alcune transazioni non compaiono nella mia esportazione?
Verifica che:
- I filtri siano stati rimossi
- L'intervallo di date corretto sia applicato
4. L'esportazione include le transazioni fallite?
Sì — a meno che tu non abbia filtrato per includere solo quelle Riuscite o Rimborsate.
5. L'esportazione include i rimborsi parziali?
Sì — Amount Refunded riflette l'importo totale cumulativo rimborsato.
6. Posso rigenerare un file già esportato?
Sì — l'esportazione può essere ripetuta in qualsiasi momento.
7. Chi può esportare le transazioni?
Solo gli utenti con i permessi per visualizzare le transazioni ed esportare i record.
Questo articolo è stato utile?