Google Sheets™-tillägg VIES-validator

Google Sheets™-tillägg VIES-validator

vies api google kalkylarkMed Google Sheets™-tillägget kan du snabbt och automatiskt kontrollera enheter (entreprenörer) med hjälp av Google Sheets™-kalkylbladet vad gäller deras aktuella status i VIES-system.

Den här dokumentationen innehåller instruktioner om hur du integrerar Google Sheets™-applikationen med VIES API-systemet.

 

 

Installation och konfiguration

Installation

Efter att du har öppnat Google Workspace Marketplace-webbplatsen https://workspace.google.com/marketplace/app/vies_api_eu_vat_validation/1043052728267, Klicka på Install knapp.

installation av tillägg för VIES API för Google Sheets

Välja det Google-konto för vilket VIES Validator Google Sheets-tillägget ska installeras och vara tillgängligt:

vies api google kalkylark tillägg installationskonto

På nästa skärm kan du läsa Integritetspolicy och den tillämpliga Användarvillkor, samt omfattningen av dina uppgifter som vi kommer att behandla. För att gå vidare till nästa steg i installationen, tryck på Continue knapp.

VIES API behörigheter för installation av tillägg i Google Sheets

Bekräfta att du har beviljat nödvändiga behörigheter för att tillägget ska fungera korrekt och tryck på Allow knapp:

vies api google sheets tillägg installationsbehörigheter tillåter

Tillägget VIES Validation har installerats på ditt konto och kommer att vara tillgängligt efter att du har startat Google Sheets på fliken Tillägg. För att fortsätta, vänligen klicka Next:

vies api google kalkylark tillägg installationstillägg

Den sista skärmen i installationsprogrammet uppmanar dig att konfigurera tillägget. Klicka på “Complete additional setup now”-länken öppnar ett nytt webbläsarfönster med den aktuella dokumentationssidan. Klicka på Done knappen och börja konfigurera tillägget enligt beskrivningen i avsnittet Konfiguration.

Vies API Google Sheets-tillägg installerat

Konfiguration

Efter installationen är plugin inställd på testmiljön som standard (mer information om Testa API sida). För att kunna anropa funktioner i produktionsmiljön är det nödvändigt att konfigurera åtkomst till webbplatsen viesapi.eu en gång. För att göra detta, gå till valfritt Google Sheets™-kalkylblad och utför funktionen:

=VIESAPI_CONNECT_PRODUCTION("identifier";"key")

där funktionsparametrarna är:

  • identifier – parametern ska innehålla identifieraren (ID) som genereras på kontot på webbplatsen viesapi.eu,
  • key – parametern ska innehålla nyckeln som genereras på kontot på webbplatsen viesapi.eu.

Detaljer om generering av identifierare och nyckel beskrivs på Dokumentation hemsida.

För att verifiera korrektheten av anslutningen med ett givet API (test eller produktion), bör följande funktion utföras:

=VIESAPI_CONNECT_STATUS()

Som kan returnera värden:

  • SUCCESS: Production – om tillägget är korrekt konfigurerat för att fungera med produktionsmiljön,
  • SUCCESS: Test – om tillägget är korrekt konfigurerat för att fungera med testmiljö,
  • ERROR: Connection requires configuration – vid felaktig konfiguration.

Om du föredrar en sidofältskonfiguration klickar du på Extensions fliken och välj sedan VIES API - EU VAT Validation och klicka slutligen Show sidebar för att aktivera sidofältet:

vies api google sheets tilläggskonfiguration sidofält

Gå sedan till ID and Key flik för att ange ID och Key i lämpliga textfält, som är tillgängliga efter inloggning på ditt VIES API-konto: https://viesapi.eu/sign-in/

konfigurations-ID och nyckel för vies api för google sheets-tillägg

Användande

Innan du använder tillägget bör du bekanta dig med detaljerna för dess funktion:

  • Alla funktionsanrop körs i asynkront läge, vilket inte orsakar frysningseffekten (inget svar) hos Google Sheets™-applikationen.
  • Att lägga till (infoga) en rad eller kolumn uppdaterar inte alla definierade funktionsanrop.
  • Att kopiera eller flytta celler som innehåller funktioner uppdaterar inte definierade funktionsanrop.
  • Om du tar bort en rad eller kolumn uppdateras alla definierade funktionsanrop och frågor skickas till viesApi.eu (endast vid standardinställningar för Google Sheets™). Beskrivningen av hur du ändrar standardinställningarna finns i kapitlet Konfiguration.
  • Observera! Det rekommenderas inte att köra fler än 500 parallella frågor eftersom Google Sheets™ har problem med att hantera ett stort antal asynkrona anrop.

Få företagsdata från VIES

VIESAPI_VIES_DATA() – Funktionen hämtar all tillgänglig företagsdata direkt från VIES-systemet. Parametrarna bör vara:

  • Europeiskt skatteregistreringsnummer (VAT EU),
  • (frivillig) FORMAT av de returnerade uppgifterna (se: Taggar som kan användas som FORMAT parameter).

