Home / Casi di studio / CAP29010

CAP29010

Evoluzione del webservice CAP29010 per integrare i dati di clienti e ordini con RFMcube. Ho curato l’adeguamento del backend PHP e la riorganizzazione dei campi merceologici, rendendo le informazioni di vendita coerenti con i requisiti di importazione della piattaforma marketing.

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.

Integrazione backendDati d’ordineRFMcube
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.

Schermata storica del 6 febbraio 2023: struttura dei campi d’ordine prima dell’adeguamento del webservice.

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 precedenteCampo richiesto in itemsSignificato
treecod_grupmercCodice del gruppo merceologico
namedes_grupmercDescrizione del gruppo merceologico
idcod_sgrupmercCodice del sottogruppo merceologico
Dettaglio della stessa schermata: i campi annidati in categories, oggetto della successiva riorganizzazione in items.

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

  1. 01

    Dati d’ordine

    Il flusso comprende righe d’ordine, linea merceologica e classificazioni degli articoli.

  2. 02

    Adeguamento nel webservice

    I campi vengono riorganizzati e rinominati in base alla struttura richiesta per l’importazione.

  3. 03

    Informazioni in items

    Le classificazioni merceologiche vengono collocate al livello delle singole righe e affiancate dalla descrizione dell’articolo.

  4. 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

Contatti

Per ogni richiesta di informazioni e di preventivo non esitate a contattarmi.

Elemento aggiunto al carrello.
0 items - 0,00 €