Die Client-Anwendung viesClient.exe ermöglicht eine schnelle und automatische Überprüfung von Entitäten (Auftragnehmern) aus der Kommandozeilenebene (CLI / CMD) hinsichtlich ihres aktuellen Status im VIES-System. Die Anwendung ermöglicht es Ihnen auch, die heruntergeladenen Daten in einer Datei in 3 Formaten zu speichern:
- JSON (Standardanzeigeformat auf stdout)
- XML
- MAP (Attributzuordnungsschlüssel = Wert)
Die Anwendung wurde erfolgreich in den folgenden Versionen von MS Windows getestet: XP, 7 und 10.
Die neueste Version der Anwendung steht immer zum Download unter zur Verfügung Download Seite.
Die volle Funktionalität der Anwendung kann – ohne die Notwendigkeit, ein Konto anzulegen – mit dem bereitgestellten überprüft werden API testen
Um das Add-in in der Produktions-API zu verwenden, müssen Sie ein Konto auf der Website viesapi.eu einrichten, mindestens den Business-Plan erwerben und einen API-Schlüssel und eine API-Schlüsselkennung generieren.
Der Prozess der Registrierung und Einrichtung eines Kontos sowie der Generierung von Schlüsseln wurde auf der beschrieben Dokumentation Webseite.
Aktivierung
Das freigegebene ausführbare Programm viesClient.exe erfordert keine Installation und muss nicht unter einem Konto mit Administratorrechten ausgeführt werden. Um das Programm auszuführen, wählen Sie die Command Prompt Bewerbung von der Start Menü oder Typ cmd in dem "Search programs and files“ Feld und drücken Sie die Eingabetaste:
Wechseln Sie nach dem Start der Konsole in das Verzeichnis, in dem sich die ZIP-Datei befindet viesClient.exe wurde heruntergeladen und entpackt.
Wenn Sie das Programm starten, ohne Parameter anzugeben, wird das Hilfefenster angezeigt.
Aufbau
Starten der viesClient.exe Anwendung ohne Angabe der API key ID und API key ermöglicht die Abfrage der Testumgebung (mehr Details auf der Testen Sie die VIES-API Seite).
Um eine Verbindung zur Produktionsumgebung herzustellen, ist es notwendig, die aufzurufen viesClient.exe Anwendung mit den Authentifizierungsparametern, die sind:
keyid– der Parameter sollte die API-Schlüsselkennung (ID) enthalten, die auf dem Konto auf der Website viesapi.eu generiert wurde,key– Der Parameter sollte den API-Schlüssel (Key) enthalten, der auf dem Konto auf der Website viesapi.eu generiert wurde.
Details zur Generierung von Kennung und Schlüssel sind auf der beschrieben Dokumentation Seite. Nachfolgend finden Sie ein Beispiel für den Aufruf der Anwendung mit Authentifizierungsparametern (keyid und key):
viesClient.exe -keyid XXXXXXXXXXXX -key YYYYYYYYYYYY -vies -euvat PL7171642051.
Aufrufsyntax
Syntax zum Aufruf des Programms viesClient.exe:
viesClient.exe <action> .
Mögliche Aktionen :
-help – Beschreibung der Programmaufrufparameter
-account – liefert Informationen über den aktuellen Kontostand von viesapi.eu
-vies – Unternehmensdaten von VIES erhalten.
Verfügbare Optionen [Optionen]:
-keyid string – API-Schlüsselkennung
-key string - API-Schlüssel
-euvat number – EU-Umsatzsteuer-Identifikationsnummer mit Länderpräfix
-format type
-file path
-proxy urlhttp://user:password@hostname:port).
Beispiele
AUFMERKSAMKEIT! Die folgenden Beispiele sind an die in der Testumgebung gesammelten Daten angepasst. Um Überprüfungen in der Produktionsumgebung durchzuführen, fügen Sie die –keyid und –key Parameter mit den entsprechenden Werten für jede Abfrage.
1. Unternehmensdaten von VIES herunterladen und das Ergebnis auf der Konsole im MAP-Format anzeigen:
viesClient.exe -vies -euvat PL5213003700 -map format
2. Informationen zum aktuellen Kontostand anzeigen:
viesClient.exe -account.
3. HTTP-Proxy-Einstellung:
viesClient.exe -vies -euvat PL7272445205 -proxy http://user:password@10.0.0.1:8080