=VIESAPI_VIES_DATA("PL7171642051")

Om du bara behöver företagsstatus i VIES, använd följande fråga:

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

Om den returnerade statusen är Ja betyder det att företaget har ett giltigt EU-momsnummer.

Taggar tillgängliga i VIESAPI_VIES_DATA funktion som kan användas som FORMAT parameter:

  • $(UID) – unik identifierare genererad av viesApi.eu-tjänsten
  • $(CountryCode) – landskod
  • $(VATNumber) – europeiskt momsregistreringsnummer
  • $(Valid) – svar från VIES-tjänsten, som informerar om det kontrollerade företagets aktuella EU-momsstatus (Yes/No)
  • $(TraderName) – företagets registreringsnamn
  • $(TraderCompanyType) – affärstyp
  • $(TraderAddress) – näringsidkarens adress där företaget är registrerat
  • $(ID) – unik identifierare genererad av VIES-systemet (konsultationsnummer)
  • $(Date) – datumet då svaret genererades
  • $(Source) – källan till uppgifterna

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

Om strängen "JSON" ges som FORMAT parameter, kommer funktionen att returnera det fullständiga resultatet i form av en JSON-sträng, som fritt kan analyseras och bearbetas vidare:

=VIESAPI_VIES_DATA("PL7171642051";"JSON")

Hämta analyserad företagsdata från VIES

VIESAPI_VIES_DATA_PARSED() – Funktionen hämtar all tillgänglig företagsdata direkt från VIES-systemet. Dessutom returneras företagets namn och adress som analyserad data uppdelad i separata attribut. Parametrarna ska vara:

  • Europeiskt skatteregistreringsnummer (VAT EU),
  • (frivillig) FORMAT av de returnerade uppgifterna (se: Taggar som kan användas som FORMAT parameter).

=VIESAPI_VIES_DATA_PARSED("PL7171642051")

Om du bara behöver företagsstatus i VIES, använd följande fråga:

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

Om den returnerade statusen är Ja betyder det att företaget har ett giltigt EU-momsnummer.

Taggar tillgängliga i VIESAPI_VIES_DATA_PARSED funktion som kan användas som FORMAT parameter:

  • $(UID) – unik identifierare genererad av viesApi.eu-tjänsten
  • $(CountryCode) – landskod
  • $(VATNumber) – europeiskt momsregistreringsnummer
  • $(Valid) – svar från VIES-tjänsten, som informerar om det kontrollerade företagets aktuella EU-momsstatus (Yes/No)
  • $(TraderName) – företagets registreringsnamn
  • $(TraderNameComponents.Name) – företagsnamn från traderName (utan juridisk form)
  • $(TraderNameComponents.LegalForm) – namn på juridisk form hämtat från traderName (utan företagsnamn)
  • $(TraderNameComponents.LegalFormCanonicalId) – ordboksidentifierare för juridisk form
  • $(TraderNameComponents.LegalFormCanonicalName) – ordboksnamn på juridisk form
  • $(TraderCompanyType) – affärstyp
  • $(TraderAddress) – näringsidkarens adress där företaget är registrerat
  • $(TraderAddressComponents.Country) – Namnet på näringsidkarens land på dess nationella språk
  • $(TraderAddressComponents.PostalCode) – postnumret för näringsidkarens adress
  • $(TraderAddressComponents.City) – näringsidkarens adressort
  • $(TraderAddressComponents.Street) – gatan för näringsidkarens adress
  • $(TraderAddressComponents.StreetNumber) – gatunummer för näringsidkarens adress
  • $(TraderAddressComponents.HouseNumber) – lägenhets-/kontorsnummer på näringsidkarens adress
  • $(TraderAddressComponents.Other) – andra adressuppgifter (områdesnamn, byggnadsnamn, våningsnummer etc.)
  • $(ID) – unik identifierare genererad av VIES-systemet (konsultationsnummer)
  • $(Date) – datumet då svaret genererades
  • $(Source) – källan till uppgifterna

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

Om strängen "JSON" ges som FORMAT parameter, kommer funktionen att returnera det fullständiga resultatet i form av en JSON-sträng, som fritt kan analyseras och bearbetas vidare:

=VIESAPI_VIES_DATA_PARSED("PL7171642051";"JSON")

Kontroll av användarkontostatus (gratis)

VIESAPI_ACCOUNT_STATUS() – Funktionen returnerar grundläggande information om den plan som för närvarande används av användaren. Parametrarna bör vara:

  • (frivillig) FORMAT av de returnerade uppgifterna (se: Taggar som kan användas som FORMAT parameter)

=VIESAPI_ACCOUNT_STATUS()

Uppmärksamhet! Att anropa funktionen ökar inte antalet förfrågningar.

