PrestaShop × API fornitori
Per ItalianTrendy, e-commerce di abbigliamento professionale, ho sviluppato e mantenuto le procedure che collegavano i dati dei fornitori al catalogo PrestaShop. In collaborazione con ClickeVia, ho lavorato su importazioni, varianti, prezzi e disponibilità: un’integrazione pensata per gestire cataloghi diversi e intervenire quando un dato incompleto impediva la corretta vendita di un articolo.
- Cliente
- ItalianTrendy
- Settore
- E-commerce / Abbigliamento professionale
- Periodo
- 2023 – 2025
- Il mio ruolo
- Sviluppatore backend, Specialista integrazioni, Responsabile della manutenzione evolutiva
- Il mio contributo
- In collaborazione con ClickeVia ho sviluppato e mantenuto le procedure PHP di importazione per il catalogo PrestaShop di ItalianTrendy. Ho integrato API, CSV e listini Excel di Isacco, Egochef, Rossini e Giblor’s, lavorando su prodotti, combinazioni, prezzi, disponibilità, immagini e schede tecniche. Ho inoltre diagnosticato anomalie nei dati, corretto giacenze, rivisto la pianificazione dei cron e predisposto notifiche email per gli errori di esecuzione.
- Tecnologie
- API HTTP / REST e JSON, Cron per la pianificazione delle procedure, CSV, XLS e XLSX per lo scambio dei dati, MySQL e SQL, PHP
- CMS e piattaforme
- Google Sheets, PrestaShop
- Estensioni e plugin
- Importatori PHP personalizzati per Isacco, Egochef, Rossini e Giblor’s
- Collaborazioni
- ClickeVia
01 / Il punto di partenza
Un catalogo, molte fonti da coordinare
Un camice può avere più colori, taglie e codici articolo. Per venderlo online, queste informazioni devono convergere in una scheda coerente, con immagini, prezzi e disponibilità associati alla combinazione giusta. Per ItalianTrendy, la difficoltà era gestire questo lavoro su cataloghi provenienti da Isacco, Egochef, Rossini e Giblor’s.
I fornitori mettevano a disposizione API, file CSV e listini Excel con strutture e significati differenti. Un prezzo poteva essere di acquisto o di vendita, uno stock poteva essere numerico o espresso con un semaforo. L’esigenza era trasformare queste differenze in regole esplicite, evitando che informazioni mancanti si traducessero in articoli senza prezzo, varianti incomplete o disponibilità errate.
02 / Il contributo
Sviluppo dell’integrazione e manutenzione operativa
Ho curato lo sviluppo e l’evoluzione delle procedure PHP, l’acquisizione dei dati in tabelle MySQL e il loro trasferimento in PrestaShop. Il lavoro ha incluso l’associazione tra codici e combinazioni, l’applicazione delle regole di prezzo, la gestione di immagini e schede tecniche e la diagnosi delle anomalie segnalate sul catalogo.
Ho lavorato con ClickeVia, confrontandomi con Enrico Bianchetti sui requisiti e sulle verifiche, a partire dalle esigenze di ItalianTrendy e dai riscontri dei fornitori. Il perimetro qui descritto riguarda l’integrazione e la manutenzione della piattaforma PrestaShop documentate nello storico del progetto.
03 / Dai dati al catalogo
Procedure dedicate per dati diversi
Acquisire, collegare e verificare le informazioni
Le procedure acquisiscono i dati esterni in tabelle intermedie, utilizzate per creare e aggiornare prodotti e combinazioni. Per Rossini, il lavoro ha accompagnato l’evoluzione dalle forniture CSV verso le API, mantenendo i listini necessari al calcolo dei prezzi. Per Isacco, l’integrazione collega i codici raggruppati nei fogli di lavoro alle informazioni degli articoli e delle relative varianti.
Fonti e destinazione
API · CSV · Excel → MySQL → PrestaShop
Il codice articolo collega le fonti. Prezzi, disponibilità e attributi seguono regole specifiche per ciascun fornitore.
La qualità dei dati
Prezzi, varianti e immagini con regole esplicite
Ho corretto calcoli di prezzo, associazioni delle immagini e assegnazioni delle schede tecniche. Ho inoltre introdotto, per l’importazione Rossini, un controllo che escludeva gli articoli privi dei riscontri necessari nei file di listino. Nel flusso Egochef ho separato composizione e colore, originariamente riuniti nello stesso campo, per rendere i dati utilizzabili nel catalogo.

