Se vendi la stessa merce dal tuo negozio WooCommerce e da eBay, la domanda non è «quale plugin installo», ma «quale dei due sistemi dice la verità sulla quantità». Una integrazione WooCommerce eBay fatta bene risponde prima a questo, poi ai dettagli delle chiamate. Se i pezzi sono unici, come i ricambi usati, l'errore costa un cliente: due persone comprano lo stesso pezzo e una delle due resta senza.
In questa guida ti spiego come ragiono quando costruisco la sincronizzazione tra un magazzino, WooCommerce ed eBay: cosa va da WooCommerce a eBay, cosa torna indietro, dove il «tempo reale» è meno reale di quanto sembra. Per i connettori verso Amazon ed eBay c'è la pagina dei connettori per marketplace. Se invece ti serve prima capire come portare sulle API Sell ciò che oggi usa la vecchia Trading API, leggi l'articolo sulle chiamate dismesse nel 2026: qui non lo ripeto.
Perché tu possa verificare, i fatti tecnici vengono dalle specifiche ufficiali di eBay (Inventory v1.18.5, Fulfillment v1.20.7, Notification v1.6.7) e dalla documentazione di WooCommerce, elencate in fondo. Le scelte di progetto le segnalo come mie.
Chi decide la quantità nel tuo negozio: una sola fonte
La prima regola per te è una sola fonte per la quantità. Può essere il gestionale oppure WooCommerce, ma una sola. Gli altri canali ricevono il valore e non lo correggono mai di testa loro.
Nel lavoro che faccio per Trimarcar la fonte è il gestionale, e ti conviene guardare come l'ho impostato. È il sistema di syncro, in produzione da ottobre 2026: manda le giacenze a WooCommerce e a eBay e manda gli ordini a Bitrix24. Il negozio ha circa 33.935 inserzioni attive su eBay e molti pezzi unici, quindi ogni vendita deve spegnere la disponibilità sugli altri canali. Lo racconto nel case study Trimarcar e per la parte di gestionale e CRM nel progetto Ready2Bitrix.
Se non hai un gestionale, la fonte per te può essere WooCommerce. Vale lo stesso principio: eBay riceve la quantità da WooCommerce, e quando arriva un ordine eBay il connettore non scrive «venduto» a mano nella scheda eBay, ma abbassa la quantità nella fonte, che poi la propaga.
Cosa va da WooCommerce a eBay: quantità e prezzo
Per aggiornare quantità e prezzo sulle inserzioni usi l'Inventory API. Il verbo da conoscere è createOrReplaceInventoryItem, cioè PUT /inventory_item/{sku}. Lo SKU lo scegli tu, deve essere unico nel tuo inventario e arriva fino a 50 caratteri: conviene usare lo stesso codice del gestionale, così non servono tabelle di traduzione.
Attenzione al «Replace» del nome, perché ti riguarda da vicino. Il PUT sostituisce tutto il record: i campi già impostati vanno rimandati, e se non rimandi la disponibilità, la documentazione avverte che i dati sulla quantità andranno persi. Se l'articolo è in inserzioni attive, una chiamata riuscita le aggiorna in automatico. La regola pratica è leggere il record, cambiare il campo che ti interessa e riscrivere l'intero oggetto, non spedire solo il campo nuovo.
Per la quantità ti serve questo campo: sta in availability.shipToLocationAvailability.quantity: è la quantità totale vendibile su tutti i marketplace. La quantità mostrata sull'inserzione è il minimo tra questo campo e availableQuantity dell'offer. Se la tua inserzione mostra un numero diverso da quello che hai inviato, controlla entrambi.
Se hai molti prodotti da aggiornare, ti servono le chiamate in blocco: bulkCreateOrReplaceInventoryItem accetta fino a 25 inventory item. bulkUpdatePriceQuantity serve a cambiare prezzo e quantità delle offer pubblicate; qui la documentazione si contraddice, perché la descrizione parla di 25 offer di un solo SKU e lo schema di 25 inventory item, quindi provala sul tuo account prima di costruirci sopra la coda.
C'è poi un limite che devi tenere presente: ogni inserzione si può modificare al massimo 250 volte in un giorno di calendario, poi resta bloccata fino al giorno dopo, con qualunque API. Se il tuo connettore reinvia la quantità a ogni piccola variazione, o ripete la stessa scrittura per un errore, consuma quel margine. Per questo la coda deve fondere le modifiche ravvicinate sullo stesso SKU e non spedire un valore uguale a quello già inviato. Esistono poi limiti giornalieri di chiamate per applicazione; se i tuoi volumi li avvicinano, eBay offre l'Application Growth Check, gratuito, per chiedere di alzarli.
Ultima avvertenza per te: le inserzioni create con la Inventory API non si possono modificare né ripubblicare con le chiamate della Trading API. Se hai una parte del catalogo in un sistema e una parte nell'altro, decidi per ogni inserzione chi la gestisce.
Cosa torna da eBay e ti serve: ordini, annullamenti e tracking
Dall'altra parte arrivano gli ordini, e tu devi vederli subito. Qui conviene avere due meccanismi insieme: una notifica per la velocità e una riconciliazione periodica per la sicurezza. Non è una regola di eBay, è la mia scelta di progetto, e sotto spiego perché.
La notifica che ti avvisa dei nuovi ordini
Se cerchi in giro, molti vecchi thread dei forum dicono che per i nuovi ordini non esiste una notifica. È superato: la Notification API ha il topic ORDER_CONFIRMATION, inviato al venditore quando l'acquirente completa il checkout, disponibile dalla versione 1.6.6 del 1° dicembre 2025. Serve lo scope sell.fulfillment oppure sell.fulfillment.readonly. Altri topic utili sono ORDER_CANCELLATION_ACTIVITY, ORDER_RETURN_ACTIVITY, ITEM_MARKED_SHIPPED e LISTING, che segnala un'inserzione creata, modificata o chiusa. Non c'è invece un topic per il venditore sulla variazione della quantità.
Un obbligo che tu potresti dimenticare: MARKETPLACE_ACCOUNT_DELETION. Ogni applicazione deve iscriversi, oppure chiedere l'esenzione se non conserva dati eBay, prima della prima chiamata in produzione. Se non lo fai, l'accesso alle API può essere ridotto o revocato. La tua callback deve rispondere con 200, 201, 202 o 204.
La riconciliazione con getOrders
Non fidarti di una notifica sola: può arrivare in ritardo, può non arrivare, può essere persa dal tuo server mentre è fermo. Per questo accanto alla notifica tengo un controllo periodico con getOrders, cioè GET /order, filtrato per lastmodifieddate. Senza filtri la chiamata restituisce gli ordini degli ultimi 90 giorni; con lastmodifieddate:[da..] chiedi solo ciò che è cambiato dall'ultimo controllo. Il limit predefinito è 50 e arriva a 200. Se nel filtro metti anche creationdate, vale quello e non la data di modifica.
Anche eBay, per le notifiche della vecchia Trading API, raccomanda di confermare i dati ricevuti con chiamate API e di tenere un'interrogazione periodica di GetOrders. Il ragionamento vale ancora: la notifica è un campanello, i dati veri li chiedi tu.
Annullamenti e tracking: cosa ti serve leggere
Per gli annullamenti ti aspetta un tranello: nella lista di getOrders le richieste di annullamento sono sempre vuote. Per leggerle devi chiamare getOrder sul singolo ordine, guardando cancelStatus. Gli altri campi che usi per decidere sono orderPaymentStatus e orderFulfillmentStatus.
Quando evadi l'ordine in WooCommerce, il tracking torna a eBay con createShippingFulfillment, POST /order/{orderId}/shipping_fulfillment. Ne crei uno per pacco, con lineItems, shippedDate, shippingCarrierCode e trackingNumber. eBay non verifica il numero di tracking: se il tuo sistema scrive un valore sbagliato, lo accetta, quindi il controllo lo fai tu prima di inviare.
Il tuo pezzo unico venduto due volte
Con un catalogo normale una doppia vendita si recupera, magari riordinando. Con un pezzo unico no: ne hai uno solo. La finestra di rischio è il tempo tra la vendita su un canale e il momento in cui l'altro canale lo sa. Non si porta a zero, si riduce.
Le misure che uso e che puoi copiare, in ordine di effetto:
- Scalare subito. Alla notifica
ORDER_CONFIRMATIONil connettore mette la quantità a 0 sul canale opposto prima di fare qualunque altra cosa, ordine nel CRM compreso. In WooCommerce lo fai conwc_update_product_stock(), che aggiorna con una query diretta per evitare problemi di stock. - Trattenere lo stock degli ordini non pagati. In WooCommerce, nelle impostazioni dei prodotti, il campo «Mantieni scorte (minuti)» trattiene lo stock per gli ordini in attesa di pagamento e, scaduto il tempo, annulla l'ordine e rilascia lo stock. Vale per lo stato «In attesa di pagamento», non per «In sospeso»; vuoto significa funzione disattivata. A livello di codice esiste
wc_reserve_stock_for_order()per trattenere lo stock di un ordine. - Controllo prima della conferma. Quando arriva un ordine da un canale, il connettore verifica che la quantità nella fonte sia ancora maggiore di zero. Se non lo è, l'ordine non si conferma in silenzio: va in una coda di conflitti con un avviso a una persona, che decide se annullare, proporre un pezzo equivalente o sentire il cliente.
- Una sola coda per SKU. Gli eventi sullo stesso codice si eseguono uno alla volta. Senza questo, due ordini simultanei leggono entrambi «1» e passano tutti e due.
Nessuna di queste cose elimina del tutto il caso, e te lo dico chiaro: se due persone pagano nello stesso istante su due canali, uno dei due ordini va gestito a mano. Quello che puoi fare è renderlo raro e visibile, e non scoprirlo quando il pezzo è già partito.
Esaurito su eBay: cosa ti aspetta alla quantità zero
Quando la quantità arriva a 0, l'inserzione si chiude? Dipende dalle preferenze del tuo account, che devi guardare tu. Secondo l'aiuto di eBay Italia, con l'opzione «Le inserzioni rimangono attive quando hai esaurito le scorte» (Preferenze di vendita, Inserzioni con più oggetti) l'inserzione a quantità 0 resta in corso ma non compare nei risultati di ricerca; se resta a 0 per 180 giorni consecutivi, eBay la chiude. La pagina non dice se la regola vale anche per le inserzioni con un solo oggetto.
Per i pezzi unici su inserzioni create con la Inventory API non ho una conferma documentata del comportamento esatto, con l'opzione attiva o disattiva. Quindi provalo sul tuo account con un articolo di prova, prima di affidare al connettore il catalogo vero.
Ti serve un'altra distinzione, che la guida di eBay sulla gestione delle inserzioni fa in modo esplicito: impostare la quantità a zero e chiudere un'inserzione sono flussi diversi. Chiudere è withdrawOffer, che riporta l'offer a «non pubblicata». Poi per rimetterla in vendita si usa publishOffer, POST /offer/{offerId}/publish, anche in blocco per fino a 25 offer. Scegli quale dei due flussi vuoi per un pezzo venduto: a zero resta la storia dell'inserzione, con la chiusura la perdi.
Il «tempo reale» nelle integrazioni WooCommerce eBay di terze parti
Se cerchi un'integrazione già pronta, ti troverai davanti solo prodotti di terze parti: non ho trovato un'integrazione WooCommerce ufficiale di eBay. Alcune dichiarano «sincronizzazione live», ma in quella che ho guardato la documentazione non spiega il meccanismo, e importa gli ordini pagati e non spediti a intervalli scelti da chi la usa. Un intervallo di minuti è una scelta legittima per un negozio con pochi pezzi, e non va bene per un pezzo unico.
Prima di scegliere un plugin, o prima di commissionare un connettore, chiedi tre cose al fornitore: quali eventi arrivano in push e quali si recuperano a intervalli, che cosa succede a un evento perso, e come si vede un ordine rimasto fuori. Se la risposta è «ogni N minuti, e non si vede», hai un sistema senza riconciliazione. Il lavoro del connettore che descrivo sulla pagina API REST e connettori per WordPress è proprio questo: code, nuovi tentativi, idempotenza, log e riconciliazione.
Sul lato WooCommerce valgono gli stessi limiti, e li incontri presto. I webhook (order.created, order.updated, product.updated) si firmano con X-WC-Webhook-Signature, un HMAC-SHA256 in base64 del corpo, e la consegna avviene in background con WP-Cron: se il sito ha poco traffico, il cron può partire in ritardo. Dopo più di cinque consegne fallite consecutive WooCommerce disattiva il webhook, e nessuno ti avvisa se non controlli lo stato. Per scrivere in blocco i prodotti c'è POST /wp-json/wc/v3/products/batch, per impostazione predefinita fino a 100 oggetti per richiesta, con manage_stock e stock_quantity.
Passo per passo: costruisci la tua sincronizzazione
- Scegli la fonte. Gestionale o WooCommerce, scrivilo nero su bianco, e fai in modo che nessun altro sistema scriva la quantità.
- Usa uno SKU stabile. Lo stesso codice in tutti i sistemi, entro i 50 caratteri di eBay.
- Registra l'applicazione eBay e gli scope. Servono
sell.inventoryper l'inventario esell.fulfillmentper gli ordini. Iscriviti subito aMARKETPLACE_ACCOUNT_DELETIONo chiedi l'esenzione. I login li fa una persona: le credenziali non vanno nel codice. - Porta quantità e prezzo su eBay. Leggi il record, cambia il campo, riscrivi tutto con il PUT. Prova su un articolo prima di passare al catalogo.
- Metti una coda davanti. Eventi per SKU in sequenza, modifiche ravvicinate fuse, nessuna scrittura uguale alla precedente, un contatore per le 250 modifiche al giorno.
- Ricevi gli ordini in notifica. Sottoscrivi
ORDER_CONFIRMATION, rispondi subito alla callback e metti il lavoro in coda, senza farlo mentre eBay aspetta. - Riconcilia. A intervalli,
getOrdersconlastmodifieddate, egetOrderper gli annullamenti. - Rimanda il tracking.
createShippingFulfillmentdopo l'evasione, uno per pacco. - Prova con ordini finti, sul tuo account e con articoli di prova, mai sul catalogo vero.
Checklist
- Esiste una sola fonte della quantità e lo sai dire a voce in una frase.
- Il PUT sull'inventory item rimanda tutti i campi, disponibilità compresa.
- La coda tiene conto delle 250 modifiche al giorno per inserzione.
- Il connettore è iscritto a
MARKETPLACE_ACCOUNT_DELETIONo esentato. - Ogni ordine passa dal controllo della quantità prima di essere confermato.
- «Mantieni scorte (minuti)» è impostato su un valore che hai scelto, non lasciato vuoto per caso.
- La riconciliazione gira anche se le notifiche vanno bene, e il suo esito si legge nel log.
- Hai provato che cosa fa l'inserzione a quantità 0 sul tuo account.
- Gli annullamenti si leggono con
getOrder, non dagetOrders.
Errori da evitare
- Credere alla parola «live». Verifica quali eventi sono in push e quali a intervalli.
- Un PUT parziale. Perdi la disponibilità e l'inserzione si ritrova senza quantità.
- Affidarti solo alla notifica. Una notifica persa è un ordine invisibile; ci vuole la riconciliazione.
- Cercare gli annullamenti in
getOrders. La lista è sempre vuota, servegetOrder. - Scrivere la quantità da due sistemi. Nel giro di qualche ora i numeri divergono e nessuno sa quale sia giusto.
- Fidarti del tracking inserito a mano. eBay non lo controlla.
- Provare sul catalogo vero. Un articolo di prova costa niente, una inserzione sbagliata sì.
Consigli
Parti con pochi articoli e allarga a mano a mano che le riconciliazioni vengono pulite. Tieni un registro che lega SKU, ID dell'offer, ID dell'ordine e ordine di WooCommerce: quando qualcosa non torna, ti permette di rispondere in un minuto. Scrivi nel log anche i casi di conflitto, con l'ora e il canale che ha vinto.
Se vendi pezzi unici, decidi prima chi ti rappresenta e scrive al cliente quando c'è un conflitto, e con quale testo. Un ordine annullato per una doppia vendita si gestisce con una parola chiara e in fretta; con un ritardo diventa una recensione negativa. Per i rimborsi e gli annullamenti decide chi gestisce il negozio, non il connettore.
Se hai già un CRM, tienilo a valle e non in mezzo, altrimenti ti toglie chiarezza: il CRM riceve gli ordini, non decide la quantità. Per il lato Bitrix24 e WooCommerce leggi l'integrazione Bitrix24 e WooCommerce.
Domande frequenti
Esiste una notifica eBay per i nuovi ordini o devo interrogare getOrders?
Puoi usare la notifica: il topic ORDER_CONFIRMATION della Notification API, dalla versione 1.6.6 del 1° dicembre 2025. Io la uso per la velocità e tengo comunque getOrders filtrato per lastmodifieddate come riconciliazione periodica, perché una notifica può perdersi.
Come evito che lo stesso pezzo venga comprato da due persone?
Non puoi azzerare il rischio, puoi ridurre la finestra. Scala subito la quantità sull'altro canale, trattieni lo stock degli ordini non pagati con «Mantieni scorte», lavora gli eventi di uno SKU uno alla volta e controlla la quantità prima di confermare. I casi residui finiscono in una coda di conflitti per una persona.
Quando la quantità arriva a 0 l'inserzione si chiude?
Con l'opzione che mantiene attive le inserzioni esaurite, l'inserzione a 0 resta in corso ma non compare nei risultati di ricerca, e dopo 180 giorni consecutivi a 0 eBay la chiude. Per i pezzi unici su inserzioni create con le API Sell il comportamento esatto non è documentato: verificalo sul tuo account.
Come mando a eBay il tracking di un ordine evaso da WooCommerce?
Con createShippingFulfillment (POST /order/{orderId}/shipping_fulfillment), una chiamata per pacco, indicando lineItems, shippedDate, shippingCarrierCode e trackingNumber. eBay non verifica il numero, quindi controllalo tu prima.
Esiste un plugin WooCommerce eBay gratuito o ufficiale?
Un plugin ufficiale di eBay per WooCommerce non l'ho trovato, e non te lo posso indicare; esistono integrazioni di terze parti. Prima di sceglierne una controlla come aggiorna gli ordini e cosa succede a un evento perso, perché la dicitura «live» da sola non lo dice.
Considerazioni finali
Per avere una integrazione WooCommerce eBay che regge ti servono una fonte per la quantità, una coda, la notifica per la velocità e la riconciliazione per la sicurezza, e un posto dove si vedono i conflitti. Il resto sono dettagli delle chiamate, che trovi nelle fonti qui sotto. Se vuoi un connettore tra il tuo magazzino, WooCommerce ed eBay, trovi il servizio nella pagina dei connettori per marketplace, oppure scrivimi dai contatti con il numero approssimativo di articoli e il sistema che oggi usi come magazzino.
Fonti
- eBay Developers, Sell Inventory API, specifica OpenAPI v1.18.5:
createOrReplaceInventoryItem, quantità,publishOffer, chiamate in blocco. - eBay Developers, Sell Fulfillment API, specifica OpenAPI v1.20.7:
getOrders,getOrder,createShippingFulfillment. - eBay Developers, Notification events e release notes della Sell API:
ORDER_CONFIRMATIONdalla versione 1.6.6. - eBay Developers, Marketplace account deletion: iscrizione obbligatoria o esenzione.
- eBay Developers, Listing management: 250 modifiche al giorno per inserzione, quantità a zero e chiusura.
- eBay Developers, Platform Notifications: conferma dei dati e interrogazione periodica.
- eBay Developers, Application Growth Check: richiesta di limiti più alti.
- eBay Italia, Inserzioni con più oggetti e scorte esaurite: inserzioni a quantità 0 e chiusura dopo 180 giorni.
- WooCommerce, Impostazioni dei prodotti: «Mantieni scorte (minuti)».
- WooCommerce, Code reference delle funzioni di stock:
wc_update_product_stock,wc_reserve_stock_for_order. - WooCommerce, REST API e Webhooks: batch, firma e consegna dei webhook.






