DOCS

Per gli utenti di Checkout

Report scaricabili per gli utenti di Checkout

Scopri come ottenere i dati di cui hai bisogno dai report scaricabili.

I report scaricabili offrono ai merchant di Checkout i dati necessari per la riconciliazione e l'analisi. Questi report, disponibili in USD e personalizzabili per intervallo di date, supportano casi d'uso comuni come la dichiarazione fiscale, la verifica degli ordini, l'analisi degli oneri e l'acquisizione di informazioni aziendali. La data e l'ora di tutti i report sono espresse in UTC.

Tipi di report 

Sono disponibili diversi report:

ReportDescrizioneCasi d'uso
Payout summaryStrutturato allo stesso modo del report Payout summary disponibile per ogni payout, ma con la selezione di un intervallo di date. La versione precedente è disponibile anche fino al 31 luglio 2025, per consentirti di aggiornare eventuali mapping che fanno riferimento a questo report.Analizza gli ordini nei tuoi payout a livello generale, con ogni ordine nella propria riga. Visualizza le commissioni di transazione e le commissioni del merchant.
Payout detailStrutturato allo stesso modo del report Payout detail disponibile per ogni payout, ma con la selezione di un intervallo di date. La versione precedente è disponibile anche fino al 31 luglio 2025, per consentirti di aggiornare eventuali mapping che fanno riferimento a questo report.Visualizza il dettaglio del tuo payout, incluso ciò che è stato trattenuto prima che il payout venisse inviato al tuo conto bancario.
Invoice summaryStrutturato allo stesso modo del report Invoice summary disponibile per ogni fattura, ma con un intervallo di date.Visualizza un riepilogo degli oneri che ti sono stati fatturati.
Invoice detailStrutturato allo stesso modo del report Invoice detail disponibile per ogni fattura, ma con un intervallo di date. Ogni singolo onere ha la propria riga nel CSV.Visualizza il dettaglio di tutti gli oneri che ti sono stati fatturati.
OrdersMostra tutte le informazioni principali su un ordine, senza entrare nei dettagli per articolo.Analizza gli ordini per prevedere le vendite, scoprire tendenze geografiche e identificare modelli stagionali.
Orders with item detailsElenca tutti gli articoli all'interno di un ordine (ogni articolo nella propria riga). Include informazioni sull'articolo, come quantità, sku, dimensioni, codice hs, ecc.Analizza gli ordini per determinare quali prodotti vendono meglio in ciascun paese.
Landed Cost breakdownVerifica i calcoli del landed cost con il dettaglio di dazi, imposte e commissioni.Dichiarazione fiscale periodica, verifica dei calcoli del landed cost.
Esporta un report
  1. Vai su Dashboard -> Reports
  2. Passa il mouse sopra il report desiderato e fai clic su Generate.
  3. Seleziona l'intervallo di date preferito.
  4. Fai clic su Generate report.
Struttura
Payout summaryPayout detailOrdersOrders with item detailsLanded cost breakdown
Ogni ordine ha la propria riga
Ogni onere dell'ordine ha la propria riga
Informazioni disponibili (riepilogo)
Payout summaryPayout detailOrdersOrders with item detailsLanded Cost breakdown
Informazioni sul cliente e numero di tracciamento
Informazioni sul payout
Commissioni di transazione e commissioni del merchant
Dettagli su dazi, imposte e commissioni
Dettagli dell'articolo (nome, SKU, codice HS, ecc.)
Numero di articoli dell'ordine e peso
Tutti i campi disponibili

Di seguito sono riportati i campi disponibili in ciascun report:

CampoPayout summaryPayout detailOrdersOrders with item detailsLanded Cost breakdown
accountName
orderAdditionalTariffLines
addressLine1
addressLine2
amount
amountDiscount
amountDutiesTaxesFees
amountItem
amountShipping
amountTotal
arrivalDate
brokerage
city
country
countryCode
countryOfOrigin
countryOfOriginSource
currency
currencyCode
customerName
customsDescription
description
detailType
dimensionsUnit
discountOrder
dutyOrder
dutyTaxFeeOrder
fx
guarantee
height
hsCode
hsCodeSource
itemWeight
itemWeightUnit
itemOrder
landedCostGuarantee
length
merchantAdjustment
merchantSet
merchantFee
memo
name
orderDate
orderDuty
orderFeeAdvancement
orderFeeBrokerage
orderFeeCarrier
orderFeeShopper
orderFx
orderNumber
orderReference
orderStatus
orderTax
orderTotal
other
otherCarrierFee
packageWeight
packageWeightUnit
payee
payor
payoutDate
payoutNumber
payoutTotal
postalCode
processing
productId
quantity
referenceNumber
settled
shippingOrder
shippingService
sku
state
taxOrder
total
totalItems
totalItemWeight
trackingNumber
transactionDate
transactionFee
transactionId
transactionType
weightUnit
width
Definizioni dei campi

