Тестове середовище для перевірки стану сутності Система 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 вимагає використання конструктора без параметрів під час створення клієнтського об’єкта для правильної автентифікації. Ось приклади для окремих бібліотек:
- 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()
Використання
Перевірка окремих функцій тестового API полягає у виклику окремих функцій, детально описаних на документація сторінку з параметрами (номерами платника ПДВ ЄС), наведеними вище.
Кожна бібліотека, яку ми надаємо, містить вихідний код прикладу програми під назвою приклад, який ілюструє правильне використання всіх функцій API.