DESAmedia ·

Trumpas atsakymas

Integracija su Rivile, Directo ir Agnum įmanoma, tačiau kiekviena sistema tam siūlo skirtingą kelią. Rivilė GAMA ir Rivilė ERP turi dokumentuotą REST API, kuris įsigyjamas pagal sutartį, Directo turi XML sąsają ir naujesnę API Direct sąsają su API raktais, o Agnum viešos API dokumentacijos neskelbia, todėl jungtis derinama su gamintoju arba jo partneriu. Kai API nėra, patikimai veikia failų mainai (XML, XLS, EIP), jei jie automatizuoti, registruojami ir tikrinami.

Ką reiškia integracija su apskaita

Apskaitos integracija yra automatinis duomenų perdavimas tarp apskaitos programos ir kitos jūsų sistemos: el. parduotuvės, CRM, sandėlio ar gamybos valdymo. Dažniausiai perduodami keturi duomenų tipai:

  • prekių kortelės, kainos ir likučiai iš apskaitos į el. parduotuvę;
  • užsakymai ir klientai iš el. parduotuvės ar CRM į apskaitą;
  • sąskaitos faktūros (dažniausiai kuriamos apskaitoje, kad numeracija ir PVM būtų vienoje vietoje);
  • mokėjimai ir skolos, kad vadybininkas CRM sistemoje matytų, ar klientas atsiskaitė.

Techniškai jungtis gali veikti trimis būdais. API (programinė sąsaja) leidžia vienai sistemai tiesiogiai klausti kitos ir gauti atsakymą per kelias sekundes. Failų mainai reiškia, kad viena sistema suformuoja failą, o kita jį importuoja pagal grafiką. Tiesioginė prieiga prie duomenų bazės techniškai įmanoma, tačiau ji apeina apskaitos programos taisykles, todėl ją rekomenduojame tik skaitymui ir tik gamintojui sutikus.

Prieš pasirenkant būdą verta atsakyti į du klausimus: kaip greitai duomenys turi atsinaujinti (realiu laiku, kas valandą ar kartą per parą) ir kuri sistema yra kiekvieno duomenų tipo šaltinis. Nuo šių atsakymų priklauso ir jungties sudėtingumas.

Rivilė integracija: galimybės ir apribojimai

Rivilė turi du produktus, o jų integracijos veikia skirtingai.

Rivilė GAMA

Rivilė GAMA naudoja Rivile API v2 - REST sąsają, kuri, pagal gamintojo gidą, leidžia saugiai pasiekti duomenų bazę iš išorinių sistemų, pavyzdžiui, el. parduotuvių. Užklausos siunčiamos į vieną adresą (api.manorivile.lt) su API raktu antraštėje, o duomenys gali būti XML arba JSON formatu. Metodai skirstomi į skaitymo (GET_..._LIST) ir redagavimo (EDIT_...) tipus ir apima pirkimus, pardavimus, atsargas, didžiąją knygą, darbo užmokestį, ilgalaikį turtą ir kitus modulius.

Keletas savybių, kurias būtina žinoti projektuojant jungtį:

  • Reikalingas tarpininkas. API veikia per programą Manorivile-Gateway, kuri įdiegiama kliento kompiuteryje ar serveryje, turinčiame prieigą prie Rivilė GAMA duomenų bazės. Jei tas serveris išjungtas, API grąžina klaidą 502, todėl jūsų sistema turi mokėti palaukti ir pakartoti.
  • Atsakymai pateikiami po 100 įrašų. Norint nuskaityti 5 000 prekių, reikia 50 užklausų.
  • Vienas įrašas per vieną redagavimo užklausą. Masinis atnaujinimas vyksta daugybe atskirų užklausų.
  • Apmokestinama pagal užklausų skaičių, nepriklausomai nuo grąžintų duomenų kiekio. Tai tiesiogiai veikia sinchronizacijos dažnumo sprendimą.
  • Paslauga įsigyjama pagal sutartį su UAB „Rivilė" arba jos atstovais. Kainos viešai neskelbiamos, jas pateikia gamintojas ar partneris.

Be API, Rivilė GAMA palaiko importą ir eksportą EIP formato failais bei turi paruoštas jungtis su Shopify, WooCommerce, PrestaShop, Pigu.lt, EDI tiekėjais (Edisoft, Telema, Unifiedpost) ir kasų sistemomis.

Rivilė ERP

Debesų produktas Rivilė ERP turi atskirą REST API su OpenAPI (Swagger) dokumentacija. API raktas kuriamas pačioje Rivilė ERP sistemoje. Pagal gamintojo gidą, viena GET užklausa grąžina daugiausia 100 įrašų, siunčiamų duomenų dydis ribojamas iki 5 MB, o vienu kartu galima sukurti dokumentą su ne daugiau kaip 100 eilučių. Gide pateikiami pavyzdžiai PHP, Python, JavaScript ir kitomis kalbomis.

