Nel processo EMCS un documento non è semplicemente “inviato”: avvia uno scambio di messaggi tra il sistema dell'operatore e l'infrastruttura doganale. Capire la funzione di IE815, IE801 e IE906 aiuta a progettare correttamente la logica applicativa dell'e-AD.
ADM elenca IE815 come Draft Documento Elettronico (e-AD/e-DAS), IE801 come documento elettronico di risposta a un IE815 corretto con ARC e IE906 come risposta a un IE815 errato.
IE815: il draft del documento elettronico
IE815 rappresenta il draft del documento elettronico. La pagina ADM dedicata ai messaggi e-AD/EMCS indica per IE815 la firma digitale. Dal punto di vista del software, prima dell'invio occorre quindi produrre i dati nel formato previsto, validarli rispetto agli schemi applicabili e predisporre il messaggio al processo di firma e trasmissione.
È utile conservare una copia logica dei dati che hanno generato il messaggio, così da poter ricostruire la pratica anche in caso di errore o ritrasmissione.
IE801: risposta corretta e ARC
Quando il draft è corretto, ADM identifica IE801 come documento elettronico di risposta con ARC. Il gestionale deve associare l'ARC alla movimentazione originaria e aggiornare lo stato della pratica senza richiedere reinserimenti manuali.
Questo è il punto in cui una semplice funzione “esporta XML” mostra i propri limiti: il valore reale nasce dalla correlazione tra risposta doganale e processo operativo.
IE906: risposta a un IE815 errato
IE906 segnala un problema sul draft. L'integrazione dovrebbe trasformare la risposta tecnica in un flusso gestibile:
- ricezione e registrazione dello scarto;
- associazione alla pratica che ha generato IE815;
- visualizzazione dell'errore utile all'operatore o al supporto;
- correzione dei dati;
- nuovo invio controllato e tracciato.
IE810, IE813, IE818 e IE819
Il ciclo e-AD comprende anche messaggi successivi. ADM indica, tra gli altri, IE810 per l'annullamento e-AD, IE813 per il cambio di destinazione, IE818 per il rapporto di ricezione/esportazione e IE819 per il rigetto o la segnalazione di un documento elettronico.
Questi eventi confermano che EMCS va modellato come una macchina a stati, non come una procedura di upload isolata.
Come modellare il ciclo nel gestionale
Ogni pratica dovrebbe disporre almeno di:
- identificativo interno;
- tipo di messaggio e versione del tracciato;
- timestamp di generazione e invio;
- identificativi restituiti dal canale;
- stato corrente;
- eventuale ARC;
- errore o esito;
- storico degli eventi e dei tentativi.
Questa struttura permette di separare il dato fiscale dal dettaglio tecnico della comunicazione e semplifica assistenza, audit e monitoraggio.
Schemi e documentazione
ADM rende disponibili gli schemi XSD dei messaggi, il manuale operativo e il WSDL dedicato al documento elettronico. Poiché le specifiche possono essere aggiornate, l'implementazione deve fare riferimento alla versione pubblicata per l'ambiente e la fase applicabile.
Fonti ufficiali
Le specifiche EMCS evolvono nel tempo. Prima di qualsiasi adeguamento operativo o sviluppo, verificare sempre la documentazione aggiornata pubblicata da ADM.