Le complément Excel vous permet de vérifier rapidement et automatiquement les entités (entrepreneurs) à l'aide de la feuille de calcul Excel en fonction de leur statut actuel dans le Système VIES.

Ce chapitre contient des instructions sur la façon d'intégrer l'application Microsoft Excel avec le système nip24.pl. Le complément fourni a été testé avec succès dans les versions suivantes de MS Excel : 2007, 2010, 2013, 2016, 2019 (sur les systèmes d'exploitation Windows et MacOS) et 2021 (sur les systèmes d'exploitation Windows et MacOS) et la version Web d'Excel365.

La dernière version du module complémentaire pour Excel 2007, 2010, 2013, 2016 et 2019 est toujours disponible en téléchargement sur le Page de téléchargement. Le module complémentaire peut être installé dans les versions 32 bits et 64 bits d'Excel. Attention! Sélectionnez la version (32 ou 64 bits) qui correspond à la version d'Excel, pas le système d'exploitation.

Pour télécharger et installer le module complémentaire pour MacOS et Excel 2021 pour Windows et Excel365, veuillez visiter la boutique officielle Microsoft : https://appsource.microsoft.com.

La fonctionnalité complète du complément Excel peut être vérifiée - sans avoir besoin de créer un compte – en utilisant le Tester l'API. La page décrit également comment configurer un complément Excel à utiliser dans l'API fournie pour les tests.

L'utilisation du complément dans l'API de production nécessite de créer un compte sur le site viesapi.eu, d'acheter au minimum le plan Business et de générer une clé et son identifiant. Le processus d'enregistrement et de création d'un compte ainsi que la génération de clés ont été décrits sur le Documentation site Internet.

Installation et configuration pour MS Excel 2021 et Excel 365 à partir de Microsoft Store (AppSource)

Installation

Après avoir accédé au site Web Microsoft Official Store https://appsource.microsoft.com, clique le Get it now bouton.

Une fenêtre de connexion s'affiche dans laquelle vous devez saisir l'adresse e-mail pour laquelle vous avez créé un compte auprès de Microsoft (privé ou entreprise). Si vous ne disposez pas d'un tel compte, vous pouvez en créer un et poursuivre le processus d'installation ou arrêter l'installation et utiliser l'option d'installation du module complémentaire de l'une des manières décrites ci-dessus.

Pour télécharger et installer le complément à partir d'Excel 2021 ou d'Excel 365 (web), accédez au Insert [1], recherchez la section Compléments et cliquez sur le OfficeAdd-ins bouton [2]. Ensuite, dans la fenêtre ouverte, entrez le mot 'viesapi ′ [3] dans le champ de recherche et appuyez sur l'icône de la loupe. Un module complémentaire appelé "VIES API - EU VAT Validation” doit être trouvé, qui doit être installé en cliquant sur le Add bouton [4]. Toutes les étapes ci-dessus sont illustrées dans la capture d'écran ci-dessous :

Après avoir cliqué sur le Add , un écran devrait apparaître où vous pouvez lire les termes de la licence et les règles de protection de la vie privée.

Pour démarrer l'installation du complément, appuyez sur Continue bouton.

Configuration

Après avoir correctement installé le plugin, vous devriez voir un écran similaire à celui présenté ci-dessous. Dans le Home menu [1], repérez l'icône représentant le VIES API Panel [2] et cliquez dessus pour afficher le panneau latéral. Immédiatement après l'installation, le complément est configuré pour fonctionner dans un environnement de test - détails sur le Tester la page de l'API. L'utilisation de l'add-on en mode test ne nécessite pas la création d'un compte sur le viesapi.eu site Internet.

Pour basculer le module complémentaire vers l'environnement de production, cliquez sur le ID and key [3] et saisissez l'onglet Key et clé ID, que vous pouvez retrouver après vous être connecté à votre compte sur le site viesapi.eu dans la rubrique «API Keysonglet ". Après avoir saisi les deux valeurs, appuyez sur la touche Save bouton.

