Sommaire
Présentation
Ce connecteur permet d'interroger le référentiel VIES de la commission européenne afin de contrôler le numéro de TVA intracommunautaire des tiers et de leurs adresses.
Prérequis
Le module "REF-VIES - Contrôle du numéro de TVA intracommunautaire" est le socle d'accès à la fonctionnalité, il est obligatoire. Demandez une clé pour l'activer.
Paramétrage technique
Le connecteur est appelé sur le serveur Web.
Mise en place du certificat client
Non concerné. Aucune installation n'est à effectuer.
Mise en place du certificat SSL
Le certificat SSL, utilisé pour la connexion HTTPS, est un certificat signé par une autorité connue. En règle générale, aucune installation n'est à effectuer.
Si toutefois, vous rencontrez une erreur liée à ce certificat telle "unable to find valid certification path to requested target", il est préconisé en premier lieu de mettre à jour Java sur le serveur.
En dernier recours, installer ce certificat sur l'environnement Java du serveur Web et du serveur de traitements.
Unix :
$JAVA_HOME/bin/keytool -import -alias aliascertificat -keystore $JAVA_HOME/lib/security/cacerts -file /tmp/certificat.crt -storepass changeit
Windows :
%JAVA_HOME%\bin\keytool -import -alias aliascertificat -keystore %JAVA_HOME%\lib\security\cacerts -file c:\temp\certificat.crt -storepass changeit
Configuration pour l'utilisation d'un proxy HTTP/TCP
Les options Java "-Dhttp.proxyHost" et "-Dhttp.proxyPort" doivent être définies dans la variable JAVA_OPTS :
- Pour le serveur Web : au niveau du script de démarrage de Tomcat (%CATALINA_HOME%\bin\catalina.bat sous Microsoft Windows, $CATALINA_HOME/bin/catalina.sh sous Unix) ;
- Pour le serveur de traitements : au niveau du fichier qualiacdb.properties (%IAC_HOME%\trt\local\ sous Microsoft Windows, $IAC_HOME/trt/local/ sous Unix).
Paramétrage de la connexion
Vérifier la présence de l'URL du WebService dans GTSVC en recherchant l'identifiant :
- "VIES", URL : https://ec.europa.eu/taxation_customs/vies/services/checkVatService
Test de la sortie internet depuis le serveur Web
Unix :
curl --request POST \
--header 'Content-Type: text/xml;charset=UTF-8' \
--data '<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:ec.europa.eu:taxud:vies:services:checkVat:types"> <soapenv:Header/><soapenv:Body> <urn:checkVat><urn:countryCode>FR</urn:countryCode> <urn:vatNumber>52327888111</urn:vatNumber> </urn:checkVat></soapenv:Body></soapenv:Envelope>' \
https://ec.europa.eu/taxation_customs/vies/services/checkVatService
Windows :
curl --request POST ^
--header "Content-Type: text/xml;charset=UTF-8" ^
--data "<soapenv:Envelope xmlns:soapenv=\"http://schemas.xmlsoap.org/soap/envelope/\" xmlns:urn=\"urn:ec.europa.eu:taxud:vies:services:checkVat:types\"> <soapenv:Header/><soapenv:Body> <urn:checkVat><urn:countryCode>FR</urn:countryCode> <urn:vatNumber>52327888111</urn:vatNumber> </urn:checkVat></soapenv:Body></soapenv:Envelope>" ^
https://ec.europa.eu/taxation_customs/vies/services/checkVatService
Utilisation du connecteur dans Cegid XRP Ultimate
GTIE - Tiers, adresses et domiciliations, GTIA - Adresses de tiers, OEITTIB - Tiers adresses
Prérequis : positionner à "O" la valeur du paramètre PR3 associé au mnémonique afin de faire apparaître le bouton de contrôle du numéro de TVA intracommunautaire.