Testomgeving voor het controleren van de entiteitsstatus in VIES-systeem.

Voor iedereen die de werking van gedeelde bibliotheken, plug-ins en een add-on voor Microsoft Excel wil testen, is er een test-API beschikbaar gesteld op: https://viesapi.eu/api-test/

Voor het gebruik van de test-API hoeft u geen account aan te maken op de website viesapi.eu en alle test-API-functies werken op precies dezelfde manier als in het geval van de productie-API (https://viesapi.eu/api/). De enige beperking is het aantal EU-btw-nummers waarvoor aanvragen kunnen worden verzonden.

Vragen die naar het API-testadres worden verzonden, kunnen alleen verwijzen naar de volgende nummers die zijn toegewezen aan specifieke functies:

Configuratie

Voor productieaccounts worden de sleutel-ID en de sleutel gegenereerd door de gebruiker na het inloggen op zijn account op het viesapi.eu-portaal. In het geval van de test-API is het niet nodig om een account aan te maken - het volstaat om de configuratie uit te voeren zoals hieronder beschreven.

Gebruik voor autorisatie in de testomgeving de volgende waarden: test_id en test_key.

Het volgende voorbeeld toont een query die kan worden aangeroepen in een test omgeving vanuit een webbrowser. Kopieer en plak het in de adresbalk van de browser:

https://test_id:test_key@viesapi.eu/api-test/get/vies/euvat/PL7171642051

Voor een productieomgeving worden de identificatie en de sleutel door de gebruiker gegenereerd nadat hij is ingelogd op zijn account op de viesapi.eu portaal (API keys tabblad). Se de documentatie pagina voor meer informatie over het genereren van ID's en sleutels.

De test-API vereist dat een parameterloze constructor wordt gebruikt bij het construeren van het clientobject om correcte authenticatie uit te voeren. Hier zijn voorbeelden voor bepaalde bibliotheken:

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

Gebruik

Het controleren van individuele functionaliteiten van de test-API bestaat uit het aanroepen van individuele functies die in detail worden beschreven op de documentatie pagina met de hierboven vermelde parameters (EU-btw-nummers).

Elk van de bibliotheken die we aanbieden, bevat de broncode voor een voorbeeldprogramma met de naam voorbeeld, die het juiste gebruik van alle API-functies illustreert.