1. Home
  2. iThink
  3. Digital Marketing
  4. eBay Trading API: le chiamate dismesse nel 2026 e come portare stock, categorie e ordini sulle API Sell
Digital Marketing

eBay Trading API: le chiamate dismesse nel 2026 e come portare stock, categorie e ordini sulle API Sell

Negozio di ricambi auto con vetrina e insegne, fotografia storica
Immagine: pingnews.com · Flickr · Pubblico dominio (PDM 1.0)

Se il tuo negozio WooCommerce parla con eBay attraverso un plugin o uno script scritto qualche anno fa, c'è una buona probabilità che usi ancora la eBay Trading API, l'interfaccia in formato XML che eBay sta smantellando chiamata dopo chiamata. In questo articolo trovi le date ufficiali delle dismissioni del 2026 e del 2027, la mappa tra le vecchie chiamate e le API Sell che le sostituiscono (Inventory, Taxonomy, Metadata, Fulfillment, Notification) e un metodo per portare stock, categorie e ordini sul modello nuovo senza fermare le vendite.

La risposta breve, se ti stai chiedendo se la tua integrazione è a rischio: eBay non ha spento la Trading API in un colpo solo, ma ha già disattivato chiamate usate da molti plugin, tra cui GetCategories e GetCategoryFeatures, e ha fissato al 30 giugno 2027 la data di dismissione di GetOrders. Chi vende ricambi auto ha un motivo in più per muoversi: la compatibilità con i veicoli e lo stock allineato passano dalle API Sell, e un disallineamento di magazzino si paga in ordini annullati.

Quali chiamate della eBay Trading API che usi sono già state dismesse?

Ho letto l'11 novembre 2026 le note di rilascio della Trading API e la pagina sullo stato delle deprecazioni di eBay Developers. Le date che interessano a te, se vendi ricambi, sono queste.

ChiamataStatoDataSostituto indicato da eBay
GetCategoriesdismessa15 aprile 2026 (release 1453)Taxonomy API e Metadata API
GetCategoryFeaturesdismessagiugno 2026 (3 giugno nelle note di rilascio, 4 giugno nella pagina sullo stato)Metadata API
GetVeROReportStatus, GetVeROReasonCodeDetails, VeROReportItemsdismesse2 febbraio 2026 (release 1451)VeRO API (la pagina sullo stato indica per tutti i metodi della VeRO API la dismissione del 30 settembre 2026 e la VeRO API v2 come sostituto)
UploadSiteHostedPicturesdismessa30 settembre 2026Media API (createImageFromFile, createImageFromUrl)
GeteBayDetailsin deprecazione dal 21 settembre 202615 marzo 2027metodi della Metadata API (spedizione e altri)
SetShippingDiscountProfiles e chiamata di lettura collegatain deprecazione dal 10 giugno 202619 gennaio 2027Combined Shipping Rules dell'Account API v2
GetOrdersin deprecazione dal 6 novembre 202630 giugno 2027Fulfillment API (solo ordini pagati)

Due avvertenze sulla lettura. Per GetCategoryFeatures le due pagine ufficiali differiscono di un giorno, quindi non scrivere nel tuo registro un giorno solo: segna «inizio giugno 2026». Per le chiamate sui profili sconto la pagina sullo stato usa nel testo un nome (GetSellerDiscountProfiles) diverso da quello del collegamento (GetShippingDiscountProfiles): se le usi, controlla quale delle due compare nel tuo codice.

C'è poi un secondo tipo di cambiamento, che non ti accorgi di subire finché non fallisce una pubblicazione: le regole di validazione. Le note di rilascio spiegano che, per le inserzioni di abbigliamento e calzature (Apparel & Footwear), le richieste con taglie personalizzate vengono rifiutate da luglio 2026 e che il 24 agosto 2026 è arrivato un nuovo errore bloccante, il 21920468, per un valore di taglia non valido. Per un negozio di ricambi auto riguarda poco, ma mostra come lavora eBay: un campo prima tollerato diventa un avviso, poi un rifiuto.

