Excel-Add-in VIES Validator

Mit dem Excel-Add-In können Sie schnell und automatisch Entitäten (Auftragnehmer) anhand der Excel-Tabelle hinsichtlich ihres aktuellen Status in der prüfen VIES-System.

Dieses Kapitel enthält Anweisungen zur Integration der Microsoft Excel-Anwendung in das nip24.pl-System. Das bereitgestellte Add-In wurde erfolgreich in den folgenden Versionen von MS Excel getestet: 2007, 2010, 2013, 2016, 2019 (auf den Betriebssystemen Windows und MacOS) und 2021 (auf den Betriebssystemen Windows und MacOS) und der Webversion von Excel365.

Die neueste Version des Add-Ons für Excel 2007, 2010, 2013, 2016 und 2019 steht immer zum Download unter bereit Seite herunterladen. Das Add-On kann sowohl in 32-Bit- als auch in 64-Bit-Versionen von Excel installiert werden. Aufmerksamkeit! Wählen Sie die Version (32 oder 64 Bit) aus entspricht der Version von Excel, nicht das Betriebssystem.

Um das Add-on für MacOS und Excel 2021 für Windows und Excel365 herunterzuladen und zu installieren, besuchen Sie bitte den offiziellen Microsoft Store: https://appsource.microsoft.com.

Die volle Funktionalität des Excel-Add-ins kann überprüft werden – ohne dass ein Konto erstellt werden muss – unter Verwendung der bereitgestellten API testen. Auf der Seite wird auch beschrieben, wie Sie ein Excel-Add-In für die Verwendung in der zum Testen bereitgestellten API konfigurieren.

Die Verwendung des Add-Ins in der Produktions-API erfordert die Einrichtung eines Kontos auf der Website viesapi.eu, den Kauf eines Minimums des Business-Plans und die Generierung eines Schlüssels und seiner Kennung. Der Prozess der Registrierung und Einrichtung eines Kontos sowie der Generierung von Schlüsseln wurde auf der beschrieben Dokumentation Webseite.

Installation und Konfiguration für MS Excel 2021 und Excel 365 aus dem Microsoft Store (AppSource)

Installation

Nach dem Aufrufen der Microsoft Official Store-Website https://appsource.microsoft.com, drücke den Get it now Taste.

vergleicht Excel-Massenvalidierung

Es wird ein Anmeldefenster angezeigt, in dem Sie die E-Mail-Adresse eingeben müssen, für die Sie ein Konto bei Microsoft (Privat oder Unternehmen) erstellt haben. Wenn Sie kein solches Konto haben, können Sie eines erstellen und den Installationsvorgang fortsetzen oder die Installation abbrechen und die Option verwenden, das Add-On auf eine der oben beschriebenen Arten zu installieren.

Um das Add-In von Excel 2021 oder Excel 365 (Web) herunterzuladen und zu installieren, gehen Sie zu Insert [1], suchen Sie den Abschnitt Add-Ins und klicken Sie auf die OfficeAdd-ins [2]-Taste. Geben Sie dann im geöffneten Fenster das Wort 'viesapi ′ [3] in das Suchfeld ein und drücke auf das Lupen-Symbol. Ein Add-on namens „VIES API - EU VAT Validation“ gefunden werden, die durch Klicken auf installiert werden sollte Add Taste [4]. Alle obigen Schritte sind im folgenden Screenshot dargestellt:

Nach dem Anklicken der Add klicken, sollte ein Bildschirm erscheinen, auf dem Sie die Lizenzbedingungen und Datenschutzbestimmungen lesen können.

Um das Add-In zu installieren, drücken Sie Continue Taste.

Aufbau

Nach der korrekten Installation des Plugins sollten Sie einen Bildschirm ähnlich dem unten gezeigten sehen. In dem Home menu [1], finden Sie das Symbol, das die darstellt VIES API Panel [2] und klicken Sie darauf, um die Seitenleiste anzuzeigen. Unmittelbar nach der Installation wird das Add-In für den Betrieb in einer Testumgebung konfiguriert – Details auf der Test-API-Seite. Die Nutzung des Add-Ons im Testmodus erfordert kein Erstellen eines Kontos auf der viesapi.eu Webseite.

Um das Add-on in die Produktionsumgebung zu schalten, klicken Sie auf die ID and key [3] und geben Sie die ein Key und Schlüssel ID, die Sie nach dem Einloggen in Ihr Konto auf der Website viesapi.eu unter „API Keys” Registerkarte. Nachdem Sie beide Werte eingegeben haben, drücken Sie die Save Taste.

