<!-- Fonte: https://www.guerrillacommerce.it/risorse/ebay-italia/api-ebay-cosa-permettono-di-automatizzare/ — © Guerrilla Commerce -->

# API eBay: cosa permettono di automatizzare

## Risposta immediata

Le API di eBay permettono di automatizzare la gestione completa del catalogo (caricamento massivo, aggiornamento prezzi e giacenze in tempo reale), l'elaborazione degli ordini (dalla sincronizzazione al marketplace fino alla generazione delle etichette di spedizione), e le attività di customer service (messaggi, feedback, resi). Un seller italiano con 500+ inserzioni può ridurre da 3-4 ore a 15-20 minuti il tempo giornaliero dedicato agli aggiornamenti manuali. Le API ufficiali eBay si dividono in REST (moderne, per la maggior parte delle operazioni) e Trading API (legacy, ancora necessarie per funzioni specifiche come alcune personalizzazioni avanzate). L'accesso base è gratuito, con limiti di chiamate giornaliere che variano da 5.000 a 1.500.000 secondo il volume di vendita.

## Quali operazioni sul catalogo si automatizzano con le API eBay

Le API eBay consentono di gestire l'intero ciclo di vita delle inserzioni senza toccare Seller Hub. 

**Caricamento massivo**: con una chiamata all'API Inventory puoi creare centinaia di inserzioni in pochi minuti, specificando titolo, descrizione, prezzo, categoria, immagini, specifiche tecniche e policy di spedizione. Per un seller che importa prodotti dalla Cina e vuole pubblicare 200 varianti di cover per smartphone, il processo passa da giorni a pochi minuti.

**Sincronizzazione inventario multicanale**: le API permettono di aggiornare giacenze e prezzi in tempo reale. Se vendi lo stesso articolo su eBay, Amazon e il tuo e-commerce, ogni vendita su un canale può automaticamente decrementare la disponibilità sugli altri, evitando overselling. Un negozio di ricambi auto con 1.500 SKU attivi su tre canali riduce da 2-3 ore a zero il tempo di allineamento manuale quotidiano.

**Gestione varianti**: le API Offer e Inventory gestiscono prodotti con varianti (taglie, colori) come entità uniche, aggiornando prezzi e stock per singola variante. Un negozio di abbigliamento con 50 modelli × 5 taglie × 3 colori (750 varianti) può modificare il prezzo base del 10% su tutti gli articoli in una singola operazione batch.

**Modifica prezzi dinamica**: integrando le API con software di repricing, il prezzo si adatta automaticamente alla concorrenza, all'ora del giorno, al livello di stock. Range realistici: ±5-15% rispetto al prezzo base, con regole di margine minimo (es. mai sotto il 18% di margine lordo).

## Come automatizzare ordini e spedizioni

Le API di eBay coprono l'intero flusso post-vendita.

**Sincronizzazione ordini**: l'API Order permette di scaricare automaticamente tutti gli ordini ricevuti, con dati cliente, prodotti acquistati, indirizzo di spedizione, metodo di pagamento. Per chi usa un gestionale o un WMS, l'ordine eBay entra direttamente nel sistema di evasione senza riscrittura manuale.

**Generazione etichette**: tramite l'integrazione con i corrieri (Poste Italiane, BRT, GLS), le API creano automaticamente l'etichetta di spedizione appena l'ordine viene processato. Costo medio etichetta per pacco fino a 2 kg in Italia: 4,50-6,50€ con contratti volume. Un seller con 50 ordini/giorno risparmia 1-1,5 ore al giorno eliminando la generazione manuale.

**Aggiornamento tracking**: le API caricano automaticamente il numero di tracciamento su eBay, attivando la notifica al cliente e avviando il countdown per il feedback. Questo migliora il defect rate e la seller performance.

**Gestione resi**: l'API Return Management consente di ricevere notifiche automatiche quando un cliente apre una richiesta di reso, scaricare l'etichetta di reso prepagata e aggiornare lo stato. Per negozi con policy "reso gratuito 30 giorni", automatizzare questo flusso riduce il tempo medio di gestione da 10-15 minuti a 2-3 minuti per pratica.

| Operazione | Tempo manuale | Tempo con API |
|------------|---------------|---------------|
| Download 50 ordini | 25-30 min | < 1 min |
| Creazione 50 etichette | 60-90 min | 2-3 min |
| Caricamento 50 tracking | 20-25 min | < 1 min |

## Automazione del customer service e delle metriche

Le API eBay gestiscono anche la relazione con i clienti e il monitoraggio delle performance.

**Messaggistica automatica**: l'API Notification e Post-Order permettono di inviare messaggi automatici ai clienti (conferma ordine, richiesta feedback, promozioni per acquisti futuri) rispettando i limiti imposti da eBay contro lo spam. Limite realistico: 1-2 messaggi transazionali automatici per ordine.

