Vendi sul tuo sito e su uno o più marketplace, e le giacenze le tieni in un gestionale. Quando prodotti e ordini aumentano, compaiono le vendite di articoli ormai esauriti, i prezzi rimasti indietro e gli ordini ricopiati da una schermata all’altra. Un’integrazione marketplace fatta bene sposta questo lavoro dietro le quinte e ti dice con chiarezza quando qualcosa non è passato.
La prima decisione non è tecnica: quale sistema fa fede per ciascuna informazione. Di norma le giacenze arrivano dal gestionale, descrizioni e foto dal negozio. Se due sistemi possono scrivere lo stesso campo, prima o poi si contraddiranno.
Dove si spezza la catena quando vendi su più canali
Il problema classico è vendere merce che non hai più: l’ultimo pezzo viene venduto sul sito e il marketplace continua a mostrarlo disponibile fino al prossimo aggiornamento. Il secondo è il prezzo: cambi il listino nel gestionale e dimentichi un canale, oppure applichi uno sconto che, tolta la commissione della piattaforma, ti porta sotto costo.
Il terzo riguarda le persone: qualcuno scarica gli ordini, li ridigita nel gestionale, emette la fattura e riporta sulla piattaforma il numero di spedizione. Ogni passaggio manuale è un’occasione di errore e un limite ai volumi, proprio quando vendi di più.
Che cosa sincronizziamo tra negozio, gestionale e piattaforma
Il collegamento è un servizio separato, collocato tra i tre sistemi: legge le modifiche da una parte, le traduce nel formato dell’altra e tiene traccia di ciò che ha inviato. Così più avanti puoi aggiungere un secondo canale senza rifare tutto.
Prendi il caso di un negozio WooCommerce, con un gestionale dotato di API (l’interfaccia con cui un programma chiede dati a un altro) e un account venditore su eMAG Marketplace. I flussi abituali:
- Giacenze: ogni movimento registrato nel gestionale parte verso tutti i canali, con una scorta di sicurezza sui prodotti ad alta rotazione.
- Prezzi: partiamo dal prezzo base e applichiamo regole per canale (ricarico, arrotondamento, prezzo minimo).
- Ordini: l’ordine arrivato dalla piattaforma entra nel gestionale come qualsiasi altro e scala le giacenze ovunque.
- Stati e documenti: numero di spedizione, fattura e stato dell’ordine tornano sulla piattaforma; i resi si riflettono sulle giacenze.
La mappatura di categorie e caratteristiche
Ogni marketplace ha il proprio albero di categorie e, per ciascuna categoria, caratteristiche obbligatorie, spesso con valori ammessi presi da un elenco predefinito. Da te il colore può essere «blu navy»; la piattaforma accetta solo «blu». Senza questa traduzione i prodotti vengono respinti in fase di validazione o finiscono nella categoria sbagliata.
Costruiamo una tabella di corrispondenza: la tua categoria verso quella della piattaforma, il tuo attributo verso la sua caratteristica, il tuo valore verso il valore ammesso. Una parte si abbina in automatico, il resto lo completa una persona, una volta sola. Dove il prodotto esiste già nel catalogo della piattaforma, lo colleghiamo alla scheda esistente, di norma tramite il codice a barre (EAN), invece di crearne una nuova.
Code di messaggi, nuovi tentativi e che cosa vedi in caso di errore
Le API delle piattaforme hanno limiti di richieste e finestre di manutenzione. Per questo non inviamo nulla direttamente: ogni modifica diventa un messaggio in una coda, cioè un elenco di attività elaborate una alla volta, in background. Se la piattaforma non risponde, il messaggio resta in coda e viene ritentato a intervalli via via più lunghi.
Due dettagli contano. L’idempotenza: lo stesso messaggio, inviato due volte, produce un solo effetto, quindi un nuovo tentativo non raddoppia un ordine. La sequenza: per le giacenze inviamo il valore corrente, non la differenza, così un messaggio arrivato in ritardo non falsa la cifra.
- Nuovo tentativo automatico: per gli errori passeggeri, come il limite di richieste raggiunto.
- Elenco dei messaggi bloccati: per gli errori che richiedono una persona (una caratteristica obbligatoria mancante, per esempio), con il motivo spiegato in parole chiare.
- Avviso: un messaggio al team quando la coda cresce in modo anomalo o quando un ordine non è arrivato nel gestionale.
- Riconciliazione periodica: un confronto completo delle giacenze tra i sistemi, che intercetta ciò che è sfuggito al flusso ordinario.
Come si svolge un’integrazione marketplace, dagli account ai primi ordini
Cominciamo con una ricognizione: quali API ha il gestionale, quali permessi ha l’account venditore, quanti prodotti hai. Lo sviluppo parte da giacenze e prezzi su un piccolo gruppo di prodotti, prosegue con l’acquisizione degli ordini e solo alla fine arriva alla pubblicazione di nuovi prodotti.
Facciamo i test nell’ambiente di prova della piattaforma, dove esiste, poi con ordini reali di piccolo importo. Di solito usiamo Laravel (un framework PHP con un sistema di code integrato), Redis (un database tenuto in memoria, adatto alle code) e i webhook (notifiche inviate da un sistema quando qualcosa cambia).
Un limite detto con franchezza: se vendi pochi prodotti su un solo canale, un plugin già pronto può bastare e costare meno. Il codice su misura si giustifica quando hai regole di prezzo tue, più magazzini o un gestionale senza connettore.
Domande frequenti
In quanto tempo una variazione di giacenza arriva sul marketplace?
Rapidamente, ma non all’istante: dipende da quanto spesso il gestionale comunica le variazioni e dai limiti di richieste della piattaforma. La scorta di sicurezza riduce il rischio di vendere, in questo intervallo, ciò che non hai più.
Posso avere prezzi diversi sul sito e sul marketplace?
Sì, le regole di prezzo si definiscono separatamente per ogni canale. Verifica comunque le condizioni contrattuali della piattaforma su prezzi e promozioni.
Da che cosa dipende il costo di un collegamento di questo tipo?
Dal numero di sistemi collegati, dalla qualità delle API del gestionale e da quanto lavoro richiede la mappatura del catalogo. Un catalogo pulito accorcia molto i tempi.
Questa è la descrizione di un progetto tipo: mostra come affrontiamo di solito un lavoro di questo genere e non presenta un progetto realizzato per un cliente specifico. Ogni progetto reale parte dalla situazione della tua azienda; fasi, tempi e prezzo si definiscono dopo il primo colloquio.