VIES API -tilin hallinta asiakaspaneelin kautta

Tässä luvussa on yksityiskohtaisia tietoja asiakastilien hallintapaneelin yksittäisistä välilehdistä ja asetuksista.

Luo tili

Tilin luomiseksi sinun on annettava Email osoite, aseta salasana ("Password“) ja toista se (“Confirm Password") ja hyväksy sitten Terms and Conditions.

.

Kirjaudu tilille

Kirjautuminen tapahtuu käyttämällä Email rekisteröitymisen yhteydessä annettu osoite ja Password.

Kirjautumisnäytössä on mahdollisuus palauttaa unohtunut salasana ("Forgot your password?“):

Kun olet syöttänyt sähköpostiosoitteen ja painanut Reset password -painiketta, järjestelmä lähettää viestin annettuun sähköpostiosoitteeseen, jonka avulla käyttäjä voi nollata salasanan.

Tilityypit

Palvelu tarjoaa kahdenlaisia tilejä:

• Prepaid – prepaid-tilityyppi, joka edellyttää maksua ennen Palveluiden käyttöä.
• Jälkimaksu – tilaustilityyppi, joka edellyttää maksua Palveluiden käytön jälkeen.

Jokaiselle uudelle palvelun käyttäjälle määritetään oletuksena prepaid-tilityyppi tilin luomisen yhteydessä.

Käyttäjän tili voidaan vaihtaa jälkikäteen maksettavaksi, jos hän on käyttänyt Palvelua vähintään kolme kuukautta ja hänellä on vähintään aktiivinen Business-sopimus.

Jos haluat vaihtaa jälkikäteen maksettavaan tilaan, ota yhteyttä asiakaspalveluun.

Profiilit – Yritystietojen täydentäminen

Profile välilehteä käytetään käyttäjä- ja yritystietojen hallintaan.

Company details: Tämä osio tulee täyttää laskutukseen ja VIES-järjestelmän kanssa viestintään käytettävillä tiedoilla. Käyttäjät voivat syöttää ALV-numeron manuaalisesti tai käyttää ”Get from VIES”-painiketta hakeaksesi tietoja suoraan tietokannasta. Muita kenttiä ovat: country, company name, postal code, post city, city, street name, building number, ja office number.

Lisäksi voit määrittää erillisen sähköpostiosoitteen, johon laskut lähetetään (oletusarvoisesti tämä on kirjautumisosoite) ja sisällyttää laskuun lisätietoja, esim. tilausnumeron (PO-numero).

Kun olet täyttänyt tai muuttanut tietoja, muista vahvistaa muutos painamalla Savenappi.

Login email change & Password change: Profiiliosiossa on erilliset lomakkeet, joiden avulla voit muuttaa kirjautumissähköpostiosoitettasi ja nykyistä salasanaasi.

Kojelauta

Kojelauta on tilisi tietokeskus ja tarjoaa nopean yleiskatsauksen tärkeimmistä mittareista. Se sisältää seuraavat paneelit:

  • AccountTilin tila ja tyyppi (esim. ennakkoon maksettu, aktiivinen).
  • SubscriptionTietoja nykyisestä tilauksesta ja sen maksusta (esim. Aloitus, Maksettu/Ei maksettu).
  • Requests this monthViivakaavio, joka näyttää VIES-järjestelmäpyyntöjen määrän eriteltynä VIES-tilan mukaan ja VIES-tilapyynnöt jäsennetyillä osoitetiedoilla kuluvana kuukautena.
  • Pikalinkit: Painikkeet, jotka johtavat kohteeseen API documentation (”Dokumentaatio”) REST API Client (”Swagger UI” – jonka avulla voit testata API-toimintoja selaimessa) ja lataamalla OpenAPI definition kuin viesapi.yaml tiedosto.

.

Tilaus

Tämän välilehden avulla voit valita ja muuttaa hinnoittelusuunnitelmaasi.

• Huomautus: Maksettuja liittymiä voi käyttää vasta, kun olet antanut EU VAT numero ja yrityksen tiedot kohdassa Profile -välilehti.
• Saatavilla olevat paketit ovat Startup (10,00 €), Business (30,00 €) ja Professional (50,00 €).

Kun olet valinnut suunnitelman ja painanut Buy now nappi , käyttäjä siirretään osoitteeseen Payments -välilehti.

.Suunnitelman tiedot

Suunnitelman yksityiskohtien laajentaminen (“Show details“) antaa sinun nähdä tarkalleen, mitä se sisältää:

API-avaimet

API-avaimia tarvitaan palveluiden käytön todentamiseen REST API:n, asiakaskirjastojen ja kaikkien muiden palvelun tarjoamien työkalujen (sovellusten ja lisäosien) kautta.

• Käyttäjä voi luoda minkä tahansa määrän avaimia.
• Avaimen tunniste (“Identifier“) on julkinen, kun taas itse avain (“)API key“) on piilotettu ja se voidaan kopioida.
• Listan näppäimiä voidaan muokata ja deaktivoida käyttämällä "Action”-valikko

