Det viesapi-cli.exe Klientapplikationen muliggør hurtig og automatisk kontrol af enheder (leverandører) fra kommandolinjeniveau (CLI/CMD) med hensyn til deres aktuelle status i VIES-systemet. Applikationen giver dig også mulighed for at gemme de downloadede data til en fil i 3 formater:

  • JSON
  • PROP (liste over egenskaber i form af nøgle = værdi)
  • XML

Applikationen er blevet testet med succes i følgende versioner af MS Windows: XP, 7, 10 og 11. Den seneste version af applikationen kan altid downloades fra Hent side.

Applikationens fulde funktionalitet kan kontrolleres – uden at det er nødvendigt at oprette en konto – ved hjælp af det medfølgende Test API

For at bruge tilføjelsen i produktions-API'en skal du oprette en konto på webstedet viesapi.eu, købe et minimum af forretningsplanen og generere en API-nøgle og API-nøgle-id.

Processen med registrering og oprettelse af en konto samt generering af nøgler er beskrevet på Dokumentation internet side.

Aktivering

Det delte eksekverbare program viesapi-cli.exe kræver ikke installation og skal ikke køres under en konto med administrative rettigheder. For at køre programmet skal du vælge Command Prompt ansøgning fra Start menu eller type cmd i Search programs and files felt og tryk på Enter:

Når du har startet konsollen, skal du gå til den mappe, hvor zip-filen med viesapi-cli.exe blev downloadet og pakket ud.

Start af programmet uden at angive parametre viser hjælpevinduet.

Konfiguration

Lancering af viesapi-cli.exe ansøgning uden at specificere API key ID og API key giver dig mulighed for at forespørge testmiljøet (flere detaljer om Test VIES API side).

For at oprette forbindelse til produktionsmiljøet er det nødvendigt at kalde viesapi-cli.exe applikation med godkendelsesparametrene, som er:

  • keyid – parameteren skal indeholde API-nøgle-id'et (ID) genereret på kontoen på viesapi.eu-webstedet,
  • key – parameteren skal indeholde API-nøglen (Nøglen), der er genereret på kontoen på viesapi.eu-webstedet.

Detaljer om generering af identifikator og nøgle er beskrevet på Dokumentation side. Nedenfor er et eksempel på kald af applikationen med godkendelsesparametre (keyid og key):

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

Opkaldssyntaks

Syntaks for at kalde viesapi-cli.exe program:

viesapi-cli.exe <action> [options]

Tilgængelige handlinger:

-help – beskrivelse af programkaldende parametre
-vies – nuværende VIES-systemstatus
-account – status på den nuværende konto
-data – hent virksomhedsdata fra VIES
-data-parsed – hent virksomhedsdata fra VIES med parsede data
-batch-upload – upload batch af momsnumre og få batch-token
-batch-download – tjek batchresultat og download data

Tilgængelige muligheder:

-keyid string – API-nøgle-id
-key string – API nøgle
-euvat number – EU VAT ID-nummer med landepræfiks
-token string – batch-tokenværdi
-format type – outputformattype (json, prop, xml), standard: json
-file-in path – sti til inputfilen
-file-out path – sti til outputfilen
-proxy url – HTTP-proxy-konfiguration (som URL http://user:password@hostname:port)

Eksempler

OPMÆRKSOMHED! Følgende eksempler er tilpasset de data, der er indsamlet i testmiljøet. For at udføre kontrol af produktionsmiljøet skal du tilføje –keyid og –key parametre med de relevante værdier til hver forespørgsel.

1. Kontrollerer den aktuelle VIES-systemstatus og viser resultatet som XML:

viesapi-cli.exe -vies -format xml

2. Kontrollerer den aktuelle kontostatus og gemmer resultatet i en JSON-fil:

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

3. Downloader virksomhedsdata fra VIES og viser resultatet som PROP:

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

4. Downloader virksomhedens parsede data fra VIES og gemmer resultatet i en JSON-fil:

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

5. Uploader en batchfil (et nummer pr. linje) og modtager en batch-token til resultatkontrol:

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

6. Kontrollerer den aktuelle batchstatus og gemmer resultatet i en JSON-fil:

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