Google Sheets™ Add-on VIES Validator

Google Sheets™ Add-on VIES Validator

Google Sheets API verwendenDas Google Sheets™-Add-on ermöglicht es Ihnen, mithilfe der Google Sheets™-Tabelle schnell und automatisch den aktuellen Status von Entitäten (Auftragnehmern) zu überprüfen. VIES-System.

Diese Dokumentation enthält Anweisungen zur Integration der Google Sheets™-Anwendung in das VIES API-System.

 

 

Installation und Konfiguration

Installation

Nach dem Aufrufen der Google Workspace Marketplace-Website https://workspace.google.com/marketplace/app/vies_api_eu_vat_validation/1043052728267, drücke den Install Taste.

Installation des Google Sheets-Add-ons mit der Vies-API

Auswahl des Google-Kontos, für das das VIES Validator Google Sheets Add-on installiert und verfügbar sein soll:

vies API Google Sheets Add-on installieren Konto

Auf dem nächsten Bildschirm können Sie Folgendes lesen: Datenschutz-Bestimmungen und die anwendbaren Nutzungsbedingungensowie den Umfang Ihrer Daten, die wir verarbeiten werden. Um mit dem nächsten Installationsschritt fortzufahren, drücken Sie die entsprechende Taste. Continue Taste.

Berechtigungen für die Installation des Google Sheets-Add-ons über die API

Vergewissern Sie sich, dass Sie die erforderlichen Berechtigungen für die ordnungsgemäße Funktion des Add-ons erteilt haben, und drücken Sie die entsprechende Taste. Allow Taste:

Berechtigungen für die Installation des Google Sheets-Add-ons über die API zulassen

Das VIES-Validierungs-Add-on wurde erfolgreich auf Ihrem Konto installiert und ist nach dem Start von Google Sheets auf der Registerkarte „Erweiterungen“ verfügbar. Um fortzufahren, klicken Sie bitte hier. Next:

vies API Google Sheets Add-on-Erweiterung installieren

Im letzten Bildschirm des Installationsprogramms werden Sie aufgefordert, das Add-on zu konfigurieren. Durch Klicken auf „Complete additional setup nowDer Link „“ öffnet ein neues Browserfenster mit der aktuellen Dokumentationsseite. Klicken Sie auf den Link „“. Done Klicken Sie auf die Schaltfläche und beginnen Sie mit der Konfiguration des Add-ons, wie im Abschnitt „Konfiguration“ beschrieben.

Das Google Sheets-Add-on „vies api“ ist installiert.

Aufbau

