Powerall – integrazione ERP con nopCommerce

Un livello di integrazione personalizzato, composto da due plugin, che collega nopCommerce a Powerall, la piattaforma aziendale olandese all-in-one che riunisce officina, magazzino, pianificazione, amministrazione e vendite in un unico sistema per oltre 6.000 utenti. Realizzato per On-Site BV, solution partner nopCommerce di Rotterdam specializzato in commercio B2B complesso, il livello di integrazione consente ai suoi clienti di gestire uno storefront nopCommerce basato su Powerall come unica fonte di verità - senza che nessuno debba mantenere il catalogo due volte.

La sfida

Powerall possiede i dati di prodotto e li possiede in forma ERP: file di proprietà di gruppo, proprietà tecniche, varianti e record di paese che non sono mai stati modellati per un negozio online. Un'importazione generica appiattirebbe tutto questo in campi di testo inutilizzabili, oppure costringerebbe uno sviluppatore a scrivere a mano una mappatura per ogni nuovo gruppo di prodotti. On-Site aveva bisogno di qualcosa che i suoi consulenti potessero configurare per ciascun cliente, non di uno script una tantum.

Un'architettura a due plugin

Abbiamo diviso il lavoro lungo una linea netta, così ogni parte può evolvere ed essere distribuita per conto proprio:

• Nop.Plugin.Misc.Powerall.Import - il livello di mappatura e modellazione dei dati che trasforma le esportazioni di Powerall in un vero catalogo nopCommerce
• Nop.Plugin.Misc.Powerall.Integration - la connessione in tempo reale che mantiene allineati i due sistemi e restituisce gli ordini

Entrambi seguono l'architettura standard dei plugin nopCommerce - entità di dominio con il proprio livello dati e le proprie migrazioni, servizi, model factory, view component e viste di amministrazione - così nulla filtra nel core e gli aggiornamenti restano di routine.

Powerall.Import: mappatura guidata dai comportamenti

Invece di una mappa di campi fissa, il plugin di importazione è costruito attorno a Import Behaviours configurabili: regole riutilizzabili che descrivono come un dato di Powerall deve arrivare in nopCommerce.

• I Product Property Behaviours decidono, per ciascuna proprietà, se un valore di Powerall diventa un attributo di specifica, un attributo di prodotto che genera varianti o semplice contenuto di prodotto
• I metadati di categoria sono derivati dal file delle proprietà di gruppo, così la struttura delle categorie e i metadati SEO nascono dai dati dell'ERP invece di essere ridigitati a mano
• Specifiche e varianti sono mappate insieme, mantenendo i dati tecnici filtrabili nella pagina di catalogo e corrette le combinazioni acquistabili nella pagina di prodotto
• Un menu Behaviours dedicato nell'amministrazione presenta le regole come schede, così a configurare la mappatura è un consulente - non uno sviluppatore
• I dati vengono convalidati prima dell'esecuzione dell'importazione e ogni impostazione include risorse di stringa localizzate e descrizioni in linea

Powerall.Integration: mantenere allineati i due sistemi

• Sincronizzazione iniziale per allineare completamente un negozio nuovo a Powerall in un'unica passata
• Attività di sincronizzazione pianificata con logica di filtro, così le esecuzioni ricorrenti toccano solo i prodotti che rientrano davvero nei criteri, invece di percorrere l'intero catalogo
• Sincronizzazione basata sugli eventi, agganciata agli eventi di nopCommerce, per le modifiche che non possono attendere la successiva esecuzione pianificata
• Sincronizzazione degli ordini verso Powerall, con un pulsante di sincronizzazione manuale nell'amministrazione per i singoli ordini che hanno bisogno di una spinta
• Mappatura dei paesi tra i record di paese di Powerall e i paesi di nopCommerce, con una gestione difensiva dei dati ERP incompleti
• Un percorso di disinstallazione completo che rimuove in modo pulito impostazioni, schema e attività - importante per un'integrazione distribuita su più negozi di clienti

Esperienza di amministrazione e osservabilità

Entrambi i plugin aggiungono le proprie voci di menu e le proprie schermate di configurazione all'amministrazione di nopCommerce. Il plugin di integrazione scrive un log di sincronizzazione dettagliato con viste di log dedicate, così quando un ordine o un prodotto non compare dove dovrebbe la risposta è a un clic di distanza, invece che a un ticket di assistenza e a una sessione sul server.

Base tecnica

Realizzato per nopCommerce 4.80 su ASP.NET Core, distribuito come due plugin indipendenti con impostazioni, valori predefiniti, migrazioni e localizzazione propri. Il risultato è riutilizzabile: On-Site può distribuire la stessa integrazione per qualunque cliente che usi Powerall e configurarla per ciascun negozio dall'amministrazione, invece di creare un fork del codice.

Il risultato

Un'integrazione in produzione che offre a On-Site BV una risposta ripetibile alla domanda «potete collegare il nostro negozio online a Powerall?» - dati di prodotto di proprietà dell'ERP che arrivano come catalogo nopCommerce correttamente strutturato e filtrabile, ordini che tornano indietro automaticamente e l'intera mappatura configurabile da un consulente invece di essere ricostruita nel codice a ogni implementazione.