Ufficio federale dell’informatica e della telecomunicazione UFIT

Dipartimento federale delle finanze DFF

Service Contract per contestazioni

EdecComplaintService

Nome del progetto:	e-dec
Versione:	0.6
Data:	2018-04-15
Stato	in elaborazione	in esame	approvato per l’uso
	□	☑	□

Persone interessate
Autori:	Xxxx Xxxxx (SiR), Xxxxxx Xxxxxx (mgr)
Approvazione:	Responsabile del progetto
Utenti:	Concessionari, spedizionieri
Per informazione/conoscenza:	Committente del progetto

Controllo delle modifiche, revisione, approvazione
Data	Versione	Autore	Descrizione
2014-11-25	0.1	SiR	Creazione prima versione
2014-12-05	0.2	mgr	Rielaborazione del Contract
2014-12-16	0.3	mgr	Adeguamento degli esempi
2015-09-04	0.4	mgr	Sostituzione di Centro di servizio alla clientela (CSC) con Centro di servizio TIC
2017-05-16	0.5	pho	Eliminato traffico postale integrato (itp)
2018-04-15	0.6	cb	Rielaborazione del capitolo 3.7 (Trasporto e sicurez- za, Endpoint)

Indice

1 Introduzione

2/19

Il presente documento definisce l’interfaccia di servizio per le contestazioni elettroniche rela- tive a una dichiarazione doganale nel sistema e-dec Importazione/Esportazione e descrive il funzionamento del Web Service nonché del Mail Service. Il documento è destinato agli svi- luppatori di software, che realizzano il collegamento del edecComplaintService per le conte- stazioni elettroniche nei propri sistemi informatici.

La comunicazione può avvenire in due modi:

1. Il dichiarante doganale desidera inviare alla dogana una richiesta o una risposta a una contestazione.

In tal caso il sistema IT del dichiarante doganale invia una ServiceRequest edec- ComplaintRequest a e-dec.

E-dec risponde alla richiesta o alla contestazione con una edecComplaintResponse.

2. Lo specialista doganale desidera inviare al dichiarante doganale una contestazione, una comunicazione o una risposta a una richiesta.

In tal caso e-dec invia una ServiceRequest edecComplaintRequest al sistema IT del dichiarante doganale.

Il sistema IT del dichiarante doganale non deve inviare una Response.

Il documento è da considerarsi un’aggiunta alla descrizione dell’interfaccia in [1], che descri- ve la versione attuale dello schema XML per la contestazione elettronica.

1.2 Struttura e contenuto del documento

Il capitolo 2 «Punto di vista aziendale» illustra il funzionamento di edecComplaint Web Servi- ce dal punto di vista dell’esercizio.

Il capitolo 3 «Aspetto tecnico del Web Service» contiene il Service Contract con diversi det- tagli tecnici. Tali informazioni sono necessarie per visualizzare il servizio. Il Service Contract contiene anche un Service Level Agreement (SLA).

Nel capitolo Fehler! Verweisquelle konnte nicht gefunden werden. «Fehler! Verweis- quelle konnte nicht gefunden werden.» sono descritti i dettagli tecnici del servizio di posta elettronica.

Nell’allegato è illustrato un esempio di visualizzazione SOAP/HTTP di edecComplaintServi- ce.

3/19

1.3 Riferimenti

Le seguenti fonti sono indicate nel documento o sono servite come documenti di base.

