Uuendatud 28. jaanuar 2026
API päringute enamlevinud tõrgete põhjused
1. Viga 401 ehk „Access Denied“ või “Unauthorized” („Ligipääs puudub“) võimalikud põhjused:
- Samaaegsete kasutajate arv on täis.
- Kasutajanimi/parool on vale või aegunud. Salasõna muutmiseks või uuendamiseks leiad juhise SIIT
- Excellent Booksi serveri logi failis võib esineda teade: “Tee pole lubatud: api/2/TRVc“.
Kasutajaõigused puuduvad Booksis. Kontrolli moodul Üldine > Seadistused > Kasutajagrupid. Veendu, et oleks REST API tase = Täis ja ligipääs konkreetsele registrile (siin näites TRVs=Finantskanded). “2” teates viitab ettevõtte järjekorrale Ettevõtete tabelis.
2. Viga 404 ehk „Page Not Found“ („Lehte ei leitud“) võimalikud põhjused:
- Excellent Books serverprogrammi töö on peatunud.
- Kasutusel on IP aadressi piirang ja päringu tegija IP on muutunud.
3. API POST: „Soov on muuta arvel kliendi nime ära aga see muutub tagasi“
- Nime lahter muudetakse arve peal ära enne, kui Kliendikood. Nagu ka akendega klientprogrammis, muutub peale kliendikoodi asetamist kliendi nimi.
4. API GET: „Päringuga on soov küsida ainult updates_after kaarte, aga peale andmebaasihooldust tulid kõik kaardid“:
- Moodul Üldine > Seadistused > “Valikulised võimalused”. Puudub linnuke „Ekspordi järjekorranumbrid“. Kui see valik on puudu, siis lähevad sequence numbrid iga andmebaasihooldusega algpositsioonile.
5. API POST: „Tühikute asemel tulevad postitatud kaartidele + märgid“
- POST puhul tuleb kasutada päise ridu, ehk curlis näiteks (eraldi ridadel):
–header ‘Content-Type: application/x-www-form-urlencoded’ –header ‘Content-Type: charset=utf-8’
6. API POST: „Täpitähtede asemel on imelikud sümbolid“
- POST puhul peab kindlasti kasutama päise ridu, ehk curlis näiteks (eraldi ridadel):
–header ‘Content-Type: application/x-www-form-urlencoded’ –header ‘Content-Type: charset=utf-8’
7. Kui Excellent Booksi saadetavate andmete sees (näiteks, artikli nimetuses) on tehnilisi tähemärke, mida muidu kasutatakse URL-s sees, siis kasutage urlencoded andmetes neid ASCII tähemärke:
| Soovitud sümbol | Kasutatav sümbol |
|---|---|
| % | %25 |
| & | %26 |
| \ | %5C |
| / | %2F |
| : | %3A |
| ; | %3B |
| $ | %24 |
| ? | %3F |
8. Järgnevalt leiad loetelu Excellent Booksi teated ja tõlketekstid, mis API-ga seotud. Teksti kood on üldiselt leitav serveri logifailis, API veateadetes ja hoiatustes.
|
1033 |
Ei ole määratud numbriseerias |
Not a defined serial number |
|
1557 |
Ei ole määratud numbriseerias |
Not in any defined series |
|
1744 |
Kontrolli arvete numbriseeriaid |
Check Invoices Number Series |
|
1747 |
Kontrolli numbriseeriaid |
Check Number Series |
|
1256 |
Sisesta tasumistingimus |
Enter payment term |
|
1958 |
Tasumistingimus ei ole lubatud |
Payment Term not allowed |
|
1218 |
Ei ole sama klient |
Not the same customer |
|
20859 |
Sellist klienti ei eksisteeri |
Customer does not exist |
|
33721 |
Klienti ei leitud |
Customer was not found |
|
40892 |
Vähemalt ühel real peab olema kogus ja artikkel |
At least one row should have Quantity and Item |
|
1266 |
Artikkel suletud: |
Item Closed: |
|
25711 |
Vale KM-kood |
Incorrect #VAT# Code |
|
1134 |
Sisesta KM-kood |
Enter #VAT Code# |
|
1286 |
Ei ole sama KM-kood |
Not the same #VAT Code# |
|
1902 |
Müügi KM konto puudub, kontrolli KM-koodide seadistust |
Account for Sales #VAT# not found, check #VAT# Codes |
|
1903 |
KM konto puudub, kontrolli Lausendamist |
Account for #VAT# (A/C) not found, check Account Usage #S/L# |
|
1951 |
KM-kood puudub. |
#VAT# code is missing. |
|
25711 |
Vale KM-kood |
Incorrect #VAT# Code |
|
20413 |
KM koodi pikkus ei tohi ületada 6 märki |
#VAT Code# length cannot exceed 10 characters |
Täpse nimekirja kõikidest veakoodidest leiad SIIT
(SOAP, api url, veateated, error)
Sind võivad huvitada ka need artiklid:
Kuidas vältida API-ga liiga sagedast autentimist ehk sessioonide kasutamine?