PrestaShop e ManoMano: l'integrazione feed che funziona

Integrare PrestaShop e ManoMano sembra un problema risolto: c’è il modulo ufficiale, ci sono i connettori multicanale, c’è la documentazione del marketplace. Poi vai a vendere davvero e scopri che il collo di bottiglia non è “collegare” i due sistemi: è il feed - quel file che ogni giorno deve dire a ManoMano prezzi, quantità e spedizioni di migliaia di referenze senza rompersi. Su un e-commerce di arredamento che seguo, alla fine il feed l’ho riscritto io, su misura. In questo articolo ti racconto come funziona l’integrazione, dove si inceppa e quando ha senso passare al custom.

⚠️ Vendere su ManoMano con PrestaShop: le tre strade

ManoMano è il marketplace europeo del bricolage, casa e giardino: se vendi arredamento, utensili o materiale edile, è un canale che pesa. Per collegarci un PrestaShop le strade sono tre:

Nessuna delle tre è “quella giusta” in assoluto. La domanda vera è un’altra: il tuo catalogo entra nelle regole dello strumento, o lo strumento va piegato al tuo catalogo? Con poche decine di prodotti senza varianti, il modulo standard di solito basta. Quando il catalogo si complica, cominciano i problemi che vedo più spesso: prodotti che non compaiono, quantità che restano indietro, spedizioni calcolate male.

🛠️ Come funziona il feed ManoMano: catalogo e offerte

ManoMano lavora su due binari distinti. Il feed catalogo descrive i prodotti: SKU univoco, EAN (o, in alternativa, codice produttore più brand), categoria ManoMano corretta, titolo tra 50 e 65 caratteri, almeno un’immagine e fino a cinque, descrizione ricca. Le varianti vanno raggruppate con un ParentSKU, e ogni combinazione resta un item a sé con il suo codice.

Il feed offerte è quello che lavora tutti i giorni: prezzo pieno e prezzo scontato, quantità disponibile, tempi di spedizione e costi per corriere - dichiarati riga per riga o tramite le griglie vettori configurate sul seller center.

Il feed catalogo si tocca quando cambia l’assortimento. Il feed offerte deve girare spesso, essere leggero e non fallire mai: è lui che decide se su ManoMano il tuo prezzo è giusto e il prodotto ordinabile.

È una distinzione che sembra banale, ma è il punto in cui molte integrazioni tra PrestaShop e ManoMano si incastrano: trattano tutto come un unico blocco.

⚠️ Il problema vissuto: tutto il catalogo, a ogni giro

Sul caso che seguo - un e-commerce di arredamento con migliaia di referenze - l’integrazione partiva dal modulo ufficiale a pagamento. Con quel catalogo, la parte feed rigenerava a ogni giro l’export completo: tutti i prodotti, tutti gli attributi, l’XML di tutto, anche quando l’unica cosa cambiata dal giorno prima erano prezzi e quantità. Dal nostro lato vedevamo il risultato: elaborazioni che non andavano a buon fine, aggiornamenti che arrivavano in ritardo, e ogni volta la stessa domanda - è il file, il trasferimento o il marketplace?

Il paradosso: per tenere allineati prezzo e stock - l’unica cosa che serve davvero ogni giorno - non serviva niente di tutto quel peso. Bastava un file leggero e parsabile, con dentro solo quello che cambia, che ManoMano potesse digerire senza sorprese.

✅ Il caso reale: un feed offerte CSV su misura

La soluzione è stata scrivere un generatore di feed offerte dedicato: uno script PHP che interroga direttamente PrestaShop e produce il CSV esattamente nel formato che ManoMano si aspetta. Niente strati intermedi, niente export monolitico.

Schema del flusso: PrestaShop resta la sorgente, ma al marketplace arriva solo quello che cambia davvero - prezzi, quantità, tempi - invece dell’intero catalogo a ogni giro.

Cosa gestisce, in concreto:

