Google Sheets™-tilføjelse VIES-validator

Google Sheets™-tilføjelse VIES-validator

vies api google regnearkMed Google Sheets™-tilføjelsen kan du hurtigt og automatisk kontrollere enheder (leverandører) ved hjælp af Google Sheets™-regnearket med hensyn til deres aktuelle status i VIES system.

Denne dokumentation indeholder instruktioner om, hvordan du integrerer Google Sheets™-applikationen med VIES API-systemet.

 

 

Installation og konfiguration

Installation

Efter at have åbnet Google Workspace Marketplace-webstedet https://workspace.google.com/marketplace/app/vies_api_eu_vat_validation/1043052728267, klik på Install knap.

installation af VIES API til Google Sheets-tilføjelsesprogram

Valg af den Google-konto, som VIES Validator Google Sheets-tilføjelsen skal installeres og være tilgængelig for:

vies api google sheets tilføjelseskonto installation

På den næste skærm kan du læse Fortrolighedspolitik og den gældende Servicevilkår, samt omfanget af dine data, som vi behandler. For at fortsætte til næste trin i installationen skal du trykke på Continue knap.

tilladelser til installation af tilføjelser i Vies API i Google Sheets

Bekræft, at du har givet de nødvendige tilladelser til, at tilføjelsen fungerer korrekt, og tryk på Allow knap:

Vies API tilladelser til installation af tilføjelsesprogrammer i Google Sheets

VIES Validation-tilføjelsen er blevet installeret på din konto og vil være tilgængelig, når du har startet Google Sheets under fanen Udvidelser. For at fortsætte, klik venligst Next:

VIES API google sheets tilføjelsesudvidelse installation

Det sidste skærmbillede i installationsprogrammet vil bede dig om at konfigurere tilføjelsesprogrammet. Klik på “Complete additional setup now""-linket åbner et nyt browservindue med den aktuelle dokumentationsside. Klik på Done knappen og begynd at konfigurere tilføjelsen som beskrevet i afsnittet Konfiguration.

Vies API Google Sheets-tilføjelse installeret

Konfiguration

Efter installationen er pluginnet indstillet til testmiljøet som standard (flere detaljer om Test API side). For at kunne aktivere funktioner i produktionsmiljøet er det nødvendigt at konfigurere adgangen til viesapi.eu-webstedet én gang. For at gøre dette skal du gå til et hvilket som helst Google Sheets™-regneark og udføre funktionen:

=VIESAPI_CONNECT_PRODUCTION("identifier";"key")

hvor funktionsparametrene er:

  • identifier – parameteren skal indeholde identifikatoren (ID) genereret på kontoen på webstedet viesapi.eu,
  • key – parameteren skal indeholde den nøgle, der er genereret på kontoen på webstedet viesapi.eu.

Detaljer om generering af identifikator og nøgle er beskrevet på Dokumentation internet side.

For at verificere rigtigheden af forbindelsen med en given API (test eller produktion), skal følgende funktion udføres:

=VIESAPI_CONNECT_STATUS()

Som kan returnere værdier:

  • SUCCESS: Production – hvis tilføjelsesprogrammet er korrekt konfigureret til at arbejde med produktionsmiljøet,
  • SUCCESS: Test – hvis tilføjelsesprogrammet er korrekt konfigureret til at arbejde med testmiljø,
  • ERROR: Connection requires configuration – i tilfælde af en forkert konfiguration.

Hvis du foretrækker en sidebarkonfiguration, skal du klikke på Extensions fanen, og vælg derefter VIES API - EU VAT Validation og klik endelig Show sidebar for at aktivere sidebjælken:

vies api google sheets tilføjelsessidekonfiguration

Gå derefter til ID and Key fanen for at indtaste ID og Key i de relevante tekstfelter, som er tilgængelige efter login på din VIES API-konto: https://viesapi.eu/sign-in/

konfigurations-id og nøgle for vies api til google sheets-tilføjelser

