Documentazione VatChecker

Vatchecker – MCM.Tools
- Manuale di uso e installazione -
Sommario
Premessa ........................................................................................................................................................... 2
Gestione dei dati ............................................................................................................................................... 2
File xml........................................................................................................................................................... 2
Schema MCM.Tools.VatCheckerInfo.xsd................................................................................................... 2
Esempio file XML con le Piva da elaborare ............................................................................................... 3
Esempio risposta su file xml ...................................................................................................................... 3
File scambi.cee .............................................................................................................................................. 3
Esempio file scambi.cee con le Piva da elaborare. ................................................................................... 3
Esempio risposta su file scambi.cee .......................................................................................................... 4
Installazione e configurazione ........................................................................................................................... 5
Setup.............................................................................................................................................................. 5
Configurazione - menù Info/Impostazioni..................................................................................................... 5
configurazione di VatChecker .................................................................................................................... 5
Configurazione Siti ..................................................................................................................................... 5
Configurazione connessione OLEDB .......................................................................................................... 5
Configurazione Servizio ................................................................................................................................. 6
Gestione menù File , funzione interrattiva........................................................................................................ 6
Verifica Cli/For As400 .................................................................................................................................... 6
File XML ......................................................................................................................................................... 6
Presentazione ................................................................................................................................................ 7
Verifica nuovamente errori web ................................................................................................................... 7
Cosa si intende per operazione controllo di validità ................................................................................. 7
Multi Consult Milano S.p.A.
Via Rombon, 11
20134 Milano
P.Iva: 08393130151
Document1
www.multiconsult.com
Tel +39 02264271
Fax +39 0226411685
Pagina 1 di 7
Premessa
VatChecker è un servizio Windows da utilizzare per controllare la validità della Partita Iva o del VAT
europeo di una o più anagrafiche dell’applicazione gestionale o di un file Intrastat.
Il controllo viene effettuato inviando una richiesta al sito dell’agenzia delle entrate italiana e/o europea che
si preoccuperà di controllarne la validità.
Le informazioni ricevute vengono memorizzate per velocizzare le operazioni di controllo, infatti ogni volta
che si richiede di ricontrollare le Partita Iva il programma controlla solo quelle per le quali in precedenza
non è stato possibile verificarne la validità.
E’ possibile impostare i giorni di scadenza dell’informazione memorizzata per forzare il ricontrollo delle
Partite Iva oltre questo termine.
Attenzione: se le anagrafiche da controllare sono molte il sito non permette di effettuare il controllo in un
unico giorno in quanto disabilita l’indirizzo IP da cui viene effettuata la richiesta dopo un certo numero di
chiamate (circa 100).
Le successive risulteranno tutte in errore web e il controllo andrà rilanciato il giorno successivo.
Tutte le operazioni sono schedulabili tramite servizio Windows.
Gestione dei dati
I dati relative alle P.Iva da controllare possono essere forniti all’applicazione in uno o più dei seguenti modi:
1. spediti in una cartella come file xml secondo il tracciato del file MCM.Tools.VatCheckerInfo.xsd,
il risultato viene memorizzato nel Db dell’applicazione e su un file di output;
2. spediti in una cartella secondo il tracciato del file scambi.cee,
il risultato viene memorizzato nel Db dell’applicazione e su un file di output;
3. accesso diretto ad un database raggiungibile tramite driver OLEDB (ad esempio AS/400) tramite
query su uno o piu’ file,
il risultato viene memorizzato nel Db dell’applicazione.
Di seguito il dettaglio dei file di interscambio utilizzati.
File xml
Schema MCM.Tools.VatCheckerInfo.xsd
<?xml version="1.0" encoding="utf-8" ?>
<xsd:schema id="VatCheckerSchema"
targetNamespace="http://schema.multiconsult.com/Tools.VatChecker/VatCheckerInfo.xsd"
elementFormDefault="qualified"
xmlns="http://schema.multiconsult.com/Tools.VatChecker/VatCheckerInfo.xsd"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<xsd:element name="VatCheckerInfo">
<xsd:complexType>
<xsd:sequence>
<!-- Dettaglio VAT -->
<xsd:element name="VatCheckerInfoDetail" minOccurs="0" maxOccurs="unbounded">
<xsd:complexType>
<xsd:attribute name="CountryCode" type="xsd:string" use="required" />
<xsd:attribute name="VatCode" type="xsd:string" use="required" />
<xsd:attribute name="Reference" type="xsd:string" use="optional" />
<xsd:attribute name="Result" type="VatCheckerInfoResultEnum" use="optional" />
</xsd:complexType>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
Multi Consult Milano S.p.A.
Via Rombon, 11
20134 Milano
P.Iva: 08393130151
Document1
www.multiconsult.com
Tel +39 02264271
Fax +39 0226411685
Pagina 2 di 7
</xsd:element>
<!-- enumeratore esiti verifiche -->
<xsd:simpleType name="VatCheckerInfoResultEnum">
<xsd:restriction base="xsd:int">
<!-- Non valido -->
<xsd:enumeration value="0"/>
<!-- Valido -->
<xsd:enumeration value="1"/>
<!-- Non reperibile -->
<xsd:enumeration value="2"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:schema>
Esempio file XML con le Piva da elaborare
<?xml version="1.0" encoding="utf-8"?>
<VatCheckerInfo xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns="http://schema.multiconsult.com/Tools.VatChecker/VatCheckerInfo.xsd">
<VatCheckerInfoDetail CountryCode="GB" VatCode="310199487"/>
<VatCheckerInfoDetail CountryCode="HU" VatCode="41055337"/>
<VatCheckerInfoDetail CountryCode="GB" VatCode="111111111"/>
<VatCheckerInfoDetail CountryCode="EL" VatCode="091110176"/>
</VatCheckerInfo>
Esempio risposta su file xml
L’attributo Result contiene il risultato della verifica, secondo lo schema di VatCheckerInfoResultEnum:
0 = Non Valido
1 = Valido
2 = non reperibile (errore Web)
<?xml version="1.0" encoding="utf-8"?>
<VatCheckerInfo xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns="http://schema.multiconsult.com/Tools.VatChecker/VatCheckerInfo.xsd">
<VatCheckerInfoDetail CountryCode="GB" VatCode="310199487" Result="1"/>
<VatCheckerInfoDetail CountryCode="HU" VatCode="41055337" Result="1"/>
<VatCheckerInfoDetail CountryCode="GB" VatCode="111111111" Result="0"/>
<VatCheckerInfoDetail CountryCode="EL" VatCode="091110176" Result="1"/>
</VatCheckerInfo>
File scambi.cee
Esempio file scambi.cee con le Piva da elaborare.
EUROA11041470151078110000000C09M05000831701590011041470151000220000000013222000000000000000000
EUROA11041470151078110100001ATU19430006
0000000000692196032930000000009600000020000000000000000
EUROA11041470151078110100002EL999824646
0000000000134133071000000000001500000000000000000000000
EUROA11041470151078110100003EL99982RR46
0000000000209133072000000000001300000000000000000000000
EUROA11041470151078110100004EL999824646
0000000000240139269097000000000200000000000000000000000
EUROA11041470151078110100005EL9998RR646
0000000000135182142000000000001800000000000000000000000
EUROA1104147015107811520001103009ATU48400001
-00000000000931611241900000000000000
EUROA1104147015107811520001204009ATU56796RR9
-00000000000371610443000000000000000
EUROA1104147015107811520001301009ATU56796569
-00000000000381611219000000000000000
EUROA1104147015107811520001403009ATU56796569
-00000000004381611241900000000000000
EUROA1104147015107811520001504009ATU62572308
-00000000000441611241900000000000000
EUROA1104147015107811520001604009BE0437913527 -00000000000281611241900000000000000
EUROA11041470151078116000000C09M05005019501740011041470151000100000000035422000000000000000000
EUROA11041470151078116100001ATU37612106
0000000000907184818099000000009200000000000000000000000
EUROA11041470151078116100002ATU64409401
0000000002211184818039000000024800000000000000000000000
EUROA11041470151078117000000C09M05006000909890011041470151000010000000010941000000000000000000
EUROA11041470151078117100001DE126180387
0000000010941190289090000000200200000000000000000000000
EUROA11041470151078118000000C09M0500660160433001104147015100126000000031221400001000000000001v
EUROA11041470151078118100001CZ48114154
0000000000006144152020000000000100000000100000000000000
EUROA11041470151078118100002CZ48114154
0000000000020161121900000000000100000000010000000000000
EUROA11041470151078118100003CZ48114154
0000000007427161123190000000008700000009280000000000000
Multi Consult Milano S.p.A.
Via Rombon, 11
20134 Milano
P.Iva: 08393130151
0ATMI
0ELMI
0ELMI
0ELMI
0ELMI
0ATBS
0ATBS
0DEBS
0CZMC
0CZMC
0CZMC
Document1
www.multiconsult.com
Tel +39 02264271
Fax +39 0226411685
Pagina 3 di 7
EUROA1104147015107811820000104009FR52391634474 -00000000000161611090900000000000000
EUROA11041470151078127000000C09M05017623301550011041470151000020000000023246000010000000001450
EUROA11041470151078127100001HU10566680
0000000012380172199080000001750000000000000000000000000 0HUMI
EUROA11041470151078127100002RO14759613
0000000010866172199080000001873500000000000000000000000 0ROMI
EUROA1104147015107812720000103009FR42347618134 +00000000014501721990800000000000000
EUROA11041470151078145100003NL005485435B010000000003027185444993000000055000000000000000000000000 0NLMI
EUROA1104147015107814520000103009DE131066447
-00000000001501854449930000000000000
Esempio risposta su file scambi.cee
L’attributo Result contiene il risultato della verifica, secondo lo schema di VatCheckerInfoResultEnum:
0 = Non Valido
1 = Valido
2 = non reperibile (errore Web)
<?xml version="1.0" encoding="utf-8" ?>
<VatCheckerInfo xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns="http://schema.multiconsult.com/Tools.VatChecker/VatCheckerInfo.xsd">
<VatCheckerInfoDetail CountryCode="AT" VatCode="U19430006" Result="1" />
<VatCheckerInfoDetail CountryCode="EL" VatCode="999824646" Result="1" />
<VatCheckerInfoDetail CountryCode="EL" VatCode="99982RR46" Result="0" />
<VatCheckerInfoDetail CountryCode="EL" VatCode="999824646" Result="1" />
<VatCheckerInfoDetail CountryCode="EL" VatCode="9998RR646" Result="0" />
<VatCheckerInfoDetail CountryCode="AT" VatCode="U48400001" Result="1" />
<VatCheckerInfoDetail CountryCode="AT" VatCode="U56796RR9" Result="0" />
<VatCheckerInfoDetail CountryCode="AT" VatCode="U56796569" Result="1" />
<VatCheckerInfoDetail CountryCode="AT" VatCode="U56796569" Result="1" />
<VatCheckerInfoDetail CountryCode="AT" VatCode="U62572308" Result="1" />
<VatCheckerInfoDetail CountryCode="BE" VatCode="0437913527" Result="1" />
<VatCheckerInfoDetail CountryCode="AT" VatCode="U37612106" Result="1" />
<VatCheckerInfoDetail CountryCode="AT" VatCode="U64409401" Result="1" />
<VatCheckerInfoDetail CountryCode="DE" VatCode="126180387" Result="1" />
<VatCheckerInfoDetail CountryCode="CZ" VatCode="48114154" Result="1" />
<VatCheckerInfoDetail CountryCode="CZ" VatCode="48114154" Result="1" />
<VatCheckerInfoDetail CountryCode="CZ" VatCode="48114154" Result="1" />
<VatCheckerInfoDetail CountryCode="FR" VatCode="52391634474" Result="1" />
<VatCheckerInfoDetail CountryCode="HU" VatCode="10566680" Result="1" />
<VatCheckerInfoDetail CountryCode="RO" VatCode="14759613" Result="1" />
<VatCheckerInfoDetail CountryCode="FR" VatCode="42347618134" Result="1" />
<VatCheckerInfoDetail CountryCode="NL" VatCode="005485435B01" Result="1" />
<VatCheckerInfoDetail CountryCode="DE" VatCode="131066447" Result="1" />
</VatCheckerInfo>
Multi Consult Milano S.p.A.
Via Rombon, 11
20134 Milano
P.Iva: 08393130151
Document1
www.multiconsult.com
Tel +39 02264271
Fax +39 0226411685
Pagina 4 di 7
Installazione e configurazione
Setup
Viene fornito un setup del programma.
Seguendo la procedura guidata verrà installato in C:\%Program Files%\MCM\Tools\VatChecker
Alla prima esecuzione il programma chiede la LICENZA da farsi rilasciare da MCM.
Per il rilascio della licenza comunicare il codice di attivazione visualizzato.
Dopo il rilascio della licenza è possibile procedere con l’installazione.
Il servizio MCM.Tools.VatChecker.Service è visibile da pannello di controllo | strumenti di amministrazione
| servizi.
Il log degli errori MCM VatChecker Log è visibile da pannello di controllo | strumenti di amministrazione |
eventi.
Configurazione - menù Info/Impostazioni
configurazione di VatChecker
La configurazione di VatChecker si trova sotto il menù Info/Impostazioni.
La prima operazione da effettuare è Configurazione VatChecker: occorre rendere disponibile il database
installato a tutti gli utenti e al servizio perciò il db deve essere copiato dalla cartella di installazione
C:\Program Files\MCM\Tools\VatChecker\VatChecker.mdb
alla cartella di windows che viene già proposta:
C:\Documents and Settings\All Users\Application Data\MCM.Tools.VatChecker
Questa informazione viene poi memorizzata nel file di configurazione dell’applicazione come stringa di
connessione al DB:
Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\Documents and Settings\All
Users\Application Data\MCM.Tools.VatChecker\Vatcheker.mdb;User
Id=admin;Password=;
È possibile correggere manualmente la stringa di connessione per indicare la cartella in cui si trova.
Configurazione Siti
Vengono proposti i siti autorizzati al controllo delle partite iva e i messaggi per identificarne il risultato.
Impostare il numero di tentativi da fare in caso di errore di accesso al sito e i giorni di validità da
considerare prima che l’applicazione ripeta il controllo.
Configurazione connessione OLEDB
In seguito si considera l’accesso OLEDB specifico per AS/400 ma la soluzione è valida per ogni database che
sia in grado di supportare un driver OLEDB.
Configurazione dell’accesso ad AS/400
L’accesso avviene tramite il seguente driver:
.NET Framework Data Provider for OLE DB
usage:System.Data.OleDb.OleDbConnection
La stringa di connessione va indicata nel seguente modo:
Provider=IBMDA400;Data Source=nome_AS_o_indirizzo_IP;User
Id=utente;Password=password;Default Collection=Libreria_AS400
Indicare la tabella e i campi che contengono i dati da controllare, in tal caso verrà calcolato il comando sql
di accesso alla tabella.
Oppure scrivere direttamente il comando di accesso ad uno o più file, in tal caso il risultato DEVE essere
così strutturato:
 Il primo campo restituito deve essere la nazione
 il secondo campo deve essere la Partita iva che non deve contenere dati vuoti o duplicati.