Si vous n'avez pas encore de compte sur notre site, cliquez sur le lien à viesapi.eu [4] et passer par le processus d'enregistrement, qui est décrit en détail sur le Documentation page.

Installation et configuration pour Excel : 2007, 2010, 2013, 2016 et 2019

Installation

Obtenez la dernière version du complément pour Excel 2007, 2010, 2013, 2016 et 2019 à partir du Page de téléchargement. Lancez MS Excel et accédez à File> Options, puis sélectionnez Add-ins [1] dans le menu.

En bas des paramètres, sélectionnez Excel Add-ins [2] et cliquez sur le Go bouton [3].

Les utilisateurs avancés peuvent ajouter un module complémentaire à partir du Developer l'onglet [1], puis cliquez sur Excel Add-ins [2] et cliquez sur le Browse Bouton [3] :

Dans le Add-ins fenêtre, cliquez sur le Browse bouton, allez dans le répertoire où se trouve le viesapi-ms-excel-addin-version-number.zip fichier a été décompressé et sélectionnez :

• viesapiExcel.xll – pour la version 32 bits d'Excel,
• viesapiExcel64.xll – pour la version 64 bits d'Excel.

Le chargement correct du complément est illustré dans la figure ci-dessous [1].

Il suffit de cliquer sur le OK bouton [2] pour rendre les fonctions implémentées dans le complément disponibles dans Excel.

Configuration

