Тестове середовище для перевірки стану сутності Система VIES.

Для всіх, хто бажає перевірити роботу спільних бібліотек, плагінів і надбудови для Microsoft Excel, тестовий API був доступний за адресою: https://viesapi.eu/api-test/

Для використання тестового API не потрібно створювати обліковий запис на веб-сайті viesapi.eu, а всі функції тестового API працюють точно так само, як і у випадку з API виробництва (https://viesapi.eu/api/). Єдиним обмеженням є діапазон номерів ПДВ ЄС, щодо яких можна надсилати запити.

Запити, надіслані на адресу API-test, можуть тільки зверніться до наступних номерів, призначених для певних функцій:

Назва функції опис Номери ПДВ ЄС
getVIESData Функція для підтвердження діяльності номеру ПДВ ЄС, виданого будь-якою з країн-членів Європейського Союзу 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 Функція, яка дозволяє підтвердити діяльність номера ПДВ ЄС, виданого будь-якою з держав-членів Європейського Союзу, і додатково повертає проаналізовану адресу торговця зареєстрованого офісу компанії.

Примітка! Через відсутність даних, які повертає VIES для трейдерів з Німеччини та Іспанії, функція повертає не повернути проаналізована адреса трейдера для цих країн.

Конфігурація

Для виробничих облікових записів ідентифікатор ключа та ключ генеруються користувачем після входу в обліковий запис на порталі viesapi.eu. У випадку тестового API немає необхідності створювати обліковий запис – достатньо виконати налаштування, як описано нижче.

Для авторизації в тестовому середовищі використовуйте такі значення: test_id і test_key.

У наступному прикладі показано запит, який можна викликати в a тестове середовище з веб-браузера. Просто скопіюйте та вставте його в адресний рядок браузера:

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

Для робочого середовища ідентифікатор і ключ генеруються користувачем після входу в обліковий запис на viesapi.eu портал (API keys вкладка). Сee the документація сторінку для отримання додаткової інформації про створення ідентифікатора та ключа.

Тестовий API вимагає використання конструктора без параметрів під час створення клієнтського об’єкта для правильної автентифікації. Ось приклади для окремих бібліотек:

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

Використання

Перевірка окремих функцій тестового API полягає у виклику окремих функцій, детально описаних на документація сторінку з параметрами (номерами платника ПДВ ЄС), наведеними вище.

Кожна бібліотека, яку ми надаємо, містить вихідний код прикладу програми під назвою приклад, який ілюструє правильне використання всіх функцій API.