Perché una chiamata dismessa ti costa ordini e non solo errori nel log?

Una chiamata dismessa risponde con un errore, e un plugin scritto male gestisce l'errore in due modi, che tu puoi riconoscere dai log: lo registra e va avanti, oppure ignora la risposta. Nel secondo caso il negozio continua a lavorare con dati vecchi, e il dato più pericoloso è la quantità. Se un pezzo si vende sul sito e la quantità su eBay non scende, il ricambio resta in vendita su un canale dove non c'è più.

Il conto che ti riguarda lo fa la pagina «Norme generali di rendimento per i venditori» di eBay.it: tra le transazioni con difetti rientra l'ordine che il venditore annulla in modo inatteso, per esempio perché il pezzo era esaurito o l'aveva venduto a qualcun altro. La stessa pagina dice che eBay consente fino al 2% di transazioni con difetti per periodo di valutazione, che può esserci un solo difetto per transazione e che, se i difetti sono associati a più di 4 acquirenti diversi, il venditore viene valutato come «Sotto lo standard». Nella pagina contano quindi sia la percentuale sia il numero di acquirenti coinvolti, e gli esempi riportati mostrano come le due condizioni lavorano insieme: per la tua valutazione leggi lo stato del venditore in eBay.

Come cambia il modello che usi: dall'inserzione all'inventario?

La Trading API ragiona per inserzione: tu crei un annuncio, lo modifichi, lo termini. Le API Sell ragionano per inventario. Secondo la documentazione dell'Inventory API, ogni prodotto è un inventory item con uno SKU scelto dal venditore, che deve essere unico nel suo inventario, e l'offerta (offer) è ciò che diventa un'inserzione attiva. Ogni offerta deve richiamare tre business policy, di pagamento, di spedizione e di reso, e alcuni campi facoltativi alla creazione diventano obbligatori alla pubblicazione.

Per il tuo negozio WooCommerce il passaggio è naturale se lo SKU di WooCommerce è già quello del magazzino: lo stesso codice identifica il prodotto sul sito e su eBay. Se negli ultimi anni gli SKU sono nati in modo disordinato, questo è il punto in cui conviene sistemarli, prima di scrivere una riga di codice.

Un limite che ti conviene conoscere prima di scegliere: la documentazione avverte che le inserzioni create con l'Inventory API non si possono modificare da Seller Hub né da altre piattaforme di inserzione, ma solo via API. Per le inserzioni che esistono già, eBay offre bulkMigrateListings, che le porta nel modello Inventory, a patto che rispettino i requisiti indicati nella guida all'integrazione di vendita (l'inserzione deve essere attiva e l'account iscritto alle business policy).

Quali API sostituiscono GetCategories e GetCategoryFeatures nel tuo codice?

Quando le sostituisci, vedrai che le due chiamate si dividono tra più API, perché eBay ha separato l'albero delle categorie dai dati sulle regole di vendita.

Per GetCategories la guida alla migrazione ti indica:

  • Taxonomy API, getCategoryTree: restituisce l'albero completo delle categorie di un marketplace. Il parametro category_tree_id ha lo stesso valore del CategorySiteID che passavi a GetCategories.
  • Taxonomy API, getCategorySubtree: restituisce una parte dell'albero a partire da un category_id, l'equivalente del CategoryParent.
  • Metadata API, getCategoryPolicies: restituisce i dati non tassonomici che prima arrivavano con GetCategories (per esempio i campi autoPayEnabled, expired e virtual).
  • Cambia anche il nome del campo che indica la categoria foglia: si usa il booleano leafCategoryTreeNode al posto di LeafCategory.

Per GetCategoryFeatures la guida rimanda ai metodi della risorsa marketplace della Metadata API. I più utili a te, per i ricambi:

