Introduktion

Med VIES Checker-applikationen kan du ladda vilken CSV-fil som helst och kontrollera de enheter (entreprenörer) som visas i den här filen vad gäller deras nuvarande status i VIES-system.

Det släppta programmet har testats framgångsrikt i följande MS Windows-versioner: 7/8/8.1/10 och 11. Applikationen kan installeras i både 32-bitars och 64-bitarsversioner av Windows operativsystem.

Den senaste versionen av VIES Checker-applikationen är alltid tillgänglig för nedladdning från Ladda ner sida.

För att använda applikationen måste du skapa ett konto på viesapi.eu webbplats och generera en nyckel och dess identifierare. Processen att registrera och skapa ett konto samt generera nycklar har beskrivits på Dokumentation hemsida.

Aktivering

När du har laddat ner programmet och sparat det på din lokala dator, packa upp ZIP-arkivet. Den portabla versionen av applikationen (viesapi-app-portable.zip) kräver ingen installation och kan köras med ett vanligt användarkonto (det kräver inte administratörsrättigheter). Installationsversionen (viesapi-app-setup.exe) kräver inte heller administratörsbehörighet, och för att installera det kör du bara EXE-filen.

Konfiguration

Efter att ha startat programmet är det nödvändigt att konfigurera inställningarna en gång. För att göra detta, klicka på Settings knappen från huvudmenyn.

I den Identifier fältet, ange värdet som genererades när du skapade ett konto på viesapi.eu portal - API Keys flik, Identifier kolumn. Men i Key fältet, ange värdet som genererades när du skapade ett konto på viesapi.eu portal - API Keys flik, Key kolumn.

vies checker api nyckel konfiguration

Fliken Alternativ har tre standardalternativ:

  • Check for updates when the application starts – Den här inställningen aktiverar automatisk kontroll efter nya versioner när programmet startas.
  • Normalize the format of VAT numbers when loading data – Det här alternativet möjliggör normalisering av EU-momsregistreringsnummer i CSV-filen.
  • Use batch checking when applicable – om du väljer det här alternativet tillämpas batchläge på poster där felet "Det maximala antalet samtidiga frågor för denna medlemsstat har uppnåtts" (MS_MAX_CONCURRENT_REQ) inträffade

Om anslutningen till Internet görs med en proxyserver, gå till Proxy HTTP fliken, välj Connect via the proxy server option below och fyll i fälten med lämpliga uppgifter.

Huvudmenybeskrivning

Bilden nedan visar knapparna som är tillgängliga i huvudprogrammets meny:

VIES-kontrollprogrammets meny

Load file – låter dig välja en textfil i CSV formatera. Radformatet är vatEU [, företagsnamn], där:

  • vatEU – EU-momsnummer på grundval av vilket enhetens verifiering kommer att utföras,
  • companyName - Företagsnamn (ej obligatorisk)

I fallet med en CSV-fil, vatEU fältet är obligatoriskt och companyName fältet är ett valfritt fält och behöver inte finnas. Registeret får endast innehålla EU-momsnummer.

Enligt CSV-formatet måste textfält omges av citattecken och avgränsas med kommatecken, t.ex.: "PL7171642051", "CompanyXYZ"

Delete selected – Tar bort alla markerade rader.

Delete all – Tar bort alla laddade rader från CSV-filen.

Start checking – knappen startar verifieringen av alla valda kontroller. Skattebetalarens VIES-status kan verifieras för enheter som är registrerade i en av EU:s medlemsstater.

Save results – genom att trycka på knappen kan du spara resultaten av kontrollerna i en XLS (Microsoft Excel) eller text CSV-fil.

Settings – tar fram fliken för inmatning av identifierare och nyckel.

Manage your account – genom att trycka på knappen kan du snabbt gå till inloggningssidan till viesapi.eu-portalen.

Documentation – genom att klicka på länken omdirigeras du till denna dokumentation.

Contact genom att trycka på knappen kan du automatiskt skapa ett e-postmeddelande.

Check for updatelåter dig kontrollera om en ny version av applikationen är tillgänglig. Det här alternativet är endast tillgängligt i installationsversionen (setup.exe).

Kontrollera entiteterna som sparats i CSV-filen

För att kontrollera enheterna som är registrerade i CSV-filen, utför:

  1. Öppna CSV-filen och ladda dess innehåll med hjälp av Load file knapp.
  2. För att utföra kontrollen, tryck på Start checking knapp.

Ett fönster kommer att visas som informerar om hur kontrollprocessen fortskrider:

vies bulkverifieringSom du kan se i skärmdumpen ovan är applikationen väldigt snabb, eftersom den verifierade över 2 000 poster i VIES på mindre än 20 minuter. Vilket ger en prestanda på 1,6 frågor per sekund. Du måste dock veta att applikationsprestanda beror mest på tillgängligheten och stabiliteten hos själva VIES-systemet.

Viktigt meddelande: En mycket viktig funktion är möjligheten att skicka in förfrågningar automatiskt om The maximum number of concurrent requests has been reached (MS_MAX_CONCURRENT_REQ) fel uppstår. Detta är ett mycket vanligt fel vid verifiering av entreprenörer från Tyskland, Frankrike, Tjeckien, Danmark och ibland Belgien. Du kan läsa mer om detta problem i vår bloggartikel:  [LÖST] VIES-FEL: ”Maximalt antal samtidiga förfrågningar har uppnåtts”. För att undvika problemet implementerar programmet en mekanism för batchbaserad, asynkron inlämning av förfrågningar som inte hanterades korrekt av VIES första gången på grund av felet som beskrivs ovan. Efter att den första kontrollomgången har slutförts samlar applikationen in alla EU-momsregistreringsnummer för vilka ovanstående fel returnerades, genererar batcher för dem och skickar dem till VIES för batchverifiering av momsaktivitetsstatus.

När kontrollen är slutförd aktiveras förhandsvisningen i programmets högra panel om du väljer en specifik rad (Details flik):

vies bulkkontroll app

De erhållna resultaten kan filtreras genom att skriva in söktexten i fältet under namnet på en viss kolumn eller sparas i en XLS (Microsoft Excel) eller CSV-textfil genom att trycka på Save results knapp.

Du kan också gå till Account fliken när som helst, där du hittar:

  • Information om den aktiva planen.
  • Lista över tillgängliga funktioner i den nuvarande planen.
  • Statistik relaterad till frågor utförda sedan början av månaden.

vies valideringsapp - konto