Wenn Sie noch kein Konto auf unserer Website haben, klicken Sie auf den Link unter viesapi.eu [4] und durchlaufen Sie den Registrierungsprozess, der auf der ausführlich beschrieben ist Dokumentation Seite.

Installation und Konfiguration für Excel: 2007, 2010, 2013, 2016 und 2019

Installation

Holen Sie sich die neueste Version des Add-Ins für Excel 2007, 2010, 2013, 2016 und 2019 von der Seite herunterladen. Starten Sie MS Excel und gehen Sie zu File> Options, dann auswählen Add-ins [1] aus dem Menü.

Wählen Sie unten in den Einstellungen aus Excel Add-ins [2] und klicken Sie auf die Go [3]-Taste.

Fortgeschrittene Benutzer können ein Add-on aus dem hinzufügen Developer Registerkarte [1], dann klicken Sie auf Excel Add-ins [2] und klicken Sie auf die Browse [3]-Taste:

wie übertreffen

In dem Add-ins Fenster, klicken Sie auf Browse Schaltfläche, gehen Sie zu dem Verzeichnis, in dem sich die viesapi-ms-excel-addin-version-number.zip Datei wurde entpackt und wählen Sie:

  • viesapiExcel.xll – für die 32-Bit-Version von Excel,
  • viesapiExcel64.xll – für die 64-Bit-Version von Excel.

vergleicht Excel-Insatllation

Das korrekte Laden des Add-Ins ist in der folgenden Abbildung dargestellt [1].

siehe Excel-Konfiguration

Es reicht aus, auf die zu klicken OK Schaltfläche [2], um die im Add-In implementierten Funktionen in Excel verfügbar zu machen.

Aufbau

Nach der Installation ist das Plugin standardmäßig auf die Testumgebung eingestellt (mehr Details auf API testen Seite). Um Funktionen in der Produktivumgebung aufrufen zu können, ist eine einmalige Konfiguration des Zugangs zur Website viesapi.eu erforderlich. Gehen Sie dazu zu einer beliebigen Excel-Tabelle und führen Sie die Funktion aus:

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

wobei die Funktionsparameter sind:

  • identifier – der Parameter sollte die Kennung (ID) enthalten, die für das Konto auf der Website viesapi.eu generiert wurde,
  • key – Der Parameter sollte den Schlüssel enthalten, der auf dem Konto auf der Website viesapi.eu generiert wurde.

Details zur Generierung von Kennung und Schlüssel sind auf der beschrieben Dokumentation Webseite.

Um die Korrektheit der Verbindung mit einer bestimmten API (Test oder Produktion) zu überprüfen, sollte die folgende Funktion ausgeführt werden:

=VIESAPI.CONNECT.STATUS()

Was Werte zurückgeben kann:

  • SUCCESS: Production – ob das Add-In korrekt konfiguriert ist, um mit der Produktionsumgebung zu arbeiten,
  • SUCCESS: Test – ob das Add-In richtig konfiguriert ist, um mit dem zu arbeiten Test Umgebung,
  • ERROR: Connection requires configuration – bei falscher Konfiguration.

Standardmäßig ist jedes Excel-Dokument so eingestellt, dass es die Tabelle automatisch berechnet. Das Setzen dieser Option impliziert, dass alle Formeln aufgerufen werden, wenn Änderungen vorgenommen werden, die sich auf die Formel auswirken. Ein Beispiel hierfür ist das Löschen einer Zeile auf einem Arbeitsblatt.

Um den automatischen Aufruf aller in einem bestimmten Blatt definierten Funktionen zu vermeiden, was mit dem automatischen Senden von Abfragen an die API der Website veisapi.eu zusammenhängt, ändern Sie die Option zur Berechnung der Arbeitsmappe auf Manuell:

  1. Von dem File Speisekarte, auswählen Options
  2. Markieren Sie die Formulas Tab
  3. Wählen Sie im Abschnitt Berechnungsoptionen die Einstellung aus: Manual und deaktivieren die Zusatzoption: Recalculate the workbook before saving.
  4. Es ist notwendig, die im Blatt vorgenommenen Änderungen zu speichern.

Drücken Sie bei so konfigurierter Excel-Tabelle die Tastenkombination, um die Aktualisierung aller definierten Formeln zu erzwingen:

CTRL + ALT + SHIFT + F9

Aktualisieren Sie das Plugin auf die neueste Version