Che cosa ti serveMetodo REST
La categoria accetta la compatibilità veicolo?getAutomotivePartsCompatibilityPolicies
Supporta K-type, VIN o targa? Quante compatibilità si possono inserire?getMotorsListingPolicies
Condizioni ammesse (usato, ricondizionato, nuovo)getItemConditionPolicies
Politiche di resogetReturnPolicies
Regole di spedizionegetShippingPolicies
Best OffergetNegotiatedPricePolicies

La guida precisa che questi metodi restituiscono dati solo per le categorie foglia, senza più i valori predefiniti del sito che aveva la Trading API, e che per le condizioni ricondizionate (Refurbished) i venditori idonei devono usare un token OAuth ottenuto con il flusso authorization code e lo scope sell.inventory. Per scegliere la categoria di un singolo pezzo e sapere quali specifiche (item specifics) inserire, la Taxonomy API mette a disposizione, tra gli altri, getCategorySuggestions e getItemAspectsForCategory.

Come aggiorni stock e prezzi con le API Sell?

Qui sta il valore pratico della migrazione. La chiamata bulkUpdatePriceQuantity dell'Inventory API modifica la quantità disponibile di un inventory item e, per le offerte già attive, prezzo e quantità. La guida sugli aggiornamenti in blocco indica fino a 25 record di inventario per chiamata, e restituisce un statusCode per ogni SKU o offerta tentata, così il tuo codice sa quali aggiornamenti sono riusciti e quali no.

Sulla quantità c'è un dettaglio che fa sbagliare. La documentazione spiega che esistono due livelli: la quantità totale dell'inventory item (contenitore shipToLocationAvailability) e la quantità della singola offerta per marketplace (availableQuantity). Quando la modifichi va aggiornata a entrambi i livelli, e la quantità effettiva dell'inserzione è il valore più basso tra i due. Se aggiorni solo uno dei due, l'inserzione può mostrare un numero diverso da quello che ti aspetti.

Per gli ordini, nella Trading API usavi GetOrders. Il sostituto è la Fulfillment API, che eBay indica solo per gli ordini pagati. Invece di interrogare eBay a intervalli, puoi ricevere gli eventi: la Notification API gestisce topic, destinazioni e sottoscrizioni, e tra gli eventi di esempio nella documentazione compaiono le conferme d'ordine. La pagina non elenca i nomi dei topic: verifica con GET /topic quale copre i tuoi ordini. Con la notifica giusta il tuo sito può controllare l'ordine e scalare lo stock in WooCommerce.

E la compatibilità dei tuoi ricambi con i veicoli?

Per i ricambi che vendi la compatibilità è una parte dell'inserzione tanto quanto il prezzo. Nell'Inventory API la compatibilità si gestisce per SKU: la panoramica parla di una lista di veicoli compatibili con il ricambio e l'elenco delle risorse comprende l'endpoint PUT /inventory_item/{sku}/product_compatibility, di cui non ho letto il corpo della richiesta, quindi controllane la specifica prima di usarlo. I dati di riferimento per veicoli e prodotti non arrivano più dalle vecchie API: la pagina sullo stato delle deprecazioni indica che la Product API (dismessa il 15 agosto 2026) è sostituita dalla Catalog API e dai metodi compatibilities della Metadata API, e che anche la Product Metadata API è stata dismessa nel 2026.

Un chiarimento sul metodo, utile a te quando controlli il catalogo, che nasce dalla mia pratica di lavoro e non da una regola di eBay: la lista di compatibilità deve partire dal codice OE (il codice originale del costruttore) ricavato dal telaio, non solo dal K-type. Il K-type, anche quando la categoria lo supporta (kTypeSupported nella Metadata API), è un riferimento indicativo. Se pubblichi «compatibile con» senza aver verificato l'OE, rischi resi e controversie, che è l'altro modo in cui una transazione diventa un difetto.

Come migrare il connettore passo per passo?

