1. Home
  2. iThink
  3. WordPress
  4. Integrazione WooCommerce eBay: stock e ordini nei due sensi
WordPress

Integrazione WooCommerce eBay: stock e ordini nei due sensi

Corsia di un magazzino con scaffali alti pieni di scatole
Immagine: tianya1223 · Pixabay · Licenza dei contenuti Pixabay

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.

Il flusso nei due sensi. Quantità e prezzi scendono verso eBay, ordini, annullamenti e tracking risalgono. Il connettore sta in mezzo e tiene la coda, i controlli e il registro; il CRM riceve gli ordini a valle.

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_CONFIRMATION il connettore mette la quantità a 0 sul canale opposto prima di fare qualunque altra cosa, ordine nel CRM compreso. In WooCommerce lo fai con wc_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.

simulazione · sincronizzazione.log
$ tail -f sincronizzazione.log
[*] ORDER_CONFIRMATION ebay ordine 00-00000-00001, SKU PZ-1001, qta 1
[✓] fonte: PZ-1001 passa da 1 a 0, WooCommerce aggiornato
ordine WooCommerce #1001 su PZ-1001: quantità 0, bloccato dal controllo
[✓] conflitto in coda per l'operatore, cliente non ancora avvisato
[✓] ordine evaso: tracking inviato a eBay con createShippingFulfillment
[*] riconciliazione notturna: getOrders con lastmodifieddate
ordine 00-00000-00002 non ricevuto in notifica, recuperato
[✓] riconciliazione chiusa: 1 ordine recuperato, 0 doppioni
Simulazione. Numeri, nomi e tempi sono di esempio: il comportamento è quello descritto nel testo.

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

  1. Scegli la fonte. Gestionale o WooCommerce, scrivilo nero su bianco, e fai in modo che nessun altro sistema scriva la quantità.
  2. Usa uno SKU stabile. Lo stesso codice in tutti i sistemi, entro i 50 caratteri di eBay.
  3. Registra l'applicazione eBay e gli scope. Servono sell.inventory per l'inventario e sell.fulfillment per gli ordini. Iscriviti subito a MARKETPLACE_ACCOUNT_DELETION o chiedi l'esenzione. I login li fa una persona: le credenziali non vanno nel codice.
  4. 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.
  5. 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.
  6. Ricevi gli ordini in notifica. Sottoscrivi ORDER_CONFIRMATION, rispondi subito alla callback e metti il lavoro in coda, senza farlo mentre eBay aspetta.
  7. Riconcilia. A intervalli, getOrders con lastmodifieddate, e getOrder per gli annullamenti.
  8. Rimanda il tracking. createShippingFulfillment dopo l'evasione, uno per pacco.
  9. 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_DELETION o 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 da getOrders.

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, serve getOrder.
  • 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

Condividi LinkedIn Facebook X WhatsApp Telegram Email
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.

Marketing & Google Ads

Le tue campagne stanno bruciando budget?

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

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