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