Brug

Før du bruger tilføjelsen, bør du gøre dig bekendt med de specifikke funktioner i dens funktion:

  • Alle funktionskald udføres i asynkron tilstand, hvilket ikke forårsager den fastfrysende effekt (intet svar) fra Google Sheets™-applikationen.
  • Tilføjelse (indsættelse) af en række eller kolonne opdaterer ikke alle definerede funktionskald.
  • Kopiering eller flytning af celler, der indeholder funktioner, opdaterer ikke definerede funktionskald.
  • Hvis du sletter en række eller kolonne, opdateres alle definerede funktionskald, og forespørgsler sendes til viesApi.eu (kun i tilfælde af standardindstillinger for Google Sheets™). Beskrivelsen af ændring af standardindstillingerne findes i kapitlet Konfiguration.
  • Bemærk! Det anbefales ikke at køre mere end 500 parallelle forespørgsler, da Google Sheets™ har problemer med at håndtere et stort antal asynkrone kald.

Få virksomhedsdata fra VIES

VIESAPI_VIES_DATA() – Funktionen henter alle tilgængelige virksomhedsdata direkte fra VIES-systemet. Parametrene skal være:

  • Europæisk skatteidentifikationsnummer (VAT EU),
  • (valgfri) FORMAT af de returnerede data (se: Tags, der kan bruges som FORMAT parameter).

=VIESAPI_VIES_DATA("PL7171642051")

Hvis du kun har brug for virksomhedsstatus i VIES, skal du bruge følgende forespørgsel:

=VIESAPI_VIES_DATA("PL7171642051";"$(Valid)")

Hvis den returnerede status er Ja, betyder det, at virksomheden har et gyldigt EU-momsnummer.

Tags tilgængelige i VIESAPI_VIES_DATA funktion, der kan bruges som FORMAT parameter:

  • $(UID) – unik identifikator genereret af viesApi.eu-tjenesten
  • $(CountryCode) – landekode
  • $(VATNumber) – europæisk momsnummer
  • $(Valid) – svar fra VIES-tjenesten, der informerer om den kontrollerede virksomheds aktuelle EU-momsstatus (Yes/No)
  • $(TraderName) – virksomhedens registreringsnavn
  • $(TraderCompanyType) – virksomhedstype
  • $(TraderAddress) – den erhvervsdrivendes adresse, hvor virksomheden er registreret
  • $(ID) – unik identifikator genereret af VIES-systemet (konsultationsnummer)
  • $(Date) – datoen hvor svaret blev genereret
  • $(Source) – datakilden

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

Hvis strengen "JSON" er givet som FORMAT parameter, vil funktionen returnere det komplette resultat i form af en JSON-streng, som frit kan parses og behandles videre:

=VIESAPI_VIES_DATA("PL7171642051";"JSON")

Hent analyserede virksomhedsdata fra VIES

VIESAPI_VIES_DATA_PARSED() – Funktionen henter alle tilgængelige virksomhedsdata direkte fra VIES-systemet. Derudover returneres virksomhedens navn og adresse som parsede data opdelt i separate attributter. Parametrene skal være:

  • Europæisk skatteidentifikationsnummer (VAT EU),
  • (valgfri) FORMAT af de returnerede data (se: Tags, der kan bruges som FORMAT parameter).

=VIESAPI_VIES_DATA_PARSED("PL7171642051")

Hvis du kun har brug for virksomhedsstatus i VIES, skal du bruge følgende forespørgsel:

=VIESAPI_VIES_DATA_PARSED("PL7171642051";"$(Valid)")

Hvis den returnerede status er Ja, betyder det, at virksomheden har et gyldigt EU-momsnummer.