Riferi- mento	Titolo	Versio- ne
[1]	Descrizione dell’interfaccia per le contestazioni elettroniche in e-dec	1.0
[2]	Schema XML «edecComplaintRequest_v_#_#.xsd» (nome della versione #_#)	1.0
[3]	Schema XML «edecComplaintResponse_v_#_#.xsd» (nome della versio- ne #_#)	1.0
[4]	EdecComplaintService_v_#_#.wsdl (nome della versione #_#)	1.0
[5]	Specifica W3C SOAP: xxxx://xxx.x0.xxx/XX/0000/XXXX-XXXX- 20000508	1.1
[6]	W3C Web Services Description Language (WSDL): xxxx://xxx.x0.xxx/XX/xxxx	1.1
[7]	Simple Soap Binding Profile [1.0]: xxxx://xxx.xx- x.xxx/Xxxxxxx/Xxxxx/0000/00/XXXX00_XX00_XXX_0-0.xxx	1.0
[8]	WS-I Basic Profile: xxxx://xxx.xx-x.xxx/Xxxxxxxx/XxxxxXxxxxxx-0.0.xxx x	1.1
[9]	WS-I Profile Conformance Report test	1.0
[10]	WS-I Profile Conformance Report produzione	1.0
[11]	WSDL EdecComplaintService xxxx://xxx.xxx.xxxxx.xx/xxxxxxxxxxxxx/00000/00000/00000/00000/xxxxx. html	1.0

4/19

2 Punto di vista aziendale

2.1 Funzionamento del servizio

Il servizio di e-dec per le contestazioni «EdecComplaintService» permette di contestare elet- tronicamente una dichiarazione all’esportazione o all’importazione. Il messaggio di contesta- zione può essere allestito da un dichiarante doganale o da uno specialista doganale.

2.1.1 Messaggio del dichiarante doganale alla dogana

Il funzionamento del servizio avviene mediante vari canali di comunicazione:

• Web Service;

• E-mail.

Entrambi i canali di comunicazione possono essere utilizzati alternativamente. La differenza è di natura tecnica: il Web Service è sincrono, il Mail Service asincrono.

Il dichiarante doganale riceve per e-mail dalla dogana una risposta di conferma a un mes- saggio. La risposta viene trasmessa anche per e-mail, se il dichiarante doganale invia il suo messaggio tramite Web Service.

2.1.2 Messaggio della dogana al dichiarante doganale

Il servizio funziona solo mediante e-mail.

Non è attesa una risposta di conferma da parte del dichiarante doganale.

2.2 Utilizzo del servizio

Il servizio è previsto per l’integrazione della Business-to-Business (B2B) tra l’Amministrazione federale delle dogane (AFD) e il dichiarante doganale. Quest’ultimo deve richiedere l’utilizzo del servizio presso l’AFD.

Per l’autenticazione del sistema dell’utente è necessario un certificato di client (vedi capitolo

3.7 Trasporto e sicurezza).

2.3 Service Input

• Richiesta o contestazione XML in base allo schema e-dec Complaint (edecComplaintRequest_v_#_#.xsd) (vedi [1] e [2]).

5/19

2.4 Service Output

• Risposta della dogana XML in base allo schema e-dec Complaint (edecComplaintResponse_v_#_#.xsd) (vedi [1] e [2]).

6/19

3 Aspetto tecnico del Web Service

Il presente capitolo illustra l’aspetto tecnico del Web Service verso l’esterno, quindi per il di- chiarante doganale. Per l’implementazione interna del servizio è possibile che siano neces- sarie interfacce diverse, dato che il servizio è collegato a vari intermediari (ESB).

3.1 Artefatti

Gli artefatti tecnici qui di seguito descrivono il servizio dal punto di vista formale.

• EdecComplaintService_v_#_#.wsdl (WSDL per EdecComplaintService; #_#

rappresenta la versione attualmente supportata)

Indicazione

La versione WSDL attuale è disponibile al seguente link: xxxx://xxx.xxx.xxxxx.xx/xxx_xxxxxx.xxx?xxxxXxxxXxxxxxxxxXxxxxxx_x_0_0

• EdecComplaintService_Abnahme_v_#_#.wsdl (WSDL per EdecComplain- tService per il sistema di test; #_# rappresenta la versione attualmente supportata) Indicazione

La versione WSDL attuale è disponibile al seguente link: xxxx://xxx.xxx.xxxxx.xx/xxx_xxxxxx.xxx?xxxxXxxxXxxxxxxxxXxxxxxx_Xxxxxxx_x_0_ 0

• edecComplaintRequest_v_#_#.xsd (schema XML per le contestazioni; #_#

rappresenta la versione di schema attualmente supportata)