Aufmerksamkeit!Das folgende Verfahren zum Aktualisieren des Excel-Add-Ins funktioniert ordnungsgemäß für die Versionen MS Excel 2019, 2021 und Excel 365, wo das Add-In aus dem Microsoft Store installiert werden kann.

Aufmerksamkeit! Nach der Installation der neusten Version müssen Sie das AddOn neu konfigurieren, d.h. ID und Schlüssel eingeben und speichern.

Um die neueste Version des Excel-Add-Ins zu installieren, führen Sie diese Schritte aus:

1. Überprüfen Sie die Version des installierten Add-Ins, indem Sie die Formel aufrufen =VIESAPI.VERSION()Die neueste Version des Add-ons ist 1.2.8

2. Löschen des MS Excel-Cache gemäß dem auf der offiziellen Dokumentationsseite beschriebenen Verfahren: https://learn.microsoft.com/en-us/office/dev/add-ins/testing/clear-cache

3. Nachdem Sie alle Schritte ab Punkt 2 abgeschlossen haben, starten Sie die MS Excel-Anwendung neu.

4. Während des Neustarts lädt die MS Excel-Anwendung die neueste Version des Add-Ins aus dem Microsoft Store herunter.

5. Konfigurieren Sie das Add-on, indem Sie die ID und den Schlüssel eingeben, die Sie nach der Anmeldung bei Ihrem Konto auf unserer Webseite – Registerkarte „API-Schlüssel“.

Verwendungszweck

Sehen Sie sich an, wie Sie mit unserem Excel-Add-In den EU-Umsatzsteuerstatus von Unternehmen im VIES-System automatisch und umfassend überprüfen:

Bevor Sie das Add-On verwenden, sollten Sie sich mit den Besonderheiten seiner Funktionsweise vertraut machen:

  • Alle Funktionsaufrufe werden im asynchronen Modus ausgeführt, was nicht zum Einfrieren (keine Antwort) der Excel-Anwendung führt.
  • Das Hinzufügen (Einfügen) einer Zeile oder Spalte aktualisiert nicht alle definierten Funktionsaufrufe.
  • Durch das Kopieren oder Verschieben von Zellen, die Funktionen enthalten, werden definierte Funktionsaufrufe nicht aktualisiert.
  • Das Löschen einer Zeile oder Spalte aktualisiert alle definierten Funktionsaufrufe und sendet Abfragen an viesApi.eu (nur bei Standard-Excel-Einstellungen). Die Beschreibung zum Ändern der Standardeinstellungen ist im Kapitel Konfiguration enthalten.
  • Aufmerksamkeit! Es wird nicht empfohlen, mehr als 500 parallele Abfragen auszuführen, da Excel Probleme hat, eine große Anzahl asynchroner Aufrufe zu verarbeiten.

Holen Sie sich Unternehmensdaten von VIES

VIESAPI.VIES.DATA() – Die Funktion ruft alle verfügbaren Unternehmensdaten direkt aus dem VIES-System ab. Die Parameter sollten sein:

  • Europäische Steueridentifikationsnummer (VAT EU),
  • (Optional) FORMAT der zurückgegebenen Daten (siehe: Tags, die als verwendet werden können FORMAT Parameter).

=VIESAPI.VIES.DATA("PL7171642051")

Wenn Sie nur den Unternehmensstatus im VIES benötigen, verwenden Sie bitte die folgende Abfrage:

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

Wenn der zurückgegebene Status Ja ist, bedeutet dies, dass das Unternehmen eine gültige EU-Umsatzsteuernummer hat.

Tags verfügbar in der VIESAPI.VIES.DATA Funktion, die als verwendet werden kann FORMAT Parameter:

  • $(UID) – Eindeutige Kennung, die vom Dienst viesApi.eu generiert wird
  • $(CountryCode) – Ländercode
  • $(VATNumber) – Europäische Umsatzsteuer-Identifikationsnummer
  • $(Valid) – Gültiger Status EU-Umsatzsteuer-Identifikationsnummer (Yes/No)
  • $(TraderName) – Name des Auftragnehmers/Lieferanten
  • $(TraderCompanyType) - Unternehmensart
  • $(TraderAddress) – Adresse der Gegenpartei
  • $(ID) – Vom VIES-System generierte eindeutige Kennung
  • $(Date) – Das Datum, an dem die Antwort generiert wurde
  • $(Source) – Die Quelle der Daten

Standardformat: "$(TraderName), $(TraderAddress)"

