eBay · API · Microsoft Azure
eBay Sell API: guida pratica per sviluppatori (2026)
Quando si parla di integrazioni marketplace, eBay resta una piattaforma rilevante per chi vende online — soprattutto quando l’obiettivo non è caricare prodotti manualmente, ma automatizzare l’intero flusso: catalogo, stock, ordini, spedizioni e riconciliazione economica. In questo contesto entra in gioco la eBay Sell API.
Il nome può far pensare a un’unica API per «vendere su eBay», ma in realtà la Sell API è una famiglia di API REST pensate per il lato venditore. Per uno sviluppatore, un integratore o un’azienda che vuole collegare eBay a ERP, PIM o e-commerce, è il punto di partenza naturale per un’integrazione moderna.
La eBay Sell API in breve
La Sell API permette a un software esterno di collegarsi all’account eBay di un seller e automatizzare attività come:
- pubblicare e aggiornare prodotti, prezzi e disponibilità;
- sincronizzare lo stock;
- importare ordini e caricare tracking di spedizione;
- leggere payout e movimenti finanziari;
- gestire policy di pagamento, reso e spedizione;
- consultare regole e vincoli del marketplace.
Il punto centrale: la Sell API non serve solo a «creare inserzioni». Serve a costruire uno strato di integrazione tra i sistemi interni dell’azienda e il marketplace eBay.
Non è una singola API
La Sell API è un insieme di API specializzate. Ogni area copre una parte del ciclo di vendita:
| Area | A cosa serve |
|---|---|
| Account | Impostazioni venditore: policy di pagamento, reso e spedizione |
| Inventory | Prodotti, SKU, stock, prezzi e pubblicazione offerte |
| Fulfillment | Ordini, spedizioni, tracking, rimborsi e dispute |
| Finances | Payout, transazioni, commissioni e movimenti economici |
| Metadata | Regole marketplace, categorie, condizioni e vincoli di pubblicazione |
| Marketing | Promozioni, campagne e advertising |
| Analytics | Report, metriche di performance e dati sul traffico |
| Feed | Operazioni massive e asincrone per grandi cataloghi |
Un sistema serio deve tenere allineati prodotti, stock, ordini, spedizioni, commissioni, payout e regole commerciali — non solo pubblicare listing.
Dallo SKU all’inserzione pubblicata
Nel modello moderno, eBay ragiona in termini di SKU e inventario, vicino a come lavorano ERP e magazzini:
- si parte da uno SKU;
- lo SKU diventa prodotto a inventario;
- il prodotto genera un’offerta;
- l’offerta viene pubblicata come inserzione su eBay.
Se il gestionale aggiorna la quantità di uno SKU, l’integrazione può propagare il dato verso eBay senza ricostruire ogni volta l’intero processo di pubblicazione — lo stesso vale per prezzo, varianti e attributi prodotto.
Prima di pubblicare: account venditore pronto
Un errore frequente è pensare che bastino titolo, prezzo, descrizione e immagini. eBay usa policy per pagamento, resi, spedizione, tempi di gestione e condizioni commerciali. Se mancano o non sono compatibili con categoria e marketplace, la pubblicazione fallisce.
Un’integrazione B2B dovrebbe verificare prima che l’account sia pronto e rendere gli errori comprensibili: policy mancante, categoria non valida, dato incompleto o regola marketplace non rispettata.
Ordini e fulfillment
Dopo la pubblicazione arriva la parte operativa. In un flusso tipico:
- eBay genera un nuovo ordine;
- un worker cloud lo importa;
- l’ordine si sincronizza con ERP o magazzino;
- il corriere gestisce la spedizione;
- il tracking torna verso eBay.
In produzione conviene usare processi asincroni: code, worker, retry, gestione limiti API e stati intermedi. La differenza tra una demo e un’integrazione reale si vede nella tolleranza a ritardi, errori parziali e sistemi non sempre allineati.
Ordini, commissioni e payout
Un ordine non coincide con ciò che il venditore riceve sul conto. Tra prezzo pagato dal cliente e payout netto possono esserci commissioni, rimborsi, crediti, rettifiche e differenze temporali tra vendita e accredito.
Per collegare eBay a ERP o contabilità non basta importare gli ordini: serve anche leggere e riconciliare i movimenti finanziari. Un ordine da 129,90 € non implica un payout netto uguale.
Regole marketplace e validazione
I metadata descrivono regole che cambiano per marketplace e categoria: condizioni ammesse, attributi obbligatori, vincoli su resi e spedizioni, requisiti normativi. Un listing tool efficace valida i dati prima della pubblicazione, comportandosi come uno strato intelligente tra gestionale e marketplace.
Architettura di integrazione su Microsoft Azure
In un progetto reale la Sell API non viene chiamata dal frontend. Serve un layer di integrazione. Su Azure, un’architettura tipica può includere:
- Azure Functions per ingresso e orchestrazione;
- Queue per disaccoppiare i processi;
- Database per stato, log e sincronizzazioni;
- Worker per regole di business e preparazione dati;
- chiamate verso la eBay Sell API con monitoraggio e retry.
Sell API vs Trading API
| Aspetto | Sell API | Trading API |
|---|---|---|
| Modello | REST e JSON | Legacy, orientata XML |
| Organizzazione | Aree funzionali (Inventory, Fulfillment…) | Molte chiamate operative |
| Ideale per | Nuove integrazioni cloud | Sistemi esistenti e casi legacy |
| Manutenibilità | Migliore per nuovi progetti | Utile se già costruita così |
Nel 2026, per un nuovo progetto la Sell API è la scelta naturale. La Trading API resta utile per integrazioni legacy o funzionalità non ancora coperte — spesso la migrazione è graduale.
Quando usare la eBay Sell API
- integrazione ERP ↔ eBay;
- sincronizzazione stock multicanale;
- listing tool custom o piattaforma marketplace;
- order management e connettori corrieri;
- dashboard seller e riconciliazione payout;
- automazione promozioni e report.
Diventa davvero interessante quando il sistema di partenza ha già dati strutturati: SKU, quantità, prezzi, ordini e movimenti contabili.
Caso operativo: cambio stock da ERP a eBay
Un flusso reale non parte da eBay, ma da un evento del gestionale. Esempio: il magazzino scarica 3 pezzi per una vendita offline; l'integrazione calcola la quantità pubblicabile, applica il buffer e accoda un delta verso Inventory API.
{
"eventType": "StockChanged",
"sku": "ERP-12345",
"warehouse": "IT-01",
"physicalQuantity": 12,
"reservedQuantity": 3,
"safetyBuffer": 2,
"publishableQuantity": 7,
"sourceVersion": "erp-stock-ledger-88421"
}Il worker invia solo il campo disponibilità, salva risposta e versione sorgente. Se eBay rifiuta il dato, l'evento resta tracciabile: puoi capire se il problema è stock negativo, SKU non pubblicato, token scaduto o categoria non valida.
Troubleshooting da produzione
| Sintomo | Cause tipiche | Azione |
|---|---|---|
| 401/403 | token scaduto, scope errato, seller non autorizzato | rinnova OAuth e verifica RuName/scope |
| publishOffer fallisce | policy mancanti, categoria/aspetti incompleti | blocca pubblicazione e mostra checklist dati |
| stock non allineato | eventi fuori ordine o buffer non applicato | usa versione sorgente e idempotenza per SKU |
| payout non riconciliato | rimborso, fee o rettifica arrivata dopo l'ordine | riconcilia per transazione, non per totale ordine |
Errori comuni
- trattare la Sell API come un pulsante «pubblica su eBay»;
- ignorare il setup account e le policy venditore;
- confondere ordini e incassi effettivi;
- non progettare flussi asincroni con retry e limiti API;
- sottovalutare la validazione pre-pubblicazione.
Conclusione
La eBay Sell API è la base moderna per integrazioni seller-side con eBay: un ecosistema organizzato attorno ad account, inventario, ordini, spedizioni, payout e regole marketplace. Una buona integrazione non crea solo inserzioni — mantiene allineati prodotti, stock, ordini, commissioni e payout. È la spina dorsale di un’integrazione marketplace affidabile, soprattutto quando costruita su architetture cloud come Microsoft Azure.
Documentazione ufficiale: eBay Sell API — Overview.