• edecComplaintResponse_v_#_#.xsd (schema XML per le risposte alle conte- stazioni; #_# rappresenta la versione di schema attualmente supportata)

Indicazione

Le versioni dello schema XML attualmente supportate sono disponibili al seguente link: xxxx://xxx.xxx.xxxxx.xx/xxxxxxxxxxxxx/00000/00000/00000/00000/xxxxx.xxxx

3.2 Diagramma WSDL

L’Immagine 1 è una rappresentazione grafica del file Web Service Description Language (WSDL). Il servizio prevede un’operazione edecComplaintRequest, che accetta come input lo schema XML edecComplaintRequest.

La risposta è un Payload XML conformemente allo schema edecComplaintResponse.

7/19

Immagine 1: rappresentazione grafica del WSDL EdecComplaintService

La descrizione WSDL del servizio è disponibile sul sito dell’AFD (vedi [3]) nonché nel capito- lo 5.1.

Nei capitoli che seguono, il Web Service è illustrato in modo più dettagliato.

3.3 Compatibilità con la WS-I

Per la creazione del file WSDL sono da osservare le direttive della Web Services Interopera- bility Organization (WS-I). Il file WSDL segue le direttive del Simple Soap Binding Profile [6] e del Basic Profile [8].

Le direttive vengono verificate con gli Interoperability Testing Tools 1.1 che la WS-I mette a disposizione sul suo sito. Gli strumenti di test verificano le direttive di entrambi i profili. I risul- tati sono documentati nei Profile Conformance Report [9], che contiene i risultati di test del WSDL senza definizione della Policy, e il Profil Conformance Report [10] in cui invece sono documentati i risultati di test del WSDL con definizione della Policy.

In entrambi i Profile Conformance Reports i WSDL sono considerati compatibili. I WSDL non contravvengono ad alcuna asserzione dei test definita nei profili.

3.4 Namespaces

Namespaces
Servizio	xxxx://xxx.x- xxx.xx/xxxxxxxx/XxxxXxxxxxxxxXxxxxxx/x0/
edecComplaintRequest	xxxx://xxx.x- xxx.xx/xxx/xxxxxx/xxxxXxxxxxxxxXxxxxxx/x0/
edecComplaintResponse	xxxx://xxx.x- xxx.xx/xxx/xxxxxx/xxxxXxxxxxxxxXxxxxxxx/x0/

3.5 Service Operation

complaintAcceptance

Descrizione

Tratta una contestazione e trasmette una risposta

Preconditions

• L’utente del servizio deve autenticarsi in e-dec.

A tale proposito va presentato un certificato client a livello di tra- sporto HTTPS (vedi capitolo 3.7 Trasporto e sicurezza).

• L’utente del servizio deve essere noto al sistema e-dec e deve di- sporre dell’autorizzazione per la trasmissione.

8/19

Postconditions

• La contestazione è stata elaborata da e-dec e una risposta è stata allestita.

• Nel 98 per cento dei casi la risposta (ripartizione temporale ugua- le) viene allestita nel giro di 150 secondi. Se e-dec non è in grado di allestire la risposta entro questo lasso di tempo, si attiva un ti- meout a livello di trasporto.

Indicazione

In caso di timeout, l’utente non è in grado di decidere se uno dei due messaggi scambiati è andato perso o se il servizio non è stato in gra- do di elaborarli entro i 150 secondi. In tal caso è sempre necessario trasmettere il messaggio una seconda volta (vedi invio multiplo).

Message-Exchange Pattern (MEP)

• Request-response: ricezione del messaggio di input, esecuzione di Business Logik, invio di un messaggio di risposta correlato.

• L’esatta composizione del messaggio di output è descritta al capi- tolo 2.4 Service Output.

Idempotenza (invio multiplo)

• Il servizio non è idempotente: una richiesta non può essere tra- smessa più volte. Se ciò avviene, ogni trasmissione viene consi- derata come un nuovo messaggio.

3.6 Messaggi Input, Output and Fault