.

Lisää API-avain

Luodaksesi uuden avaimen, napsauta "+ Add API keyLomakkeella voit määrittää oman avaintunnisteen (“Key label") helpottaakseen sen tunnistamista ja valinnaisesti rajoittaakseen pääsyä syöttämällä tietyn IP address josta viesapi.eu-palveluun lähetetään pyyntöjä.

Laskutus

Billing: Yksityiskohtainen luettelo API-pyynnöistä. Käyttäjät voivat suodattaa luetteloa päivämäärän ja valittujen API-avainten mukaan. Taulukossa näkyy request date, key ID, key label, request type (“Request for EU VAT number status in the VIES system"), ja requested value (erityinen EU:n ALV-numero).

.Maksut

Näytä prepaid-tilille

Sillä Prepaid-tilit Tässä osiossa voit valita sopimuksen avattavasta luettelosta, määrittää voimassaoloajan (mahdollisuus alennukseen pidemmillä ajanjaksoilla, esim. 20% 12 kuukaudeksi) ja tarkastella netto-, ALV- ja bruttomääriä.

Käyttäjä voi luoda pro forma -laskun ("Download pro forma invoice“) maksua varten pankkisiirrolla tai verkossa maksuintegraattoreiden avulla Stripe.com tai Tpay.com.

.

Näytä jälkikäteen maksetulle tilille

Jälkimaksu Tilinäkymässä tässä osiossa on luettelo maksettavista laskuista ja voit ladata ne PDF-tiedostoina.

Tilaukset

Orders: Käyttäjätilausten tiedot. Suodata päivämäärän ja tilauksen tilan mukaan. Näkyvissä oleviin kohteisiin kuuluvat tilausnumerot, päivämäärät ja tilat (esim. maksuvahvistusta odotetaan, Canceled) ja kokonaishinnat.

Ajoissa maksamatta jätetyt tilaukset peruuntuvat automaattisesti.

Tilastot

Välilehti Saatavilla Professional- ja Individual-sopimuksille. Se näyttää kootun API-käytön päivittäin, tietyt API-avaimet ja kyselytyypit sekä tehtyjen puheluiden määrän ("Count"). Näkymän voi myös viedä CSV-tiedostoon.

.

Näyttö

Tämä välilehti on käytettävissä vain Professional- ja Individual-sopimuksissa.

Sen avulla voit määrittää ja automatisoida ALV-numeroryhmien tilan tarkistamisen tiettynä ajankohtana.

Groups: Käyttäjät voivat lisätä, muokata ja poistaa ryhmiä. Ryhmät sisältävät EU:n ALV-numeroita, jotka tarkistetaan tietyin väliajoin. Ryhmän enimmäiskoko on 10 000 EU:n ALV-numeroa.

Checks: Luettelo suoritetuista ALV-tarkistuksista. Taulukossa näkyy tarkistuksen päivämäärä, EU:n ALV-numero, tila, vastauskoodi ja onko tila muuttunut. Tiedot voidaan viedä CSV-tiedostoon.

Yksityiskohtainen kuvaus EU:n ALV-numeron seurantapalvelun toiminnasta on seuraavassa luvussa: https://viesapi.eu/monitoring-eu-vat-numbers-in-vies-service/

Lisää ryhmä

Ryhmämääritelmän lisääminen edellyttää sen nimen syöttämistä ja aikataulun asettamista sen suorittamiselle:

Muokkaa ryhmää

Ryhmän muokkaaminen toimii samalla tavalla kuin lisääminen. Muista vain vahvistaa muutokset napsauttamalla Save nappi .

Poista ryhmä

Ryhmän poistaminen järjestelmästä tarkoittaa tämän datan historian peruuttamatonta menetystä (vienti on suositeltavaa ennen poistamista).

Lisää numerot valittuun ryhmään

Numeroiden lisääminen: ALV-numerot voidaan tuoda CSV-tiedostosta valittuihin ryhmiin tai yksinkertaisesti liittää tekstikenttään (yksi numero riviä kohden). Muista sisällyttää maakohtainen etuliite jokaiseen EU:n ALV-numeroon, esim.: PL7171642051.

Lokit

Tämä välilehti on tarkoitettu yritys-, ammatti- ja yksilökäyttäjille. Se mahdollistaa VIES-vahvistuslokien joukkolataukset. Käyttäjät valitsevat halutun kuukauden avattavasta luettelosta (esim. 2026-09) ja napsauttavat "Download”-painiketta.

.

Laskut

Tämä välilehti näyttää yhteenvedon lähetetyistä laskuista, ja voit suodattaa niitä päivämäärän mukaan. Luettelo sisältää tilan (esim. ”Unpaid“), laskun päivämäärä, laskun numero, summa, eräpäivä ja painike asiakirjan lataamiseksi PDF-tiedostona.