Multi Consult Milano S.p.A.
Via Rombon, 11
20134 Milano
P.Iva: 08393130151
Document1
www.multiconsult.com
Tel +39 02264271
Fax +39 0226411685
Pagina 5 di 7
Esempio di accesso al file anagrafiche contabili MCM
Configurazione Servizio
Attiva servizio per elaborazione cartella contenente file vatcheker.xml e cartella scambi cee.
Attiva servizio per elaborazione dati su As400.
Dopo aver configurato il servizio è possibile avviarlo tramite il pulsante Avvia.
Il servizio esegue autonomamente le funzioni previste per la gestione interrattiva.
Si differenzia per il caricamento dei dati da file esterni in quanto elabora tutta una cartella e no richiede il
singolo file.
Gestione menù File , funzione interrattiva
Viene presentato un elenco partite iva presenti nel database dell’applicazione.
I dati sono interrogabili tramite i filtri proposti e selezionando il pulsante carica.
E’ possibile anche cancellare le partite iva presenti.
Verifica Cli/For As400
Questa funzione carica e controlla i dati presenti sul server richiesto.
Si collega al server indicato in configurazione, estrae le partite iva dal file configurato e per ogni partita iva e
ne esegue il controllo di validità.
I dati vengono salvati sul database dell ‘applicazione
File XML
Questa funzione carica e controlla i dati presenti su un file del formato di VatCheckerInfo.xml
I dati presenti nel file xml vengono caricati nel database dell ‘applicazione e per ogni partita iva si esegue il
controllo di validità.
Il risultato viene scritto anche in un file di output secondo il formato di VatCheckerInfo.xml
Multi Consult Milano S.p.A.
Via Rombon, 11
20134 Milano
P.Iva: 08393130151
Document1
www.multiconsult.com
Tel +39 02264271
Fax +39 0226411685
Pagina 6 di 7
Presentazione
Carica e controlla i dati presenti su un file di tipo scambi.cee
I dati presenti nel file vengono caricati nel database dell ‘applicazione e per ogni partita iva si esegue il
controllo di validità.
Il risultato viene scritto anche in un file di output secondo il formato di VatCheckerInfo.xml
Verifica nuovamente errori web
Per ogni partita iva presente nel database dell’applicazione viene eseguito il controllo di validità.
Cosa si intende per operazione controllo di validità
Per il controllo di validità si intende che ogni partita iva già esistente nel database dell ‘applicazione viene
ricontrollata solo se è scaduta (i giorni di validità impostati in configurazione sono trascorsi) oppure se era
in stato errore web.
Le partite iva nuove vengono sempre controllate.
Motore database
Per mantenere lo storico delle partite iva controllate si utilizza un database access
Multi Consult Milano S.p.A.
Via Rombon, 11
20134 Milano
P.Iva: 08393130151
Document1
www.multiconsult.com
Tel +39 02264271
Fax +39 0226411685
Pagina 7 di 7