Messaggio Input
Descrizione	Contestazione e-dec
Style/Encoding	document/literal
Tipo di dato	edecComplaintRequest_v_1_0.xsd
MIME Parts	n/a

Messaggio Output
Descrizione	Risposta e-dec, che può rappresentare: • accettanza (vedi in basso), oppure • rifiuto con indicazione del motivo (p. es. errore di schema XML, errore di validazione XML, errore di elaborazione EDEC)
Style/Encoding	document/literal
Tipo di dato	edecComplaintResponse_v_1_0.xsd
MIME Parts	n/a

Messaggio Fault: «Invalides SOAP»

Descrizione

Invalide SOAP Envelope

Questo avviso viene inviato se il messaggio Input non è un messaggio SOAP valido.

9/19

Esempio

<SOAP-ENV:Envelope xmlns:SOAP- ENV ="xxxx://xxxxxxx.xxxxxxx.xxx/xxxx/xxxxxxxx/" xmlns:xsd="xxxx://xxx.x0.xxx/0000/XXXXxxxxx" xmlns:xsi="xxxx://xxx.x0.xxx/0000/XXXXxxxxx-xxxxxxxx">

<SOAP-ENV:Body>

<SOAP-ENV:Fault>

<faultcode>SOAP-ENV:Client</faultcode>

<faultstring>parsing error: org.xml.sax.SAXParseException: The end-tag for element type "language" must end with a '>' delimi- ter.</faultstring>

</SOAP-ENV:Fault>

</SOAP-ENV:Body>

</SOAP-ENV:Envelope>

10/19

Messaggio Fault: «Invalide XML Payload»
Descrizione	Invalide XML Payload Envelope Questo avviso viene inviato, se il messaggio Input contiene un XML non valido (non corrisponde allo schema di e-dec Complaint)
Esempio	<SOAP-ENV:Envelope xmlns:SOAP- ENV="xxxx://xxxxxxx.xxxxxxx.xxx/xxxx/xxxxxxxx/"> <SOAP-ENV:Header/> <SOAP-ENV:Body> <SOAP-ENV:Fault> <faultcode>SOAP-ENV:Client</faultcode> <faultstring>see detail element for more information </faultstring> <detail> <edecComplaintResponse xmlns =xxxx://xxx.x-xxx.xx/xxx/xxxxxx/xxxxXxxxxxxxxXxxxxxxx/x0 xmlns:xsi ="xxxx://xxx.x0.xxx/0000/XXXXxxxxx-xxxxxxxx" xsi:schemaLocation=xxxx://xxx.x- xxx.xx/xxx/xxxxxx/xxxxXxxxxxxxxXxxxxxxx/x0 xxxx://xxx.xxx.xxxxx.xx/xxx_xxxxxx.xxx?xxxxxxxxXxxxxxxxxXxxxxxxx _v_1_0" schemaVersion="1.0"> <requestorTraderIdentificationNum- ber>CHE123456789</requestorTraderIdentificationNumber> <requestorCorrelationID>MyId</requestorCorrelationID> <edecComplaintRejection> <rejectionDate>1967-08-13</rejectionDate> <rejectionTime>14:20:00.0Z</rejectionTime> <errors> <XMLSchemaErrors> <schema> <schemaLocation> xxxx://xxx.xxx.xxxxx.xx/xxx_xxxxxx.xxx?xxxxxxxxXxxxxxxxxXxxxxxxx _v_1_0 </schemaLocation> <namespace> xxxx://xxx.x-xxx.xx/xxx/xxxxxx/xxxxXxxxxxxxxXxxxxxx/x0 </namespace> <version>1.0</version> </schema> <parser> <name>Xerxes-J 2.6.2</name> </parser> <error> <message>Parsing Error: Line: 6, URI: null, Mes- sage: cvc-complex-type.2.4.a: Invalid content was found starting with element &apos;traderReference2&apos;. One of &apos;{&quot;xxxx://xxx.x- xxx.xx/xml/schema/edecComplainRequest/v1}&apos; is expec- ted.</message> </error> </XMLSchemaErrors> </errors> </edecComplaintRejection> </edecComplaintResponse> </detail> </SOAP-ENV:Fault> </SOAP-ENV:Body> </SOAP-ENV:Envelope>