• Una riga per combinazione, identificata su prodotto più variante - non sull’EAN. È la scelta che fa la differenza tra un catalogo online e uno fermo al palo: se pretendi un codice a barre su ogni combinazione, in un catalogo di arredamento ne pubblichi pochissime, perché le varianti un EAN proprio spesso non ce l’hanno. Il tracciato ManoMano lo consente: al posto dell’EAN si identifica il prodotto con codice interno e brand, e la scheda entra a scaffale invece di restare fuori.
• Prezzi custom per il canale: il prezzo si calcola a runtime con le regole vere dello shop (promozioni attive comprese), poi si applica il ricarico di canale e i prezzi concordati per singolo brand. Un marketplace non è il tuo sito: commissioni e accordi cambiano i margini, e il feed lo sa. Quando lo sconto non c’è, il campo del prezzo pieno resta vuoto: il barrato non è mai finto.
• Quantità reale dal magazzino PrestaShop, filtrata dalle regole di pubblicabilità del canale: prodotti disattivi o non ordinabili, categorie escluse e - soprattutto - i brand che non autorizzano la vendita sul marketplace. È il punto che un export generico ignora sempre, e che sull’arredamento ti mette nei guai con i fornitori.
• Tempi di lavorazione per prodotto: un divano su ordinazione dichiara tempi diversi da una lampada a stock, e il feed li porta riga per riga.
• Le sei colonne delle griglie vettori compilate secondo il tracciato, con le tariffe gestite dove vanno gestite: nelle griglie del seller center. Il file dichiara quale griglia applicare, non cabla i costi di spedizione dentro ogni riga.
• Prezzi per quantità su tre soglie, per i prodotti dove l’acquisto multiplo ha senso.
• Esecuzione via cron o su chiamata protetta da token: il file è sempre fresco e la generazione si controlla da fuori.

Da quando il feed offerte è custom, gli aggiornamenti su ManoMano sono leggeri e prevedibili, e la diagnosi - quando serve - parte da un file che si legge in un secondo.

✅ Modulo ManoMano per PrestaShop o feed custom: quando ha senso cosa

Se il tuo catalogo è piccolo e regolare, parti dal modulo ufficiale: per i casi standard funziona e costa una frazione di uno sviluppo su misura. Il custom entra in gioco quando riconosci almeno uno di questi segnali:

1. Varianti complesse o attributi che il modulo mappa male (e su ManoMano un identificativo corretto per combinazione non è negoziabile).
2. Aggiornamenti che non stanno dietro al negozio: prezzi e stock cambiano più in fretta di quanto il feed venga digerito.
3. Regole di pubblicazione tue: ricarico di canale, brand che non vuoi (o non puoi) vendere sul marketplace, categorie da tenere fuori.
4. Errori ricorrenti lato marketplace su cui perdi ore senza una causa chiara.

Quanto costa? Nella maggior parte dei casi un feed offerte su misura rientra in un pacchetto da 10 ore - 500 EUR, gli stessi della pagina di assistenza PrestaShop: abbastanza per analizzare il feed attuale, sviluppare la generazione corretta e validare l’output con ManoMano. Cataloghi più complessi richiedono qualcosa in più, e in quel caso te lo dico prima di partire, dopo aver visto il feed: nessun preventivo a scatola chiusa.

🛠️ La stessa logica vale per Google Shopping

Il principio - feed separati, per canale, con i dati giusti e leggeri - non è una fissazione da ManoMano. Sullo stesso genere di problema ho lavorato lato Google: un catalogo che esportava 3 prodotti su 6.750 in Google Merchant, risolto con feed per-paese e regole di spedizione coerenti. Se vendi su più canali, il feed è l’infrastruttura: conviene trattarlo come tale.

Il feed ManoMano ti sta bloccando?

Analizzo il feed attuale, i log e la configurazione del seller center, e ti dico cosa non va prima di proporre qualsiasi sviluppo. È il lavoro che faccio ogni giorno come tecnico PrestaShop, da remoto in tutta Italia. Scrivimi da uno dei canali qui sotto: partiamo dal file, non dalle ipotesi.