Quando un'azienda utilizza già un ERP, l'adeguamento EMCS non dovrebbe trasformarsi automaticamente in un progetto di sostituzione del gestionale. Una buona integrazione mantiene il sistema aziendale come fonte del processo e inserisce un layer specializzato per il colloquio tecnico con ADM.
Principio architetturale: l'ERP governa il business; il layer EMCS governa formati, validazioni, firma, comunicazione, identificativi, stato ed esiti.
Separare logica di business e interoperabilità
Il gestionale conosce ordine, cliente, prodotto, quantità, deposito, vettore e destinazione. Il componente EMCS deve invece conoscere i messaggi previsti, la struttura XML, i requisiti di firma, il canale di comunicazione e il modo in cui interpretare le risposte.
Questa separazione evita che ogni variazione delle specifiche doganali richieda modifiche diffuse nel cuore dell'ERP.
Flusso applicativo consigliato
- L'ERP crea o aggiorna la pratica aziendale.
- Il layer EMCS riceve i dati necessari attraverso API, database, file o connettore dedicato.
- Il componente costruisce e valida il messaggio previsto.
- Viene applicata la firma dove richiesta.
- La richiesta viene trasmessa al servizio ADM previsto.
- Identificativi, stato e risposta vengono correlati alla pratica originaria.
- L'ERP riceve l'esito e aggiorna il proprio workflow.
Stato, esito e idempotenza
Uno dei rischi più comuni nelle integrazioni asincrone è trattare l'invio come se coincidesse con la conclusione del processo. In realtà occorre distinguere almeno tra richiesta generata, trasmissione effettuata, presa in carico, risposta disponibile, esito positivo o negativo e necessità di intervento.
È inoltre importante progettare retry e ritrasmissioni in modo controllato, evitando duplicazioni e mantenendo un identificativo stabile che permetta di ricostruire l'intera storia della pratica.
Gestire gli errori come eventi applicativi
Servizio non disponibile, dato incoerente, validazione negativa, credenziale non valida o risposta applicativa negativa non dovrebbero finire in una casella tecnica invisibile all'operatore.
- Il log tecnico deve conservare il dettaglio utile al supporto.
- Il gestionale deve mostrare uno stato comprensibile all'utente.
- Il sistema deve indicare se la pratica può essere ritentata, corretta o deve essere presa in carico manualmente.
BIT EMCS Connect
BIT EMCS Connect segue questo modello: espone un livello stabile verso il sistema aziendale e concentra nel gateway la complessità specifica dell'interoperabilità EMCS. Il collegamento può essere progettato in funzione dell'ERP esistente e dei vincoli infrastrutturali del cliente.
L'esperienza BIT su sistemi per depositi e processi fiscali comprende gestione di flussi EMCS, e-AD/e-DAS, invio, recupero esiti, ritrasmissioni, fallback e tracciamento degli eventi. Il perimetro effettivo di ogni progetto viene definito attraverso assessment e test sull'ambiente disponibile.
Per software house e system integrator
Per chi distribuisce un proprio gestionale, un layer dedicato consente di mantenere un'interfaccia applicativa relativamente stabile verso più clienti, separando l'evoluzione EMCS dal ciclo di rilascio delle funzioni core del prodotto.
Fonti ufficiali
Le specifiche EMCS evolvono nel tempo. Prima di qualsiasi adeguamento operativo o sviluppo, verificare sempre la documentazione aggiornata pubblicata da ADM.