1. Home
  2. Amazon & eBay
  3. eBay
eBay · API Sell · WooCommerce

Esaurito.
Annullato.
Difetto su eBay.

Vendi sul sito l'ultimo pezzo, ma su eBay è ancora online. Arriva l'ordine e devi annullarlo: eBay lo conta come transazione con difetti. Fonte: eBay.it Aiuto

Un connettore su misura tiene allineati stock, prezzi, specifiche e compatibilità tra WooCommerce ed eBay, con le API REST ufficiali. Tu vendi. Il connettore aggiorna.

Consulenza iniziale gratuita. Rispondo entro 24 ore.

esempio · anatomia di un'inserzione

Ricambio di esempio

SKURIC-0001
Prezzoda WooCommerce
Quantità1 · sincronizzata
OffertaSKU, prezzo e quantità pubblicatiInventory API
CategoriaLa più adatta all'articoloTaxonomy API
SpecificheMarca ✓Codice ✓Tipo: obbligatoriaColore: facoltativaTaxonomy API
Veicoli
MarcaModelloAnnoMotore
Marca AModello 120151.6 diesel
Marca AModello 220162.0 diesel
Compatibilità
OrdiniConferma d'ordine → WooCommerceNotification API
Esempio illustrativo: articolo, specifiche e veicoli non sono dati reali.
OAuth 2.0Token utente per i dati del venditore
Il conto da fare

Su eBay.it il margine d'errore è il 2%.

eBay.it consente fino al 2% di transazioni con difetti per periodo di valutazione. Oltre questa soglia, se i difetti riguardano più di 4 acquirenti diversi, il venditore è valutato "Sotto lo standard". Fonte: eBay.it Aiuto

E WooCommerce, da solo, non vede cosa vendi su eBay: aggiorna le quantità a ogni vendita del sito. Fonte: WooCommerce Docs Il ponte tra i due canali va costruito.

Voglio lo stock allineato

Prima consulenza gratuita, senza impegno.

Stock a mano

  • Aggiorni le quantità quando te ne ricordi
  • L'ultimo pezzo resta online su due canali
  • Annulli ordini e accumuli difetti
  • Specifiche e compatibilità ricopiate inserzione per inserzione

Connettore su misura

  • Una vendita sul sito aggiorna la quantità su eBay, senza che tu intervenga
  • Gli ordini eBay scalano lo stock in WooCommerce
  • Le specifiche obbligatorie si controllano prima di pubblicare
  • Le compatibilità partono dai tuoi dati, SKU per SKU
Le API giuste

Ogni pezzo dell'inserzione ha la sua API.

Il connettore lavora con le API REST di eBay e l'autorizzazione OAuth 2.0. Ecco cosa fa ciascuna, con il link alla documentazione ufficiale.

OAuth 2.0

Token di applicazione (client credentials) per i dati non legati a un utente, come taxonomy e metadata. Token utente (authorization code) per i dati del venditore. Anche per la Trading API eBay consiglia OAuth: Auth'n'Auth resta per le app meno recenti.

Documentazione eBay →

Taxonomy API

Ti aiuta a scegliere la categoria migliore per ogni articolo e ti dice quali specifiche (item specifics) inserire. Alcune sono obbligatorie, altre facoltative. Quelle obbligatorie vanno incluse quando pubblichi l'offerta.

Documentazione eBay →

Notification API

Gestisce le notifiche asincrone: topic, destinazioni e sottoscrizioni con filtri. Tra gli eventi ci sono conferme d'ordine, revisioni delle inserzioni, feedback e modifiche all'account. Così il connettore aggiorna WooCommerce o il gestionale senza interrogare eBay di continuo.

Documentazione eBay →

Media API

Le foto passano dai metodi createImageFromFile e createImageFromUrl. Sostituiscono UploadSiteHostedPictures, la chiamata della Trading API dismessa il 30 settembre 2026.

Release notes eBay →

Metadata API e Catalog API

Per i dati di compatibilità dei ricambi oggi si usano i metodi compatibilities della Metadata API, come getProductCompatibilities, e la Catalog API. Hanno preso il posto di Product Metadata API e Product API, dismesse nel 2026.

Stato delle API eBay →
Controllo gratuito

Le tue inserzioni eBay sono pronte per le API di oggi?

Guardiamo insieme cosa usi, cosa è già stato dismesso e cosa conviene fare prima. La consulenza iniziale è gratuita.

Ricambi auto

La compatibilità è metà dell'inserzione.