Nach der Installation ist das Plugin standardmäßig auf die Testumgebung eingestellt (mehr Details auf API testen Um Funktionen in der Produktionsumgebung aufrufen zu können, muss der Zugriff auf die Website viesapi.eu einmalig konfiguriert werden. Gehen Sie dazu in eine beliebige Google Sheets™-Tabelle und führen Sie die folgende 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.

Wenn Sie eine Seitenleistenkonfiguration bevorzugen, klicken Sie auf die Schaltfläche Extensions Drücken Sie die Tabulatortaste und wählen Sie dann aus VIES API - EU VAT Validation und schließlich klicken Show sidebar Um die Seitenleiste zu aktivieren:

Seitenleiste des Google Sheets-Add-ons mit API-Konfiguration

Dann geh zu ID and Key Drücken Sie die Tabulatortaste, um die Eingabe zu starten. ID und Key in den entsprechenden Textfeldern, die nach dem Einloggen in Ihr VIES-API-Konto verfügbar sind: https://viesapi.eu/sign-in/

vies API Google Sheets Add-on Konfigurations-ID und Schlüssel

Verwendungszweck

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

  • Alle Funktionsaufrufe werden im asynchronen Modus ausgeführt, wodurch das Einfrieren (keine Reaktion) der Google Sheets™-Anwendung vermieden wird.
  • 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 Anfragen an viesApi.eu (nur bei den Standardeinstellungen von Google Sheets™). Die Beschreibung zum Ändern der Standardeinstellungen finden Sie im Kapitel „Konfiguration“.
  • Achtung! Es wird nicht empfohlen, mehr als 500 parallele Abfragen auszuführen, da Google Sheets™ Probleme mit der Verarbeitung einer großen Anzahl asynchroner Aufrufe hat.

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ändervorwahl
  • $(VATNumber) – europäische Umsatzsteuer-Identifikationsnummer
  • $(Valid) – Antwort des VIES-Dienstes, die über den aktuellen EU-Mehrwertsteuerstatus des geprüften Unternehmens informiert (Yes/No)
  • $(TraderName) – Firmenname
  • $(TraderCompanyType) – Unternehmensart
  • $(TraderAddress) – Adresse des Händlers, an der das Unternehmen registriert ist
  • $(ID) – vom MIAS-System generierte eindeutige Kennung (Konsultationsnummer)
  • $(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")

Erhalten Sie analysierte Unternehmensdaten von VIES

VIESAPI_VIES_DATA_PARSED() – Die Funktion ruft alle verfügbaren Unternehmensdaten direkt aus dem MIAS-System ab. Zusätzlich werden Firmenname und -adresse als analysierte Daten zurückgegeben, die in einzelne Attribute aufgeteilt sind. Die Parameter sollten lauten:

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

=VIESAPI_VIES_DATA_PARSED("PL7171642051")

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

=VIESAPI_VIES_DATA_PARSED("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_PARSED Funktion, die als verwendet werden kann FORMAT Parameter:

  • $(UID) – eindeutige Kennung, die vom Dienst viesApi.eu generiert wird
  • $(CountryCode) – Ländervorwahl
  • $(VATNumber) – europäische Umsatzsteuer-Identifikationsnummer
  • $(Valid) – Antwort des VIES-Dienstes, die über den aktuellen EU-Mehrwertsteuerstatus des geprüften Unternehmens informiert (Yes/No)
  • $(TraderName) – Firmenname
  • $(TraderNameComponents.Name) – Firmenname von traderName (ohne Rechtsform)
  • $(TraderNameComponents.LegalForm) – Name der Rechtsform aus „traderName“ (ohne Firmennamen)
  • $(TraderNameComponents.LegalFormCanonicalId) – Wörterbuchkennung der Rechtsform
  • $(TraderNameComponents.LegalFormCanonicalName) – Wörterbuchname der Rechtsform
  • $(TraderCompanyType) – Unternehmensart
  • $(TraderAddress) – Adresse des Händlers, an der das Unternehmen registriert ist
  • $(TraderAddressComponents.Country) – Name des Händlerlandes in seiner Landessprache
  • $(TraderAddressComponents.PostalCode) – Postleitzahl der Adresse des Händlers
  • $(TraderAddressComponents.City) – Ort der Adresse des Händlers
  • $(TraderAddressComponents.Street) – Straße der Adresse des Händlers
  • $(TraderAddressComponents.StreetNumber) – Straße und Hausnummer der Adresse des Händlers
  • $(TraderAddressComponents.HouseNumber) – Wohnungs-/Büronummer der Adresse des Händlers
  • $(TraderAddressComponents.Other) – sonstige Adressdaten (Gebietsname, Gebäudename, Stockwerk usw.)
  • $(ID) – vom MIAS-System generierte eindeutige Kennung (Konsultationsnummer)
  • $(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_PARSED("PL7171642051";"JSON")

Statusprüfung des Benutzerkontos (kostenlos)

VIESAPI_ACCOUNT_STATUS() – 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_ACCOUNT_STATUS()

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

Die verfügbaren Tags in der VIESAPI_ACCOUNT_STATUS Funktion kann als verwendet werden FORMAT Parameter:

  • $(UID) – eindeutige Kennung, die vom Dienst viesApi.eu generiert wird
  • $(BillingPlanName) – Name des aktuellen Plans
  • $(SubscriptionPrice) – monatliche Abonnementgebühr
  • $(ItemPrice) – Kosten einer einzelnen Abfrage außerhalb des Plans
  • $(ItemPriceStatus) – Kosten pro Abfrage – MwSt./MIAS/Unternehmensaktivitätsstatus
  • $(ItemPriceParsed) – Kosten pro Abfrage – MwSt./VIES/Unternehmensaktivitätsstatus mit analysierten Daten
  • $(Limit) – maximale Anzahl von Abfragen im Plan
  • $(RequestDelay) – Mindestzeitintervall zwischen Abfragen
  • $(DomainLimit) – maximale Anzahl von Domänen (API-Schlüssel)
  • $(OverPlanAllowed) – Möglichkeit, die maximale Anzahl von Abfragen im Plan zu überschreiten
  • $(ExcelAddIn) – Zugriff auf das Google Sheets™- und Microsoft Excel™-Add-in
  • $(Stats) – Zugriff auf Abfragestatistiken
  • $(NIPMonitor) – Zugang zur Überwachung des Unternehmensstatus: MwSt./MIAS/Aktivitätsstatus
  • $(FuncGetVIESData) – Zugriff auf Funktionen zur Überprüfung des Unternehmensstatus im VIES-System
  • $(FuncGetVIESDataParsed) – Zugriff auf Funktionen, die den Unternehmensstatus im VIES-System überprüfen und den Namen und die Adresse des Händlers analysieren
  • $(VIESDataCount) – Anzahl der in diesem Monat durchgeführten VIES-Abfragen
  • $(VIESDataParsedCount) – Anzahl der MIAS-Abfragen mit analysierten Daten, die in diesem Monat durchgeführt wurden
  • $(TotalCount) – Gesamtzahl der in diesem Monat durchgefü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.

Statusprüfung des VIES-Systems (kostenlos)

VIESAPI_VIES_STATUS() – Mit dieser Funktion können Sie den aktuellen Status des MIAS-Systems überprüfen. Sie gibt einen Gesamtstatus mit Verfügbarkeitsangaben sowie eine Liste der einzelnen Mitgliedsländer mit dem aktuellen Verfügbarkeitsstatus ihrer nationalen Systeme zurück. Die Parameter sollten lauten:

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

=VIESAPI_VIES_STATUS()

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

Die verfügbaren Tags in der VIESAPI_VIES_STATUS Funktion kann als verwendet werden FORMAT Parameter:

  • $(UID) – eindeutige Kennung, die vom Dienst viesApi.eu generiert wird
  • $(Available) – aktuelle Verfügbarkeit des VIES-Systems (Verfügbar, Teilweise verfügbar, Nicht verfügbar)
  • $(Countries) – Liste der Staaten der einzelnen Mitgliedsländer (Verfügbar, Nicht verfügbar)
  • $(AT), $(FR), $(PL), etc. – Verfügbarkeitsstatus eines bestimmten Mitgliedslandes (verwenden Sie als Tag-Wert einen zweistelligen Ländercode in Großbuchstaben)

Standard-FORMAT: "$(Available)"

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

Google Sheets™ ist eine Marke von Google LLC.