De viesapi-cli.exe Klientapplikationen möjliggör snabb och automatisk kontroll av enheter (leverantörer) från kommandoradsnivå (CLI/CMD) avseende deras aktuella status i VIES-systemet. Applikationen låter dig också spara nedladdad data till en fil i 3 format:

  • JSON
  • PROP (lista över egenskaper i form av nyckel = värde)
  • XML

Applikationen har testats framgångsrikt i följande versioner av MS Windows: XP, 7, 10 och 11. Den senaste versionen av applikationen finns alltid tillgänglig för nedladdning från Ladda ner sida.

Applikationens fulla funktionalitet kan kontrolleras – utan att behöva skapa ett konto – med hjälp av det medföljande Testa API

För att använda tillägget i produktions-API:et måste du skapa ett konto på webbplatsen viesapi.eu, köpa ett minimum av affärsplanen och generera en API-nyckel och API-nyckelidentifierare.

Processen att registrera och skapa ett konto samt generera nycklar har beskrivits på Dokumentation hemsida.

Aktivering

Det delade körbara programmet viesapi-cli.exe kräver ingen installation och behöver inte köras under ett konto med administrativa rättigheter. För att köra programmet, välj Command Prompt ansökan från Start meny eller typ cmd i Search programs and files fältet och tryck på Enter:

Efter att ha startat konsolen, gå till katalogen där zip-filen med viesapi-cli.exe laddades ner och packades upp.

Om du startar programmet utan att ange parametrar visas hjälpfönstret.

Konfiguration

Lansering av viesapi-cli.exe ansökan utan att ange API key ID och API key låter dig fråga testmiljön (mer information om Testa VIES API sida).

För att ansluta till produktionsmiljön är det nödvändigt att anropa viesapi-cli.exe applikation med autentiseringsparametrarna, som är:

  • keyid – parametern ska innehålla API-nyckelidentifieraren (ID) som genereras på kontot på webbplatsen viesapi.eu,
  • key – parametern ska innehålla API-nyckeln (nyckel) som genereras på kontot på webbplatsen viesapi.eu.

Detaljer om generering av identifierare och nyckel beskrivs på Dokumentation sida. Nedan finns ett exempel på anrop av applikationen med autentiseringsparametrar (keyid och key):

viesapi-cli.exe -keyid XXXXXXXXXXXX -key YYYYYYYYYYYY -vies -format xml

Anropssyntax

Syntax för att anropa viesapi-cli.exe programmera:

viesapi-cli.exe <action> [options]

Tillgängliga åtgärder:

-help – beskrivning av programanropsparametrar
-vies – aktuell status för VIES-systemet
-account – status på löpande konto
-data – hämta företagsdata från VIES
-data-parsed – hämta företagsdata från VIES med analyserad data
-batch-upload – ladda upp en batch med momsnummer och få en batchtoken
-batch-download – kontrollera batchresultat och ladda ner data

Tillgängliga alternativ:

-keyid string – API-nyckelidentifierare
-key string – API-nyckel
-euvat number – EU VAT ID-nummer med landsprefix
-token string – batch-tokenvärde
-format type – utdataformattyp (json, prop, xml), standard: json
-file-in path – sökvägen till inmatningsfilen
-file-out path – sökvägen till utdatafilen
-proxy url – HTTP-proxykonfiguration (som URL http://user:password@hostname:port)

Exempel

UPPMÄRKSAMHET! Följande exempel är anpassade till den data som samlats in i testmiljön. För att utföra kontroller av produktionsmiljön, lägg till –keyid och –key parametrar med lämpliga värden för varje fråga.

1. Kontrollerar VIES-systemets aktuella status och visar resultatet som XML:

viesapi-cli.exe -vies -format xml

2. Kontrollerar den aktuella kontostatusen och sparar resultatet till en JSON-fil:

viesapi-cli.exe -account -file-out result.json.

3. Laddar ner företagsdata från VIES och visar resultatet som PROP:

viesapi-cli.exe -data -euvat PL5213003700 -format prop

4. Laddar ner företagets analyserade data från VIES och sparar resultatet till en JSON-fil:

viesapi-cli.exe -data-parsed -euvat PL5213003700 -file-out result.json

5. Laddar upp en batchfil (ett nummer per rad) och tar emot en batchtoken för resultatkontroll:

viesapi-cli.exe -batch-upload -file-in numbers.csv

6. Kontrollerar aktuell batchstatus och sparar resultatet till en JSON-fil:

viesapi-cli.exe -batch-download -token 1fd853a5-ac9e-490c-81a1-d4900a9c906c -file-out result.json