La disponibilità
Gestire ciò che il fornitore comunica davvero
Le API Egochef comunicavano la disponibilità attraverso semafori, senza una quantità di magazzino esatta: la traduzione nel catalogo richiedeva quindi regole concordate con l’agenzia. Per Isacco ho invece individuato record con stock nullo e corretto le giacenze degli articoli segnalati, rivedendo anche la procedura di popolamento dei dati. Sono casi diversi, da trattare con logiche diverse.

04 / Automazione e dipendenze
Come si articola il flusso
-
Fornitori → acquisizione
API e file alimentano le tabelle intermedie, secondo i formati disponibili per ciascun marchio.
-
Dati → regole di catalogo
codici, attributi e listini vengono collegati per distinguere prodotti, combinazioni e condizioni economiche.
-
Importatori → PrestaShop
le procedure creano gli articoli e aggiornano i dati previsti: prezzi, disponibilità, immagini e documentazione.
-
Cron → esecuzioni coordinate
acquisizione, importazione e aggiornamento seguono dipendenze e frequenze distinte; alcuni passaggi sui listini rimangono manuali.
-
Controlli → manutenzione
log, verifiche sui prodotti e notifiche email aiutano a individuare gli errori e a distinguere problemi dei dati da problemi delle procedure.
05 / Riscontri operativi
Problemi concreti, interventi verificabili
Importazione più selettiva
Modificata la procedura Rossini per non importare articoli privi dei dati necessari di listino, dopo la comparsa di prodotti a prezzo zero.
Giacenze corrette
Individuata l’origine di alcune disponibilità Isacco errate e corrette le giacenze dei prodotti segnalati dal cliente.
Cron e avvisi controllabili
Rivista la frequenza del cron Isacco in timeout e verificata la ricezione delle email di errore degli importatori.
Automazione con visibilità sui limiti
Nell’agosto 2025, dopo il passaggio da dieci minuti a un’ora, il cron Isacco interessato aveva ripreso a funzionare senza timeout nelle verifiche riportate. A dicembre è stata confermata la ricezione delle notifiche di errore. Il lavoro comprendeva anche la mappatura delle dipendenze: a settembre 2025 i flussi Isacco ed Egochef risultavano attivi, mentre Rossini e parte di Giblor’s erano ancora condizionati dalla risposta delle API Rossini. Il valore dell’intervento sta anche nel rendere riconoscibili questi vincoli, per gestire le anomalie con informazioni concrete.

06 / Cosa portare nel prossimo progetto
Cosa rende sostenibile un’integrazione di catalogo
01
Una fonte per ogni informazione
Definire da dove arrivano prezzo, stock, codice, immagine e scheda tecnica. Lo stesso fornitore può richiedere più sorgenti.
02
Significati prima dei formati
Distinguere prezzo di acquisto e di vendita, IVA inclusa o esclusa, quantità effettiva e disponibilità indicativa.
03
Dati incompleti riconoscibili
Gestire stock nulli, immagini mancanti e codici senza listino senza confonderli con informazioni commerciali valide.
04
Frequenze e dipendenze sostenibili
Programmare gli aggiornamenti in base alla durata delle elaborazioni, alle risorse del server e alla disponibilità dei servizi esterni.
07 / Il tuo progetto
Il tuo catalogo dipende da più fornitori?
Se aggiorni prodotti, listini e disponibilità da fonti diverse, posso aiutarti a definire e sviluppare l’integrazione con il tuo e-commerce. Partiamo dai dati disponibili, dalle regole commerciali e dalle attività che oggi richiedono più interventi manuali.
Parliamo del tuo catalogoApprofondisci il servizio di sviluppo e consulenza web oppure raccontami il tuo progetto.