Après l'installation, le plugin est défini par défaut sur l'environnement de test (plus de détails sur Tester l'API page). Pour pouvoir appeler des fonctions dans l'environnement de production, il est nécessaire de configurer une fois l'accès au site viesapi.eu. Pour ce faire, accédez à n'importe quelle feuille de calcul Excel et exécutez la fonction :

=VIESAPI.CONNECT.PRODUCTION("identifier";"key")

où les paramètres de la fonction sont :

• identifier – le paramètre doit contenir l'identifiant (ID) généré sur le compte sur le site viesapi.eu,
• key – le paramètre doit contenir la Clé générée sur le compte sur le site viesapi.eu.

Les détails sur la génération de l'identifiant et de la clé sont décrits sur le Documentation site Internet.

Afin de vérifier l'exactitude de la connexion avec une API donnée (test ou production), la fonction suivante doit être exécutée :

=VIESAPI.CONNECT.STATUS()

Qui peut renvoyer des valeurs :

• SUCCESS: Production – si le complément est correctement configuré pour fonctionner avec l'environnement de production,
• SUCCESS: Test – si le complément est correctement configuré pour fonctionner avec le environnement d'essai,

• ERROR: Connection requires configuration – en cas de mauvaise configuration.

Par défaut, chaque document Excel est configuré pour calculer automatiquement la feuille de calcul. La définition de cette option implique que toutes les formules sont appelées lorsque des modifications affectant la formule sont apportées. Un exemple de ceci est de supprimer une ligne sur une feuille de calcul.

Afin d'éviter l'invocation automatique de toutes les fonctions définies dans une feuille donnée, qui est liée à l'envoi automatique de requêtes à l'API du site veisapi.eu, changez l'option de calcul du classeur en Manuel :

1. Du File menu, sélectionner Options
2. Mettre en évidence le Formulas languette
3. Dans la section Options de calcul, sélectionnez le paramètre : Manual et décochez l'option supplémentaire : Recalculate the workbook before saving.
4. Il est nécessaire de sauvegarder les modifications apportées dans la feuille.

Avec la feuille de calcul Excel configurée de cette manière, afin de forcer le rafraîchissement de toutes les formules définies, appuyez sur la combinaison de touches :

CTRL + ALT + SHIFT + F9

Mettre à jour le plugin vers la dernière version

Attention!La procédure suivante de mise à jour du module complémentaire Excel fonctionne correctement pour les versions MS Excel 2019, 2021 et Excel 365, où le module complémentaire peut être installé à partir du Microsoft Store.

Attention! Après avoir installé la dernière version, vous devez reconfigurer le module complémentaire, c'est-à-dire saisir et enregistrer l'ID et la clé.

Pour installer la dernière version du module complémentaire Excel, procédez comme suit :

1. Vérifiez la version du module complémentaire installé en appelant la formule =VIESAPI.VERSION(). La dernière version du module complémentaire est la 1.2.8

2. Vider le cache MS Excel, selon la procédure décrite sur la page de documentation officielle : https://learn.microsoft.com/en-us/office/dev/add-ins/testing/clear-cache

3. Après avoir terminé toutes les étapes du point 2, redémarrez l'application MS Excel.

4. Lors du redémarrage, l'application MS Excel téléchargera la dernière version du module complémentaire depuis le Microsoft Store.

5. Configurez le module complémentaire en saisissant l'ID et la clé téléchargés après vous être connecté à votre compte sur notre site web – Onglet « Clés API ».

Usage

Découvrez comment vérifier automatiquement et massivement le statut de TVA de l'UE des entreprises dans le système VIES à l'aide de notre complément Excel :

Avant d'utiliser le module complémentaire, vous devez vous familiariser avec les spécificités de son fonctionnement :

• Tous les appels de fonction sont exécutés en mode asynchrone, ce qui ne provoque pas l'effet de blocage (pas de réponse) de l'application Excel.
• L'ajout (insertion) d'une ligne ou d'une colonne n'actualise pas tous les appels de fonction définis.
• La copie ou le déplacement de cellules contenant des fonctions n'actualise pas les appels de fonction définis.
• La suppression d'une ligne ou d'une colonne actualisera tous les appels de fonction définis et enverra des requêtes à viesApi.eu (uniquement dans le cas des paramètres Excel par défaut). La description de la modification des paramètres par défaut est incluse dans le chapitre Configuration.
• Attention! Il n'est pas recommandé d'exécuter plus de 500 requêtes parallèles car Excel a du mal à gérer un grand nombre d'appels asynchrones.

Obtenir les données de l'entreprise de VIES

VIESAPI.VIES.DATA() – La fonction récupère toutes les données d'entreprise disponibles directement à partir du système VIES. Les paramètres doivent être :

• Numéro d'identification fiscale européen (TVA UE),
• (optionnel) FORMAT des données retournées (voir : Balises pouvant être utilisées comme FORMAT paramètre).

=VIESAPI.VIES.DATA("PL7171642051")

Si vous n'avez besoin que du statut d'entreprise dans VIES, veuillez utiliser la requête suivante :

=VIESAPI.VIES.DATA("PL7171642051";"$(Valid)")

Si le statut renvoyé est Oui, cela signifie que l'entreprise a un numéro de TVA intracommunautaire valide.

Balises disponibles dans le VIESAPI.VIES.DATA fonction qui peut être utilisée comme FORMAT paramètre:

• $(UID) – Identifiant unique généré par le service viesApi.eu
• $(CountryCode) - Code postal
• $(VATNumber) – Numéro de TVA européen
• $(Valid) – Statut valide Numéro de TVA intracommunautaire (Yes/No)
  
• $(TraderName) – Nom de l'entrepreneur/fournisseur
• $(TraderCompanyType) - Type d'entreprise
• $(TraderAddress) – Adresse de la contrepartie
• $(ID) – Identifiant unique généré par le système VIES
• $(Date) – La date à laquelle la réponse a été générée
• $(Source) – La source des données

Format par défaut : "$(TraderName), $(TraderAddress)"

Si la chaîne "JSON" est donné comme le FORMAT paramètre, la fonction renverra le résultat complet sous la forme d'une chaîne JSON, qui peut être librement analysée et traitée ultérieurement :

=VIESAPI.VIES.DATA("PL7171642051";"JSON")

Vérification de l'état du compte utilisateur (gratuit)

VIESAPI.STATUS.ACCOUNT() – La fonction renvoie des informations de base sur le plan actuellement utilisé par l'utilisateur. Les paramètres doivent être :

• (optionnel) FORMAT des données retournées (voir : Balises pouvant être utilisées comme FORMAT paramètre)

=VIESAPI.STATUS.ACCOUNT()

Attention! L'appel de la fonction n'augmente pas le nombre de requêtes effectuées.

Les balises disponibles dans le VIESAPI.STATUS.ACCOUNT fonction peut être utilisée comme FORMAT paramètre:

• $(BillingPlanName) – Nom du plan tarifaire actuel
• $(SubscriptionPrice) – Prix net de l'abonnement mensuel
• $(ItemPrice) – Coût net de la demande unique hors plan dans le plan standard
• $(ItemPriceStatus) – Coût net d'une seule demande – VIES / Statut d'entreprise de l'entité dans un plan individuel
• $(Limit) – Le nombre maximum de requêtes dans le plan
• $(RequestDelay) – L'intervalle de temps minimum entre les requêtes
• $(DomainLimit) – Nombre maximum de domaines (clés API)
• $(OverPlanAllowed) – Possibilité de dépasser le nombre maximum de requêtes dans le plan
• $(ExcelAddIn) – Accès à l'aide du complément MS Excel
• $(Stats) – Accès aux statistiques des requêtes effectuées
• $(NIPMonitor) – Accès au suivi du statut VIES
• $(SearchByNIP) – Recherche par numéro d'identification fiscale à la TVA de l'UE
• $(FuncGetVIESData) – Accès aux fonctions qui vérifient le statut de l'entité dans le système VIES
• $(VIESStatusCount) – Nombre de demandes de renseignements concernant le statut de l'entité dans le système VIES
• $(TotalCount) – Nombre total de requêtes exécutées dans le mois en cours

FORMAT par défaut : "Name of the current tariff plan: $(BillingPlanName), Monthly subscription net price: $(SubscriptionPrice), Maximum number of inquiries in the plan: $(Limit), Total number of queries made in the current month: $(TotalCount)"

Si la chaîne "JSON" est donné comme le FORMAT paramètre, la fonction renverra le résultat complet sous la forme d'une chaîne JSON, qui peut être librement analysée et traitée ultérieurement.

Autres fonctions utiles (gratuites)

VIESAPI.ACCOUNT.STATUS.TOTAL() – La fonction renvoie des informations sur le nombre total de requêtes effectuées au cours du mois de facturation en cours pour un compte donné (toutes les clés API). Renvoie exactement le même nombre que le $(TotalCount) balise dans le VIESAPI.STATUS.ACCOUNT() fonction.

VIESAPI.ACCOUNT.STATUS.LIMIT() – La fonction renvoie des informations sur le nombre maximum de requêtes disponibles dans le plan sélectionné par l'utilisateur. Renvoie exactement le même nombre que le $(Limit) faire VIES.STATUS.ACCOUNT() fonction

VIESAPI.EUVAT.NORM() - Cette fonctionnalité corrige et formate le numéro de TVA intracommunautaire (supprime les espaces et les tirets, etc.) hors ligne et ne récupère aucune donnée de VIES :

=VIESAPI.EUVAT.NORM("PL 717-164-20-51")

VIESAPI.EUVAT.VALID() – La fonction vérifie uniquement l'exactitude (syntaxe, somme de contrôle) du numéro de TVA intracommunautaire hors ligne et ne récupère aucune donnée du système VIES. Retour TRUE si le numéro est valide ou FALSE s'il n'est pas valide :

=VIESAPI.EUVAT.VALID("PL7171642051")

VIESAPI.CONNECTION.STATE() – La fonction renvoie l'état actuel de la configuration du complément.

Si la fonction renvoie la valeur suivante, cela signifie, entre autres, que le ID et API key n'ont pas été sauvegardés :

ERROR: Connection requires configuration

Après avoir enregistré le API ID et key, la fonction doit renvoyer le message suivant :

SUCCESS: Production