Klientapplikationen viesClient.exe möjliggör snabb och automatisk kontroll av enheter (entreprenörer) från kommandoradsnivån (CLI / CMD) vad gäller deras nuvarande status i VIES-systemet. Applikationen låter dig också spara nedladdade data till en fil i tre format:
- JSON (standardvisningsformat till stdout)
- XML
- MAP (attributmappsnyckel = värde)
Applikationen har testats framgångsrikt i följande versioner av MS Windows: XP, 7 och 10.
Den senaste versionen av applikationen är 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 viesClient.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 viesClient.exe
laddades ner och packades upp.
Om du startar programmet utan att ange parametrar visas hjälpfönstret.
Konfiguration
Lansering av viesClient.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 viesClient.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
):
viesClient.exe -keyid XXXXXXXXXXXX -key YYYYYYYYYYYY -vies -euvat PL7171642051
.
Anropssyntax
Syntax för att anropa programmet viesClient.exe:
viesClient.exe <action>
.
Tillgängliga åtgärder :
-help
– beskrivning av programanropsparametrar
-account
– returnerar information om bytesbalansen för viesapi.eu
-vies
– få företagsdata från VIES.
Tillgängliga alternativ [alternativ]:
-keyid string
– API-nyckelidentifierare
-key string
– API-nyckel
-euvat number
– EU VAT ID-nummer med landsprefix
– format för returnerad data (JSON, MAP, XML), standard: JSON
-format type
– namn och sökväg till resultatfilen, standard: viesClient.exe körkatalog
-file path
– HTTP-proxykonfiguration (som URL
-proxy urlhttp://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. Ladda ner företagsdata från VIES och visa resultatet på konsolen i MAP-format:
viesClient.exe -vies -euvat PL5213003700 -map format
2. Visa information om aktuell kontostatus:
viesClient.exe -account
.
3. HTTP-proxyinställning:
viesClient.exe -vies -euvat PL7272445205 -proxy http://user:password@10.0.0.1:8080