Di seguito sono riportate le definizioni di ciascun campo nei report:

CampoDefinizione
accountNameNome dell'account con Zonos.
orderAdditionalTarriffLinesCommissione dello spedizioniere doganale per il lavoro aggiuntivo necessario a gestire e dichiarare più codici tariffari (HS) nella dichiarazione doganale.
addressLine1Prima riga dell'indirizzo del destinatario.
addressLine2Seconda riga dell'indirizzo del destinatario, se applicabile.
advancementCommissione applicata per l'anticipo di dazi e imposte per conto del cliente.
amountValore monetario della voce o dell'onere.
amountDiscountImporto dello sconto per l'ordine.
amountDutiesTaxesFeesImporto di dazi, imposte e commissioni applicati all'ordine.
amountItemImporto per un singolo articolo.
amountShippingImporto della spedizione su un ordine.
amountTotalImporto per un singolo articolo moltiplicato per la quantità dell'articolo.
arrivalDateData in cui il payout è arrivato sul conto bancario del merchant.
brokerageCommissione di intermediazione doganale associata allo sdoganamento.
cityCittà dell'indirizzo del destinatario.
countryCodice paese ISO a 2 lettere della destinazione.
countryOfOriginPaese in cui l'articolo è stato fabbricato o prodotto.
countryOfOriginSourceOrigine delle informazioni sul paese di origine.
currencyValuta utilizzata per la transazione, in formato ISO a 3 lettere.
customerNameNome del cliente che effettua l'ordine.
customsDescriptionDescrizione dell'articolo utilizzata per le dichiarazioni doganali.
descriptionDescrizione del prodotto.
detailTypeMotivo dettagliato dell'importo sull'ordine (ad es. imposta, commissione di intermediazione doganale, commissione di conversione valuta, commissione di elaborazione del merchant, ecc.)
dimensionsUnitUnità di misura (ad es. pollici, cm).
discountOrderSconto applicato all'ordine.
dutyOrderImporto del dazio applicato all'ordine.
dutyTaxFeeOrderImporto totale di dazi, imposte e commissioni applicati all'ordine.
fxTasso di cambio applicato alla transazione.
guaranteeImporto garantito da Zonos.
heightAltezza dell'articolo.
hsCodeCodice del Sistema Armonizzato (HS) assegnato all'articolo.
hsCodeSourceOrigine della classificazione del codice HS.
itemWeightPeso dell'articolo nell'ordine.
itemWeightUnitUnità di misura per il peso dell'articolo (ad es. kg, lb).
itemOrderCosto degli articoli nell'ordine.
landedCostGuaranteeCosto del servizio di garanzia landed cost (include sia la componente in $ che quella in % del prezzo).
lengthLunghezza dell'articolo.
merchantAdjustmentModifiche inserite/richieste dal merchant, in genere tramite regole.
merchantSetEventuali margini/modifiche impostati dal merchant.
merchantFeeParte del costo di Checkout attribuita ai costi di elaborazione dei pagamenti.
memoNote o dettagli aggiuntivi relativi al payout o alla transazione.
nameNome del prodotto.
orderDateData in cui l'ordine è stato effettuato, in UTC.
orderDutyImporto del dazio per l'ordine.
orderFeeAdvancementCommissioni di anticipo per l'ordine.
orderFeeBrokerageCommissioni di intermediazione doganale per l'ordine.
orderFeeCarrierCommissioni del vettore per l'ordine.
orderFeeShopperCommissioni addebitate allo shopper.
OrderFxTasso di cambio applicato alla transazione.
orderNumberIdentificatore univoco dell'ordine nel sistema di Zonos.
orderReferenceNumero di riferimento aggiuntivo associato all'ordine, in genere il numero d'ordine nella piattaforma ecommerce.
orderStatusStato attuale dell'ordine.
orderTaxImporto dell'imposta per l'ordine.
orderTotalImporto totale per l'ordine.
otherOnere o modifica varia relativa alla transazione.
otherCarrierFeeCommissioni aggiuntive addebitate dal vettore di spedizione, incluse le commissioni di prepagamento (che il vettore indica sulla bolletta di spedizione).
packageWeightPeso totale del pacco.
packageWeightUnitUnità di misura per il peso del pacco.
payoutDateData in cui il payout è stato emesso al merchant.
payeeSoggetto che riceve il pagamento.
payorSoggetto responsabile dell'effettuazione del pagamento.
payoutNumberCorrisponde all'id del payout di Stripe.
payoutTotalImporto totale versato al merchant.
postalCodeCodice postale o ZIP dell'indirizzo del destinatario.
processingMetodo previsto per l'elaborazione del pagamento doganale: TAX_REMITTANCE (versamento tramite partita IVA/codice fiscale) o CUSTOMS_BILL (pagamento di una bolletta doganale).
productIdIdentificatore univoco del prodotto.
quantityNumero di unità dell'articolo nell'ordine.
referenceNumberFa riferimento al numero del payout (ad es. po_1QcGXkGbPRfOWRJBfaa90A1A) o al numero della fattura (ad es. 584184EA-0000).
settledL'importo della transazione liquidato al merchant.
shippingOrderCosto di spedizione per l'ordine.
shippingServiceMetodo o servizio di spedizione utilizzato per la consegna.
skuStock Keeping Unit (SKU) del prodotto.
stateStato o regione dell'indirizzo del destinatario.
taxOrderImporto dell'imposta applicata all'ordine.
totalIl totale dell'ordine (il totale pagato dallo shopper).
totalItemsIl numero totale di articoli nell'ordine.
totalItemWeightPeso totale di tutti gli articoli nell'ordine.
trackingNumberNumero di tracciamento della spedizione.
transactionDateData in cui la transazione è stata registrata, in UTC.
transactionFeeInclude il costo dei servizi di Checkout, inclusa la protezione dalle frodi. Non include i costi di elaborazione dei pagamenti.
transactionIdIdentificatore univoco della transazione.
transactionTypeTipi possibili: ORDER, ORDER_REFUND, ORDER_CANCEL, CHARGE o CREDIT. Le fatture hanno un altro tipo, STRIPE, relativo ai costi dell'abbonamento, alle commissioni della piattaforma o ai crediti CTP.
weightUnitUnità di misura per i valori di peso.
widthLarghezza dell'articolo.