Chi cerca un ricambio cerca prima il suo veicolo. Su eBay la compatibilità si gestisce per SKU, e nel 2026 le regole sono cambiate.

  • Per SKU, nella Inventory API. Associ all'articolo l'elenco dei veicoli compatibili per marca, modello, anno, motore e allestimento. L'elenco si collega all'inserzione quando pubblichi l'offerta. Fonte
  • Nuove fonti per i dati. Product Metadata API e Product API sono state dismesse nel 2026: per la Product API eBay indica il 15 agosto, per la Product Metadata API le fonti ufficiali non concordano (27 aprile o 15 luglio). Ora si usano i metodi compatibilities della Metadata API e la Catalog API. Fonte
  • Le compatibilità altrui non si leggono più con GetItem. Dal 6 ottobre 2026, in tutti i marketplace eBay tranne USA e Canada, GetItem restituisce la lista di compatibilità solo al venditore o a chi è autorizzato per suo conto. Fonte

Tradotto: le compatibilità devono partire dai tuoi dati. Il connettore le prende dal tuo catalogo o dal gestionale e le associa a ogni SKU.

Parliamo dei tuoi ricambi
SKU RIC-0001 · veicoli compatibiliesempio
MarcaModelloAnnoMotoreAllestimento
Marca AModello 120141.6 dieselBase
Marca AModello 120151.6 dieselComfort
Marca AModello 220162.0 dieselTutti

createOrReplaceProductCompatibility(SKU) → collegata all'offerta quando la pubblichi

Esempio illustrativo: marche, modelli e motori non si riferiscono a veicoli reali.

Trading API e API legacy

Il 2026 ha spento parecchie chiamate. Il tuo sistema le usa ancora?

eBay ha dismesso diverse chiamate della Trading API (XML) e alcune API storiche. Altre hanno già una data. Ecco il tabellone, con i sostituti ufficiali.

Dismissioni eBay · situazione a novembre 2026
Chiamata o APIStatoDataAl suo posto
GetCategoriesTrading APIDismessa15/04/2026release 1453Taxonomy API e Metadata API
GetCategoryFeaturesTrading APIDismessa04/06/2026release 1475Metadata API
UploadSiteHostedPicturesTrading APIDismessa30/09/2026registrata con la release 1489Media API: createImageFromFile e createImageFromUrl
Product Metadata APIDismessa202627/04 o 15/07: le fonti eBay non concordanoMetodi compatibilities della Metadata API e Catalog API
Product APIDismessa15/08/2026Metodi compatibilities della Metadata API e Catalog API
GetItem: lista compatibilitàTrading API · release 1487Limitata06/10/2026Fuori da USA e Canada la vede solo il venditore o chi è autorizzato per suo conto
Get/SetShippingDiscountProfilesTrading APIIn uscita19/01/2027Account API v2: metodi combined_shipping_rules
GeteBayDetailsTrading APIIn uscita15/03/2027Metodi di spedizione e altri metodi della Metadata API

Fonti: Trading API Release Notes · eBay Developers Newsletter Q3 2026 · API Deprecation Status

Vendi dall'Italia? Alcune chiamate vogliono la firma digitale.

Per i venditori con domicilio nell'UE o nel Regno Unito, eBay richiede per motivi normativi una firma digitale nella richiesta HTTP di alcune chiamate: tutti i metodi della Finances API, issueRefund della Fulfillment API, GetAccount della Trading API e alcuni metodi della Post-Order API per rimborsi, resi e cancellazioni. Il connettore deve saperle firmare. Fonte: eBay Developers

Come lavora

Una vendita. Tutti i canali aggiornati. Zero copia-incolla.

Ecco cosa fa il connettore dietro le quinte. È una simulazione, costruita sulle API descritte sopra.

  • Ascolta le notifiche di eBay, come le conferme d'ordine
  • Aggiorna WooCommerce e, se c'è, il gestionale
  • Quando vendi altrove, rimanda a eBay prezzo e quantità
  • Ferma la pubblicazione se manca una specifica obbligatoria
  • Registra ogni operazione e ti avvisa se qualcosa non va

Vuoi collegare anche gestionale e CRM? Guarda i connettori API REST.