Wenn die Zeichenfolge "JSON" wird als angegeben FORMAT Parameter liefert die Funktion das komplette Ergebnis in Form eines JSON-Strings zurück, der frei geparst und weiterverarbeitet werden kann:

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

Statusprüfung des Benutzerkontos (kostenlos)

VIESAPI.STATUS.ACCOUNT() – Die Funktion gibt grundlegende Informationen über den Plan zurück, der derzeit vom Benutzer verwendet wird. Die Parameter sollten sein:

  • (Optional) FORMAT der zurückgegebenen Daten (siehe: Tags, die als verwendet werden können FORMAT Parameter)

=VIESAPI.STATUS.ACCOUNT()

Aufmerksamkeit! Durch Aufrufen der Funktion wird die Anzahl der durchgeführten Abfragen nicht erhöht.

Die verfügbaren Tags in der VIESAPI.STATUS.ACCOUNT Funktion kann als verwendet werden FORMAT Parameter:

  • $(BillingPlanName) – Name des aktuellen Tarifplans
  • $(SubscriptionPrice) – Nettopreis des monatlichen Abonnements
  • $(ItemPrice) – Einzelanfrage Nettokosten außerhalb des Plans im Standardplan
  • $(ItemPriceStatus) – Nettokosten einer einzelnen Anfrage – MIAS / Geschäftsstatus des Unternehmens in einem individuellen Plan
  • $(Limit) – Die maximale Anzahl von Abfragen im Plan
  • $(RequestDelay) – Das minimale Zeitintervall zwischen Anfragen
  • $(DomainLimit) – Maximale Anzahl an Domains (API-Keys)
  • $(OverPlanAllowed) – Möglichkeit, die maximale Anzahl von Abfragen im Plan zu überschreiten
  • $(ExcelAddIn) – Zugriff über das MS-Excel-Add-in
  • $(Stats) – Zugriff auf Statistiken durchgeführter Abfragen
  • $(NIPMonitor) – Zugang zur Überwachung des VIES-Status
  • $(SearchByNIP) – Suche nach EU-Umsatzsteuer-Identifikationsnummer
  • $(FuncGetVIESData) – Zugriff auf Funktionen, die den Entitätsstatus im VIES-System prüfen
  • $(VIESStatusCount) – Anzahl der Anfragen zum Rechtsträgerstatus im MIAS-System
  • $(TotalCount) – Gesamtzahl der im aktuellen Monat ausgeführten Abfragen

Standard-FORMAT: "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)"

Wenn die Zeichenfolge "JSON" wird als angegeben FORMAT -Parameter liefert die Funktion das komplette Ergebnis in Form eines JSON-Strings zurück, der frei geparst und weiterverarbeitet werden kann.

Weitere nützliche Funktionen (kostenlos)

VIESAPI.ACCOUNT.STATUS.TOTAL() – Die Funktion liefert Informationen über die Gesamtzahl der Anfragen, die im aktuellen Abrechnungsmonat für ein bestimmtes Konto (alle API-Schlüssel) getätigt wurden. Gibt genau die gleiche Zahl zurück wie die $(TotalCount) Etikett in der VIESAPI.STATUS.ACCOUNT() Funktion.

VIESAPI.ACCOUNT.STATUS.LIMIT() – Die Funktion gibt Informationen über die maximale Anzahl verfügbarer Abfragen in dem vom Benutzer ausgewählten Plan zurück. Gibt genau die gleiche Zahl zurück wie die $(Limit) eintaggen VIES.STATUS.ACCOUNT() Funktion

VIESAPI.EUVAT.NORM() – Diese Funktion korrigiert und formatiert die EU-Umsatzsteuernummer (entfernt Leerzeichen und Bindestriche usw.) offline und ruft keine Daten von VIES ab:

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

VIESAPI.EUVAT.VALID() – Die Funktion prüft offline nur die Korrektheit (Syntax, Prüfsumme) der EU-Umsatzsteuernummer und ruft keine Daten aus dem VIES-System ab. Kehrt zurück TRUE ob die Nummer gültig ist oder FALSE wenn es nicht gültig ist:

=VIESAPI.EUVAT.VALID("PL7171642051")

VIESAPI.CONNECTION.STATE() – Die Funktion gibt den aktuellen Status der Add-In-Konfiguration zurück.

Wenn die Funktion den folgenden Wert zurückgibt, bedeutet dies unter anderem, dass die ID und API key wurden nicht gespeichert:

ERROR: Connection requires configuration

Nach dem Speichern der API ID und key, sollte die Funktion die folgende Meldung zurückgeben:

SUCCESS: Production