eBay conta le revisioni via API, annuncio per annuncio

Un annuncio smette di accettare le revisioni fatte dai programmi. eBay tiene un contatore di revisioni agganciato al singolo annuncio, per giorno di calendario. E sul numero si contraddice da solo, nella stessa pagina.

Il fornitore alza il prezzo. Il tuo software prova a ribattere il nuovo prezzo su eBay, e eBay dice di no. Riprovi su quell'annuncio: ancora no. Il giorno di calendario dopo, senza che tu abbia toccato niente, riparte da solo.

Non è un guasto casuale. eBay conta le revisioni fatte via API, e le conta annuncio per annuncio.

Il contatore è agganciato all'oggetto, non all'account

In cima alla pagina di ReviseFixedPriceItem, nella documentazione della Trading API, c'è una nota: ogni annuncio eBay può essere revisionato un certo numero di volte in un giorno di calendario. Raggiunta quella soglia, il venditore resta bloccato dall'usare quelle chiamate su quell'annuncio fino al giorno di calendario successivo.

Le parole contano: «on the listing», e più in basso «from revising the item». In tutti e due i casi lo scope è il singolo annuncio. Da lì si deduce — ed è una deduzione, perché il contrario eBay non lo scrive mai in positivo — che gli altri annunci non siano toccati. Ed è il motivo per cui il guasto sembra casuale.

Il numero: eBay si contraddice da solo

Qui arriva la parte che non racconta nessuno. Sulla stessa pagina ci sono due cifre diverse: la nota in cima dice 250 revisioni in un giorno di calendario, il paragrafo Usage Details più in basso dice 150.

E non cambia solo il numero: cambia anche quali chiamate contano. La nota dei 250 nomina ReviseFixedPriceItem e ReviseItem, il paragrafo dei 150 ci aggiunge ReviseInventoryStatus. La nota dei 250, poi, compare identica anche sulla pagina di ReviseItem: non è il refuso di una pagina sola.

Come si presenta quando succede

Il codice è 21917010, e nell'elenco ufficiale degli errori della Trading API è classificato Serious Error: bloccante, non un avviso. Dice che l'annuncio non può essere revisionato perché è stato raggiunto il numero massimo di revisioni consentite. È l'unico codice di quell'elenco che riguarda questo limite.

Il limite di account esiste, ma è un'altra cosa

Attenzione a non leggere «non è per account» come «eBay non limita l'account». Limita eccome: sono limiti diversi, con codici diversi, e confonderli fa cercare il guasto nel posto sbagliato.

Il primo eBay lo chiama esplicitamente un limite a livello venditore, e non di applicazione: 1200 chiamate Revise ogni 30 secondi, cioè ReviseItem, ReviseFixedPriceItem e ReviseSellingManagerTemplate. Quando le richieste di un venditore raggiungono quel tetto nella finestra di tempo, il codice restituito è 21919144.

Poi c'è ReviseInventoryStatus, la chiamata che cambia solo prezzo e/o quantità: per user ID venditore non più di 6000 chiamate in un intervallo di 15 secondi, e chi supera viene bloccato finché il blocco non si azzera dopo 15 secondi. Sulla sua pagina non c'è nessun tetto giornaliero per oggetto.

Che cosa conta come revisione

Le cose che tocchi tutti i giorni. eBay spiega che per qualunque cosa il venditore voglia cambiare — come la quantità o il prezzo — va incluso quel campo nella richiesta con il nuovo valore. Prezzo e quantità sono gli esempi della documentazione stessa: cioè quello che un'automazione di dropshipping muove tutto il giorno.

ReviseInventoryStatus cambia solo prezzo e/o quantità, e in una chiamata sola può toccare fino a quattro annunci a prezzo fisso. Se entri nel contatore per oggetto dipende da quale delle due frasi di eBay leggi: la nota dei 250 non la include, il paragrafo dei 150 sì.

Il titolo ha una restrizione tutta sua, che col contatore giornaliero non c'entra: su un annuncio a prezzo fisso a quantità multipla, dopo che è stato venduto un pezzo non si possono più cambiare titolo, categoria principale, categoria secondaria, durata e tipo di inserzione. Gli altri campi restano modificabili.

Il punto in cui è facile dire troppo

Tutto quello che hai letto sta nella documentazione per sviluppatori, e parla di chiamate API. La pagina di aiuto per i venditori normali, Revise a listing, non nomina mai un tetto giornaliero: dice che revisionare non costa niente a meno di aggiungere una funzione a pagamento, e che per la maggior parte degli annunci titolo, foto e opzioni si possono modificare in qualsiasi momento. Anche la guida sviluppatori sulle regole di revisione resta su restrizioni di altro tipo — offerte, Proposte d'acquisto, aste a meno di dodici ore dalla fine — senza dare nessun numero.

Quindi la frase onesta è una sola: eBay documenta un tetto sulle revisioni fatte via API. Che una modifica battuta a mano dal pannello venditore incrementi lo stesso contatore non lo scrive nessuna fonte ufficiale, né in un senso né nell'altro.

Un dettaglio che vale la pena conoscere

Una revisione che non cambia niente — stesso prezzo e stessa quantità di quelli già presenti — eBay non la applica, e risponde con un Warning invece che con un errore: codici 21917091, 21917092 e 21917093. Se una chiamata a vuoto così consumi comunque una unità del contatore giornaliero, però, eBay non lo dice. Quindi non lo diciamo neanche noi.

Le cose che restano senza risposta

• Quale delle due cifre valga. eBay ne pubblica due nella stessa pagina, e nessuna fonte ufficiale sceglie.
• Se il tetto per oggetto sia uguale su tutti i mercati, eBay.it compreso: l'articolo di supporto rimanda a regole di revisione diverse per ogni sito nazionale, e nessuna di quelle pagine dà un numero.
• Se una modifica fatta a mano incrementi lo stesso contatore. Nessuna fonte ufficiale lo afferma.

Dove entra DropMind, e dove no

Prima il no, che vale di più. Nessun software alza quel tetto. E in nessuna delle pagine ufficiali che abbiamo letto c'è un contatore da consultare per sapere quanto ci sei vicino: il primo segnale è l'errore, e arriva quando è già successo.

Quello su cui si lavora sta a monte. L'unica cosa che la documentazione conta sono le chiamate Revise su quell'annuncio: un'automazione che le lancia più volte del necessario lavora contro un contatore che non vede.

Il monitor di DropMind controlla i prodotti dal lato del fornitore — prezzo e disponibilità — e ti segnala quando cambiano, su dieci fornitori e cinque canali. Quello che non fa è indovinare al posto tuo un limite che eBay dichiara in due modi diversi.

Da dove vengono questi fatti

Dalle pagine ufficiali eBay elencate qui sotto, aperte nel browser l'1 settembre 2026. Una nota di metodo, perché è il motivo per cui la contraddizione è saltata fuori: developer.ebay.com non risponde ai recuperi automatici, va in timeout, e le pagine sono state lette a mano una per una. I 250 e i 150 stanno a due schermate di distanza: chi legge solo la nota in cima non li vede mai insieme.