Il percorso che consiglio per un negozio con un connettore esistente è graduale, con una chiamata alla volta e una prova su un campione prima di estendere.

  1. Fai l'inventario delle chiamate. Cerca nel codice del plugin o del gestionale i nomi delle chiamate della Trading API (GetCategories, GetCategoryFeatures, GetOrders, UploadSiteHostedPictures, i profili spedizione) e annota dove e con che frequenza vengono usate. Guarda anche i log degli errori degli ultimi mesi: un errore ripetuto su una chiamata dismessa è il segnale più chiaro.
  2. Sistema gli SKU. Uno SKU unico per pezzo, identico tra WooCommerce, magazzino ed eBay. È la chiave di tutto il modello Inventory.
  3. Configura l'autorizzazione. Le API Sell usano OAuth 2.0: per i dati del venditore serve un token utente, come quello con flusso authorization code e scope sell.inventory richiesto dalla guida per le condizioni di tipo ricondizionato. Le credenziali non si scrivono nel codice né in un repository.
  4. Sposta per prime le letture. Categorie e regole di categoria (Taxonomy e Metadata) sono le più semplici da sostituire, perché non cambiano il tuo catalogo.
  5. Porta le inserzioni nel modello Inventory. Prova bulkMigrateListings su un piccolo gruppo di pezzi, controlla il risultato e verifica che le business policy siano al loro posto.
  6. Passa a stock e prezzi con bulkUpdatePriceQuantity, con aggiornamento a entrambi i livelli di quantità e gestione dei statusCode di errore.
  7. Sostituisci gli ordini con la Fulfillment API e, se ti serve, con le notifiche, prima del 30 giugno 2027.
  8. Prova tutto nell'ambiente di prova di eBay (sandbox) e poi su pochi articoli reali, confrontando le quantità tra sito ed eBay dopo ogni vendita.

Checklist prima di spegnere la tua vecchia integrazione

  • [ ] Ogni chiamata della Trading API trovata nel codice ha un sostituto indicato e provato.
  • [ ] Gli SKU di WooCommerce corrispondono a quelli su eBay.
  • [ ] Dopo una vendita sul sito, la quantità su eBay scende (e viceversa) a entrambi i livelli.
  • [ ] Gli errori di eBay sono registrati e arrivano a una persona, senza essere ignorati.
  • [ ] Le specifiche obbligatorie della categoria vengono controllate prima di pubblicare.
  • [ ] La compatibilità parte da codici OE verificati.
  • [ ] Hai una data per la migrazione degli ordini, prima del 30 giugno 2027.

Errori da evitare nella tua migrazione

  • Aspettare l'errore. Una chiamata dismessa non avvisa chi non guarda i log: scopri il problema dall'ordine annullato.
  • Aggiornare un solo livello di quantità. Il valore più basso tra inventory item e offerta vince.
  • Migrare tutto in un colpo. Un errore sulle business policy o sulle specifiche si moltiplica per il numero di inserzioni.
  • Fidarsi del K-type come prova di compatibilità. È un indizio, non un controllo.
  • Dare per scontato che un plugin generico sia aggiornato. Chiedi al fornitore quali API usa e da quale versione, e verifica con la lista delle date qui sopra.

Consigli pratici per chi vende ricambi da WooCommerce

Parti dalla chiamata con la scadenza più vicina e dall'effetto più costoso: lo stock. Tieni una tabella delle chiamate con la data di dismissione ufficiale e rileggi la pagina sullo stato delle deprecazioni di eBay ogni mese, perché le date, come hai visto, si aggiornano. Se non sei tu a scrivere il codice, chiedi per iscritto al fornitore del plugin la versione che usa le API Sell e una prova su pochi articoli.

Domande frequenti

La Trading API è stata spenta del tutto per te?

