Vendere su Amazon, eBay o altri marketplace oltre che sul proprio sito porta fatturato. Porta anche un problema: prodotti, ordini e disponibilità vivono in posti diversi, e qualcuno deve tenerli allineati.
All'inizio si fa a mano: si copia l'ordine nel gestionale, si aggiorna lo stock, si incolla la scheda prodotto dal sito al marketplace. Poi i canali diventano tre, gli ordini cinquanta al giorno, e gli errori cominciano a costare: prodotti venduti due volte, spedizioni dimenticate, prezzi diversi da un canale all'altro.
In questo articolo vediamo le strade possibili per portare prodotti e ordini dai marketplace nel tuo eCommerce o nel gestionale: API ufficiali, report ed export, estensioni browser che leggono la pagina e integrazioni dedicate. E soprattutto come mappare i dati perché il flusso non crei più problemi di quanti ne risolva.
In breve
- Le API ufficiali sono la strada migliore per flussi continui, quando sono accessibili.
- Report ed export vanno bene per import periodici e volumi contenuti.
- Un'estensione browser è utile quando il dato è visibile in pagina ma non esposto da un'API, o quando un sistema non ha API.
- La parte difficile non è prendere il dato, è mapparlo: SKU, varianti, IVA, stati ordine, valute.
- Ogni dato deve avere una sola fonte autorevole, e ogni ordine una chiave univoca.
Tre strade per portare i dati fuori dal marketplace
1. Le API ufficiali
I principali marketplace offrono API per i venditori. Amazon ha la Selling Partner API, con API dedicate a ordini, listing e catalogo; eBay ha le Sell API, fra cui la Fulfillment API per gli ordini e la Inventory API per offerte e disponibilità.
Vantaggi:
- dati strutturati e documentati;
- autorizzazioni esplicite concesse dall'account venditore;
- adatte a sincronizzazioni automatiche e continue;
- possibilità di scrivere, non solo leggere: aggiornare stock, confermare spedizioni.
Limiti da conoscere:
- serve registrare un'applicazione e ottenere le autorizzazioni;
- ci sono limiti di chiamate da rispettare;
- le API cambiano versione: Amazon, per esempio, ha pubblicato una nuova versione della Orders API datata 2026-01-01, e le integrazioni vanno aggiornate;
- i dati personali degli acquirenti richiedono autorizzazioni specifiche e vanno trattati con attenzione;
- alcune informazioni visibili nel pannello venditore non sono esposte, o lo sono in forma diversa.
2. Report ed export
Quasi tutti i pannelli venditore permettono di scaricare report di ordini, inventario e listing in CSV o formati simili. È la strada più semplice per iniziare: si scarica, si trasforma, si importa.
Funziona bene per volumi contenuti e aggiornamenti giornalieri. Diventa fragile quando serve più frequenza, perché dipende da una persona che scarica il file e da un formato che può cambiare senza preavviso.
3. Estensioni browser che leggono la pagina
Ci sono casi in cui le API non bastano o non ci sono:
- un marketplace o un portale fornitore senza API;
- un dato visibile in pagina ma non restituito dall'API;
- un'azienda piccola che non vuole affrontare registrazione e manutenzione di un'app;
- un import puntuale, per esempio il catalogo iniziale quando si apre il proprio eCommerce.
In questi casi un'estensione del browser può leggere la pagina che stai già consultando, estrarre i dati strutturati, fartene vedere un'anteprima e inviarli al tuo sistema. È l'approccio di Ammatita Bridge, un'estensione Chrome che estrae prodotti, ordini e dati generici da una pagina — leggendo JSON-LD, elementi della pagina, selettori CSS o XPath, con adattatori dedicati per Amazon ed eBay — e li invia in JSON, XML o CSV a un endpoint configurabile, con autenticazione tramite API key, token o firma HMAC.
Il vantaggio è che il dato arriva già strutturato e passa da una revisione umana prima dell'invio. Il limite è che si lavora pagina per pagina e che l'estrazione dipende dalla struttura della pagina: un'estensione è ottima per import puntuali e per colmare i buchi delle API, non sostituisce una sincronizzazione continua lato server.
Una nota importante: usare un'estensione non cambia le regole. Va usata su pagine che hai diritto a consultare e su dati che hai diritto a riutilizzare — i tuoi prodotti, i tuoi ordini, i listini dei fornitori con cui hai un accordo — rispettando i termini d'uso della piattaforma. Copiare in massa schede e immagini di altri venditori è un'altra cosa, e non la consigliamo.
Quale strada scegliere
| Situazione | Strada consigliata |
|---|---|
| Molti ordini al giorno, più canali, stock condiviso | API ufficiali con integrazione lato server |
| Pochi ordini, aggiornamento giornaliero sufficiente | Report/export con import automatizzato |
| Import iniziale del proprio catalogo da un marketplace | API se disponibili, altrimenti estensione con revisione |
| Portale fornitore o marketplace senza API | Estensione browser verso un endpoint dedicato |
| Dato visibile in pagina ma assente nell'API | API per il flusso principale + estensione per il dato mancante |
Spesso la risposta giusta è una combinazione, non una sola tecnologia.
La parte difficile: mappare i dati
Prendere il dato è la parte facile. Farlo entrare correttamente nel tuo eCommerce o nel gestionale richiede decisioni precise.
Identificativi dei prodotti
Ogni marketplace ha i suoi codici: ASIN su Amazon, item ID su eBay, più lo SKU del venditore e spesso un EAN/GTIN. Serve una tabella di corrispondenza fra il tuo codice interno e i codici di ogni canale. Senza, lo stesso prodotto diventa tre prodotti diversi.
Varianti
Taglie e colori sono organizzati in modo diverso da piattaforma a piattaforma. Un prodotto padre con varianti su un marketplace può essere una serie di prodotti semplici su un altro. Il mapping va deciso prima, non scoperto durante l'import.
Prezzi, IVA e valute
Il prezzo che vedi può essere IVA inclusa o esclusa, in valute diverse, con commissioni del marketplace non visibili nell'ordine. Per report e margini servono campi separati: prezzo lordo, imposte, commissioni, spedizione.
Stati degli ordini
"Pending", "Unshipped", "Shipped", "Cancelled": ogni canale ha i suoi stati e vanno ricondotti a quelli del tuo sistema.
| Stato nel marketplace | Stato interno | Azione |
|---|---|---|
| In attesa di pagamento | Non importare o "in attesa" | Non scalare lo stock definitivo |
| Pagato, da spedire | Da evadere | Scalare lo stock, creare l'ordine |
| Spedito | Evaso | Aggiornare tracking |
| Annullato | Annullato | Ripristinare lo stock |
| Reso/rimborsato | Reso | Aggiornare report e margini |
Una chiave univoca per ogni ordine
L'ID ordine del marketplace va salvato come chiave esterna. L'import lavora in modalità upsert: se l'ordine esiste lo aggiorna, se non esiste lo crea. È l'unico modo per rilanciare un import fallito senza creare doppioni.
Chi è la fonte autorevole di ogni dato
L'errore più comune è sincronizzare tutto in tutte le direzioni. Il risultato sono dati che si sovrascrivono a vicenda.
- Stock: una sola fonte, di solito gestionale o magazzino, che aggiorna sito e marketplace.
- Ordini: nascono nel canale di vendita e confluiscono in un unico sistema di evasione.
- Schede prodotto: si curano in un solo posto (PIM, gestionale o eCommerce) e si adattano ai canali.
- Prezzi: una regola per canale, calcolata da un prezzo base, non modificata a mano ovunque.
È lo stesso principio che descriviamo nell'articolo su eCommerce, gestionale, API e magazzino: senza una fonte autorevole per ogni campo, l'integrazione moltiplica gli errori invece di eliminarli.
Un esempio pratico
Un negozio di articoli per la casa vende sul proprio sito, su Amazon e su eBay, con circa 1.200 prodotti e 60 ordini al giorno. Oggi una persona passa due ore al giorno a copiare ordini e aggiornare disponibilità.
- Gli ordini Amazon ed eBay arrivano via API ogni pochi minuti e vengono creati nel gestionale con l'ID del marketplace come chiave.
- Lo stock parte dal gestionale e viene inviato al sito e ai marketplace dopo ogni movimento.
- Per l'apertura di un nuovo canale, un portale B2B di un distributore senza API, i listini vengono letti con un'estensione browser e inviati a un endpoint che li normalizza.
- Gli ordini che non superano i controlli — SKU sconosciuto, stato incoerente — finiscono in una coda di errori da gestire, invece di bloccare tutto il flusso.
Il lavoro manuale non sparisce del tutto: si sposta sulle eccezioni, che sono poche e visibili.
Checklist prima di partire
- Elenco dei canali e, per ciascuno, dei dati da importare ed esportare.
- Verifica di quali dati sono disponibili via API, via report o solo in pagina.
- Tabella di corrispondenza fra codici interni e codici dei marketplace.
- Regole per varianti, prezzi, IVA, valute e commissioni.
- Mappatura degli stati ordine.
- Fonte autorevole definita per stock, prezzi, schede e ordini.
- ID esterni salvati e import in modalità upsert.
- Coda errori e log consultabili.
- Gestione dei dati personali degli acquirenti limitata a ciò che serve per evadere l'ordine.
- Verifica dei termini d'uso di ogni piattaforma.
Cosa chiedere a chi realizza l'integrazione
- Usate le API ufficiali? Chi è il titolare dell'applicazione registrata?
- Cosa succede quando il marketplace cambia versione dell'API?
- Come riconoscete un ordine già importato?
- Chi aggiorna lo stock e in quale direzione?
- Dove vedo gli ordini che non sono stati importati e perché?
- Quali dati personali degli acquirenti vengono salvati, e per quanto tempo?
- Se usate un'estensione o un'automazione sulla pagina, su quali pagine e con quali permessi?
Come lo gestiamo in BitHub
Progettiamo l'integrazione partendo dai flussi, non dallo strumento: quali canali, quali dati, quale sistema comanda su ogni campo. Poi scegliamo il mezzo giusto per ciascun flusso — API ufficiali dove possibile, report automatizzati dove bastano, estensione browser e endpoint dedicati dove servono — e costruiamo mapping, code di errore e log.
Quando il problema è più ampio, l'integrazione con i marketplace rientra nel progetto complessivo di eCommerce integrato con il gestionale o di sviluppo eCommerce su misura. E se i prodotti vanno anche su Google Shopping, lo stesso catalogo normalizzato alimenta il feed Merchant Center.
Se stai ancora decidendo la piattaforma, vale la pena leggere anche il confronto fra Shopify, PrestaShop e custom: la facilità di integrazione con i canali è uno dei criteri che cambiano la scelta. E per chi monitora anche i prezzi dei concorrenti sui marketplace, l'articolo sul monitoraggio prezzi competitor affronta il tema dal lato dell'analisi.
FAQ
Qual è il modo migliore per importare gli ordini da Amazon o eBay?
Quando è possibile, le API ufficiali del marketplace: sono pensate per la sincronizzazione continua, hanno autorizzazioni esplicite e restano stabili nel tempo. Report ed estensioni sono utili quando le API non sono accessibili o non espongono il dato che serve.
Un'estensione browser può sostituire un'integrazione via API?
No. Un'estensione lavora sulla pagina che hai aperto ed è ottima per importazioni puntuali, dati non esposti dalle API o sistemi senza API. Per flussi continui e ad alto volume serve un'integrazione lato server.
Posso importare i prodotti di un altro venditore dal marketplace?
È una scelta da valutare con molta cautela: testi, immagini e dati appartengono a chi li ha pubblicati e i termini del marketplace pongono limiti. L'uso tipico e sicuro è importare i propri prodotti, i propri ordini e i dati dei fornitori con cui si ha un accordo.
Come si evitano ordini importati due volte?
Usando l'ID ordine del marketplace come chiave esterna e facendo import in modalità upsert: se l'ordine esiste già viene aggiornato, non duplicato. Servono anche log e controllo degli stati.
Lo stock va sincronizzato dal marketplace verso l'eCommerce?
Di solito no. Lo stock dovrebbe avere una sola fonte autorevole, tipicamente il gestionale o il magazzino, che aggiorna sito e marketplace. Dal marketplace arrivano gli ordini che scalano la disponibilità.
Vendi su più canali e passi troppo tempo a copiare dati?
Possiamo analizzare i tuoi canali, capire quali dati sono disponibili via API e quali no, e progettare un flusso che porti prodotti e ordini dove servono senza doppioni.