Directo: galimybės ir apribojimai

Directo turi dvi integracijos sąsajas.

XML sąsaja (Directo dokumentacijoje vadinama xmlcore ir XML Direct) leidžia išorinei sistemai gauti duomenis (prekes, klientus, likučius, užsakymus, sąskaitas) ir siųsti juos į Directo. Duomenų srautą visada inicijuoja išorinė sistema, o atsakymas grąžinamas iš karto XML formatu. Dokumentacijoje nurodyta, kad sąsaja pagal nutylėjimą neįjungta ir konfigūruojama kiekvienam klientui atskirai, o jos diegimo kaina priklauso nuo duomenų srautų skaičiaus kiekviena kryptimi. 2026 m. rugsėjo duomenimis, Directo Lietuvos kainoraštyje XML dokumentų priėmimas į Directo duomenų bazę kainuoja 25 Eur per mėnesį, o atidavimas iš jos 5 Eur per mėnesį (be PVM).

API Direct yra naujesnė REST sąsaja, grąžinanti JSON arba XML. Prieiga suteikiama API raktu, kurį administruoja Directo naudotojas su SUPER teisėmis (nustatymuose, integracijų skiltyje). Kiekvienam raktui galima nurodyti, kuriuos išteklius ir laukus jis mato, o openapi.json adresas parodo būtent to rakto galimybes. Duomenys filtruojami taip pat kaip pačioje Directo, taip pat ir pagal pakeitimo laiką, todėl patogu atsisiųsti tik tai, kas pasikeitė nuo paskutinės sinchronizacijos.

Directo dokumentacija vieša ir išsami (wiki.directo.ee), tai sutrumpina analizės etapą. Pagrindinis apribojimas yra organizacinis: kol sąsaja neįjungta ir raktas nesukonfigūruotas, programuotojas neturi su kuo dirbti, todėl tai reikia užsakyti iš karto projekto pradžioje.

Agnum: galimybės ir apribojimai

Agnum savo svetainėje nurodo duomenų importą iš XLS, TXT ir XML failų, integraciją su el. parduotuvėmis, bankais, GPAIS, i.SAF, i.VAZ, EDI tiekėjais (Edisoft, Telema) ir „API integracijas su išorinėmis sistemomis". Tačiau viešos API dokumentacijos 2026 m. rugsėjį Agnum svetainėje nėra.

Praktikoje partneriai jungiasi per Agnum naudojamą duomenų mainų žiniatinklio paslaugą (web service), per kurią perduodami užsakymai, prekių kortelės, kainos ir likučiai. Techniniai jos aprašai, prieigos sąlygos ir kaina pateikiami gamintojo arba jo partnerio paprašius. Todėl su Agnum pirmasis žingsnis visada yra tas pats: kliento vardu kreiptis į gamintoją, išsiaiškinti, kokia versija ir konfigūracija naudojama ir kokius metodus paslauga palaiko.

O jei naudojate Site.pro (buvusį B1.lt)?

B1.lt apskaitos programa pervadinta į Site.pro. Ji turi viešą API dokumentaciją, Postman kolekciją ir PHP biblioteką. Duomenims per API importuoti ar eksportuoti reikia aktyvaus integracijų plano.

Palyginimas

Sistema Sąsaja Dokumentacija Prieiga
Rivilė GAMA REST API v2 (XML, JSON) per Manorivile-Gateway, EIP failai Vieša (gidas.rivile.lt) Sutartis su Rivile ar atstovu, apmokestinamos užklausos
Rivilė ERP REST API (OpenAPI) Vieša (guide.rivile.cloud) API raktas sistemoje
Directo XML sąsaja, REST API Direct (JSON, XML) Vieša (wiki.directo.ee) Įjungia Directo, mėnesinis mokestis už srautus
Agnum Žiniatinklio paslauga, XLS, TXT, XML importas Viešai neskelbiama Per gamintoją ar partnerį
Site.pro (B1.lt) REST API Vieša Aktyvus integracijų planas

Ką daryti, kai API nėra

API gali nebūti dėl kelių priežasčių: sena programos versija, nenupirktas modulis, per brangus užklausų modelis arba gamintojas tiesiog jo nesiūlo. Tada lieka failų mainai, ir jie gali veikti patikimai, jei laikomasi kelių taisyklių.

  1. Formatas iš gamintojo. Naudojamas apskaitos programos palaikomas importo formatas (Rivilės EIP, Agnum XML ar XLS šablonas), o ne išgalvota struktūra. Taip importas nepriklauso nuo žmogaus, kuris failą „pataiso" Excel'yje.
  2. Automatinis perdavimas. Failas formuojamas ir padedamas į sutartą vietą (SFTP, bendrą katalogą) pagal grafiką. Žmogus spaudžia tik importo mygtuką, o dar geriau, jei apskaitos programa gali importuoti pagal tvarkaraštį.
  3. Grįžtamasis failas. Apskaita eksportuoja atsakymą: kurie dokumentai įkelti, kokiais numeriais. Be jo jūsų sistema nežino, ar užsakymas tikrai pateko į apskaitą.
  4. i.SAF atsargiai. i.SAF yra į VMI teikiamo sąskaitų faktūrų registro XML formatas. Kai kurios programos jį importuoja, tačiau jame nėra prekių eilučių, todėl jis tinka nebent PVM registrui perkelti, bet ne visai pardavimų apskaitai.

