Uuendatud 23. juuli 2026

Mida see tähendab, kui Panga päringute järjekorras on teade: „Viga vaheserveris“?

Moodulis Tehnika asub register “Panga päringute järjekord“. Igapäevaselt seda registrit reeglina kasutajal vaja ei ole, sest see on mõeldud peamiselt tõrgete diagnoosimisel (näiteks, kui tasumine ei jõua panka, või pangaväljavõte ei saabu Booksi). Seda registrit kasutab Excellent Books taustal nendel eesmärkidel:

• Saadab päringuid perioodiliselt Swedbank Gateway serverisse ja kontrollib päringute vastuseid;
• Loeb siit registrist hetkeseisu, mida kuvada aruandes “E-tasumise hetkeseis“;
• Tasumiste saatmisel Booksist kontrollib, kas sama tasumise number on juba siin registris olnud (vältimaks topeltsaatmist);
• Kasutaja saab siit tuvastada põhjuseid tõrgete uurimisel (veerud Hetkeseis ja Kommentaar).

Kui “Panga päringute järjekorra” registris on päringu juures teade „Viga vaheserveris“, siis tähendab see, et pangaliidestuse päring ei saanud korrektselt vastust vaheserveri kaudu. Vaheserver on Excellenti poolt hallatav tehniline andmevahetuse vahekiht, mille kaudu liiguvad päringud Excellent Booksi serveri ja panga serveri vahel. Selle kaudu toimub suhtlus näiteks Swedbanki, SEB, LHV, Coop Panga ja teiste pangaliidestustega.

Teade „Viga vaheserveris“ ei tähenda automaatselt, et viga on kliendi andmetes või Booksis. Tõrge võib olla ajutine ja tekkida mitmes kohas:

1. Kliendi Booksi serveri ja Excellenti vaheserveri vahel

Päring saadetakse kliendi serverist vaheserverisse, kuid vaheserver ei vasta ootuspäraselt. Põhjuseks võib olla näiteks:

• ajutine ühenduse probleem;
• vaheserveri teenuse ajutine tõrge;
• vale või puudulik pangaliidestuse seadistus;
• sertifikaadi, aadressi või ühenduse seadistuse probleem.

2. Excellenti vaheserveri ja panga serveri vahel

Vaheserver võib päringu kätte saada, kuid pank tagastab päringule veateate. Sellisel juhul võib põhjus olla näiteks:

• panga teenuse ajutine katkestus;
• panga poolne tehniline viga;
• autoriseerimise või õiguste probleem;
• pangalepingu või teenuse kasutusõiguse puudumine.

TÕRKE PÕHJUSE TUVASTAMINE

Kõige kiirem viis pangaliidestusega seotud tõrgete korral on avada Tehnika mooduli register “Panga päringute järjekord”, leia sealt konkreetne päring, millega võib probleem olla ja kontrollida selle päringu “Kommentaar” lahtrit. Kommentaar väljale võib olla salvestatud täpsem tehniline teade, näiteks:

• kasutajal või ettevõttel puudub õigus vastavat pangateenust kasutada;
• pank ei leidnud vastava ID-ga päringut;
• päringu saatmine ebaõnnestus;
• pank või vaheserver tagastas ajutise tehnilise vea.

Kui tegemist on makse ehk Tasumise saatmisega Booksist, siis tasub kontrollida ka vastava Tasumise kaardil andmeid, sh tasumise H-vahelehte. Sageli võib probleem olla seotud näiteks puuduva või ebakorrektse IBAN-iga või muu vigase infoga.

Lisaks saab kasutada Tehnika mooduli aruannet “Pangaliidestuse päringute hetkeseis“, mis annab ülevaate pangaliidestuse päringute staatusest.

Kui kommentaaris ei ole täpsemat andmeviga näha ja veateade viitab vaheserverile, siis võib tegemist olla ajutise ühenduse või teenuse tõrkega. Sellisel juhul soovitame:

1. avada vastav kaart “Panga päringute järjekorra” registris;
2. kontrollida päringu “Kommentaar” lahtrit;
3. kontrollida seotud dokumendi andmeid (näiteks Tasumise);
4. kui andmetes viga ei paista, proovida päring uuesti saata;
5. kui viga kordub, pöörduda Excellenti kasutajatoe poole ja lisada pöördumisele päringu kommentaaris olev täpne veateade.
   Kui veateade kordub ja täpsem põhjus ei ole nähtav, saab vajadusel kasutada pangaliidestuse nn. debug-režiimi. Selle kasutamiseks annab täpsemad juhised juba Excellenti konsultant.