Johdanto

Viesapi.eu-palvelu tarjoaa valikoiduille yrittäjille dataa mm. verkkopalveluiden, ohjelmointikirjastojen ja erityissovellusten avulla. Käyttämällä saatavilla olevia ohjelmistoja (kirjastot, sovellukset ja Excel-apuohjelma) asiakkaasi voivat:

tarkista urakoitsijoiden EU ALV-numeron tila VIES-järjestelmästä,
lataa yrityksen tiedot VIES-järjestelmästä,
laskulomakkeiden automaattinen täyttö,

nopeimmalla mahdollisella tavalla.

Tässä asiakirjassa kuvataan yksityiskohtaisesti, mitä toimenpiteitä tulee tehdä, jotta se integroituu kunnolla viesapi.eu-palveluun.

Huomio! Täysi toiminnallisuus voidaan tarkistaa mukana toimitetulla Testaa VIES API. API TESTillä on mahdollista tarkistaa kaikki maksullisten suunnitelmien tarjoamat toiminnot ilman tarvetta luoda tiliä.

Noudata alla olevia ohjeita päästäksesi tuotantosovellusliittymän käyttöliittymään.

Ensimmäinen askel on rekisteröityä järjestelmään ja luoda tili. Tämän ansiosta ohjelmisto on mahdollista ladata ja edelleen konfiguroida asianmukaiseen kommunikointiin viesapi.eu-palvelun tarjoamien verkkopalvelujen kanssa.

Rekisteröinti

Viesapi.eu-palvelun toimintoja käyttävän tahon rekisteröinti vaaditaan. Voit tehdä tämän siirtymällä kohtaan Rekisteröinti sivulle ja täytä sopiva lomake. Viesapi.eu-palvelun käytön edellytyksenä on sääntöjen hyväksyminen. Täytä lomake oikein ja napsauta Kirjaudu -painike luo tilin viesapi.eu-palveluun ja sen automaattisen aktivoinnin.

Kirjaudu sisään

Aktivoidulle tilille kirjautuminen on mahdollista syöttämisen jälkeen Kirjautumisvälilehti ja rekisteröinnin yhteydessä määritetyn sähköpostiosoitteen ja salasanan ilmoittaminen. Oikean todennuksen jälkeen on mahdollista hallita tiliä. Käyttäjä voi luoda tililleen tunnisteita ja avaimia, joiden avulla hänet tunnistetaan järjestelmään.

Tunnisteen (tunniste) ja pääsyavaimen (avain) luominen

Kun kirjaudut sisään ensimmäistä kertaa, an identifier generoidaan automaattisesti vastaavan kanssa key. The identifier on julkinen eikä vaadi suojaa, kun taas key on yksityinen, eikä sen pitäisi olla kolmansien osapuolten saatavilla. Lisäksi turvallisuuden lisäämiseksi käyttäjä voi syöttää IP address josta voi tulla tiedusteluja. Tämä voi olla esimerkiksi verkkokaupan IP-osoite. Luotujen avainparien ja tunnisteiden määrää ei ole rajoitettu. Mikäli käyttäjä ei halua käyttää mitään tunniste-avainparia, hän voi kytkeä sen pois päältä muuttamalla sen tilaa.

API-avaimet

Tällä hetkellä saatavilla olevat VIES API -käyttötavat

Alla esittelemme mahdolliset pääsytavat VIES API:lle. Napsauta otsikkoa tai linkkiä dokumentaatioon saadaksesi lisätietoja.

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

Tekninen dokumentaatio ja yksityiskohtainen kuvaus kirjastojen käytöstä saatavilla osoitteessa Dokumentointi -välilehti.

Kirjastotiedostot voi ladata linkitetyltä verkkosivustolta ladata.

2. Microsoft Excel VIES API -lisäosa

Excel-sovellusta päivittäin käyttäville ihmisille valmistelimme helppokäyttöisen apuohjelman. Sen avulla voit tehokkaasti (ilman ohjelmointiosaamista) tarkistaa yhteisön tilan valkoisessa listassa, ALV-rekisterissä ja VIES-järjestelmässä sekä etsiä ja ladata yksiköiden tietoja ja tarkistaa niiden nykyisen liiketoimintatilanteen.

Asennus-, konfigurointi- ja käyttötiedot sivulla MS Excel VIES API -lisäosa sivu.

3. EU:n ALV-hakemusten tarkistus (GUI)

VIES Checker -sovelluksen avulla voit ladata minkä tahansa CSV-tiedoston tarkistaaksesi entiteetit (urakoitsijat), joiden EU:n ALV-numerot on tallennettu CSV-tiedostoon VIES-järjestelmän tilan perusteella.

Asennus-, konfigurointi- ja käyttötiedot on kuvattu suoraan VIES Checker -sovellus sivu.

Sovellus ei vaadi asennusta ja järjestelmänvalvojan oikeuksia toimiakseen. Voit ladata sen osoitteesta ladata sivu.

4. EU:n ALV CLI/CMD-tarkistus

VIES CLI/CMD Checker on asiakassovellus, jonka avulla voidaan nopeasti ja automaattisesti tarkistaa entiteetit (urakoitsijat) komentorivitasolta (CLI / CMD) niiden nykyisen tilan VIES-järjestelmässä.

Asennus-, konfigurointi- ja käyttötiedot on kuvattu suoraan VIES Checker CLI/CMD sivu.