Invoering

De dienst Viesapi.eu biedt geselecteerde ondernemers gegevens via onder meer webservices, programmeerbibliotheken en speciale toepassingen. Door gebruik te maken van de beschikbare software (bibliotheken, applicaties en Excel-add-in) kunnen uw klanten:

  • controleer de status van het EU-btw-nummer van aannemers in het VIES-systeem,
  • download bedrijfsgegevens van het VIES-systeem,
  • automatisch invullen van de factuurformulieren,

op de snelst mogelijke manier.

Dit document beschrijft in detail welke stappen moeten worden genomen om goed te integreren met de viesapi.eu-service.


Aandacht! De volledige functionaliteit kan worden gecontroleerd met behulp van het meegeleverde VIES-API testen. Door de API TEST te gebruiken, is het mogelijk om alle functies te controleren die worden aangeboden in de betaalde abonnementen zonder de noodzaak om een account aan te maken.


Volg de onderstaande stappen om toegang te krijgen tot de productie-API-interface.

De eerste stap is om u te registreren in het systeem en een account aan te maken. Hierdoor zal het mogelijk zijn om de software te downloaden en verder te configureren voor een goede communicatie met de webservices van de dienst viesapi.eu.

Registratie

Registratie van een entiteit die bereid is om de functionaliteit van de viesapi.eu-service te gebruiken, is vereist. Ga hiervoor naar de Registratie pagina en vul het juiste formulier in. Voorwaarde voor het gebruik van de dienst viesapi.eu is de aanvaarding van de voorschriften. Correct invullen van het formulier en klikken op de Inschrijven knop zal een account aanmaken in de viesapi.eu-service en de automatische activering ervan.

Log in

Inloggen op een geactiveerd account is mogelijk na het invoeren van de Tabblad Aanmelden en het invoeren van het e-mailadres en wachtwoord dat tijdens de registratie is opgegeven. Na correcte authenticatie is het mogelijk om het account te beheren. De gebruiker kan identifiers en toegangssleutels voor zijn account genereren, die worden gebruikt om hem te authenticeren bij het systeem.

Een identifier (identifier) en een toegangssleutel (key) genereren

Wanneer u voor de eerste keer inlogt, wordt een identifier wordt automatisch gegenereerd samen met de bijbehorende key. De identifier openbaar is en geen bescherming behoeft, terwijl de key is privé en mag niet beschikbaar zijn voor derden. Bovendien kan de gebruiker, om de veiligheid te verhogen, de IP address waaruit vragen kunnen komen. Dit kan bijvoorbeeld het IP-adres van een webwinkel zijn. Er is geen limiet aan het aantal gegenereerde paren sleutels en identifiers. Als de gebruiker geen identificatie-sleutelpaar wil gebruiken, kan hij dit uitschakelen door de status ervan te wijzigen.

API-sleutels

Momenteel beschikbare VIES API-toegangsmethoden

Hieronder presenteren we de mogelijke toegangsmethoden tot de VIES API. Klik op de titel of link naar de documentatie voor details.

1. Programmeerbibliotheken: PHP, .NET (C#, Visual Basic, SQL Server, Access, Dynamics, FoxPro), Python, Java, C/C++, JavaScript

Technische documentatie en gedetailleerde beschrijving van het gebruik van bibliotheken beschikbaar in de Documentatie tabblad.

Bibliothekenbestanden kunnen worden gedownload van de gekoppelde website Downloaden.

2. Microsoft Excel VIES API-invoegtoepassing

Voor de mensen die de Excel-app dagelijks gebruiken, hebben we een gebruiksvriendelijke add-in gemaakt. Hiermee kunt u effectief (zonder programmeerkennis) de status van een entiteit in de witte lijst, het btw-register en het VIES-systeem controleren, gegevens van entiteiten zoeken en downloaden en hun huidige bedrijfsactiviteitstatus controleren.

Details over installatie, configuratie en gebruik op de MS Excel VIES API-invoegtoepassing bladzijde.

3. EU-btw-toepassingscontrole (GUI)

Met de VIES Checker-applicatie kunt u elk CSV-bestand laden om entiteiten (contractanten) te controleren waarvan de EU-btw-nummers in CSV-bestand zijn opgeslagen in termen van hun status in het VIES-systeem.

Installatie, configuratie en gebruik details direct beschreven op de VIES Checker-applicatie bladzijde.

Toepassing vereist geen installatie- en beheerdersrechten om te worden uitgevoerd. Je kunt het downloaden van de Downloaden bladzijde.

4. EU BTW CLI/CMD Checker

De VIES CLI/CMD Checker is een client-applicatie die het mogelijk maakt om snel en automatisch entiteiten (aannemers) vanaf de opdrachtregel (CLI / CMD) te controleren op hun huidige status in het VIES-systeem.

Installatie, configuratie en gebruik details direct beschreven op de VIES Checker CLI/CMD bladzijde.

Toepassing vereist geen installatie- en beheerdersrechten om te worden uitgevoerd. Je kunt het downloaden van de Downloaden bladzijde.

5. REST-API

Als u geïnteresseerd bent om rechtstreeks verbinding te maken met onze REST API, lees dan de informatie die beschikbaar is op de REST-API bladzijde.

6. Automatische monitoring van de status van EU-btw-leveranciers

De service van automatische controle van de EU-btw-nummers zorgt voor een volledig onderhoudsvrije monitoring van de status van de entiteit in het VIES-systeem. Lees meer informatie over de Toezicht houden bladzijde.