Stock da aggiornare, listini da allineare, ordini da inviare all’ERP per la fatturazione e collegamenti con le logistiche: un ecommerce scambia dati con diversi strumenti. Prima di scegliere un connettore, bisogna stabilire che cosa deve passare, chi aggiorna le informazioni e come riconoscere un trasferimento riuscito.

Scenario illustrativo MTOweb, non schermata di un prodotto o di un cliente.
Cominciare dai flussi del lavoro quotidiano
Nelle integrazioni ecommerce che seguiamo, i flussi tipici riguardano proprio l’aggiornamento di stock e listini, l’invio degli ordini all’ERP per la fatturazione e le integrazioni con le logistiche. Sono esigenze collegate, ma ciascuna richiede regole proprie: quali dati scambiare, in quale direzione e in quale momento.
Prendiamo l’invio di un ordine all’ERP. Per definirlo occorre chiarire quando l’ordine può partire, quali dati servono alla fatturazione e come gestire quelli incompleti. Anche il collegamento con la logistica va delimitato: preparare una spedizione e riceverne lo stato sono passaggi diversi, da verificare nei sistemi coinvolti. Questi esempi aiutano a precisare il perimetro; non descrivono un singolo progetto cliente.
Decidere quale sistema fa da riferimento
Per ogni informazione serve un’origine concordata. Il gestionale potrebbe essere il riferimento per codici prodotto, listini e disponibilità; il negozio per descrizioni commerciali e immagini. Non è una regola universale: dipende dall’organizzazione. Se entrambi modificano lo stesso dato senza un criterio, l’integrazione può sovrascrivere una correzione valida.
Contano anche i dettagli che sembrano secondari: varianti, unità di misura, codici non più usati e significato dei diversi stati. Un articolo presente in due sistemi deve essere riconosciuto con una corrispondenza affidabile. Prima di automatizzare, conviene risolvere i casi ambigui su un campione di dati.
API e connettore risolvono parti diverse
Un’API è un’interfaccia attraverso cui un software espone operazioni e informazioni. Per esempio, la documentazione del Webservice PrestaShop presenta strumenti per accedere ai dati del negozio. Le risorse documentate aiutano a verificare quali informazioni sono disponibili; versione, configurazione e permessi dell’installazione concreta vanno controllati.
Il connettore usa le interfacce dei sistemi e applica le regole del collegamento: associa i campi, traduce gli stati e registra gli esiti. Avere un’API su entrambi i lati non significa avere già un’integrazione pronta. Occorre verificare che le operazioni necessarie siano effettivamente supportate, anche dal gestionale.
La frequenza dipende dal lavoro quotidiano
Un aggiornamento periodico può essere adeguato per alcuni dati; altri richiedono tempi più stretti. La scelta deve considerare il rischio di vendere disponibilità non aggiornate, il volume delle operazioni e i limiti dei servizi coinvolti. “In tempo reale” richiede un significato operativo condiviso, non solo un’etichetta nel preventivo.
Va definito anche che cosa succede mentre uno dei sistemi non è disponibile: quali attività possono continuare, quali informazioni restano in attesa e come l’operatore vede che il flusso è incompleto. La necessità di un controllo manuale dipende dal processo e dalle conseguenze dell’errore.
Un’interruzione non deve generare un secondo ordine
Immaginiamo che il gestionale salvi un ordine ma la conferma non raggiunga il connettore. Prima di inviare di nuovo, serve poter riconoscere se quell’ordine è già stato acquisito. Un identificativo stabile e controlli sull’esito aiutano a progettare questo comportamento.
Il principio tecnico dell’idempotenza riguarda l’effetto di operazioni ripetute; la specifica HTTP RFC 9110 ne definisce il significato per i metodi del protocollo. A livello applicativo, la creazione di un ordine richiede regole esplicite per evitare duplicazioni: la semplice ripetizione di una richiesta non offre quella garanzia.
Provare anche annullamenti e casi incompleti
Prima dell’avvio è utile verificare il percorso ordinario insieme a prodotti sconosciuti, varianti mancanti, invii ripetuti, annullamenti e collegamenti interrotti. Per ciascun caso si confrontano risultato atteso ed effettivo e si stabilisce chi deve intervenire. I log devono essere utili alla diagnosi, limitando dati personali e informazioni riservate.
Per valutare un’integrazione servono i nomi e le versioni dei software, la documentazione disponibile e un elenco dei passaggi manuali da affrontare. Nel nostro servizio ecommerce e nello sviluppo di software e integrazioni su misura definiamo il collegamento in base ai sistemi coinvolti. Un primo flusso delimitato permette di discutere costi e verifiche su un risultato concreto, senza promettere un connettore universale.