Tags tilgængelige i VIESAPI_VIES_DATA_PARSED funktion, der kan bruges som FORMAT parameter:

  • $(UID) – unik identifikator genereret af viesApi.eu-tjenesten
  • $(CountryCode) – landekode
  • $(VATNumber) – europæisk momsnummer
  • $(Valid) – svar fra VIES-tjenesten, der informerer om den kontrollerede virksomheds aktuelle EU-momsstatus (Yes/No)
  • $(TraderName) – virksomhedens registreringsnavn
  • $(TraderNameComponents.Name) – firmanavn fra traderName (uden juridisk form)
  • $(TraderNameComponents.LegalForm) – navn på juridisk form udtrukket fra traderName (uden firmanavn)
  • $(TraderNameComponents.LegalFormCanonicalId) – ordbogsidentifikator for juridisk form
  • $(TraderNameComponents.LegalFormCanonicalName) – ordbogsnavn på juridisk form
  • $(TraderCompanyType) – virksomhedstype
  • $(TraderAddress) – den erhvervsdrivendes adresse, hvor virksomheden er registreret
  • $(TraderAddressComponents.Country) – navnet på det erhvervsdrivende land på dets nationale sprog
  • $(TraderAddressComponents.PostalCode) – postnummeret på den erhvervsdrivendes adresse
  • $(TraderAddressComponents.City) – den erhvervsdrivendes adresse i byen
  • $(TraderAddressComponents.Street) – gade på den erhvervsdrivendes adresse
  • $(TraderAddressComponents.StreetNumber) – gadenummeret på den erhvervsdrivendes adresse
  • $(TraderAddressComponents.HouseNumber) – lejligheds-/kontornummer på den erhvervsdrivendes adresse
  • $(TraderAddressComponents.Other) – andre adresseoplysninger (områdenavn, bygningsnavn, etagenummer osv.)
  • $(ID) – unik identifikator genereret af VIES-systemet (konsultationsnummer)
  • $(Date) – datoen hvor svaret blev genereret
  • $(Source) – datakilden

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

Hvis strengen "JSON" er givet som FORMAT parameter, vil funktionen returnere det komplette resultat i form af en JSON-streng, som frit kan parses og behandles videre:

=VIESAPI_VIES_DATA_PARSED("PL7171642051";"JSON")

Kontrol af brugerkontostatus (gratis)

VIESAPI_ACCOUNT_STATUS() – Funktionen returnerer grundlæggende oplysninger om den plan, der aktuelt bruges af brugeren. Parametrene skal være:

  • (valgfri) FORMAT af de returnerede data (se: Tags, der kan bruges som FORMAT parameter)

=VIESAPI_ACCOUNT_STATUS()

Opmærksomhed! Kaldning af funktionen øger ikke antallet af forespørgsler.

De tags, der er tilgængelige i VIESAPI_ACCOUNT_STATUS funktionen kan bruges som FORMAT parameter:

  • $(UID) – unik identifikator genereret af viesApi.eu-tjenesten
  • $(BillingPlanName) – navnet på den nuværende plan
  • $(SubscriptionPrice) – månedligt abonnementsgebyr
  • $(ItemPrice) – omkostningerne ved en enkelt forespørgsel uden for planen
  • $(ItemPriceStatus) – pris pr. forespørgsel – moms/VIES/virksomhedsaktivitetsstatus
  • $(ItemPriceParsed) – pris pr. forespørgsel – moms/VIES/virksomhedsaktivitetsstatus med analyserede data
  • $(Limit) – maksimalt antal forespørgsler i planen
  • $(RequestDelay) – minimum tidsinterval mellem forespørgsler
  • $(DomainLimit) – maksimalt antal domæner (API-nøgler)
  • $(OverPlanAllowed) – mulighed for at overskride det maksimale antal forespørgsler i planen
  • $(ExcelAddIn) – adgang til Google Sheets™ og Microsoft Excel™ tilføjelsesprogrammet
  • $(Stats) – adgang til forespørgselsstatistik
  • $(NIPMonitor) – adgang til overvågning af virksomheders status: moms/VIES/aktivitetsstatus
  • $(FuncGetVIESData) – adgang til funktioner, der verificerer virksomhedens status i VIES-systemet
  • $(FuncGetVIESDataParsed) – adgang til funktioner, der verificerer virksomhedens status i VIES-systemet og analyserer den erhvervsdrivendes navn og adresse
  • $(VIESDataCount) – antal VIES-forespørgsler udført i denne måned
  • $(VIESDataParsedCount) – antal VIES-forespørgsler med parsede data udført i denne måned
  • $(TotalCount) – det samlede antal forespørgsler udført i denne måned

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)"

