EU:n VIES (VAT Information Exchange System) on rajat ylittävän B2B-kaupan selkäranka. Kuten millään digitaalisella infrastruktuurilla, se ei ole täydellinen. Olipa kyse suunnitellusta huollosta tai odottamattomasta kaatumisesta, VIES-seisokki voi tapahtua juuri kun asiakas on kassalla.
ViDA -noudattamiseen siirtyvälle yritykselle « järjestelmä oli pois » ei ole pätevä syy puuttuvalle tarkastusjäljelle. Näin käsittelet VIES-katkot ammattimaisesti ja laillisesti.
1 Miksi VIES menee pois (ja miksi se ei ole yksi järjestelmä)
VIES on « yhdyskäytävä » eikä yksi tietokanta. Kun validoidat ALV-numeron, pyyntö kulkee EU-komission portaalilta kyseisen jäsenvaltion kansalliseen verotietokantaan.
Jos Italia tai Saksa päivittää paikallisia veropalvelimiaan, VIES ei voi vahvistaa näiden maiden numeroita.
Ruuhka-aikoina vastausajat voivat pidentyä merkittävästi.
Jos kansallinen palvelin ei vastaa muutamassa sekunnissa, VIES palauttaa « Ei käytettävissä » tai MS_UNAVAILABLE -virheen.
Älä anna tilapäisen VIES-virheen keskeyttää luotettavaa ALV-prosessia. VIESACin oma resilienssikerros yhdistää SmartRouter™- ja SmartCache™-toiminnot, valvotut yhteydet paikallisiin rekistereihin, vahvistetun validointihistorian, maakohtaiset tilasignaalit ja tekoälyavusteisen laadunvalvonnan. VIESin virallinen reaaliaikainen vastaus on aina ratkaiseva: viiveen aikana VIESAC dokumentoi tilanteen, hallitsee kontrolloituja jonoja ja uudelleenyrityksiä sekä pitää tilan selvästi odottavana tai rajoitettuna.
2 VIES-virhekoodit ja vianmääritys (SOAP API)
Koska VIES on reaaliaikainen yhdyskäytävä 27 kansalliseen järjestelmään, saamasi virheet (joita usein kutsutaan SOAP-virhekoodeiksi) noudattavat tiettyjä malleja. Näiden ymmärtäminen on kriittistä ViDA -yhteensopivuuden kannalta, jossa tekninen häiriö voi estää reaaliaikaisen digitaalisen raportoinnin (DRR). Tässä on kuvaus siitä, miten VIESAC tarjoaa teknistä sietokykyä näitä vikoja vastaan.
| Virhekoodi (SOAP) ja malli | Tekninen analyysi ja VIESAC-ratkaisu |
|---|---|
INVALID_INPUT (201) Malformed VAT number or request input | Input needs correction: remove invalid characters, spacing or a malformed country prefix, then retry. VIESAC can normalize ordinary formatting noise before the live call; it never changes or assumes the official result. |
INVALID_REQUESTER_INFO (202) Requester VAT details cannot be confirmed | Review the requester details: correct the VAT number supplied for the requester and send a fresh request. This fault concerns the requester data, not the validity of the VAT number being checked. |
SERVICE_UNAVAILABLE (300) Central VIES service is temporarily unavailable | Central service interruption: record the failed attempt and retry with controlled backoff. An unavailable service is a technical state, never evidence that the target VAT number is invalid. |
MS_UNAVAILABLE (301) Member State service is under maintenance or unavailable | Official national source is temporarily unavailable: preserve the timestamp and audit context, then recheck through VIES after the Member State service recovers. Do not convert this into an invalid result. |
TIMEOUT (302) Official endpoint did not respond within the response window | Response window exceeded: keep the check pending and place it in a controlled retry queue. A timeout is distinct from an invalid VAT number and from VIES concurrency-limit faults. |
VAT_BLOCKED (400) Official VAT status is blocked | Official restriction: retain the live fault in the audit trail and resolve it through the appropriate business or tax process. It must not be turned into a fallback approval. |
IP_BLOCKED (401) VIES usage-protection control has been triggered | Request protection applies: reduce request pressure, queue the check and retry responsibly. This protects the public service and is not a decision about the target VAT number. |
GLOBAL_MAX_CONCURRENT_REQ (500) Global maximum number of concurrent VIES requests reached | Global request-count limit: VIES has reached its simultaneous-request ceiling. VIESAC uses controlled pacing and queues the request for a later fresh official response. |
GLOBAL_MAX_CONCURRENT_REQ_TIME (501) Global concurrent-request time limit reached | Global time-based concurrency limit: pause with controlled backoff before retrying. This is a capacity signal, not the same fault as TIMEOUT (302) and not a VAT-status result. |
MS_MAX_CONCURRENT_REQ (600) Member State maximum number of concurrent requests reached | Member State request-count limit: the national VIES route has reached its simultaneous-request ceiling. Preserve the attempt and retry the official route when capacity returns. |
MS_MAX_CONCURRENT_REQ_TIME (601) Member State concurrent-request time limit reached | Member State time-based concurrency limit: apply controlled backoff and recheck through the official route. It is a capacity condition, not TIMEOUT (302) or an invalid VAT number. |
3 Kultasääntö: « Ei käytettävissä » ≠ « Ei voimassa »
Yksi suurimmista virheistä on kohdella teknisen aikakatkaisun tulosta virheellisenä ALV-numerona.
Kriittinen varoitus: Jos järjestelmäsi hylkää asiakkaan automaattisesti koska VIES on väliaikaisesti pois, menetät liikevaihtoa. Toisaalta jos sovellat 0 % ALV:ta ilman myöhempää vahvistusta, riskinä on suuret sakot verotarkastuksessa.
Käytännön käsittely: Dokumentoi jokainen yritys, toteuta älykäs uudelleenyritys ja viestitä selkeästi käyttäjälle—älä oleta että « ei käytettävissä » tarkoittaa « ei voimassa ».
4 Käytännön käsittely: 3-vaiheinen strategia
Noudata näitä vaiheita suojataksesi sekä myynti että noudattaminen kun VIES on pois:
- 1. Dokumentoi jokainen yritys — Verotarkastajan näkökulmasta « yritys » on olemassa vain, jos tietue on. Lokita aina: syötetty ALV-numero, tarkka aikaleima ja virheilmoitus (esim. « Palvelu ei käytettävissä » tai « MS_UNAVAILABLE »).
- 2. Toteuta älykäs uudelleenyritys — Älä pidä asiakasta « Maksa nyt » -napilla. Hyväksy tilaus, mutta merkitse taustalla uudelleenvalidointia varten. Hyvän järjestelmän täytyy yrittää tarkistusta 30–60 minuutin välein kunnes lopullinen « Voimassa » tai « Ei voimassa » -vastaus saadaan.
- 3. Viesti läpinäkyvästi — Kerro käyttäjälle selkeästi: « ALV-validointi on väliaikaisesti pois EU-palvelimen huollon vuoksi. Validoimme statuksesi pian ja päivitämme laskusi. » Tämä luo luottamusta ja estää ostoskorin hylkäämisen.
Tuo 30–60 minuutin väli on tyypillinen perinteisille järjestelmille—ne kyselyt vain niin harvoin. VIESACilla asynkroninen teknologia, hajautetut pyynnöt ja palvelimet sekä VIESAC AI mahdollistavat VIES-saatavuuden seurannan lähes reaaliaikaisena, ja toimitamme auditoinnin heti kun palvelu vastaa.
Miten VIESAC automatisoi seisokkihuolet
Manuaalisten uudelleenyritysten ja lokien hallinta on kehittäjän painajainen. VIESAC on suunniteltu hallitsemaan viranomaispalvelimien epävakaus niin ettei sinun tarvitse.
- →Automaattinen uudelleenyritys ja jonotus: Jos VIES on pois, järjestelmämme jonottaa pyynnön ja yrittää uudelleen kunnes valmis.
- →Selkeä statusten raportointi: Erotamme « Ei voimassa » -numeron ja « Palvelu pois » -statuksen, jotta työnkulku jatkuu keskeytymättä.
- →Lopullinen tarkastusjälki: VIESAC tallentaa pysyvän digitaalisen todistuksen jokaiselle tarkistukselle—myös monen yrityksen vaatineille—varmistaen 100 % valmiuden ViDA-tarkastukseen.
Kokeile VIESACia — Automaattiset uudelleenyritykset ja tarkastusjälki
Vinkki
Älä anna toisen maan palvelinvian pysäyttää kasvua. Käytä EU ALV-validointi APIa uudelleenyrityslogiikalla tai WooCommerce-lisäosamme, jotta kassa ei koskaan jumita ja tarkastusjälkesi pysyy täydellisenä. Katso myös miten validoida EU ALV tarkastusta varten.