11/19

Messaggio Fault: client non autenticabile o non autorizzato
Descrizione	Errore di autorizzazione L’utente non possiede i privilegi necessari per trasmettere una contesta- zione a e-dec.
Esempio	<SOAP-ENV:Envelope xmlns:SOAP- ENV="xxxx://xxxxxxx.xxxxxxx.xxx/xxxx/xxxxxxxx/"> <SOAP-ENV:Header/> <SOAP-ENV:Body> <SOAP-ENV:Fault> <faultcode>SOAP-ENV:Client</faultcode> <faultstring> see detail element for more information </faultstring> <detail> <edecComplaintResponse xmlns =xxxx://xxx.x-xxx.xx/xxx/xxxxxx/xxxxXxxxxxxxxXxxxxxxx/x0 xmlns:xsi ="xxxx://xxx.x0.xxx/0000/XXXXxxxxx-xxxxxxxx" xsi:schemaLocation=xxxx://xxx.x- xxx.xx/xxx/xxxxxx/xxxxXxxxxxxxxXxxxxxxx/x0 xxxx://xxx.xxx.xxxxx.xx/xxx_xxxxxx.xxx?xxxxxxxxXxxxxxxxxXxxxxxxx _v_1_0" schemaVersion="1.0"> <requestorTraderIdentificationNum- ber>CHE123456789</requestorTraderIdentificationNumber> <requestorCorrelationID>MyId</requestorCorrelationID> <edecComplaintRejection> <rejectionDate>2014-10-18</rejectionDate> <rejectionTime>14:20:00</rejectionTime> <errors> <ruleErrors> <customsDeclarationNumber>14CHEI000000123456 </customsDeclarationNumber> <declarant> <traderIdentificationNumber>900099 </traderIdentificationNumber> <declarantNumber>1</declarantNumber> </declarant> <error> <ruleName>Cxxx</ruleName> <checkType>Authorization Check</checkType> <referencedElements> <referencedElement> /edecComplaintRequest/requestorTraderIdentificationNumber </referencedElement> </referencedElements> <descriptions> <description language="de">Der Zollanmelder hat keine Berechtigung eBeanstandungen zu tätigen. </description> <description language="fr"></description> <description language="it"></description> </descriptions> </error> </ruleErrors> </errors> </edecComplaintRejection> </edecComplaintResponse> </detail> </SOAP-ENV:Fault> </SOAP-ENV:Body> </SOAP-ENV:Envelope>

12/19

3.7 Trasporto e sicurezza

Trasporto e sicurezza
Descrizione	SOAP mediante HTTPS La comunicazione con il Web Service avviene tramite HTTPS. Il client deve autenticarsi nel server mediante il certificato.
Endpoint	Produzione xxxxx://xx.xxxx.xxx.xxxxx.xx/xxxxxxxx/XxxxXxxxxxxxxXxxxxxx/x0 Test xxxxx://xx.xxxx-x.xxx.xxxxx.xx/xxxxxxxx/XxxxXxxxxxxxxXxxxxxx/x0
Sicurezza a livello di trasporto	Client-Certificate (2-way WSG) I certificati per i clienti devono essere rilasciati dall’autorità di certificazione Swiss Government PKI.
Impostazioni specifi- che del trasporto	n/a
Time out	150 secondi (vedi anche capitolo 3.5 Service Operation per la semantica del time out)

13/19

3.8 Policies

Policies
Security	La sicurezza non si basa sui messaggi (solo sicurezza a livello di traspor- to, vedi anche capitolo 3.7 Trasporto e sicurezza).
Reliable Messaging	Nessun «best effort»
Transazioni	Nessuna
Policies commerciali, Charging	L’utilizzo del servizio sottostà alle disposizioni dell’AFD.

3.9 Service Level Agreement (SLA)

