Jūsų verslas 360° Analitika360
Finvalda API ir Power BI: kaip sujungti duomenis 2026 m.
Finvaldos duomenis į Power BI galima perkelti per oficialų Finvaldos webservisą (API). Jis pasiekiamas SOAP arba REST protokolu ir grąžina pardavimų operacijas, sandėlio likučius, klientų korteles bei kitus apskaitos duomenis XML arba JSON formatu. Pats prisijungimas užtrunka neilgai. Daugiausia darbo reikalauja kiti dalykai: duomenų transformavimas (ETL), patikimas duomenų modelis ir automatinis atnaujinimas. Šiame vadove aprašome, kaip ši grandinė veikia, kur dažniausiai klystama ir kuris kelias tinka jūsų įmonei.
TL;DR
- Finvaldos webservisas veikia per SOAP arba REST, o prisijungti reikia įmonės duomenų bazės kodo, naudotojo vardo ir slaptažodžio.
- API grąžina XML arba JSON, todėl duomenis prieš įkeliant į Power BI reikia transformuoti: be ETL ataskaitos nebus patikimos.
- Jei duomenys laikomi vietiniame serveryje, automatiniam atnaujinimui reikalingas „On-premises data gateway“, kuris turi būti visada įjungtas.
- Power BI Pro licencija leidžia iki 8 suplanuotų atnaujinimų per parą, Premium tipo licencijos leidžia daugiau.
- Paruoštas Finvaldos Power BI paketas leidžia išvengti integracijos kūrimo nuo nulio. Analitika360 Finvalda Basic kainuoja 59 Eur per mėnesį, PRO kainuoja 89 Eur per mėnesį.
Turinys
- Ką iš tikrųjų suteikia Finvaldos API
- Nuo API iki Power BI ataskaitos: penki žingsniai
- Automatinis atnaujinimas: gateway ir dažnis
- Trys keliai: kurį pasirinkti
- Klaidos, kurios sugadina ataskaitas
- Mūsų požiūris: API yra tik pradžia
- Finvaldos ataskaitos be rankinio darbo
- DUK
- Šaltiniai
Ką iš tikrųjų suteikia Finvaldos API
Finvalda turi webservisą, vadinamą FVS webservisu. Jo metodai, įėjimo parametrai, rezultatai ir galimi klaidų pranešimai aprašyti oficialioje webserviso metodų naudojimo instrukcijoje. Svarbiausi faktai Power BI projektui:
- Protokolai. Metodai pasiekiami per SOAP arba REST, pavyzdžiui, per FvsServicePure.svc sąsają.
- Autentifikacija. Reikia įmonės ID (duomenų bazės kodo), naudotojo vardo ir slaptažodžio. Integracijai verta sukurti atskirą naudotoją, kuriam suteiktos tik skaitymo teisės.
- Duomenų formatas. Rezultatai grąžinami XML arba JSON formatu. Power BI juos perskaito, bet pirmiausia struktūrą reikia išskleisti į lenteles.
- Duomenų apimtis. Per API galima gauti pardavimų ir pirkimų operacijas, sandėlio likučius, klientų ir prekių korteles.
API naudoja ne tik analitikos sistemos. Pavyzdžiui, sąskaitų skaitmeninimo įrankiai per Finvaldos API siunčia sąskaitas faktūras tiesiai į Finvaldą, todėl failų importuoti nereikia. Programuotojams yra ir atvirojo kodo bibliotekų, pavyzdžiui, PHP SDK, kuriame aprašytas REST URL šablonas FvsServiceR.svc/rest. Tai rodo, kad sąsaja yra brandi ir plačiai naudojama. Vis dėlto Power BI analitikai ji yra tik pirmas grandinės etapas.
Finvalda veikia keliais pavidalais: naršyklėje, mobiliojoje aplikacijoje, serveryje ar stacionariame kompiuteryje. Nuo to priklauso, kur fiziškai yra duomenų bazė, o kartu ir tai, kaip Power BI ją pasieks.
Nuo API iki Power BI ataskaitos: penki žingsniai
Jei integraciją kuriate patys, darbų eiliškumas paprastai būna toks:
- Prieigos paruošimas. Gaunate webserviso adresą, įmonės duomenų bazės kodą ir integracijos naudotojo prisijungimo duomenis. Patikrinate, ar serveris pasiekiamas iš ten, kur bus vykdomas atnaujinimas.
- Užklausos Power Query aplinkoje. Power BI Desktop programoje sukuriate užklausas į reikalingus metodus: pardavimus, pirkimus, likučius, klientus, prekes. Kiekvienam metodui nustatote parametrus, pavyzdžiui, laikotarpį.
- Transformavimas (ETL). XML arba JSON struktūrą išskleidžiate į lenteles, suvienodinate datų ir skaičių formatus, pašalinate dublikatus, sutvarkote valiutas ir PVM.
- Duomenų modelis. Sukuriate faktų lenteles (operacijos) ir dimensijas (klientai, prekės, sandėliai, kalendorius), susiejate jas per ID ir aprašote DAX matus: pajamas, savikainą, maržą, skolas.
- Publikavimas ir atnaujinimas. Ataskaitą publikuojate Power BI tarnyboje, prijungiate gateway, nustatote atnaujinimo grafiką ir prieigos teises.
Daugiausia laiko užima trečias ir ketvirtas žingsniai. Microsoft dokumentacijoje apie semantinius modelius matyti, kad ataskaita yra tik sluoksnis virš modelio. Jei ryšiai tarp lentelių sukurti blogai arba ID nesusieti, joks vizualizavimas klaidos neištaisys. Plačiau apie modelio struktūrą rašome vadove duomenų modelis finansams.
Automatinis atnaujinimas: gateway ir dažnis
Dažniausiai pasitaikanti staigmena: ataskaita Power BI Desktop programoje atsinaujina, o publikuota nebeatsinaujina. Taip yra todėl, kad Power BI debesis tiesiogiai nemato jūsų vietinio serverio. Microsoft nurodo, kad vidiniams (on-premises) duomenų šaltiniams reikalingas „On-premises data gateway“, o suplanuotas atnaujinimas veikia tik tada, kai gateway pasiekiamas. Kaip šliuzas diegiamas ir konfigūruojamas, parodyta Microsoft mokomojoje medžiagoje apie vietinių duomenų atnaujinimą.
Praktiškai tai reiškia, kad šliuzas diegiamas kompiuteryje arba serveryje, kuris veikia nuolat ir turi interneto ryšį. Nešiojamas buhalterės kompiuteris, kuris vakare išjungiamas, šiam tikslui netinka.
Atnaujinimų skaičius per parą priklauso nuo licencijos:
| Licencija | Suplanuotų atnaujinimų per parą | Kam tinka |
|---|---|---|
| Power BI Pro | iki 8 | Vadovų ir buhalterijos ataskaitos, kurioms pakanka kelių atnaujinimų per dieną |
| Premium Per User, Premium / Fabric talpa | iki 48 | Pardavimų, sandėlio ir restoranų tinklų stebėjimas beveik realiu laiku |
Šaltinis: Microsoft Learn, suplanuoto atnaujinimo konfigūravimas. Licencijų sąlygos gali keistis, todėl prieš pirkdami jas pasitikrinkite.
Trys keliai: kurį pasirinkti
Lietuvos įmonės, dirbančios su Finvalda, paprastai renkasi vieną iš trijų variantų.
| Kriterijus | Savo integracija per API | Excel eksportas į Power BI | Paruoštas Power BI paketas |
|---|---|---|---|
| Paleidimo laikas | Savaitės ar mėnesiai | Kelios dienos | Trumpiausias, modelis jau sukurtas |
| Reikalingos žinios | API, Power Query, DAX, gateway | Excel, pagrindai Power BI | Minimalios |
| Atnaujinimas | Automatinis, jei viskas sukonfigūruota | Rankinis | Automatinis |
| Klaidų rizika | Vidutinė, priklauso nuo kūrėjo | Didelė, žmogiškas faktorius | Maža, modelis patikrintas |
| Priežiūra | Jūsų IT komanda | Buhalterija kas savaitę | Paslaugos teikėjas |
Savo integracija tinka, jei turite duomenų inžinierių ir specifinių poreikių. Įvertinkite ne tik kūrimą, bet ir priežiūrą: pasikeitus metodams ar duomenų struktūrai, užklausas reikės taisyti.
Excel eksportas yra greitas startas, bet vėliau tampa rutina: kas savaitę reikia eksportuoti, įkelti ir patikrinti duomenis. Kaip šį procesą supaprastinti, aprašėme Finvaldos pardavimų vadove buhalteriams.
Paruoštas paketas leidžia išvengti integracijos kūrimo nuo nulio. Finvalda savo svetainėje aprašo integraciją su Analitika360: automatizuotų 7 Power BI ataskaitų puslapių rinkinį finansų analitikams ir vadovams.
Klaidos, kurios sugadina ataskaitas
- „Užtenka tik prijungti“. Be ETL ir automatinio atnaujinimo duomenis teks tvarkyti rankomis, o kiekvienas rankinis veiksmas didina klaidų riziką.
- Nesusieti identifikatoriai. Jei prekių ar klientų kodai skirtingose lentelėse nesutampa, pardavimų ir sandėlio skaičiai nesusieis.
- Nėra kalendoriaus lentelės. Be jos neveiks metų palyginimai, kaupiamosios sumos ir sezoniškumo analizė.
- Visi mato viską. Microsoft rekomenduoja naudoti eilučių lygio saugą (RLS), kad vadybininkas matytų tik savo klientus, o savikainos ir maržos liktų vadovybei.
- Gateway asmeniniame kompiuteryje. Kai jis išjungiamas, atnaujinimas sustoja, o vadovas ryte žiūri į vakarykščius skaičius.
Mūsų požiūris: API yra tik pradžia
Kasdien dirbame su Finvaldos ir Rivilės naudotojais. Matome, kad sėkmę lemia ne pats prisijungimas prie API, o tai, kas vyksta po jo. Klientams svarbu ne JSON ar XML, o atsakymai į konkrečius klausimus: kiek uždirbome šį mėnesį, kurie klientai vėluoja mokėti, kurios prekės stovi sandėlyje per ilgai.
Todėl kuriame paruoštus ataskaitų rinkinius, kurie atsinaujina be papildomo naudotojo darbo. Taip pat sujungiame skirtingus šaltinius, pavyzdžiui, Finvaldą, SharePoint, Excel, CRM ar logistikos sistemas, į vieną Power BI modelį. Jei įmonės procesai nestandartiniai, sprendimą pritaikome pagal jos procesus ir esamas IT sistemas, o ne verčiame įmonę prisitaikyti prie šablono. Restoranų tinklai ir buhalteriai, naudojantys mūsų sistemą, sutaupo laiko, kurį anksčiau skirdavo Excel lentelėms derinti, ir gauna finansinę informaciją, reikalingą strateginiams sprendimams.
Mūsų patarimas: prieš pradėdami kurti integraciją, užsirašykite 5–10 rodiklių, kuriuos vadovas nori matyti kiekvieną rytą. Tada įvertinkite, ar verta juos kurti nuo nulio.
— Analitika360
Finvaldos ataskaitos be rankinio darbo
Jei norite Finvaldos duomenis matyti Power BI be savo integracijos kūrimo, Analitika360 siūlo du paruoštus planus:
- Finvalda Basic: 59 Eur per mėnesį.
- Finvalda PRO: 89 Eur per mėnesį.
- Individualūs projektai: 70 Eur per valandą, kai reikia papildomų šaltinių ar šakai būdingų ataskaitų.
Ataskaitose matysite pajamas, sąnaudas, pelną, balansą, pardavimus, sandėlį ir skolas. Taip pat parduodame Microsoft Pro ir Premium licencijas. Visas kainas rasite verslo analitikos kainų puslapyje. Konkrečias temas išsamiau aptariame straipsniuose apie Finvaldos skolų ataskaitas ir Finvaldos pelno ataskaitą.
DUK
Ar Finvalda turi oficialų API?
Taip. Finvalda turi FVS webservisą, kurio metodai pasiekiami per SOAP arba REST protokolą. Visi metodai, parametrai ir klaidų pranešimai aprašyti oficialioje Finvaldos instrukcijoje. Duomenys grąžinami XML arba JSON formatu.
Ar galima Finvaldą prijungti prie Power BI be programuotojo?
Savo integracijai per API reikia Power Query, duomenų modeliavimo ir gateway konfigūravimo žinių. Be jų lieka rankinis Excel eksportas arba paruoštas Power BI paketas. Paketas leidžia gauti automatiškai atsinaujinančias ataskaitas be techninio darbo jūsų pusėje.
Kaip dažnai atsinaujina Power BI ataskaita su Finvaldos duomenimis?
Tai priklauso nuo licencijos. Microsoft duomenimis, Power BI Pro leidžia iki 8 suplanuotų atnaujinimų per parą, Premium tipo licencijos leidžia iki 48. Jei duomenys yra vietiniame serveryje, šliuzas (gateway) turi veikti nuolat.
Ar saugu Finvaldos duomenis perkelti į Power BI?
Saugumas priklauso nuo konfigūracijos. Integracijai naudokite atskirą naudotoją, kuriam suteiktos tik skaitymo teisės, o Power BI aplinkoje taikykite eilučių lygio saugą (RLS). Tada kiekvienas darbuotojas matys tik jam skirtus duomenis.
Kiek kainuoja paruoštas Finvaldos Power BI sprendimas?
Analitika360 Finvalda Basic kainuoja 59 Eur per mėnesį, Finvalda PRO kainuoja 89 Eur per mėnesį. Individualūs projektai kainuoja 70 Eur per valandą. Microsoft licencijų kainos skaičiuojamos atskirai.
Šaltiniai
- Finvalda: webserviso metodų naudojimo instrukcija
- Finvalda: verslo valdymo sistemos
- Finvalda: integracija su Analitika360
- INVOX pagalbos centras: kaip prijungti Finvalda API
- GitHub: Finvalda PHP SDK
- Microsoft Learn: Configure scheduled refresh
- Microsoft Learn: Connect to on-premises data
- Microsoft Learn: Semantic models in the Power BI service
- Microsoft Learn: Row-level security in Power BI