simulazione · connettore-ebay.log
$ connettore ascolta --canale ebay
[*] Notification API: conferma d'ordine · SKU RIC-0001
[✓] WooCommerce: stock RIC-0001 da 2 a 1
[✓] Gestionale: ordine registrato
$ connettore sync --da woocommerce --verso ebay
[*] Vendita sul sito · SKU RIC-0002 esaurito
[✓] bulk_update_price_quantity: quantità eBay a 0
RIC-0003: manca una specifica obbligatoria → pubblicazione sospesa, avviso inviato
$ log --oggi
[✓] Operazioni registrate · nessun aggiornamento doppio

Simulazione illustrativa: SKU e sequenza non sono dati reali.

Domande frequenti

Le domande da farsi prima di collegare eBay.

Non trovi la tua? Scrivimi: rispondo personalmente entro 24 ore.

Ho già inserzioni attive su eBay: devo rifarle da zero?

Non sempre. Il metodo bulk_migrate_listing della Inventory API converte nel modello Inventory API le inserzioni attive e idonee. Servono prezzo fisso, SKU presente e business policy. Le verifichiamo insieme prima di migrare.

Il mio sistema usa ancora la Trading API. È un problema?

Dipende dalle chiamate. Nel 2026 eBay ha dismesso GetCategories, GetCategoryFeatures e UploadSiteHostedPictures; GetShippingDiscountProfiles, SetShippingDiscountProfiles e GeteBayDetails hanno date di dismissione nel 2027. Si parte da un controllo delle chiamate che usi. Guarda il tabellone.

Vendo ricambi: posso leggere le compatibilità dalle inserzioni di altri venditori?

Non con GetItem. Dal 6 ottobre 2026, in tutti i marketplace eBay tranne USA e Canada, la lista di compatibilità di un'inserzione è restituita solo al venditore o a chi è autorizzato per suo conto. Le compatibilità vanno costruite sui tuoi dati e associate ai tuoi SKU.

Meglio un plugin pronto o un connettore su misura?

Se il tuo flusso è semplice, un'estensione pronta può bastare e te lo dico in consulenza. Il su misura serve quando entrano gestionale, regole tue su prezzi e categorie, compatibilità dei ricambi o processi che lo standard non copre. Leggi il confronto.

Quanto costa un connettore WooCommerce-eBay?

Su preventivo, dopo la consulenza gratuita. Dipende da flussi, numero di canali, sistemi da collegare e dati da mappare.

Rispondo entro 24 ore

Colleghiamo eBay al tuo WooCommerce. Una volta, bene.

Consulenza iniziale gratuita. Guardiamo inserzioni, categorie, specifiche e, se vendi ricambi, compatibilità. Poi ricevi una proposta scritta, su preventivo.

  • Controllo delle chiamate legacy che usi oggi
  • Piano per specifiche e compatibilità
  • Nessun costo per la prima consulenza

Vendi anche su Amazon? Leggi la pagina Amazon. Vuoi più traffico sullo shop? Guarda Scala il tuo e-commerce.

Riservatezza sui tuoi dati di vendita. Nessun impegno.

Consulenza iniziale gratuita

Ogni ordine annullato per un esaurito è un difetto evitabile.

Allinea stock, specifiche e compatibilità alla fonte. Partiamo da una chiacchierata, senza impegno.

Fonti

  1. eBay.it Aiuto, Standard di rendimento per i venditori: transazioni con difetti, soglia del 2%, più di 4 acquirenti.
  2. WooCommerce Documentation, Configuring WooCommerce Settings: Products. Che le vendite su eBay non entrino da sole nello stock WooCommerce è un'indicazione pratica, non riportata dalla fonte.
  3. eBay Developers Program, Authorization guide: OAuth 2.0, token di applicazione e token utente, Auth'n'Auth.
  4. eBay Developers Program, Inventory API Overview; dettaglio dei metodi in developer.ebay.com/develop/api/sell/inventory_api.md.
  5. eBay Developers Program, Managing product compatibility (Inventory API).
  6. eBay Developers Program, Taxonomy API Overview.
  7. eBay Developers Program, Trading API Release Notes: release 1453 (15/04/2026), 1475 (04/06/2026), 1487 (06/10/2026), 1489 (26/10/2026).
  8. eBay Developers Program, Newsletter Q3 2026 (vedi anche Newsletter Q2 2026).
  9. eBay Developers Program, API Deprecation Status.
  10. eBay Developers Program, Digital Signatures for APIs.
  11. eBay Developers Program, Notification API Overview. L'uso delle notifiche per aggiornare WooCommerce o il gestionale è un'applicazione pratica, non indicata dalla fonte.

Stock, specifiche e compatibilità allineati su eBay.

Strumenti gratuiti