SLA
Disponibilità	Il sistema deve avere una disponibilità del 99,5 per cento (24 ore su 24 per 7 giorni). Sono escluse da questo periodo di tempo 2 ore di manutenzione settima- nali. Le finestre di manutenzione vengono annunciate già in anticipo.
Downtime massimo (imprevisto)	Il sistema, una volta riavviato, è di nuovo disponibile dopo 5 minuti.
Tempo di risposta (latenza)	Carico normale: 95 % < 10 sec. 99 % < 15 sec. Carico di punta: 95 % < 20 sec. 99 % < 60 Sek Contestazioni Il tempo di risposta viene calcolato come differenza di tempo tra ricezione della contestazione nel sistema e invio della risposta dal sistema. Il tempo di trasmissione mediante rete pubblica non è preso in considerazione.
Portata	Carico normale: fino a circa 10 contestazioni al minuto. Carico di punta: a partire da circa 50 contestazioni al minuto.

14/19

4 Aspetto tecnico del Mail Service

Per il messaggio trasmesso dal dichiarante doganale alla dogana, EdecComplaintService supporta, parallelamente al canale di comunicazione SOAP/HTTPS, anche l’accesso via SMTP. Per garantire l’autenticità e la sicurezza contro l’intercettazione, devono essere utiliz- zate e-mail criptate e firmate.

Per il messaggio della dogana al dichiarante doganale vengono inviate e-mail firmate e crip- tate.

4.1 Sistema di test (criptato e firmato)

Indirizzo di posta elettronica: xxxxxxxxx_x@xxxx.xxx.xxxxx.xx

Codificazione delle e-mail, allegati compresi: S/MIME Versione 3. Ai fini della codificazione va utilizzato il certificato X.509 del sistema di test, disponibile sul sito e-dec della dogana (Customs Services/Firma digitale e codificazioni): xxxx://xxx.xxx.xxxxx.xx/xxxxxxxxxxxxx/00000/00000/00000/00000/xxxxx.xxxx).

Firma delle e-mail e degli allegati: firma allestita con la chiave privata del dichiarante dogana- le.

Identificazione dei mittenti: per l’invio di e-mail di test all’indirizzo sopra indicato deve essere disponibile in AdminDir1 dell’UFIT il certificato X.509 dello spedizioniere. Il certificato deve essere valido (durata, non revocato). L’indirizzo e-mail del mittente viene ignorato al momen- to della verifica della firma. Le e-mail di mittenti non autenticabili non vengono elaborate da e-dec e il mittente non riceve risposta.

Mittente e-mail di e-dec: From: xxxxxxxxx_x@xxxx.xxx.xxxxx.xx, ReplyTo: com- xxxxxx_x@xxxx.xxx.xxxxx.xx

4.2 Ambiente di produzione (criptato e firmato)

Indirizzo di posta elettronica: xxxxxxxxx@xxxx.xxx.xxxxx.xx

Codificazione delle e-mail, allegati compresi: S/MIME Versione 3. Ai fini della codificazione va utilizzato il certificato X.509 dell’ambiente di produzione, disponibile sul sito e-dec della dogana (Customs Services/Firma digitale e codificazioni): xxxx://xxx.xxx.xxxxx.xx/xxxxxxxxxxxxx/00000/00000/00000/00000/xxxxx.xxxx).

Firma delle e-mail e degli allegati: firma allestita con la chiave privata del dichiarante dogana- le.

Identificazione dei mittenti: per l’invio delle e-mail all’indirizzo sopra indicato deve essere disponbile in AdminDir dell’UFIT il certificato X.509 dello spedizioniere. ll certificato deve es- sere valido. L’indirizzo e-mail del mittente viene ignorato al momento della verifica della fir- ma. Le e-mail di mittenti non autenticabili non vengono elaborate da e-dec e il mittente non riceve risposta.

1 AdminDir è l’elenco LDAP centralizzato della Confederazione.

15/19

E-mail del mittente di e-dec: From: xxxxxxxxx@xxxx.xxx.xxxxx.xx, ReplyTo: com- xxxxxx@xxxx.xxx.xxxxx.xx

4.3 Nome del file