Taggarna som finns tillgängliga i VIESAPI_ACCOUNT_STATUS funktionen kan användas som FORMAT parameter:

  • $(UID) – unik identifierare genererad av viesApi.eu-tjänsten
  • $(BillingPlanName) – namnet på den nuvarande planen
  • $(SubscriptionPrice) – månadsavgift för prenumeration
  • $(ItemPrice) – kostnad för en enskild förfrågan utanför planen
  • $(ItemPriceStatus) – kostnad per förfrågan – moms/VIES/status för företagsaktivitet
  • $(ItemPriceParsed) – kostnad per fråga – moms/VIES/företagsaktivitetsstatus med analyserad data
  • $(Limit) – maximalt antal frågor i planen
  • $(RequestDelay) – minsta tidsintervall mellan förfrågningar
  • $(DomainLimit) – maximalt antal domäner (API-nycklar)
  • $(OverPlanAllowed) – möjlighet att överskrida det maximala antalet frågor i planen
  • $(ExcelAddIn) – åtkomst till Google Sheets™ och Microsoft Excel™-tilläggen
  • $(Stats) – åtkomst till frågestatistik
  • $(NIPMonitor) – tillgång till övervakning av företagens status: moms/VIES/verksamhetsstatus
  • $(FuncGetVIESData) – åtkomst till funktioner som verifierar företagets status i VIES-systemet
  • $(FuncGetVIESDataParsed) – åtkomst till funktioner som verifierar företagets status i VIES-systemet och analyserar handlarens namn och adress
  • $(VIESDataCount) – antal VIES-förfrågningar som utförts denna månad
  • $(VIESDataParsedCount) – antal VIES-frågor med analyserad data som utförts denna månad
  • $(TotalCount) – totalt antal utförda frågor denna månad

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

Om strängen "JSON" ges som FORMAT parameter, kommer funktionen att returnera det fullständiga resultatet i form av en JSON-sträng, som fritt kan analyseras och bearbetas vidare.

Statuskontroll av VIES-systemet (kostnadsfritt)

VIESAPI_VIES_STATUS() – Den här funktionen låter dig verifiera VIES-systemets aktuella status. Den returnerar en övergripande status som anger tillgänglighet, samt en lista över enskilda medlemsländer tillsammans med den aktuella tillgänglighetsstatusen för deras nationella system. Parametrarna ska vara:

  • (frivillig) FORMAT av de returnerade uppgifterna (se: Taggar som kan användas som FORMAT parameter)

=VIESAPI_VIES_STATUS()

Uppmärksamhet! Att anropa funktionen ökar inte antalet förfrågningar.

Taggarna som finns tillgängliga i VIESAPI_VIES_STATUS funktionen kan användas som FORMAT parameter:

  • $(UID) – unik identifierare genererad av viesApi.eu-tjänsten
  • $(Available) – VIES-systemets nuvarande tillgänglighet (Tillgänglig, Delvis tillgänglig, Ej tillgänglig)
  • $(Countries) – lista över enskilda medlemsländers stater (Tillgänglig, Ej tillgänglig)
  • $(AT), $(FR), $(PL), etc. – tillgänglighetsstatus för ett specifikt medlemsland (använd landskod med två bokstäver i versaler som taggvärde)

StandardFORMAT: "$(Available)"

Om strängen "JSON" ges som FORMAT parameter, kommer funktionen att returnera det fullständiga resultatet i form av en JSON-sträng, som fritt kan analyseras och bearbetas vidare.

Andra användbara funktioner (gratis)

VIESAPI_ACCOUNT_STATUS_TOTAL() – Funktionen returnerar information om det totala antalet förfrågningar gjorda under den aktuella faktureringsmånaden för ett givet konto (alla API-nycklar). Returnerar exakt samma nummer som $(TotalCount) tagga i VIESAPI_STATUS_ACCOUNT() fungera.

VIESAPI_ACCOUNT_STATUS_LIMIT() – Funktionen returnerar information om det maximala antalet förfrågningar som är tillgängliga i planen som valts av användaren. Returnerar exakt samma nummer som $(Limit) tagga in VIES.STATUS.ACCOUNT() fungera

VIESAPI_EUVAT_NORM() – Den här funktionen korrigerar och formaterar EU-momsnummer (tar bort mellanslag och bindestreck etc.) offline och hämtar ingen data från VIES:

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

VIESAPI_EUVAT_VALID() – Funktionen kontrollerar endast korrektheten (syntax, kontrollsumma) för EU-momsnummer offline och hämtar ingen data från VIES-systemet. Returnerar TRUE om numret är giltigt eller FALSE om det inte är giltigt:

=VIESAPI_EUVAT_VALID("PL7171642051")

VIESAPI_CONNECTION_STATE() – Funktionen returnerar aktuell status för tilläggskonfigurationen.

Om funktionen returnerar följande värde betyder det bland annat att ID och API key blev inte sparade:

ERROR: Connection requires configuration

Efter att ha sparat API ID och key, bör funktionen returnera följande meddelande:

SUCCESS: Production

Google Sheets™ är ett varumärke som tillhör Google LLC.