**Gestione feedback**: le API consentono di monitorare i feedback ricevuti, rispondere automaticamente a quelli negativi o neutri con template predefiniti, e richiedere revisione per feedback che violano le policy. Un seller con 200 transazioni/mese può impostare alert automatici per feedback < 5 stelle e rispondere entro 24 ore senza controllo manuale quotidiano.

**Monitoraggio metriche**: l'API Analytics fornisce dati su traffico, conversion rate, tasso di difettosità (defect rate), late shipment rate, casi aperti. Per mantenere lo status "Above Standard" su eBay.it servono: defect rate < 2%, late shipment < 4%, casi risolti senza escalation > 90%. Le API permettono di creare dashboard in tempo reale che allertano quando una metrica si avvicina alla soglia critica.

**Gestione casi e controversie**: l'API Case Management scarica automaticamente i casi aperti dai clienti, li smista per tipologia (prodotto non ricevuto, non conforme, danneggiato) e può attivare workflow automatici (es. rimborso automatico sotto i 15€, offerta di sostituzione per difetti).

## Integrazioni pratiche: gestionali, marketplace e repricing

Le API eBay diventano potenti quando integrate con altri sistemi.

**Sincronizzazione con gestionali**: software come Danea, TeamSystem, Zucchetti possono dialogare con eBay via API per allineare automaticamente ordini, fatture, movimenti di magazzino. Per seller con Partita IVA, l'ordine eBay genera automaticamente fattura elettronica e movimenta il gestionale contabile, rispettando gli obblighi di tracciabilità dell'Agenzia delle Entrate.

**Multichannel**: piattaforme come ChannelAdvisor, Lengow, Shopify consentono di gestire eBay + Amazon + e-commerce proprietario da un'unica interfaccia, usando le API per sincronizzare tutto. Un seller attivo su 3 canali con 800 SKU può gestire l'intero inventario in 30-40 minuti/giorno invece di 3-4 ore.

**Repricing automatico**: tool come Appeagle o Seller Snap usano le API per monitorare i prezzi dei concorrenti e modificare automaticamente i tuoi, 24/7. Incrementi realistici di buy box per chi usa repricing: +8-15% rispetto a prezzi fissi, su categorie competitive come elettronica e ricambi.

**Feed prodotto da fornitori**: se il tuo fornitore fornisce un feed CSV o XML aggiornato quotidianamente (prezzo, stock), le API possono importarlo e aggiornare automaticamente tutte le inserzioni eBay. Per rivenditori di cataloghi con 2.000+ articoli, questa automazione è indispensabile.

## Limiti e accesso alle API eBay

L'accesso alle API eBay è gratuito ma soggetto a limiti tecnici e policy.

**Limiti di chiamata**: eBay assegna quote giornaliere in base al volume di vendita. Seller base: ~5.000 chiamate/giorno; Above Standard: fino a 1.500.000. Una chiamata tipica per aggiornare un'inserzione conta come 1 richiesta; scaricare 100 ordini può costare 1-2 chiamate se impaginate correttamente.

**Certificazione**: per alcune API (es. trading API per funzioni legacy) serve una certificazione che richiede qualche giorno di review da parte di eBay. Per API REST moderne il processo è immediato.

**Sviluppo o software terzi**: puoi sviluppare internamente (serve programmatore con conoscenza REST, OAuth 2.0) oppure usare software SaaS già integrati (costo medio: 50-300€/mese secondo funzionalità e volume). Per seller sotto i 1.000 ordini/mese, il SaaS è quasi sempre più conveniente dello sviluppo custom.

**Policy**: eBay vieta l'uso delle API per scraping massivo di dati competitori, invio spam, manipolazione artificiale di metriche. La violazione porta alla sospensione dell'accesso API e, nei casi gravi, dell'account venditore.

**Documentazione**: eBay fornisce documentazione completa, sandbox di test e forum sviluppatori. Tempo di setup realistico per un'integrazione base (sync ordini + inventario): 2-5 giorni per uno sviluppatore esperto.

## FAQ

### Le API eBay sono gratuite?
Sì, l'accesso alle API eBay è gratuito. I costi nascono solo se usi software terzi o servizi a pagamento che le sfruttano (gestionali, tool di repricing, piattaforme multichannel). I limiti di chiamate giornaliere sono sufficienti per la maggior parte dei seller, scalando automaticamente con il volume di vendita.

### Serve un programmatore per usare le API eBay?
Non necessariamente. Se usi software terzi già integrati (Shopify, ChannelAdvisor, gestionali italiani come Danea), le API lavorano in background senza bisogno di scrivere codice. Per integrazioni custom o automazioni specifiche serve uno sviluppatore con competenze REST API e OAuth 2.0, oppure un'agenzia specializzata.

### Le API funzionano anche per eBay.it o solo per eBay USA?
Le API eBay sono globali e funzionano su tutti i marketplace, incluso eBay.it. Devi solo specificare il marketplace ID corretto (EBAY_IT per l'Italia) nelle chiamate. Questo permette di gestire anche account multi-paese (es. eBay.it + eBay.de + eBay.fr) dalla stessa integrazione, utile per seller che espandono in Europa.