No. Dalle fonti che ho letto risultano dismesse singole chiamate, con altre in deprecazione e date nel 2027, ma non una data unica di chiusura della Trading API. Controlla la tua integrazione chiamata per chiamata.

Che cosa succede alle tue inserzioni già pubblicate?

Le inserzioni restano online. Cambia il modo di gestirle: se il tuo strumento usa una chiamata dismessa, non riesce più ad aggiornare quella parte (categorie, ordini, foto) e le informazioni su eBay possono restare ferme.

Devo rifare tutte le inserzioni?

Non necessariamente: bulkMigrateListings serve a portare nel modello Inventory le inserzioni attive e idonee, rispettando i requisiti della guida di eBay.

Basta passare a OAuth per risolvere?

No. L'autenticazione e le chiamate sono due cose distinte: un nuovo tipo di token non fa tornare disponibile una chiamata dismessa, servono i nuovi metodi.

Considerazioni finali: il tuo stock allineato e la compatibilità verificata

Le dismissioni del 2026, se le leggi in fila, hanno una logica: eBay sposta categorie, metadati, ordini e foto su API REST separate, e questo obbliga a ripensare un connettore costruito attorno all'inserzione. Per un negozio di ricambi auto il guadagno concreto è doppio, perché lo stock si aggiorna in modo controllabile e la compatibilità segue lo SKU.

Se vuoi vedere come si traduce nel tuo caso, la pagina sul Connettore eBay per WooCommerce su misura descrive come lavoro: stock, prezzi, specifiche e compatibilità tra WooCommerce ed eBay con le API ufficiali. Per capire da dove partire, puoi prenotare la consulenza gratuita oppure scrivermi dalla pagina dei contatti: mi basta sapere con quale plugin o gestionale vendi oggi su eBay.

Fonti

Verifica delle fonti: 11 novembre 2026. Le date di dismissione possono cambiare: rileggi la pagina ufficiale prima di pianificare. Il limite di 25 record per bulkUpdatePriceQuantity è quello della guida sugli aggiornamenti in blocco. La nota sul codice OE e sul K-type è un'indicazione di metodo dell'autore.

Condividi LinkedIn Facebook X WhatsApp Telegram Email
Marketing & Google Ads

Le tue campagne stanno bruciando budget?

Raccontami obiettivi e numeri attuali: ti dico dove intervenire per primo.

Cybersecurity per PMI

Quanto è esposta la tua azienda?

Un hacker etico certificato trova le falle prima di chi attacca e ti dice come chiuderle, partendo dalla più pericolosa.

Coding & debugging

Codice scritto con l’AI? Funziona oggi. Reggerà domani?

Audit del debito tecnico e della sicurezza di app e siti, debugging e code review.

iLife · crescita personale

Riprogramma la tua vita con il metodo di un hacker etico

Percorsi one-to-one per capire dove sei, scegliere la direzione e arrivarci con metodo.

Digital Agency

Dove sta frenando il tuo business?

Una consulenza per capire cosa sistemare prima: sicurezza, tecnologia, marketing o persone.

Continua a leggere

Tutti gli articoli del blog

Rocco Balzamà
Parli direttamente con me

Il prossimo passo?
Parliamone.

Raccontami cosa vuoi proteggere, costruire o far crescere. Ti aiuto a capire da dove partire.

Di cosa mi occupo

Da oltre trent'anni faccio tre cose. Cerco le falle della tua azienda prima che le trovi chi vuole entrare. Imposto il marketing perché i risultati si possano misurare. E aiuto persone e aziende a capire chi sono, prima ancora di decidere cosa vendere.

Da remoto e in presenzaLavoro da remoto tramite call e videocall. Quando il progetto lo richiede, intervengo anche in presenza.
Seguimi sui social
Certified Ethical HackerSicurezza informatica dal 1993
Gli strumenti con cui lavoro
  • Google Ads
  • Meta
  • WordPress
  • WooCommerce
  • Shopify
  • TikTok
Strumenti gratuiti