Entrambi i report sui payout possono essere utilizzati per la riconciliazione con il tuo estratto conto bancario. È più semplice scaricarli dalla pagina Payouts, in modo che contengano esattamente gli ordini collegati a quel payout (piuttosto che dalla pagina Reports, dove devi selezionare l'intervallo di date).

  1. Vai su Dashboard → Payouts.
  2. Seleziona il payout.
  3. Fai clic su Export transactions nell'angolo in alto a destra, quindi scegli Payout summary o Payout detail dal menu a discesa.

La somma della colonna settled nel Payout summary e nel Payout detail corrisponderà all'importo totale del payout mostrato in Dashboard.

Utilizza il report Payout summary per visualizzare il tuo ordine e il relativo rimborso.

  1. Vai su Dashboard → Reports.
  2. Fai clic su Generate accanto al report Payout summary.
  3. Seleziona l'intervallo di date preferito. Assicurati che l'intervallo di date includa sia la data dell'ordine che la data del rimborso, per ottenere una visione completa.
  4. Fai clic su Generate report.
  5. Filtra il report per l'ordine in questione.

Esempio 

Analizziamo un ordine come esempio. Ecco un'istantanea di un download CSV del report Payout summary, filtrato per l'ordine 1234, per il quale è stato emesso un rimborso completo.

orderNumber (I)transactionType (L)itemOrder (M)shippingOrder (N)dutyTaxFeeOrder (P)guarantee (Q)transactionFee (R)merchantFee (S)settled (U)
1234ORDER105.8080.7658.96-58.96-7.38-9.88169.30
1234ORDER_REFUND (verrebbe mostrato ORDER_CANCEL se questo ordine non fosse stato spedito)-105.80-80.76-58.9658.967.37-179.20

In questo esempio:

  • Il merchant utilizza la garanzia Landed Cost di Zonos (valori nella colonna Q, guarantee).
  • Al momento dell'ordine, il merchant ha ricevuto il pagamento per itemOrder e shippingOrder meno le commissioni di Zonos (transactionFee e merchantFee). Questo importo, la somma delle colonne da M a T, corrisponde al valore settled nella colonna U.
    • Dazi, imposte e commissioni (dutyTaxFeeOrder) sono stati riscossi, ma poiché il merchant ha scelto che fosse Zonos a gestirli, Zonos trattiene tali fondi e paga direttamente la dogana. Di conseguenza, dutyTaxFeeOrder e guarantee si annullano a vicenda (netto pari a 0).
  • Quando l'ordine è stato rimborsato, Zonos ha rimborsato lo shopper e ha recuperato dal merchant gli importi itemOrder e shippingOrder. Zonos ha anche rimborsato la transactionFee, ma ha trattenuto la merchantFee poiché a Zonos verrà comunque addebitata la commissione del merchant da parte del fornitore di servizi di pagamento.
    • Dazi, imposte e commissioni non sono comunque a carico del merchant, quindi non compaiono in questo report. Zonos li ha rimborsati allo shopper in base alla richiesta di rimborso del merchant, ma poiché quel rimborso era Zonos → shopper, non è riflesso qui.

Il report Payout detail può essere utilizzato per scoprire quanto stai pagando a Zonos rispetto a quanto stanno pagando i tuoi shopper. Tuttavia, il modo in cui interpreti il report dipende dall'utilizzo o meno della nostra garanzia Landed Cost. Scegli di seguito se la utilizzi o meno.

Per impostazione predefinita, gli shopper pagano la garanzia landed cost, mentre i merchant pagano il costo dei servizi di checkout (come l'elaborazione dei pagamenti e la protezione dalle frodi). Il report Payout detail registra chi ha pagato per ciascuna parte dell'ordine.

Per scoprire quanto hai pagato tu e quanto ha pagato il tuo shopper, scarica prima il report:

  1. Vai su Dashboard → Reports.
  2. Fai clic su Generate accanto al report Payout detail.
  3. Seleziona l'intervallo di date preferito.
  4. Fai clic su Generate report.

Nel report, filtra in base a ciò che desideri sapere:

  • Per scoprire quanto il tuo shopper ti ha pagato per l'ordine, filtra il Payor (colonna O) su SHOPPER e il Payee (colonna N) su MERCHANT. Questo non includerà i costi passthrough come dazi e imposte.
  • Per scoprire quanto hai pagato di tasca tua a Zonos, filtra il Payor (colonna O) su MERCHANT e il Payee (colonna N) su ZONOS. Somma questi valori.
  • Per scoprire quanto hai guadagnato sull'ordine, somma tutte le righe relative all'ordine (questo corrisponderà alla differenza tra i due totali precedenti).

Esempio

Analizziamo un ordine come esempio. Ecco un'istantanea di un download CSV del report Payout detail, che mostra tutte le righe relative a un singolo ordine, 0123.

orderNumber (I)detailType (M)payee (N)payor (O)amount (P, all in USD)
0123ITEMMERCHANTSHOPPER96.85
0123SHIPPINGMERCHANTSHOPPER30.63
0123MERCHANT_PROCESSINGZONOSMERCHANT-6.72
0123TRANSACTION_PERCENTZONOSMERCHANT-4.94

Per interpretare questo dettaglio, raggruppiamo questi elementi in guadagni e commissioni.

Guadagni: Zonos ha riscosso questi costi dallo shopper, per poi versarli al merchant.

  • Il subtotale degli articoli, in questo caso 96,85 $ (ITEM).
  • Il costo di spedizione, 30,63 $ (SHIPPING).

Commissioni: Zonos riscuote questi costi dal merchant; non sono incluse nell'importo pagato dallo shopper al checkout.

  • Una commissione di elaborazione del merchant di 6,72 $ (MERCHANT_PROCESSING).
  • Una commissione di transazione di 4,94 $ (TRANSACTION_PERCENT).

I report sui payout sono disponibili per ogni payout; tuttavia, potresti voler riconciliare, ad esempio, tutti i payout dell'ultimo trimestre. Invece di scaricare più report sui payout, puoi scaricare facilmente un unico report con l'intervallo di date desiderato.

Per scaricare i report CSV Payout summary o Payout detail per qualsiasi intervallo di date:

  1. Vai su Dashboard → Reports.
  2. Fai clic su Generate accanto al report desiderato.
  3. Seleziona l'intervallo di date che inizia all'inizio del trimestre e termina alla fine del trimestre.
  4. Fai clic su Generate report.

Se hai effettuato una modifica di recente, potresti voler confermare che tutti gli ordini nel Zonos Dashboard compaiano anche nella tua piattaforma ecommerce. Per farlo:

  1. Scarica il report CSV Orders.
    1. Vai su Dashboard → Reports.
    2. Fai clic su Generate accanto al report Orders.
    3. Seleziona l'intervallo di date che desideri verificare.
    4. Fai clic su Generate report.
  2. Confronta questi ordini con quanto visualizzato nella tua piattaforma ecommerce.

Contatta il nostro team di supporto se riscontri problemi con i tuoi ordini.

Utilizza il report Landed Cost Breakdown per esplorare i dettagli dei nostri calcoli del landed cost senza dover gestire tabelle verticali. Questo report mostra ogni singolo costo che contribuisce al landed cost totale di un ordine, con ogni componente elencato nella propria colonna.

Per scaricare il report Landed cost breakdown:

  1. Vai su Dashboard → Reports.
  2. Fai clic su Generate accanto al report Landed cost breakdown.
  3. Seleziona l'intervallo di date che corrisponde a quello della bolletta del vettore.
  4. Fai clic su Generate report.

Questa pagina è stata utile?