Webservice × Dati per il marketing
Per CAP29010 ho lavorato sulla creazione del webservice utilizzato per trasferire i dati d’ordine a RFMcube. In collaborazione con ClickeVia, ho adattato la struttura dei campi alle esigenze di importazione della piattaforma, riorganizzando le informazioni merceologiche e aggiungendo la descrizione dell’articolo. Un intervento di integrazione backend per rendere i dati commerciali più chiari e utilizzabili nel contesto delle attività di marketing.
- Cliente
- Clickevia s.r.l.
- Settore
- Agenzia di web marketing e sviluppo web
- Periodo
- Dal 2021, in corso
- Il mio ruolo
- Sviluppatore backend, Specialista integrazioni
- Il mio contributo
- Ho curato la creazione del webservice CAP29010 per integrare i dati d’ordine con RFMcube, in collaborazione con ClickeVia. Ho riorganizzato i campi merceologici nelle singole righe d’ordine, aggiornato la mappatura e aggiunto la descrizione dell’articolo. Il mio intervento ha riguardato lo sviluppo backend e la struttura dei dati trasmessi, traducendo i requisiti di importazione concordati in modifiche applicative.
- Tecnologie
- PHP, Webservices
- CMS e piattaforme
- Plesk, RFMcube
- Framework e librerie
- cURL, Monolog
01 / Il contesto
Il contesto e l’esigenza
Per utilizzare i dati di vendita in una piattaforma di marketing, ogni informazione deve arrivare con un nome comprensibile e nella posizione prevista. Anche un dato presente può risultare poco utile se viene interpretato o raggruppato in modo diverso da quello atteso.
Nel flusso CAP29010, alcuni codici e descrizioni merceologiche comparivano nel gruppo categories. L’esigenza era portarli direttamente in items, insieme alle informazioni delle singole righe d’ordine, adeguando i nomi dei campi.
02 / Il mio contributo
Il mio ruolo nel progetto
Ho curato la realizzazione del webservice e l’adeguamento della struttura dei dati, confrontandomi con ClickeVia sui requisiti di importazione. Il mio contributo riguarda la componente tecnica di collegamento con RFMcube e l’organizzazione delle informazioni trasmesse.
Il progetto prevedeva anche un confronto sull’accesso ai dati tra ClickeVia e il referente infrastrutturale CR Informatica. In questo caso di studio il perimetro del mio lavoro è l’integrazione applicativa; la gestione delle campagne marketing resta un’attività distinta.

03 / La soluzione
La soluzione realizzata
Dalla struttura tecnica al significato del dato
La modifica ha riguardato la collocazione e la denominazione dei campi. I riferimenti a gruppo e sottogruppo merceologico sono stati ricondotti al livello delle righe d’ordine, per rispondere alla struttura richiesta dal sistema di destinazione.
| Campo precedente | Campo richiesto in items | Significato |
|---|---|---|
tree | cod_grupmerc | Codice del gruppo merceologico |
name | des_grupmerc | Descrizione del gruppo merceologico |
id | cod_sgrupmerc | Codice del sottogruppo merceologico |

Più contesto per ogni articolo
Alla riorganizzazione dei campi ho affiancato l’aggiunta di des_articolo, confermata nella consegna della modifica. La descrizione permette di accompagnare i riferimenti tecnici con un’informazione leggibile sul prodotto.
I campi codice_linea e descrizione_linea erano già presenti nel flusso: l’intervento si concentrava sulle informazioni da ricollocare e completare.
04 / Il flusso
Come funziona il flusso
01
Dati d’ordine
Il flusso comprende righe d’ordine, linea merceologica e classificazioni degli articoli.
02
Adeguamento nel webservice
I campi vengono riorganizzati e rinominati in base alla struttura richiesta per l’importazione.
03
Informazioni in items
Le classificazioni merceologiche vengono collocate al livello delle singole righe e affiancate dalla descrizione dell’articolo.
04
Utilizzo in RFMcube
Il webservice espone i dati alla piattaforma secondo il modello concordato. Il passaggio successivo è la verifica della loro interpretazione nel sistema di destinazione.
05 / I risultati
Risultati ed evidenze
Struttura
Campi ricollocati
Le informazioni merceologiche sono state spostate in items, come confermato nella comunicazione del 7 febbraio 2023.
Contenuto
Descrizione aggiunta
Il campo des_articolo è stato aggiunto al webservice per accompagnare i riferimenti tecnici con la descrizione del prodotto.
Collaborazione
Requisiti tradotti in codice
La richiesta operativa di ClickeVia è stata trasformata in una modifica puntuale al formato dei dati trasmessi.
Il valore dell’intervento è nella qualità del collegamento tra sistemi: informazioni più esplicite e organizzate secondo il modello richiesto. Questa è la base tecnica su cui costruire l’utilizzo dei dati per il marketing; il caso non attribuisce all’integrazione incrementi di vendite o risultati di campagna non misurati.
06 / Il metodo
Cosa conta in un’integrazione dati
01
Chiarire il modello di destinazione
Stabilire per ogni campo nome, significato e livello di appartenenza prima di modificare il flusso.
02
Conservare il significato commerciale
Portare con i codici anche descrizioni comprensibili a chi utilizzerà le informazioni.
03
Verificare i due lati dell’integrazione
Distinguere l’adeguamento del webservice dalla verifica finale dei dati importati.
07 / Il tuo progetto
Hai un’esigenza simile?
Devi collegare dati commerciali, un gestionale o una piattaforma di marketing? Posso aiutarti a definire il flusso, sviluppare le trasformazioni necessarie e rendere più chiaro il passaggio delle informazioni tra i sistemi.
Parliamo del tuo progetto


