Testumgebung zur Überprüfung des Entitätsstatus in VIES-System.
Für alle, die den Betrieb von gemeinsam genutzten Bibliotheken, Plugins und einem Add-On für Microsoft Excel testen möchten, wurde eine Test-API zur Verfügung gestellt unter: https://viesapi.eu/api-test/
Die Verwendung der Test-API erfordert kein Erstellen eines Kontos auf der Website viesapi.eu, und alle Test-API-Funktionen funktionieren genauso wie im Fall der Produktions-API (https://viesapi.eu/api/
). Die einzige Einschränkung ist der Bereich der EU-Umsatzsteuernummern, für die Anfragen gesendet werden können.
Anfragen an die API-Testadresse können ggf nur beziehen sich auf die folgenden Nummern, die bestimmten Funktionen zugeordnet sind:
Funktionsname | Beschreibung | EU-Umsatzsteuernummern |
getVIESDaten | Eine Funktion zur Bestätigung der Aktivität einer EU-Umsatzsteuernummer, die von einem der Mitgliedstaaten der Europäischen Union ausgestellt wurde | PL7272445205 PL5213003700 PL5252242171 PL7171642051 DE327990207 FR10402571889 DK56314210 ES38076731R PT501613897 CZ7710043187 IT06903461215 BG202211464 HU29312757 RO14388698 EL801116623 FI23064613 HR79147056526 LT100005828314 LV40203202898 SK2022210311 NL863726392B01 BE0835221567 ATU74581419 CY10137629O EE100110874 IE8251135U LU22108711 MT26572515 SE556037867001 SI51510847 |
getVIESDataParsed | Eine Funktion, mit der Sie die Aktivität einer von einem der Mitgliedstaaten der Europäischen Union ausgestellten EU-Umsatzsteuer-Identifikationsnummer bestätigen können und die zusätzlich eine analysierte Händleradresse des eingetragenen Firmensitzes zurückgibt.
Notiz! Aufgrund der fehlenden Daten, die das VIES-System für Händler aus Deutschland und Spanien zurückgibt, funktioniert die Funktion nicht. nicht zurückkehren eine analysierte Händleradresse für diese Länder. |
Aufbau
Bei Produktionskonten werden die Schlüsselkennung und der Schlüssel vom Benutzer generiert, nachdem er sich bei seinem Konto auf dem Portal viesapi.eu angemeldet hat. Im Fall der Test-API muss kein Konto erstellt werden – es reicht aus, die Konfiguration wie unten beschrieben durchzuführen.
Verwenden Sie für die Autorisierung in der Testumgebung die folgenden Werte: test_id
und test_key
.
Das folgende Beispiel zeigt eine Abfrage, die aufgerufen werden kann in einem Test Umgebung aus einem Webbrowser. Kopieren Sie es einfach und fügen Sie es in die Adressleiste des Browsers ein:
https://test_id:test_key@viesapi.eu/api-test/get/vies/euvat/PL7171642051
Für eine Produktionsumgebung werden Kennung und Schlüssel vom Benutzer generiert, nachdem er sich bei seinem Konto angemeldet hat. viesapi.eu
Portal (API keys
Tab). Säh die Dokumentation Seite für weitere Informationen zur ID- und Schlüsselgenerierung.
Die Test-API erfordert die Verwendung eines parameterlosen Konstruktors beim Erstellen des Clientobjekts, um eine korrekte Authentifizierung durchzuführen. Hier sind Beispiele für bestimmte Bibliotheken:
- C#
- C/C++
- Java
- JavaScript
- PHP
- Python
- Visual Basic
- Excel
using viesapiLibrary.dll;
// Create the test env service client object.
VIESAPIClient viesapi = new VIESAPIClient();
#include "viesapi.h"
// Create the test env service client object.
VIESAPIClient* viesapi = NULL;
viesapi_new_test(&viesapi);
import pl.viesapi.client.*;
// Create the test env service client object.
VIESAPIClient viesapi = new VIESAPIClient();
var VIESAPI = require('viesapiclient');
// Create the test env service client object.
var viesapi = new VIESAPI.VIESAPIClient();
require_once 'VIESAPI/VIESAPIClient.php';
\VIESAPI\VIESAPIClient::registerAutoloader();
// Create the test env service client object.
$viesapi = new \VIESAPI\VIESAPIClient();
from viesapi import *
from pprint import pprint
# Create the test env service client object.
viesapi = VIESAPIClient()
' Create the test env service client object
Dim viesapi As New VIESAPIClient
# Create the test env service client object.
=VIESAPI.CONNECT.TEST()
Verwendungszweck
Die Überprüfung einzelner Funktionalitäten der Test-API besteht im Aufruf einzelner Funktionen, die auf der ausführlich beschrieben sind Dokumentation Seite mit den oben aufgeführten Parametern (EU-Umsatzsteuernummern).
Jede der von uns bereitgestellten Bibliotheken enthält den Quellcode für ein Beispielprogramm namens Beispiel, die die korrekte Verwendung aller API-Funktionen veranschaulicht.