Il presente capitolo descrive i diversi nomi dei file per gli allegati alle e-mail. I nomi nelle pa- rentesi graffe {} sono sostituiti dai relativi valori della contestazione:

edecComplaint
Request	e-dec_edecComplaintRequest_{Data_Ora}_{Numero della dichiarazione}_ {TIN}.XML
Response	e-dec_edecComplaintResponse_{Data_Ora}_{Numero della dichiarazione}_ {TIN}.XML
Rule Error	e-dec_ruleErrors_{Data_Ora}_{Numero della dichiarazione}_{TIN}.XML
Validazione	edecComplaintResponse_XMLSchemaErrors.xml

4.4 Informazioni tecniche su firma e codificazione

Vengono elaborati e inviati i seguenti messaggi firmati S/MIMEv3 e codificati. Envelope MIME-Attribute

• Versione MIME 1.0

• Content-Type: multipart/signed; protocol= "application/pkcs7-signature"; mi- calg=sha1

Attachment MIME-Attribute (dichiarazione doganale, risposta)

• Content-Type: application/octet-stream

• Content-Transfer-Encoding: base64

Attachment MIME-Attribute (firma)

• Content-Type: application/pkcs7-signature; Name= "smime.p7s"

• Content-Transfer-Encoding: base64

• Content-Disposition: attachment; filename= "smime.p7s"

Ogni messaggio firmato deve contenere il certificato del mittente (multipart/signed e applica- tion/pkcs-signature formato MIME).

Envelope MIME-Attribute di e-mail in entrata e in uscita

• Versione MIME 1.0

• Content-Type: application/pkcs7-mime; smime-type=enveloped-data; name= "smi- me.p7m"

• Content-Transfer-Encoding: base64

• Content-Disposition: attachment; filename= "smime.p7m"

• Content-Transfer-Encoding: base64

Al momento dell’invio e-dec utilizza le seguenti impostazioni:

• RSA

• 3DES grado di codificazione 192b

• CBC/PKCS5Padding

MIME-Part Attribute delle risposte e-dec

16/19

• Ogni parte del messaggio MIME ha il Content-Transfer-Encoding «base64» (analo- gamente a NCTS).

4.5 Informazioni sui server di posta elettronica presso i dichiaranti doganali e spam

I server di posta elettronica mediante i quali i dichiaranti doganali inviano le contestazioni a e-dec devono disporre di un indirizzo IP fisso. In caso contrario vi è il rischio che questo tipo di e-mail venga eliminato perché considerato spam.

Molti server di posta elettronica utilizzano filtri anti-spam che accedono a banche dati conte- nenti liste con indirizzi sospetti. Se un provider finisce su una di queste liste, le e-mail inviate da esso vengono automaticamente considerate spam.

Se un provider di indirizzi di posta elettronica va a finire su una lista spam senza motivo, oc- corre rivolgersi al Centro di servizio (TIC) per verificare se l’indirizzo è stato bloccato a causa del suo inserimento in una lista di spam. Se il motivo del blocco è questo, il provider deve contattare gli amministratori della relativa lista e richiedere l’eliminazione dell’indirizzo e-mail dalla banca dati degli indirizzi considerati spam.

4.6 Informazioni sui server di posta elettronica

Per i server di posta elettronica è definito un nome DNS. Si raccomanda di utilizzare tale nome al momento della configurazione da parte del cliente e di non rimandare direttamente agli indirizzi IP dei server di posta elettronica. L’utilizzo degli indirizzi IP fa sì che il sistema clienti si colleghi alla definizione dell’infrastruttura di e-dec. Ad ogni adeguamento anche per i clienti sono necessarie delle modifiche.

Nome DNS del server di posta elettronica di e-dec: xxxx.xxx.xxxxx.xx

Il summenzionato nome DNS può essere sospeso mediante i server DNS a disposizione.

17/19

5 Allegato

5.1 Codice sorgente WSDL EdecComplaint

Vedi xxxx://xxx.xxx.xxxxx.xx/xxxxxxxxxxxxx/00000/00000/00000/00000/xxxxx.xxxx

