eBay · Finances · Payout
Riconciliazione payout e fee eBay per la contabilità e l'ERP
Uno degli errori più costosi nelle integrazioni eBay è confondere l'ordine con l'incasso. Il prezzo pagato dal cliente non è ciò che arriva sul conto del venditore: in mezzo ci sono commissioni, rimborsi, crediti, rettifiche e differenze temporali. Per chi deve collegare eBay a ERP e contabilità serve la eBay Finances API.
Perché un ordine non è un incasso
Tra il valore dell'ordine e il payout netto intervengono diversi fattori:
- commissioni sul venduto e sul valore totale (final value fee);
- rimborsi totali o parziali verso l'acquirente;
- crediti e rettifiche applicati da eBay;
- tempistiche: la vendita e l'accredito non coincidono.
Importare solo gli ordini, quindi, racconta metà della storia. La contabilità ha bisogno del flusso finanziario completo.
Il modello della Finances API
| Concetto | Significato |
|---|---|
| Transaction | Movimento singolo: vendita, commissione, rimborso, credito |
| Payout | Accredito netto verso il conto del venditore |
| Transfer | Movimenti dovuti dal venditore a eBay |
Le chiamate chiave sono getTransactions per leggere i movimenti e getPayouts per gli accrediti; ogni payout è composto dalle transazioni del periodo.
La logica di riconciliazione
Riconciliare significa ricostruire, per ogni payout, l'insieme di transazioni che lo compongono e collegarle agli ordini:
- importa le transazioni con un polling incrementale per data;
- collega ogni transazione all'ordine tramite
orderId; - raggruppa le transazioni per
payoutId; - verifica che la somma delle transazioni corrisponda al payout;
- registra le differenze come anomalie da investigare.
Da eBay all'ERP e alla contabilità
Una volta riconciliato, il dato va portato dove serve: scritture contabili, registrazione delle commissioni come costo, gestione dei rimborsi come note di credito. Conviene mantenere una tabella di mapping tra i tipi di transazione eBay e i conti/causali contabili, così l'esportazione resta coerente e ripetibile.
Architettura su Azure
Su Microsoft Azure una pipeline tipica usa una Function schedulata per il polling delle transazioni, un database per conservare movimenti, payout e stato di riconciliazione, e un worker che produce le scritture verso l'ERP o un file per la contabilità. Idempotenza per transactionId e payoutId evita doppie registrazioni.
Errori comuni
- esportare gli ordini come incassi, ignorando commissioni e rimborsi;
- non riconciliare la somma delle transazioni con il payout;
- perdere movimenti per finestre di polling senza sovrapposizione;
- registrare due volte la stessa transazione per mancanza di idempotenza.
Conclusione
La Finances API chiude il cerchio di un'integrazione eBay: collega ordini, commissioni e payout e rende possibile una contabilità accurata. Senza riconciliazione, i numeri non torneranno mai. Documentazione ufficiale: eBay Finances API — Overview.