Hvis strengen "JSON" er givet som FORMAT parameter, vil funktionen returnere det komplette resultat i form af en JSON-streng, som frit kan parses og behandles videre.

Statuskontrol af VIES-systemet (gratis)

VIESAPI_VIES_STATUS() – Denne funktion giver dig mulighed for at verificere VIES-systemets aktuelle status. Den returnerer en samlet status, der angiver tilgængelighed, samt en liste over individuelle medlemslande sammen med den aktuelle tilgængelighedsstatus for deres nationale systemer. Parametrene skal være:

  • (valgfri) FORMAT af de returnerede data (se: Tags, der kan bruges som FORMAT parameter)

=VIESAPI_VIES_STATUS()

Opmærksomhed! Kaldning af funktionen øger ikke antallet af forespørgsler.

De tags, der er tilgængelige i VIESAPI_VIES_STATUS funktionen kan bruges som FORMAT parameter:

  • $(UID) – unik identifikator genereret af viesApi.eu-tjenesten
  • $(Available) – VIES-systemets nuværende tilgængelighed (Tilgængelig, Delvist tilgængelig, Ikke tilgængelig)
  • $(Countries) – liste over de enkelte medlemslandes stater (tilgængelig, ikke tilgængelig)
  • $(AT), $(FR), $(PL), etc. – tilgængelighedsstatus for et specifikt medlemsland (brug landekode på 2 bogstaver med store bogstaver som tagværdi)

Standard FORMAT: "$(Available)"

Hvis strengen "JSON" er givet som FORMAT parameter, vil funktionen returnere det komplette resultat i form af en JSON-streng, som frit kan parses og behandles videre.

Andre nyttige funktioner (gratis)

VIESAPI_ACCOUNT_STATUS_TOTAL() – Funktionen returnerer information om det samlede antal forespørgsler foretaget i den aktuelle faktureringsmåned for en given konto (alle API-nøgler). Returnerer nøjagtigt det samme tal som $(TotalCount) tag i VIESAPI_STATUS_ACCOUNT() fungere.

VIESAPI_ACCOUNT_STATUS_LIMIT() – Funktionen returnerer information om det maksimale antal forespørgsler, der er tilgængelige i planen valgt af brugeren. Returnerer nøjagtigt det samme tal som $(Limit) tag ind VIES.STATUS.ACCOUNT() fungere

VIESAPI_EUVAT_NORM() – Denne funktion retter og formaterer EU-momsnummer (fjerner mellemrum og bindestreger osv.) offline og henter ingen data fra VIES:

=VIESAPI_EUVAT_NORM("PL 717-164-20-51")

VIESAPI_EUVAT_VALID() – Funktionen kontrollerer kun rigtigheden (syntaks, kontrolsum) af EU-momsnummeret offline og henter ingen data fra VIES-systemet. Vender tilbage TRUE hvis nummeret er gyldigt eller FALSE hvis det ikke er gyldigt:

=VIESAPI_EUVAT_VALID("PL7171642051")

VIESAPI_CONNECTION_STATE() – Funktionen returnerer den aktuelle status for tilføjelseskonfigurationen.

Hvis funktionen returnerer følgende værdi, betyder det blandt andet, at ID og API key blev ikke gemt:

ERROR: Connection requires configuration

Efter at have gemt API ID og key, skal funktionen returnere følgende meddelelse:

SUCCESS: Production

Google Sheets™ er et varemærke tilhørende Google LLC.