Esempio di SOAP/HTTP Binding per visualizzazione dell’operazione edecComplaintRequest

La seguente Service Request rappresenta una versione abbreviata del messaggio SOAP nel SOAP/HTTP Binding. Alcune informazioni specifiche sono state omesse (…).

POST …/services/EdecComplaintService/v1 HTTP/1.1 Host: …

Content-Length: …

SOAPAction: "edecComplaintRequest" Content-Type: text/xml;charset=UTF-8

…

<soapenv:Envelope xmlns:soapenv=xxxx://xxxxxxx.xxxxxxx.xxx/xxxx/xxxxxxxx/ xmlns="xxxx://xxx.x-xxx.xx/xxx/xxxxxx/xxxxXxxxxxxxxXxxxxxx/x0">

<soapenv:Header/>

<soapenv:Body>

<edecComplaintRequest

xmlns=xxxx://xxx.x-xxx.xx/xxx/xxxxxx/xxxxXxxxxxxxxXxxxxxx/x0 xmlns:xsi="xxxx://xxx.x0.xxx/0000/XXXXxxxxx-xxxxxxxx" xsi:schemaLocation=xxxx://xxx.x-xxx.xx/xxx/xxxxxx/xxxxXxxxxxxxxXxxxxxx/x0 xxxx://xxx.xxx.xxxxx.xx/xxx_xxxxxx.xxx?xxxxxxxxXxxxxxxxxXxxxxxx_x_0_0" schemaVersion="1.0">

<location>Position</location>

<elementName>statisticalValue</elementName>

<remark>Wert zu gross</remark>

</complaint>

<location>Header</location>

<elementName>transportMode</elementName>

<remark>Wert nicht zulässig</remark>

</complaint>

</complaints>

</edecComplaintRequest>

</soapenv:Body>

</soapenv:Envelope>

5.2 Esempio di SOAP/HTTP Binding per una risposta

dell’operazione edecComplaintRequest in caso di accettazione

La seguente Service Response rappresenta una versione abbreviata del messaggio SOAP nel SOAP/HTTP Binding.

HTTP/1.1 200 OK

18/19

Date: Thu, 2 Dez 2014 11:04:37 GMT

Server: Unknown

Servlet-Engine: Unknown (Servlet 2.2; JSP 1.1) Content-Type: multipart/related;

Content-Type: text/xml; charset=UTF8 Content-Transfer-Encoding: 8bit

Content-Description: e-dec_edecComplaintResponse_20141202110400_14CHEI000000123456_ trdr-432343242123e.xml

Content-ID: <parameters=-7093df8c:11a34a147dd:-0000_0@xxx.xxxxx.xx>

<?xml version="1.0" encoding="UTF-8"?>

<SOAP-ENV:Envelope xmlns:edec="xxxx://xxx.x- xxx.xx/xxx/xxxxxx/xxxxXxxxxxxxxXxxxxxxx/x0">

<SOAP-ENV:Header/>

<SOAP-ENV:Body>

<edecComplaintResponse xmlns=xxxx://xxx.x-xxx.xx/xxx/xxxxxx/xxxxXxxxxxxxxXxxxxxxx/x0 xmlns:xsi="xxxx://xxx.x0.xxx/0000/XXXXxxxxx-xxxxxxxx"

xsi:schemaLocation=xxxx://xxx.x-xxx.xx /xxx/xxxxxx/xxxxXxxxxxxxxXxxxxxxx/x0 xxxx://xxx.xxx.xxxxx.xx/xxx_xxxxxx.xxx?xxxxxxxxXxxxxxxxxXxxxxxxx _v_1_0" schemaVersion="1.0">

<requestorTraderIdentificationNum- ber>CHE123456789</requestorTraderIdentificationNumber>

</edecComplaintAcceptance>

</edecComplaintResponse>

</SOAP-ENV:Body>

</SOAP-ENV:Envelope>

19/19

Document Metadata

Table of Contents

Ufficio federale dell’informatica e della telecomunicazione UFIT

Document Metadata