Tiesioginis rašymas į apskaitos duomenų bazę yra paskutinė išeitis, kurios vengiame: apeinamos programos taisyklės, o po atnaujinimo pasikeitusi lentelių struktūra gali tyliai sugadinti duomenis.

Kaip sprendžiami duomenų konfliktai

Konfliktas atsiranda, kai tas pats įrašas pakeičiamas dviejose sistemose arba kai viena sistema nepriima kitos duomenų. Dažniausi atvejai ir sprendimai:

  • Vienas šaltinis kiekvienam laukui. Iš anksto sutariama, kad kainos ir likučiai keičiami tik apskaitoje, o prekės aprašymai ir nuotraukos tik el. parduotuvėje. Tada sinchronizacija neperrašo svetimų laukų.
  • Kodų atitikmenys. Rivilė GAMA kodai yra iki 12 simbolių ir rašomi didžiosiomis raidėmis, todėl el. parduotuvės prekės kodas ne visada tinka tiesiogiai. Laikoma atitikmenų lentelė: išorinis ID ir apskaitos kodas.
  • Pakartotinio siuntimo apsauga. Kiekvienas užsakymas siunčiamas su unikaliu išoriniu numeriu, o prieš kuriant dokumentą patikrinama, ar jis jau yra. Taip ryšio trikdžio atveju pakartota užklausa nesukuria dvigubos sąskaitos.
  • Apvalinimo skirtumai. PVM gali būti skaičiuojamas nuo eilutės arba nuo visos sumos, todėl el. parduotuvės ir apskaitos sumos kartais skiriasi 1 centu. Taisyklė nustatoma iš anksto kartu su buhalteriu.
  • Klaidų žurnalas ir pakartojimai. Kiekviena užklausa ir atsakymas registruojami. Laikinos klaidos (serveris nepasiekiamas, baigėsi laukimo laikas) automatiškai kartojamos didėjančiais intervalais, o nuolatinės (neegzistuojantis prekės kodas, uždarytas laikotarpis) patenka į sąrašą, kurį peržiūri atsakingas žmogus, ir apie jas pranešama el. paštu.

Toks registravimas praverčia ne tik klaidoms. Mūsų kurtoje padangų el. parduotuvėje su tiekėjų importu kiekvienas importas registruojamas, todėl administratorius mato, kas atnaujinta ir kas nepavyko, neklausdamas programuotojo.

Kiek laiko užtrunka viena jungtis

Trukmę labiau lemia duomenų tipų skaičius ir sinchronizacijos kryptis nei pati apskaitos programa. Toliau pateikiami orientaciniai inžineriniai rėžiai, kai prieiga prie API ar importo formato jau suteikta:

Jungties tipas Orientacinė trukmė
Vienos krypties likučių ir kainų sinchronizacija 1-2 savaitės
Užsakymai į apskaitą ir sąskaitų numeriai atgal 2-4 savaitės
Dvikryptė jungtis su klientais, skolomis ir mokėjimais 4-8 savaitės

Į šiuos rėžius neįeina laukimas, kol gamintojas įjungs modulį ar išduos prieigą. Šis etapas kartais trunka ilgiau už programavimą, todėl prieigą užsakome lygiagrečiai su analize. Taip pat skiriame laiko bandymams su tikrais duomenimis bandomojoje aplinkoje: Directo tam turi XML demo aplinką, o su Rivile ir Agnum dažniausiai naudojama duomenų bazės kopija.

Integracija su apskaita dažnai yra didesnio projekto dalis. Kuriant CRM sistemą ar el. parduotuvę, jungtį su apskaita verta suprojektuoti iš pradžių, nes nuo jos priklauso, kaip sistemoje saugomi prekių kodai, klientai ir dokumentų būsenos.

Ką daryti toliau

Jei planuojate sujungti apskaitos programą su el. parduotuve, CRM ar kita sistema, pradėkite nuo sąrašo: kokie duomenys, kuria kryptimi ir kaip dažnai turi judėti. Su tokiu sąrašu galime įvertinti jūsų atvejį ir pasiūlyti tinkamiausią būdą, o daugiau apie tai, kaip dirbame, rasite sistemų integracijų ir automatizavimo puslapyje.

Šaltiniai